Integrare MCP în plugin-urile Claude Code

Ce face

Skill-ul mcp-integration îți permite să conectezi servere Model Context Protocol la plugin-urile Claude Code. Practic, expui tool-uri externe (baze de date, API-uri, sisteme de fișiere) ca și cum ar fi funcții native în Claude. Poți folosi fie un fișier dedicat .mcp.json la rădăcina plugin-ului, fie secțiunea mcpServers direct în plugin.json. Suportă trei tipuri principale de servere: stdio (proces local), SSE (conexiune la cloud cu OAuth) și HTTP.

Când îmi folosește

Îl folosești când vrei să adaugi rapid acces la servicii externe fără să scrii wrapper-e custom. E util pentru plugin-uri care au nevoie de 10+ tool-uri dintr-un singur serviciu, pentru fluxuri cu autentificare OAuth sau când vrei să bundle-uiesti serverul MCP odată cu plugin-ul. Dacă utilizatorul menționează „add MCP server”, „use .mcp.json”, „${CLAUDE_PLUGIN_ROOT} with MCP” sau tipuri de servere, skill-ul se activează automat.

Cum îl invoc / declanșez

Skill-ul pornește când cererea conține una din expresiile canonice: „add MCP server”, „integrate MCP”, „configure MCP in plugin”, „set up Model Context Protocol” sau „connect external service”. Nu există comandă manuală; se declanșează din contextul conversației. Pentru detalii exacte de invocare verifică doctrina pentru detalii exacte.

Exemplu practic

Creezi .mcp.json la rădăcina plugin-ului:

{
  "database-tools": {
    "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
    "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
    "env": {
      "DB_URL": "${DB_URL}"
    }
  }
}

Sau, pentru un singur server, adaugi direct în plugin.json cheia mcpServers. Claude Code va porni procesul stdio sau va iniția conexiunea SSE la prima utilizare.

Output / unde aterizează

Configurația este citită la pornirea Claude Code. Serverele stdio sunt pornite ca procese copil și comunică prin stdin/stdout. Serverele SSE declanșează prompt-ul de OAuth la prima conectare, iar token-urile sunt stocate de Claude Code. Tool-urile devin disponibile imediat în lista de funcții a plugin-ului.

Limite / gotchas

Metoda inline din plugin.json e practică doar pentru un singur server; pentru mai multe, .mcp.json e recomandat. Serverele stdio sunt terminate automat la ieșirea din Claude Code. Pentru SSE, autentificarea OAuth se face o singură dată, dar necesită conexiune la internet. Nu uita să folosești ${CLAUDE_PLUGIN_ROOT} pentru căi relative – altfel plugin-ul nu va găsi serverele la instalare. Vezi All guides pentru alte skill-uri daily.