{"title":"MCP FAQ","slug":"mcp-faq","category":"faq","summary":"Поширені запитання про інтеграцію MCP — інструменти, транспорти, усунення несправностей.","audience":["human","llm"],"tags":["faq","mcp","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":414,"read_minutes":2,"lang":"uk","translated":true,"requested_lang":"uk","content_markdown":"\n# MCP FAQ\n\nПоширені запитання щодо MCP-сервера Synapse.\n\n## Що таке MCP?\n\nMCP (Model Context Protocol) — відкритий стандарт від Anthropic для інтеграції\nLLM з інструментами. Замість вставки документації API в промпти, ви реєструєте\nінструменти на MCP-сервері, і LLM викликає їх як нативні функції.\n\nДивіться [Що таке MCP?](/docs/mcp/what-is-mcp).\n\n## Скільки інструментів надає Synapse MCP?\n\n**79 інструментів** у 12 категоріях: memory, chat, scheduler, tasks, scripts,\ncomputers, push, user, utility, visualization, sharing, webhooks, browser.\n\nДивіться повний список у [Що таке MCP?](/docs/mcp/what-is-mcp).\n\n## Які MCP-клієнти підтримуються?\n\n- Claude Desktop (macOS, Windows)\n- Claude Code (термінал)\n- Cursor (IDE)\n- Continue.dev (VS Code, JetBrains)\n- Cline (VS Code)\n- Будь-який MCP-сумісний клієнт\n\nДивіться [Налаштування Claude Desktop](/docs/mcp/claude-desktop) для прикладів конфігурації.\n\n## Які транспорти підтримуються?\n\n1. **stdio** (локальний, рекомендовано для десктопа)\n2. **HTTP/SSE** (віддалений, мультитенантний)\n3. **WebSocket** (мобільний, високий обсяг)\n\n## Як налаштувати Claude Desktop?\n\nВідредагуйте `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\nДивіться [Налаштування Claude Desktop](/docs/mcp/claude-desktop).\n\n## Чому інструменти не з'являються в Claude Desktop?\n\n1. **Повністю перезапустіть Claude Desktop** (Cmd+Q на macOS)\n2. **Перевірте, що файл конфігурації є коректним JSON**\n3. **Перевірте Node.js 18+** встановлено\n4. **Перевірте MCP-логи**: `~/Library/Logs/Claude/mcp.log`\n\nДивіться [Усунення несправностей MCP](/docs/mcp/troubleshooting).\n\n## Як використовувати інший mind?\n\nЗмініть `SYNAPSE_MIND_KEY` у вашій MCP-конфігурації та перезапустіть клієнт.\n\nДля кількох mind-ів запустіть кілька екземплярів MCP-сервера з різними Mind Keys.\n\n## Чи можна обмежити, які інструменти викриваються?\n\nТак, використовуйте **Профілі інструментів**:\n\n- `minimal`: 8 композитних інструментів (~500 токенів)\n- `standard`: 25 інструментів (~2 500 токенів)\n- `full`: 119 інструментів (~8 250 токенів, за замовчуванням)\n\nВстановлюється через змінну середовища `MCP_PROFILE` або заголовок `Mcp-Tool-Profile`.\n\n## Як налагодити проблеми MCP?\n\n1. **Запустіть MCP-сервер вручну**: `npx -y synapse-mcp-api@latest`\n2. **Перевірте логи клієнта** (залежить від клієнта)\n3. **Перевірте, що Mind Key працює**: `curl -H \"Authorization: Bearer mk_...\" .../memory/recall`\n4. **Перевірте стан Synapse**: `curl https://synapse.schaefer.zone/health`\n\nДивіться [Усунення несправностей MCP](/docs/mcp/troubleshooting).\n\n## MCP-сервер безкоштовний?\n\nТак. npm-пакет `synapse-mcp-api` є open source. Хостований MCP-сервер на\n`synapse-mcp.schaefer.zone` безкоштовний для публічного використання.\n\n## Чи можу я самостійно розгорнути MCP-сервер?\n\nТак:\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## Чим MCP відрізняється від прямих API-викликів?\n\n| Аспект | Прямий API | MCP |\n|--------|-----------|-----|\n| LLM повинен знати | URL, заголовки, auth | Лише назви інструментів |\n| Обробка auth | Вручну | Автоматично (змінна середовища) |\n| Виявлення інструментів | Читання /endpoints | Автоматично через MCP-протокол |\n| Обробка помилок | Вручну | Стандартизовано |\n| Найкраще для | Власних інтеграцій | LLM-агентів |\n\n## Чи можу я створити власний MCP-клієнт?\n\nТак. Використовуйте офіційний MCP SDK:\n\n- TypeScript: `@modelcontextprotocol/sdk`\n- Python: `mcp`\n\nДивіться [Власний MCP-клієнт](/docs/mcp/custom-client).\n\n## Як повідомити про баг MCP?\n\nВідкрийте issue: \n\nВключіть:\n\n- Версію MCP-сервера\n- Назву та версію клієнта\n- Операційну систему\n- Відповідні логи\n- Кроки відтворення\n\n## Наступні кроки\n\n- [Що таке MCP?](/docs/mcp/what-is-mcp)\n- [Налаштування Claude Desktop](/docs/mcp/claude-desktop)\n- [Усунення несправностей MCP](/docs/mcp/troubleshooting)\n","content_html":"

MCP FAQ

\n

Поширені запитання щодо MCP-сервера Synapse.

\n

Що таке MCP?

\n

MCP (Model Context Protocol) — відкритий стандарт від Anthropic для інтеграції\nLLM з інструментами. Замість вставки документації API в промпти, ви реєструєте\nінструменти на MCP-сервері, і LLM викликає їх як нативні функції.

\n

Дивіться Що таке MCP?.

\n

Скільки інструментів надає Synapse MCP?

\n

79 інструментів у 12 категоріях: memory, chat, scheduler, tasks, scripts,\ncomputers, push, user, utility, visualization, sharing, webhooks, browser.

\n

Дивіться повний список у Що таке MCP?.

\n

Які MCP-клієнти підтримуються?

\n\n

Дивіться Налаштування Claude Desktop для прикладів конфігурації.

\n

Які транспорти підтримуються?

\n
    \n
  1. stdio (локальний, рекомендовано для десктопа)
    2. \n
  2. HTTP/SSE (віддалений, мультитенантний)
    3. \n
  3. WebSocket (мобільний, високий обсяг)
    4. \n
\n

Як налаштувати Claude Desktop?

\n

Відредагуйте 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}

Дивіться Налаштування Claude Desktop.

\n

Чому інструменти не з'являються в Claude Desktop?

\n
    \n
  1. Повністю перезапустіть Claude Desktop (Cmd+Q на macOS)
    2. \n
  2. Перевірте, що файл конфігурації є коректним JSON
    3. \n
  3. Перевірте Node.js 18+ встановлено
    4. \n
  4. Перевірте MCP-логи: ~/Library/Logs/Claude/mcp.log
    5. \n
\n

Дивіться Усунення несправностей MCP.

\n

Як використовувати інший mind?

\n

Змініть SYNAPSE_MIND_KEY у вашій MCP-конфігурації та перезапустіть клієнт.

\n

Для кількох mind-ів запустіть кілька екземплярів MCP-сервера з різними Mind Keys.

\n

Чи можна обмежити, які інструменти викриваються?

\n

Так, використовуйте Профілі інструментів:

\n\n

Встановлюється через змінну середовища MCP_PROFILE або заголовок Mcp-Tool-Profile.

\n

Як налагодити проблеми MCP?

\n
    \n
  1. Запустіть MCP-сервер вручну: npx -y synapse-mcp-api@latest
    2. \n
  2. Перевірте логи клієнта (залежить від клієнта)
    3. \n
  3. Перевірте, що Mind Key працює: curl -H "Authorization: Bearer mk_..." .../memory/recall
    4. \n
  4. Перевірте стан Synapse: curl https://synapse.schaefer.zone/health
    5. \n
\n

Дивіться Усунення несправностей MCP.

\n

MCP-сервер безкоштовний?

\n

Так. npm-пакет synapse-mcp-api є open source. Хостований MCP-сервер на\nsynapse-mcp.schaefer.zone безкоштовний для публічного використання.

\n

Чи можу я самостійно розгорнути MCP-сервер?

\n

Так:

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

Чим MCP відрізняється від прямих 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
АспектПрямий APIMCP
LLM повинен знатиURL, заголовки, authЛише назви інструментів
Обробка authВручнуАвтоматично (змінна середовища)
Виявлення інструментівЧитання /endpointsАвтоматично через MCP-протокол
Обробка помилокВручнуСтандартизовано
Найкраще дляВласних інтеграційLLM-агентів
\n

Чи можу я створити власний MCP-клієнт?

\n

Так. Використовуйте офіційний MCP SDK:

\n\n

Дивіться Власний MCP-клієнт.

\n

Як повідомити про баг MCP?

\n

Відкрийте issue: https://gitlab.com/schaefer-services/synapse-mcp/-/issues

\n

Включіть:

\n\n

Наступні кроки

\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"]}