Claude Code MCP

Si Claude Code est un excellent dactylographe (génération de code) et testeur (vérification de code), alors l'ajout de MCP (Model Context Protocol) donne à Claude de véritables sens et membres externes—il n'est plus limité aux fichiers de code du projet actuel, mais peut se connecter activement aux ressources et outils du monde extérieur, devenant votre partenaire de collaboration de développement de bout en bout.

Qu'est-ce que MCP (Model Context Protocol) ?

MCP est un protocole standardisé ouvert introduit par Anthropic, conçu pour résoudre les principaux points de friction de la collaboration entre l'IA et les outils externes.

La logique centrale de MCP renverse l'approche traditionnelle : au lieu que l'IA apprenne une par une les règles d'utilisation de chaque outil, tous les outils fournissent une interface unifiée à l'IA.

Cette logique est comme une prise de courant universelle dans la vie réelle—au lieu de faire en sorte que les appareils s'adaptent à différentes prises, tant que les prises sont standardisées, tous les appareils peuvent être utilisés directement.

Après avoir connecté un serveur MCP, vous pouvez laisser Claude Code :

  • Récupérer des exigences depuis JIRA/les systèmes de tickets et développer des fonctionnalités, créer des PR GitHub
  • Analyser les données de surveillance de Sentry, localiser les erreurs de l'environnement de production
  • Interroger des données de base de données telles que PostgreSQL/MySQL
  • Mettre à jour le code à partir des maquettes Figma, générer automatiquement des brouillons d'e-mails, etc.

Pourquoi Claude Code a-t-il besoin de MCP ?

Avant MCP, les capacités de Claude Code étaient strictement limitées au dossier de projet que vous avez actuellement ouvert, comme un assistant regardant le ciel du fond d'un puits—il ne pouvait voir que le code devant lui et ne pouvait percevoir aucune information en dehors du projet. L'émergence de MCP brise complètement ce silo d'information, permettant à Claude de participer profondément à l'ensemble du processus de développement :

Voici quelques comparaisons de scénarios intuitives pour vous aider à comprendre rapidement la valeur de MCP :

Scénario Sans MCP Avec MCP
Analyse inter-dépôts Peut uniquement analyser le code dans le dossier actuel, ne peut pas établir de lien avec d'autres dépôts Collaboration inter-dépôts : "Aidez-moi à analyser la documentation API du dépôt A, puis écrivez les méthodes d'appel correspondantes dans le dépôt B."
Synchronisation des exigences/discussions Vous devez copier et coller manuellement les documents d'exigences et les enregistrements de discussion de l'équipe dans le chat Synchronisation des informations de collaboration en temps réel : "Vérifiez les enregistrements de discussion dans le canal #feature-x sur Slack et consultez les suggestions de chacun pour modifier cette fonctionnalité."
Validation de la base de données Impossible de vérifier directement la compatibilité entre le code et la base de données ; peut uniquement inspecter manuellement les structures de table Intégration directe avec la base de données : « Va vérifier la structure et les 5 premières lignes de la table users dans MySQL, et détermine si l'interface de requête utilisateur que j'ai écrite correspond. »
Workflows d'automatisation Ne peut générer que des extraits de code que vous devez copier et utiliser manuellement Exécution automatisée : « Aide-moi à écrire un script d'automatisation de navigateur et utilise MCP pour appeler Puppeteer afin de l'exécuter, en vérifiant la logique d'interaction de la page de connexion. »

En bref, MCP transforme Claude Code d'un assistant qui reçoit passivement des informations en un partenaire de collaboration qui obtient activement des informations et exécute des actions.


Utilisation de base de MCP dans Claude Code

Claude Code dispose de capacités complètes de gestion MCP intégrées, avec une seule commande principale :

claude mcp

Sous-commandes courantes :

Commande Description
claude mcp add Ajouter un serveur MCP
claude mcp list Afficher tous les serveurs configurés
claude mcp get <name> Afficher les détails d'un serveur spécifique
claude mcp remove <name> Supprimer un serveur
/mcp Afficher l'état / l'authentification dans Claude Code

Installation des serveurs MCP

Les serveurs MCP prennent en charge trois méthodes de connexion : HTTP/SSE/stdio. HTTP est recommandé (SSE est obsolète).

