CODEX & CLAUDE CODE · PAS À PAS

Votre premier MCP,
en quatre étapes.

Connectez data.gouv.fr à votre assistant, puis faites une recherche de données publiques. Pour ce premier essai, le serveur est déjà hébergé : vous ajoutez une connexion.

01 Préparer 02 Connecter 03 Vérifier 04 Essayer

Préparer son environnement

Utilisez un ordinateur connecté à Internet, avec Codex CLI ou Claude Code installé et votre compte connecté. CLI signifie « interface en ligne de commande ». Ouvrez Terminal sur macOS ou Linux, ou PowerShell sur Windows. Sur un poste professionnel, utilisez l’environnement autorisé par votre collectivité.

Pas encore installé ? Démarrer avec Codex CLI ↗ · Démarrer avec Claude Code ↗

Où coller les commandes ?

Les commandes codex mcp add… et claude mcp add… vont dans le terminal de votre ordinateur. Le prompt d’essai ira ensuite dans la conversation avec l’assistant.

Le README de data.gouv.fr fournit l’adresse ci-dessous. Cette instance fonctionne en lecture seule, sans clé API. Une adresse GitHub sert à lire la documentation ; l’adresse MCP sert à établir la connexion.

Adresse du serveur distant · HTTP

https://mcp.data.gouv.fr/mcp

Ajouter le serveur à son assistant

Choisissez la colonne de votre outil. Copiez la commande, collez-la dans le terminal, puis appuyez sur Entrée.

OPENAI

Codex CLI

Dans le terminal

codex mcp add datagouv --url https://mcp.data.gouv.fr/mcp

Codex enregistre cette connexion dans sa configuration. Elle ne modifie pas le site data.gouv.fr.

Documentation MCP de Codex ↗

ANTHROPIC

Claude Code

Dans le terminal

claude mcp add --transport http --scope user datagouv https://mcp.data.gouv.fr/mcp

--scope user rend cette connexion disponible dans vos projets Claude Code, pour votre compte sur cet ordinateur.

Documentation MCP de Claude Code ↗

Vous utilisez l’application de bureau avec Codex ?

Dans l’application de bureau ChatGPT décrite par la documentation actuelle d’OpenAI : ouvrez Settings → MCP servers → Add server. Saisissez datagouv, choisissez Streamable HTTP et collez l’adresse ci-dessus. Enregistrez, puis cliquez sur Restart.

Sur le même hôte, l’application et Codex CLI partagent leur configuration : utilisez une seule méthode. Une configuration locale ne s’ajoute pas automatiquement à ChatGPT dans le navigateur, qui utilise ses plugins.

Vérifier que la connexion fonctionne

Avec Codex

Dans le terminal

codex mcp list

Ouvrez ensuite une nouvelle session avec codex.

Avec Claude Code

Dans le terminal

claude mcp list

Ouvrez ensuite une nouvelle session avec claude.

Dans la conversation de l’outil choisi, saisissez /mcp pour examiner les serveurs et leurs outils. Vérifiez que datagouv est disponible, puis passez au premier essai. Un nom dans la liste de configuration ne suffit pas à prouver que le serveur répond.

Faire une première recherche

À coller dans la conversation

Utilise le MCP datagouv pour chercher 3 jeux de données sur les équipements sportifs dans l’Oise. Donne le titre, le producteur, la date de mise à jour et le lien de chaque jeu. Indique si tu as pu interroger le serveur.

Comment savoir si c’est réussi ? La conversation montre un appel à un outil de data.gouv.fr et des résultats consultables. Ouvrez un lien source et comparez son contenu à la réponse.

Reprendre la méthode avec un autre MCP

French Law MCP · connexion distante

Le README du dépôt fourni renvoie au serveur tiers d’Ansvar Systems. C’est une base issue notamment de Légifrance, pas une connexion officielle directe à Légifrance.

Codex CLI · dans le terminal

codex mcp add french-law --url https://mcp.ansvar.eu/law-fr/mcp

Claude Code · dans le terminal

claude mcp add --transport http --scope user french-law https://mcp.ansvar.eu/law-fr/mcp

Refaites les étapes de vérification avec french-law. Pour commencer, demandez les sources couvertes et leur date de mise à jour. Contrôlez ensuite tout texte utilisé sur Légifrance. La disponibilité et les fonctions du service distant dépendent de son opérateur.

Blender MCP · exemple d’un serveur local

Un serveur local, dit stdio, se lance avec une commande. Pour Blender, installez d’abord Blender, Python et uv selon le guide du dépôt, puis installez son extension :

Dans le terminal

uvx blender-mcp install-addon

Dans Blender, activez l’extension Interface: MCP for Blender. Dans la vue 3D, appuyez sur N, ouvrez son onglet et cliquez sur Start MCP Server. Gardez Blender ouvert, puis choisissez votre commande :

Codex CLI · dans le terminal

codex mcp add blender -- uvx blender-mcp

Claude Code · dans le terminal

claude mcp add --transport stdio --scope user blender -- uvx blender-mcp

Refaites la vérification avec blender. Commencez par demander une description de la scène ouverte. Le -- sépare les options de l’assistant de la commande qui lance le serveur. Chaque MCP local a ses propres prérequis.

Un problème ? Les vérifications utiles

« Commande introuvable » : vérifiez l’installation de Codex CLI ou de Claude Code, puis rouvrez le terminal.
Le serveur ne répond pas : contrôlez son adresse, votre connexion et les restrictions éventuelles du réseau professionnel.
« npx » ou « uvx » introuvable : installez le prérequis indiqué par le dépôt, puis relancez l’assistant.
Une authentification est demandée : suivez la documentation du MCP concerné ; ne copiez pas de clé secrète dans la conversation.

Vous savez maintenant connecter un serveur distant et reconnaître les prérequis d’un serveur local.

Retour aux 12 dépôts