# Що таке MCP?

**Model Context Protocol (MCP)** — це відкритий стандарт від Anthropic (2024),
який дозволяє LLM викликати зовнішні інструменти структурованим чином. Замість
вставлення API-документації у промпт, ви реєструєте інструменти на MCP-сервері,
а LLM викликає їх за потреби — як function calling, але стандартизовано та
незалежно від клієнта.

## MCP-сервер Synapse

Synapse постачається з офіційним MCP-сервером (`synapse-mcp-api` на npm), що викриває
**79 інструментів**, які покривають усі можливості Synapse:

| Категорія | Інструменти | Кількість |
|----------|-------|-------|
| Memory | recall, list, store, search, semantic-search, update, delete, bulk-delete, stats, unverified, contradictions, audit, related, by-tag, diff, expiring, health, sync, embed-batch, verify, unverify, mind-export | 22 |
| Chat | poll, reply, status, history, unread, send, upload | 7 |
| Scheduler | cron_list, cron_create, cron_delete, cron_toggle, var_list, var_get, var_set, var_delete | 8 |
| Tasks | task_list, task_get, task_create, task_update | 4 |
| Scripts | script_list, script_get, script_info, script_store, script_delete | 5 |
| Computers | computer_list, computer_get, install_code, screenshot, command_queue, command_status, commands_list, disable, delete | 9 |
| Push | vapid_public_key, subscribe, unsubscribe, test | 4 |
| User/Mind | register, login, minds_list, mind_create, mind_delete | 5 |
| Utility | time, calc, random | 3 |
| Visualization | graph, tags, compact | 3 |
| Sharing | share, list, revoke | 3 |
| Webhooks | register, list, get, update, delete | 5 |
| Browser | new, navigate, click, type, screenshot, close | 6 |
| **Усього** | | **79+** |

## Як це працює

```
┌──────────────────┐    MCP protocol    ┌──────────────────┐    HTTP    ┌──────────┐
│  LLM Client      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │
│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │
└──────────────────┘                    └──────────────────┘            └──────────┘
```

1. Ви налаштовуєте ваш LLM-клієнт (Claude Desktop, Cursor тощо) на використання MCP-сервера Synapse
2. Клієнт запускає MCP-сервер (через `npx -y synapse-mcp-api@latest`)
3. MCP-сервер підключається до Synapse API за допомогою вашого Mind Key
4. LLM бачить усі 79 інструментів як нативні функції, які він може викликати
5. Коли LLM має щось запам'ятати, він викликає `memory_store` — MCP-сервер транслює це у `POST /memory` на Synapse

## Транспорти

MCP-сервер Synapse підтримує три транспорти:

### stdio (локально, рекомендовано для десктопа)

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

### HTTP/SSE (віддалено, мультитенантно)

Підключіть ваш MCP-клієнт до:

```
URL: https://synapse-mcp.schaefer.zone/sse
Headers: Authorization: Bearer YOUR_MIND_KEY
```

### WebSocket (мобільні, великий обсяг)

```
URL: wss://synapse-mcp.schaefer.zone/ws?mind_key=YOUR_MIND_KEY
```

## Профілі інструментів (v1.4.0)

Щоб зменшити витрату токенів для менших LLM, MCP-сервер підтримує три
профілі інструментів:

| Профіль | Інструменти | Токени | Найкраще для |
|---------|-------|--------|----------|
| `minimal` | 8 (композитна диспетчеризація) | ~500 | Самохостовані LLM із контекстом ≤8k |
| `standard` | 25 (іменовані) | ~2,500 | Середні LLM (Claude Haiku, GPT-3.5) |
| `full` | 119 (усі) | ~8,250 | Великі LLM (Claude Sonnet/Opus, GPT-4) — за замовчуванням |

Керування через:

- Змінну середовища: `MCP_PROFILE=minimal|standard|full`
- Заголовок: `Mcp-Tool-Profile: minimal|standard|full`

## Підтримувані клієнти

- [Claude Desktop](/docs/mcp/claude-desktop) — десктоп-додаток Anthropic
- [Claude Code](/docs/mcp/claude-code) — термінальний агент програмування
- [Cursor](/docs/mcp/cursor) — IDE на основі AI
- [Continue.dev](/docs/mcp/continue) — AI-асистент програмування з відкритим кодом
- [Cline](/docs/mcp/claude-code) — розширення VS Code
- Будь-який MCP-сумісний клієнт

## Чому варто використовувати MCP замість прямого API?

| Підхід | Плюси | Мінуси |
|----------|------|------|
| Прямий API | Простий, без зайвого шару | LLM має знати URL, заголовки, автентифікацію |
| MCP | LLM бачить нативні інструменти, не треба запам'ятовувати URL | Додатковий процес MCP-сервера |

Для більшості сценаріїв використання LLM-агентів MCP — кращий вибір, адже LLM
не повинен запам'ятовувати API-шляхи чи шаблони автентифікації.

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

- [Налаштування Claude Desktop](/docs/mcp/claude-desktop) — конфігурація за 2 хвилини
- [Налаштування Claude Code](/docs/mcp/claude-code) — термінальна інтеграція
- [Власний MCP-клієнт](/docs/mcp/custom-client) — створіть свій