FAQ по MCP

Типовые вопросы по MCP-серверу Synapse.

Что такое MCP?

MCP (Model Context Protocol) — открытый стандарт от Anthropic для интеграции LLM и инструментов. Вместо того чтобы вставлять документацию API в промпты, вы регистрируете инструменты на MCP-сервере, и LLM вызывает их как нативные функции.

См. Что такое MCP?.

Сколько инструментов предоставляет Synapse MCP?

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

Полный список см. в Что такое MCP?.

Какие MCP-клиенты поддерживаются?

• Claude Desktop (macOS, Windows)
• Claude Code (терминал)
• Cursor (IDE)
• Continue.dev (VS Code, JetBrains)
• Cline (VS Code)
• Любой MCP-совместимый клиент

Примеры конфигурации см. в Настройка Claude Desktop.

Какие транспорты поддерживаются?

1. stdio (локально, рекомендуется для desktop)
2. HTTP/SSE (удалённо, multi-tenant)
3. WebSocket (мобильные устройства, высокий объём)

Как настроить Claude Desktop?

Отредактируйте claude_desktop_config.json:

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

См. Настройка Claude Desktop.

Почему инструменты не появляются в Claude Desktop?

1. Полностью перезапустите Claude Desktop (Cmd+Q на macOS)
2. Проверьте, что файл конфигурации — валидный JSON
3. Убедитесь, что установлен Node.js 18+
4. Проверьте логи MCP: ~/Library/Logs/Claude/mcp.log

См. Устранение проблем MCP.

Как использовать другой mind?

Измените SYNAPSE_MIND_KEY в конфигурации MCP и перезапустите клиент.

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

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

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

• minimal: 8 составных инструментов (~500 токенов)
• standard: 25 инструментов (~2 500 токенов)
• full: 119 инструментов (~8 250 токенов, по умолчанию)

Задаётся через переменную окружения MCP_PROFILE или заголовок Mcp-Tool-Profile.

Как отлаживать проблемы MCP?

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

См. Устранение проблем MCP.

MCP-сервер бесплатен?

Да. npm-пакет synapse-mcp-api имеет открытый исходный код. Хостинговый MCP-сервер на synapse-mcp.schaefer.zone бесплатен для публичного использования.

Можно ли хостить MCP-сервер самому?

Да:

npm install -g synapse-mcp-api
SYNAPSE_URL=https://your-synapse-instance.com \
SYNAPSE_MIND_KEY=mk_... \
synapse-mcp-api

Чем MCP отличается от прямых вызовов API?

Аспект	Прямой API	MCP
Что нужно знать LLM	URL, заголовки, аутентификацию	Только имена инструментов
Аутентификация	Вручную	Автоматически (env var)
Обнаружение инструментов	Чтение /endpoints	Автоматически через протокол MCP
Обработка ошибок	Вручную	Стандартизированная
Лучше всего для	Кастомных интеграций	LLM-агентов

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

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

• TypeScript: @modelcontextprotocol/sdk
• Python: mcp

См. Кастомный MCP-клиент.

Как сообщить об ошибках MCP?

Создайте issue: https://gitlab.com/schaefer-services/synapse-mcp/-/issues

Включите:

• Версию MCP-сервера
• Имя и версию клиента
• Операционную систему
• Соответствующие логи
• Шаги для воспроизведения

Следующие шаги

• Что такое MCP?
• Настройка Claude Desktop
• Устранение проблем MCP