{"title":"FAQ MCP","slug":"mcp-faq","category":"faq","summary":"Częste pytania o integrację MCP — narzędzia, transporty, rozwiązywanie problemów.","audience":["human","llm"],"tags":["faq","mcp","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":442,"read_minutes":2,"lang":"pl","translated":true,"requested_lang":"pl","content_markdown":"\n# FAQ MCP\n\nCzęste pytania dotyczące serwera MCP Synapse.\n\n## Czym jest MCP?\n\nMCP (Model Context Protocol) to otwarty standard Anthropic dla integracji LLM z\nnarzędziami. Zamiast wklejać dokumentację API do promptów, rejestruje się\nnarzędzia w serwerze MCP, a LLM wywołuje je jako funkcje natywne.\n\nPatrz [Czym jest MCP?](/docs/mcp/what-is-mcp).\n\n## Ile narzędzi udostępnia Synapse MCP?\n\n**79 narzędzi** w 12 kategoriach: memory, chat, scheduler, tasks, scripts,\ncomputers, push, user, utility, visualization, sharing, webhooks, browser.\n\nPełna lista w sekcji [Czym jest MCP?](/docs/mcp/what-is-mcp).\n\n## Które klienty MCP są obsługiwane?\n\n- Claude Desktop (macOS, Windows)\n- Claude Code (terminal)\n- Cursor (IDE)\n- Continue.dev (VS Code, JetBrains)\n- Cline (VS Code)\n- Dowolny klient zgodny z MCP\n\nPrzykłady konfiguracji w sekcji [Konfiguracja Claude Desktop](/docs/mcp/claude-desktop).\n\n## Jakie transporty są obsługiwane?\n\n1. **stdio** (lokalny, zalecany dla komputerów biurkowych)\n2. **HTTP/SSE** (zdalny, wielodostępny)\n3. **WebSocket** (mobilny, duży ruch)\n\n## Jak skonfigurować Claude Desktop?\n\nEdytować `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"synapse\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"synapse-mcp-api@latest\"],\n \"env\": {\n \"SYNAPSE_MIND_KEY\": \"mk_YOUR_KEY\",\n \"SYNAPSE_URL\": \"https://synapse.schaefer.zone\"\n }\n }\n }\n}\n```\n\nPatrz [Konfiguracja Claude Desktop](/docs/mcp/claude-desktop).\n\n## Dlaczego narzędzia nie pojawiają się w Claude Desktop?\n\n1. **W pełni zrestartować Claude Desktop** (Cmd+Q na macOS)\n2. **Sprawdzić, czy plik konfiguracyjny jest poprawnym JSON-em**\n3. **Zweryfikować Node.js 18+** zainstalowany\n4. **Sprawdzić logi MCP**: `~/Library/Logs/Claude/mcp.log`\n\nPatrz [Rozwiązywanie problemów MCP](/docs/mcp/troubleshooting).\n\n## Jak używać innego umysłu?\n\nZmienić `SYNAPSE_MIND_KEY` w konfiguracji MCP i zrestartować klienta.\n\nDla wielu umysłów uruchomić wiele instancji serwera MCP z różnymi Mind Key.\n\n## Czy mogę ograniczyć, które narzędzia są udostępniane?\n\nTak, użyć **Profili narzędzi**:\n\n- `minimal`: 8 narzędzi złożonych (około 500 tokenów)\n- `standard`: 25 narzędzi (około 2 500 tokenów)\n- `full`: 119 narzędzi (około 8 250 tokenów, domyślnie)\n\nUstawić przez zmienną środowiskową `MCP_PROFILE` lub nagłówek `Mcp-Tool-Profile`.\n\n## Jak debugować problemy MCP?\n\n1. **Uruchomić serwer MCP ręcznie**: `npx -y synapse-mcp-api@latest`\n2. **Sprawdzić logi klienta** (różne w zależności od klienta)\n3. **Zweryfikować działanie Mind Key**: `curl -H \"Authorization: Bearer mk_...\" .../memory/recall`\n4. **Sprawdzić kondycję Synapse**: `curl https://synapse.schaefer.zone/health`\n\nPatrz [Rozwiązywanie problemów MCP](/docs/mcp/troubleshooting).\n\n## Czy serwer MCP jest darmowy?\n\nTak. Pakiet npm `synapse-mcp-api` jest open source. Hostowany serwer MCP pod\nadresem `synapse-mcp.schaefer.zone` jest darmowy do użytku publicznego.\n\n## Czy mogę hostować serwer MCP samodzielnie?\n\nTak:\n\n```bash\nnpm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api\n```\n\n## Czym MCP różni się od bezpośrednich wywołań API?\n\n| Aspekt | Bezpośrednie API | MCP |\n|--------|-----------|-----|\n| LLM musi znać | URL-e, nagłówki, autoryzację | Tylko nazwy narzędzi |\n| Obsługa autoryzacji | Ręczna | Automatyczna (zmienna środowiskowa) |\n| Wykrywanie narzędzi | Czytanie /endpoints | Automatyczne przez protokół MCP |\n| Obsługa błędów | Ręczna | Ustandaryzowana |\n| Najlepsze do | Niestandardowych integracji | Agentów LLM |\n\n## Czy mogę zbudować własnego klienta MCP?\n\nTak. Użyć oficjalnego SDK MCP:\n\n- TypeScript: `@modelcontextprotocol/sdk`\n- Python: `mcp`\n\nPatrz [Niestandardowy klient MCP](/docs/mcp/custom-client).\n\n## Jak zgłaszać błędy MCP?\n\nOtworzyć zgłoszenie: \n\nDołączyć:\n\n- Wersję serwera MCP\n- Nazwę i wersję klienta\n- System operacyjny\n- Istotne logi\n- Kroki reprodukcji\n\n## Następne kroki\n\n- [Czym jest MCP?](/docs/mcp/what-is-mcp)\n- [Konfiguracja Claude Desktop](/docs/mcp/claude-desktop)\n- [Rozwiązywanie problemów MCP](/docs/mcp/troubleshooting)\n","content_html":"

FAQ MCP

\n

Częste pytania dotyczące serwera MCP Synapse.

\n

Czym jest MCP?

\n

MCP (Model Context Protocol) to otwarty standard Anthropic dla integracji LLM z\nnarzędziami. Zamiast wklejać dokumentację API do promptów, rejestruje się\nnarzędzia w serwerze MCP, a LLM wywołuje je jako funkcje natywne.

\n

Patrz Czym jest MCP?.

\n

Ile narzędzi udostępnia Synapse MCP?

\n

79 narzędzi w 12 kategoriach: memory, chat, scheduler, tasks, scripts,\ncomputers, push, user, utility, visualization, sharing, webhooks, browser.

\n

Pełna lista w sekcji Czym jest MCP?.

\n

Które klienty MCP są obsługiwane?

\n\n

Przykłady konfiguracji w sekcji Konfiguracja Claude Desktop.

\n

Jakie transporty są obsługiwane?

\n
    \n
  1. stdio (lokalny, zalecany dla komputerów biurkowych)
    2. \n
  2. HTTP/SSE (zdalny, wielodostępny)
    3. \n
  3. WebSocket (mobilny, duży ruch)
    4. \n
\n

Jak skonfigurować Claude Desktop?

\n

Edytować claude_desktop_config.json:

\n
{\n  "mcpServers": {\n    "synapse": {\n      "command": "npx",\n      "args": ["-y", "synapse-mcp-api@latest"],\n      "env": {\n        "SYNAPSE_MIND_KEY": "mk_YOUR_KEY",\n        "SYNAPSE_URL": "https://synapse.schaefer.zone"\n      }\n    }\n  }\n}

Patrz Konfiguracja Claude Desktop.

\n

Dlaczego narzędzia nie pojawiają się w Claude Desktop?

\n
    \n
  1. W pełni zrestartować Claude Desktop (Cmd+Q na macOS)
    2. \n
  2. Sprawdzić, czy plik konfiguracyjny jest poprawnym JSON-em
    3. \n
  3. Zweryfikować Node.js 18+ zainstalowany
    4. \n
  4. Sprawdzić logi MCP: ~/Library/Logs/Claude/mcp.log
    5. \n
\n

Patrz Rozwiązywanie problemów MCP.

\n

Jak używać innego umysłu?

\n

Zmienić SYNAPSE_MIND_KEY w konfiguracji MCP i zrestartować klienta.

\n

Dla wielu umysłów uruchomić wiele instancji serwera MCP z różnymi Mind Key.

\n

Czy mogę ograniczyć, które narzędzia są udostępniane?

\n

Tak, użyć Profili narzędzi:

\n\n

Ustawić przez zmienną środowiskową MCP_PROFILE lub nagłówek Mcp-Tool-Profile.

\n

Jak debugować problemy MCP?

\n
    \n
  1. Uruchomić serwer MCP ręcznie: npx -y synapse-mcp-api@latest
    2. \n
  2. Sprawdzić logi klienta (różne w zależności od klienta)
    3. \n
  3. Zweryfikować działanie Mind Key: curl -H "Authorization: Bearer mk_..." .../memory/recall
    4. \n
  4. Sprawdzić kondycję Synapse: curl https://synapse.schaefer.zone/health
    5. \n
\n

Patrz Rozwiązywanie problemów MCP.

\n

Czy serwer MCP jest darmowy?

\n

Tak. Pakiet npm synapse-mcp-api jest open source. Hostowany serwer MCP pod\nadresem synapse-mcp.schaefer.zone jest darmowy do użytku publicznego.

\n

Czy mogę hostować serwer MCP samodzielnie?

\n

Tak:

\n
npm install -g synapse-mcp-api\nSYNAPSE_URL=https://your-synapse-instance.com \\\nSYNAPSE_MIND_KEY=mk_... \\\nsynapse-mcp-api

Czym MCP różni się od bezpośrednich wywołań API?

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
AspektBezpośrednie APIMCP
LLM musi znaćURL-e, nagłówki, autoryzacjęTylko nazwy narzędzi
Obsługa autoryzacjiRęcznaAutomatyczna (zmienna środowiskowa)
Wykrywanie narzędziCzytanie /endpointsAutomatyczne przez protokół MCP
Obsługa błędówRęcznaUstandaryzowana
Najlepsze doNiestandardowych integracjiAgentów LLM
\n

Czy mogę zbudować własnego klienta MCP?

\n

Tak. Użyć oficjalnego SDK MCP:

\n\n

Patrz Niestandardowy klient MCP.

\n

Jak zgłaszać błędy MCP?

\n

Otworzyć zgłoszenie: https://gitlab.com/schaefer-services/synapse-mcp/-/issues

\n

Dołączyć:

\n\n

Następne kroki

\n\n","urls":{"html":"/docs/faq/mcp-faq","text":"/docs/faq/mcp-faq?format=text","json":"/docs/faq/mcp-faq?format=json","llm":"/docs/faq/mcp-faq?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}