SkillProof tested Claude skills

Mcp Integration

Riferimento per l'integrazione di server MCP (stdio/SSE/HTTP/ws) nei plugin Claude Code

di tzachbon · tzachbon/smart-ralph

Promosso ★ 8.4/10

Mcp Integration — Riferimento per l'integrazione di server MCP (stdio/SSE/HTTP/ws) nei plugin Claude Code

Cosa fa

Una skill di documentazione che guida la configurazione di server Model Context Protocol all'interno dei plugin Claude Code: scelta di un trasporto (stdio, SSE, HTTP, WebSocket), scrittura di voci .mcp.json o inline plugin.json, utilizzo di ${CLAUDE_PLUGIN_ROOT} e sostituzione di variabili d'ambiente, e pre-autorizzazione degli strumenti MCP. Si attiva quando l'utente chiede di aggiungere un server MCP, configurare MCP in un plugin, usare .mcp.json, o impostare Model Context Protocol.

Rapporto di test

SKILL.md recuperato e 3 file inclusi controllati a campione tramite raw GitHub (references/server-types.md, references/authentication.md, examples/stdio-server.json — tutti HTTP 200); i JSON di esempio sono reali e validi, usando ${CLAUDE_PLUGIN_ROOT}/${DATABASE_URL} correttamente. Per l'output ho scritto due file .mcp.json per lo stesso compito (integrare un server Postgres stdio locale + Sentry SSE ospitato). La baseline (nessuna skill) aveva un percorso assoluto hardcoded, credenziali DB incorporate nel DSN (postgres://admin:pass123@...), un token Sentry hardcoded e usava http://; seguendo la skill sono stati prodotti percorsi ${CLAUDE_PLUGIN_ROOT}, variabile d'ambiente ${DATABASE_URL}, "type":"sse" basato su OAuth senza token, e https:// — quattro concrete correzioni di sicurezza/portabilità. Notato ma non penalizzato: non ho potuto verificare contro Claude Code live se plugin .mcp.json omette il wrapper di primo livello "mcpServers" (gli esempi della skill lo fanno) o l'esatto formato di denominazione degli strumenti mcp__plugin_....

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

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.

Comandi e prompt di esempio

  • /mcp-integrationRiferimento per l'integrazione di server MCP (stdio/SSE/HTTP/ws) nei plugin Claude Code

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →