Mcp Integration

Referencja do łączenia serwerów MCP (stdio/SSE/HTTP/ws) w wtyczki Claude Code

Autor: tzachbon · tzachbon/smart-ralph

Testowano · Działa ★ 8.4/10

Mcp Integration — Referencja do łączenia serwerów MCP (stdio/SSE/HTTP/ws) w wtyczki Claude Code

Co robi ten skill

Umiejętność dokumentacyjna, która prowadzi konfigurację serwerów Model Context Protocol wewnątrz wtyczek Claude Code: wybór transportu (stdio, SSE, HTTP, WebSocket), pisanie wpisów .mcp.json lub inline plugin.json, używanie ${CLAUDE_PLUGIN_ROOT} i podstawiania zmiennych środowiskowych oraz wstępne zezwalanie na narzędzia MCP. Uruchamia się, gdy użytkownik prosi o dodanie serwera MCP, skonfigurowanie MCP w wtyczce, użycie .mcp.json lub skonfigurowanie Model Context Protocol.

Raport z testu

Pobrano SKILL.md i sprawdzono 3 dołączone pliki za pośrednictwem raw GitHub (references/server-types.md, references/authentication.md, examples/stdio-server.json — wszystkie HTTP 200); przykładowe pliki JSON są prawdziwe i prawidłowe, używając ${CLAUDE_PLUGIN_ROOT}/${DATABASE_URL} poprawnie. Dla OUTPUT napisałem dwa pliki .mcp.json dla tego samego zadania (pakiet lokalnego serwera Postgres stdio + hostowany Sentry SSE). Punkt odniesienia (bez umiejętności) miał zakodowaną na stałe ścieżkę absolutną, osadzone dane uwierzytelniające DB w DSN (postgres://admin:pass123@...), zakodowany na stałe token Sentry i używał http://; po zastosowaniu umiejętności uzyskano ścieżki ${CLAUDE_PLUGIN_ROOT}, zmienną środowiskową ${DATABASE_URL}, "type":"sse" oparty na OAuth bez tokena i https:// — cztery konkretne poprawki bezpieczeństwa/przenośności. Zauważono, ale nie ukarano: nie mogłem zweryfikować w działającym Claude Code, czy plugin .mcp.json pomija opakowanie najwyższego poziomu "mcpServers" (przykłady umiejętności to robią) lub dokładny format nazewnictwa narzędzi mcp__plugin_....

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

Instalacja

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.

Komendy i przykładowe prompty

  • /mcp-integrationReferencja do łączenia serwerów MCP (stdio/SSE/HTTP/ws) w wtyczki Claude Code

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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