SkillProof tested Claude skills

Mcp Integration

Referencia para empaquetar servidores MCP (stdio/SSE/HTTP/ws) en plugins de Claude Code

Por tzachbon · tzachbon/smart-ralph

Probado · Funciona ★ 8.4/10

Mcp Integration — Referencia para empaquetar servidores MCP (stdio/SSE/HTTP/ws) en plugins de Claude Code

Qué hace

Una habilidad de documentación que guía la configuración de servidores del Protocolo de Contexto del Modelo (MCP) dentro de los plugins de Claude Code: elegir un transporte (stdio, SSE, HTTP, WebSocket), escribir entradas .mcp.json o plugin.json en línea, usar ${CLAUDE_PLUGIN_ROOT} y la sustitución de variables de entorno, y pre-permitir herramientas MCP. Se activa cuando el usuario solicita añadir un servidor MCP, configurar MCP en un plugin, usar .mcp.json o configurar el Protocolo de Contexto del Modelo.

Informe de la prueba

Obtuve SKILL.md y verifiqué 3 archivos incluidos a través de GitHub raw (references/server-types.md, references/authentication.md, examples/stdio-server.json — todos HTTP 200); los JSON de ejemplo son reales y válidos, usando ${CLAUDE_PLUGIN_ROOT}/${DATABASE_URL} correctamente. Para la salida, escribí dos archivos .mcp.json para la misma tarea (empaquetar un local Postgres stdio server + hosted Sentry SSE). La línea base (sin habilidad) codificó una ruta absoluta, incrustó credenciales de DB en el DSN (postgres://admin:pass123@...), codificó un token de Sentry y usó http://; siguiendo la habilidad se produjeron rutas ${CLAUDE_PLUGIN_ROOT}, la variable de entorno ${DATABASE_URL}, "type":"sse" basado en OAuth con no token, y https:// — cuatro correcciones concretas de seguridad/portabilidad. Observado pero no penalizado: no pude verificar contra live Claude Code si plugin .mcp.json omite el top-level "mcpServers" wrapper (los ejemplos de la habilidad sí lo hacen) o el exact mcp__plugin_... tool-naming format.

Probado el: 2026-07-21 · Claude Code 2.x (agent harness)

Instalación

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.

Comandos y prompts de ejemplo

  • /mcp-integrationReferencia para empaquetar servidores MCP (stdio/SSE/HTTP/ws) en plugins de Claude Code

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

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

Informe completo →