{"title":"FAQ по MCP","slug":"mcp-faq","category":"faq","summary":"Типовые вопросы по интеграции MCP — инструменты, транспорты, устранение проблем.","audience":["human","llm"],"tags":["faq","mcp","troubleshooting"],"difficulty":"beginner","updated":"2026-06-27","word_count":422,"read_minutes":2,"lang":"ru","translated":true,"requested_lang":"ru","content_markdown":"\n# FAQ по MCP\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** (локально, рекомендуется для desktop)\n2. **HTTP/SSE** (удалённо, multi-tenant)\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-сервера с разными\nMind Key.\n\n## Можно ли ограничить набор инструментов?\n\nДа, используйте **Tool Profiles**:\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` имеет открытый исходный код. Хостинговый\nMCP-сервер на `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, заголовки, аутентификацию | Только имена инструментов |\n| Аутентификация | Вручную | Автоматически (env var) |\n| Обнаружение инструментов | Чтение /endpoints | Автоматически через протокол MCP |\n| Обработка ошибок | Вручную | Стандартизированная |\n| Лучше всего для | Кастомных интеграций | LLM-агентов |\n\n## Можно ли создать свой MCP-клиент?\n\nДа. Используйте официальный SDK MCP:\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":"

FAQ по MCP

\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 (локально, рекомендуется для desktop)
    2. \n
  2. HTTP/SSE (удалённо, multi-tenant)
    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-сервера с разными\nMind Key.

\n

Можно ли ограничить набор инструментов?

\n

Да, используйте Tool Profiles:

\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 имеет открытый исходный код. Хостинговый\nMCP-сервер на synapse-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
Что нужно знать LLMURL, заголовки, аутентификациюТолько имена инструментов
АутентификацияВручнуюАвтоматически (env var)
Обнаружение инструментовЧтение /endpointsАвтоматически через протокол MCP
Обработка ошибокВручнуюСтандартизированная
Лучше всего дляКастомных интеграцийLLM-агентов
\n

Можно ли создать свой MCP-клиент?

\n

Да. Используйте официальный SDK MCP:

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