# MCP FAQ

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

## Що таке MCP?

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

Дивіться [Що таке MCP?](/docs/mcp/what-is-mcp).

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

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

Дивіться повний список у [Що таке MCP?](/docs/mcp/what-is-mcp).

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

- Claude Desktop (macOS, Windows)
- Claude Code (термінал)
- Cursor (IDE)
- Continue.dev (VS Code, JetBrains)
- Cline (VS Code)
- Будь-який MCP-сумісний клієнт

Дивіться [Налаштування Claude Desktop](/docs/mcp/claude-desktop) для прикладів конфігурації.

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

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

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

Відредагуйте `claude_desktop_config.json`:

```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](/docs/mcp/claude-desktop).

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

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

Дивіться [Усунення несправностей MCP](/docs/mcp/troubleshooting).

## Як використовувати інший 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](/docs/mcp/troubleshooting).

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

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

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

Так:

```bash
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-клієнт](/docs/mcp/custom-client).

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

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

Включіть:

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

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

- [Що таке MCP?](/docs/mcp/what-is-mcp)
- [Налаштування Claude Desktop](/docs/mcp/claude-desktop)
- [Усунення несправностей MCP](/docs/mcp/troubleshooting)