1. Serveur HTTP distant (recommandé)

Convient aux outils de services cloud ; c'est la méthode la plus universelle :

# 基础语法
claude mcp add --transport http <服务器名称> <服务器URL>

# 示例1:连接Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 示例2:带身份验证的HTTP服务器
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer 你的令牌"

2. Serveur SSE distant (obsolète)

Compatible uniquement avec les outils hérités ; préférez plutôt HTTP :

# 基础语法(仅兼容用)
claude mcp add --transport sse <服务器名称> <服务器URL>
# 示例:连接Asana
claude mcp add --transport sse asana https://mcp.asana.com/sse

3. Serveur stdio local

Convient aux outils qui nécessitent un accès au système local (comme les bases de données locales, les scripts personnalisés) :

# 基础语法(注意:--前是Claude参数,--后是服务器命令)
claude mcp add --transport stdio [--env 环境变量] <服务器名称> -- <启动命令>

# 示例:连接Airtable(需替换自己的API密钥)
claude mcp add --transport stdio --env AIRTABLE_API_KEY=你的密钥 airtable \
  -- npx -y airtable-mcp-server

Notes importantes :--transport/--envLes paramètres tels que ... doivent être placésdevant le nom du serveur,--Utilisé pour séparer les paramètres de Claude des commandes du serveur afin d'éviter les conflits de paramètres.

Gestion des serveurs MCP

Une fois la configuration terminée, vous pouvez gérer les serveurs avec les commandes suivantes :

# 列出所有已配置的服务器
claude mcp list

# 查看指定服务器详情(如github)
claude mcp get github

# 删除指定服务器
claude mcp remove github

# 在Claude Code中检查服务器状态
/mcp

Portée de configuration (contrôle de la visibilité des serveurs)

Vous pouvez spécifier la portée effective du serveur MCP pour l’adapter à des scénarios d’utilisation personnels/collectifs :

Portée Objectif Exemple de commande de configuration
local (par défaut) Disponible uniquement pour le projet actuel ; configuration privée (par ex., clés sensibles) claude mcp add --scope local ...
project Partagé par l’équipe (stocké dans .mcp.json, peut être commité dans le dépôt) claude mcp add --scope project ...
user Disponible pour tous les projets (configuration globale personnelle) claude mcp add --scope user ...

Priorité : local > project > user (pour les serveurs portant le même nom, la configuration locale remplace la configuration partagée)

Exemples pratiques

Exemple 1 : revue de code GitHub

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

Dans Claude Code :

> Review PR #456 and suggest improvements
> Show me all open PRs assigned to me

Exemple 2 : dépannage de production Sentry

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
> /mcp   # 完成 OAuth 登录
> What are the most common errors in the last 24 hours?

Exemple 3 : interrogation directe de PostgreSQL

claude mcp add --transport stdio db \
  -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"
> Show me the schema for the orders table
> Which users haven't purchased in 90 days?

Façons avancées d'utiliser MCP dans les conversations

1. Utilisation du@Référencement des ressources MCP

> Analyze @github:issue://123 and suggest a fix

Prend en charge la comparaison de plusieurs ressources :

> Compare @postgres:schema://users with @docs:file://user-model

2. Invites MCP comme commandes slash

MCP peut exposer des commandes :

/mcp__github__list_prs
/mcp__jira__create_issue "Login bug" high

Claude les exécutera exactement comme des commandes intégrées.


Considérations clés

  1. Authentification: Les serveurs MCP distants (tels que GitHub/Sentry) doivent s'exécuter dans Claude Code/mcppour terminer l'autorisation OAuth 2.0 ;
  2. Compatibilité Windows: si vous utilisez npx pour des serveurs stdio locaux, vous devez ajoutercmd /cun wrapper (tel que-- cmd /c npx -y 包名), sinon une erreur « Connection closed » sera signalée ;
  3. Risque lié aux tiers: lorsque vous utilisez des serveurs MCP non officiels, confirmez que la source est fiable afin d'éviter les risques d'injection de prompt/de sécurité ;
  4. Ordre des paramètres: lors de la configuration d'un serveur stdio,--les paramètres avant et après ne doivent pas être inversés, sinon l'exécution échouera.
Autres extensions