mcp-integration

Skill do konfiguracji MCP (Model Context Protocol) w pluginach Claude Code. Umożliwia połączenie zewnętrznych serwisów — baz danych, API, systemów plików — i udostępnienie ich jako narzędzi w edytorze. Obsługuje różne typy serwerów MCP (stdio, SSE, HTTP, WebSocket), złożone przepływy uwierzytelniania OAuth oraz automatyczne bundlowanie serwerów z pluginem. Wybieraj między konfiguracją w dedykowanym pliku .mcp.json (dla wielu serwerów) a wbudowanym polem mcpServers w plugin.json (dla prostych przypadków).

1. Zdecyduj, czy użyjesz dedykowanego pliku .mcp.json (dla wielu serwerów MCP) czy wbudowanego pola mcpServers w plugin.json (dla pojedynczego serwera). Plik .mcp.json umieszczony w katalogu głównym pluginu zapewnia lepszą separację konfiguracji i łatwość utrzymania.

2. Jeśli wybierasz .mcp.json, utwórz plik w formacie JSON z kluczami dla każdego serwera MCP. Dla każdego serwera określ command (ścieżkę do pliku wykonywalnego), args (argumenty uruchomienia) i env (zmienne środowiskowe). Możesz używać zmiennych takich jak ${CLAUDE_PLUGIN_ROOT} do dynamicznego wskazania katalogu pluginu.

3. Jeśli wybierasz konfigurację wbudowaną, dodaj pole mcpServers do pliku plugin.json zawierające obiekty z command, args i innymi parametrami dla każdego serwera.

4. Wybierz typ serwera MCP odpowiadający Twojemu przypadkowi użycia: stdio dla lokalnych procesów i niestandardowych serwerów, SSE dla komunikacji opartej na zdarzeniach, HTTP dla interfejsów REST, lub WebSocket dla połączeń dwukierunkowych.

5. Skonfiguruj uwierzytelnianie dla zewnętrznych usług — jeśli serwer MCP wymaga OAuth lub innych złożonych przepływów autoryzacji, przekaż niezbędne dane przez zmienne środowiskowe w konfiguracji.

6. Przetestuj integrację, uruchamiając plugin w Claude Code. Serwer MCP powinien się uruchomić automatycznie i udostępnić narzędzia z podłączonej usługi jako dostępne akcje w edytorze.