MCP FAQ

Поширені запитання щодо 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 (локальний, рекомендовано для десктопа)
2. HTTP/SSE (віддалений, мультитенантний)
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 Keys.

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

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

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

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

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

• TypeScript: @modelcontextprotocol/sdk
• Python: mcp

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

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

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

Включіть:

• Версію MCP-сервера
• Назву та версію клієнта
• Операційну систему
• Відповідні логи
• Кроки відтворення

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

• Що таке MCP?
• Налаштування Claude Desktop
• Усунення несправностей MCP