# Czym jest MCP?

**Model Context Protocol (MCP)** to otwarty standard Anthropic (2024), który
pozwala LLM wywoływać zewnętrzne narzędzia w ustrukturyzowany sposób. Zamiast
wklejać dokumentację API do promptu, rejestruje się narzędzia w serwerze MCP, a
LLM wywołuje je w razie potrzeby — jak function calling, ale ustandaryzowane i
niezależne od klienta.

## Serwer Synapse MCP

Synapse dostarcza oficjalny serwer MCP (`synapse-mcp-api` na npm), który
udostępnia **79 narzędzi** obejmujących wszystkie funkcje Synapse:

| Kategoria | Narzędzia | Liczba |
|----------|-------|-------|
| 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 |
| **Łącznie** | | **79+** |

## Jak to działa

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

1. Konfiguruje się klienta LLM (Claude Desktop, Cursor itp.) do używania serwera Synapse MCP
2. Klient uruchamia serwer MCP (przez `npx -y synapse-mcp-api@latest`)
3. Serwer MCP łączy się z API Synapse przy użyciu Mind Key
4. LLM widzi wszystkie 79 narzędzi jako natywne funkcje, które może wywoływać
5. Gdy LLM musi coś zapamiętać, wywołuje `memory_store` — serwer MCP tłumaczy to na `POST /memory` w Synapse

## Transporty

Serwer Synapse MCP obsługuje trzy transporty:

### stdio (lokalny, zalecany dla komputerów biurkowych)

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

### HTTP/SSE (zdalny, wielodostępny)

Podłączyć klienta MCP do:

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

### WebSocket (mobilny, duży ruch)

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

## Profile narzędzi (v1.4.0)

Aby zmniejszyć narzut tokenów dla mniejszych LLM, serwer MCP obsługuje trzy
profile narzędzi:

| Profil | Narzędzia | Tokeny | Najlepsze dla |
|---------|-------|--------|----------|
| `minimal` | 8 (kompozytowe dyspozytor) | około 500 | Self-hostowane LLM z kontekstem ≤8k |
| `standard` | 25 (nazwane) | około 2 500 | Średnie LLM (Claude Haiku, GPT-3.5) |
| `full` | 119 (wszystkie) | około 8 250 | Duże LLM (Claude Sonnet/Opus, GPT-4) — domyślnie |

Kontrola przez:

- Zmienna środowiskowa: `MCP_PROFILE=minimal|standard|full`
- Nagłówek: `Mcp-Tool-Profile: minimal|standard|full`

## Obsługiwani klienci

- [Claude Desktop](/docs/mcp/claude-desktop) — aplikacja biurkowa Anthropic
- [Claude Code](/docs/mcp/claude-code) — terminalowy agent kodowania
- [Cursor](/docs/mcp/cursor) — IDE oparte na AI
- [Continue.dev](/docs/mcp/continue) — open-source'owy asystent kodowania AI
- [Cline](/docs/mcp/claude-code) — rozszerzenie VS Code
- Dowolny klient zgodny z MCP

## Dlaczego używać MCP zamiast bezpośredniego API?

| Podejście | Zalety | Wady |
|----------|------|------|
| Bezpośrednie API | Proste, bez dodatkowej warstwy | LLM musi znać URL-e, nagłówki, autoryzację |
| MCP | LLM widzi natywne narzędzia, bez zapamiętywania URL-i | Dodatkowy proces serwera MCP |

Dla większości przypadków użycia agentów LLM MCP jest lepszym wyborem — LLM nie
musi pamiętać ścieżek API ani wzorców autoryzacji.

## Następne kroki

- [Konfiguracja Claude Desktop](/docs/mcp/claude-desktop) — konfiguracja w 2 minuty
- [Konfiguracja Claude Code](/docs/mcp/claude-code) — integracja z terminalem
- [Niestandardowy klient MCP](/docs/mcp/custom-client) — budowa własnego