Mcp Integration

Référence pour l'intégration de serveurs MCP (stdio/SSE/HTTP/ws) dans les plugins Claude Code

par tzachbon · tzachbon/smart-ralph

Testé · Fonctionne ★ 8.4/10

Mcp Integration — Référence pour l'intégration de serveurs MCP (stdio/SSE/HTTP/ws) dans les plugins Claude Code

Ce que fait

Compétence de documentation qui guide la configuration des serveurs Model Context Protocol à l'intérieur des plugins Claude Code : choix d'un transport (stdio, SSE, HTTP, WebSocket), écriture d'entrées .mcp.json ou plugin.json en ligne, utilisation de ${CLAUDE_PLUGIN_ROOT} et de la substitution de variables d'environnement, et pré-autorisation des outils MCP. Se déclenche lorsque l'utilisateur demande d'ajouter un serveur MCP, de configurer MCP dans un plugin, d'utiliser .mcp.json, ou de configurer le Model Context Protocol.

Rapport de test

SKILL.md récupéré et 3 fichiers groupés vérifiés via raw GitHub (references/server-types.md, references/authentication.md, examples/stdio-server.json — tous HTTP 200) ; les JSON d'exemple sont réels et valides, utilisant ${CLAUDE_PLUGIN_ROOT}/${DATABASE_URL} correctement. Pour la sortie, j'ai écrit deux fichiers .mcp.json pour la même tâche (regrouper un serveur stdio Postgres local + un Sentry SSE hébergé). La base (sans compétence) a codé en dur un chemin absolu, intégré les identifiants de base de données dans le DSN (postgres://admin:pass123@...), codé en dur un jeton Sentry, et utilisé http:// ; en suivant la compétence, cela a produit des chemins ${CLAUDE_PLUGIN_ROOT}, la variable d'environnement ${DATABASE_URL}, un "type":"sse" basé sur OAuth sans jeton, et https:// — quatre corrections concrètes de sécurité/portabilité. Noté mais non pénalisé : je n'ai pas pu vérifier sur Claude Code en direct si plugin .mcp.json ommet l'enveloppe de niveau supérieur "mcpServers" (les exemples de la compétence le font) ou le format exact de nommage d'outil mcp__plugin_...

Testé le: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/tzachbon/smart-ralph.git /tmp/mcp-integration-src
mkdir -p ~/.claude/skills
cp -R "/tmp/mcp-integration-src/.agents/skills/MCP Integration" ~/.claude/skills/mcp-integration
# SKILL.md lands at ~/.claude/skills/mcp-integration/SKILL.md
# Ships references/ (server-types, authentication, tool-usage) and examples/ (stdio/sse/http json).
# Pure documentation skill — no deps, no API keys, nothing to run. It shapes how you write .mcp.json configs.

Commandes et exemples de prompts

  • /mcp-integrationRéférence pour l'intégration de serveurs MCP (stdio/SSE/HTTP/ws) dans les plugins Claude Code

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

  • Add an MCP server to this plugin
  • Configure .mcp.json for an SSE connection
  • Connect an external service via Model Context Protocol