Ajoute ton premier MCP server

Une commande pour connecter Claude Code à GitHub, aux bases de données et bien plus

⏱ Estim. ~6 min

01 · Lire

Ajouter un MCP server à Claude Code se fait en une seule commande. Tu utilises claude mcp add suivi du nom et de l'URL (HTTP) ou de la commande (stdio).

Une fois ajouté, Claude peut utiliser chacun des outils exposés par ce server — automatiquement. Pas de changement de code, pas de fichier de configuration, pas de redémarrage. Tu l'ajoutes, et tu commences à demander à Claude de l'utiliser.

Points clés

claude mcp add est la commande principale pour ajouter un server
Un server HTTP a besoin d'un nom et d'une URL
Un server stdio a besoin d'un nom et de la commande à exécuter
Les options comme --transport, --env, --scope doivent venir avant le nom du server

02 · Exemple de code

Voici comment ajouter un server HTTP distant — le type le plus courant. Cet exemple connecte Claude à GitHub.

Ajouter le MCP server GitHub

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

Ajouter le MCP server Notion

claude mcp add --transport http notion https://mcp.notion.com/mcp

Ajouter un header d'authentification

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

Le pattern est toujours le même : claude mcp add --transport http <name> <url>. Le nom est celui que tu utiliseras pour référencer ce server par la suite. L'URL est l'endroit où vit le MCP server. Si le server a besoin d'un token, ajoute un header d'authentification avec --header.

03 · Exemple de code

Les server stdio exécutent des processus locaux. Cet exemple utilise le paquet dbhub pour connecter Claude à une base de données PostgreSQL.

Ajouter le server PostgreSQL

claude mcp add --transport stdio db \
  -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:pass@localhost:5432/mydb"

Ajouter avec des variables d'environnement

claude mcp add --transport stdio airtable \
  --env AIRTABLE_API_KEY=YOUR_KEY \
  -- npx -y airtable-mcp-server

Le -- (double tiret) sépare les options de Claude de la commande et des arguments du server. Tout ce qui suit -- est la commande qui exécute le MCP server. Utilise --env pour transmettre des clés API en toute sécurité via des variables d'environnement, plutôt que de les écrire en dur.

04 · Étape par étape

1. Choisis le server

Décide quel MCP server tu veux ajouter. Pour un server HTTP, il te faut son URL. Pour un server stdio, il te faut le nom du paquet npm ou la commande. Consulte la liste officielle des MCP server ou la doc de ton service.

2. Exécute claude mcp add

Pour un server distant : claude mcp add --transport http <name> <url>. Pour un server local : claude mcp add --transport stdio <name> -- <command>. Souviens-toi : toutes les options viennent avant le nom, et -- sépare la commande du server.

3. Confirme la connexion

Exécute claude mcp list pour voir tous les server configurés, ou utilise /mcp dans Claude Code pour voir le statut et t'authentifier. Un statut vert signifie que le server est connecté et prêt.

4. Demande à Claude de l'utiliser

Lance une conversation avec Claude Code et pose des questions qui nécessitent ce server. GitHub : « Montre-moi mes PR ouvertes. » Base de données : « Quelles tables sont disponibles ? » Claude découvre automatiquement les outils du server.

05 · Quiz

Tu veux ajouter un server de base de données locale qui a besoin d'une variable d'environnement DATABASE_URL. L'ordre des flags est important. Quelle commande est correcte ?

claude mcp add --transport stdio --env DATABASE_URL=... db -- npx dbhub
claude mcp add db --transport stdio --env DATABASE_URL=... -- npx dbhub
claude mcp add --transport stdio db -- npx dbhub --env DATABASE_URL=...
claude mcp add -- npx dbhub --transport stdio db

06 · Compléter

Pour lister tous les MCP server configurés, exécute claude mcp _____

Autres leçons de ce chapitre

⚠ L'expérience interactive complète nécessite JavaScript. Active-le et recharge la page.

※ Ce site est un projet éducatif indépendant — pas un produit officiel d'Anthropic. Claude™ est une marque déposée d'Anthropic, PBC.