# Vad är MCP?

**Model Context Protocol (MCP)** är en öppen standard av Anthropic (2024) som
låter LLM:er anropa externa verktyg på ett strukturerat sätt. Istället för att
klistra in API-dokumentation i prompten registrerar ni verktyg hos MCP-servern,
och LLM:en anropar dem vid behov — som funktionsanrop, men standardiserat och
klientoberoende.

## Synapse MCP-server

Synapse levererar en officiell MCP-server (`synapse-mcp-api` på npm) som
exponerar **79 verktyg** som täcker alla Synapse-funktioner:

| Kategori | Verktyg | Antal |
|----------|-------|-------|
| 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 |
| **Totalt** | | **79+** |

## Hur det fungerar

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

1. Ni konfigurerar er LLM-klient (Claude Desktop, Cursor etc.) för att använda Synapse MCP-server
2. Klienten startar MCP-servern (via `npx -y synapse-mcp-api@latest`)
3. MCP-servern ansluter till Synapse API med er Mind Key
4. LLM:en ser alla 79 verktyg som inbyggda funktioner den kan anropa
5. När LLM:en behöver minna något anropar den `memory_store` — MCP-servern översätter detta till `POST /memory` på Synapse

## Transporter

Synapse MCP-server stöder tre transporter:

### stdio (lokal, rekommenderas för skrivbord)

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

### HTTP/SSE (fjärr, multitenant)

Anslut er MCP-klient till:

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

### WebSocket (mobil, hög volym)

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

## Verktygsprofiler (v1.4.0)

För att minska token-overhead för mindre LLM:er stöder MCP-servern tre
verktygsprofiler:

| Profil | Verktyg | Tokens | Bäst för |
|---------|-------|--------|----------|
| `minimal` | 8 (sammansatt dispatch) | ~500 | Egenvärd LLM:er med ≤8k kontext |
| `standard` | 25 (namngivna) | ~2 500 | Medelstora LLM:er (Claude Haiku, GPT-3.5) |
| `full` | 119 (alla) | ~8 250 | Stora LLM:er (Claude Sonnet/Opus, GPT-4) — standard |

Styr via:

- Miljövariabel: `MCP_PROFILE=minimal|standard|full`
- Header: `Mcp-Tool-Profile: minimal|standard|full`

## Klienter som stöds

- [Claude Desktop](/docs/mcp/claude-desktop) — Anthropics skrivbordsapp
- [Claude Code](/docs/mcp/claude-code) — terminalbaserad kodagent
- [Cursor](/docs/mcp/cursor) — AI-driven IDE
- [Continue.dev](/docs/mcp/continue) — öppen källkod AI-kodningsassistent
- [Cline](/docs/mcp/claude-code) — VS Code-tillägg
- Valfri MCP-kompatibel klient

## Varför använda MCP istället för direkt API?

| Ansats | Fördelar | Nackdelar |
|----------|------|------|
| Direkt API | Enkelt, inget extra lager | LLM behöver veta URL:er, headers, auth |
| MCP | LLM ser inbyggda verktyg, ingen URL-memorering | Extra MCP-serverprocess |

För de flesta LLM-agent-användningsområden är MCP det bättre valet — LLM:en
behöver inte minnas API-sökvägar eller auth-mönster.

## Nästa steg

- [Claude Desktop-konfiguration](/docs/mcp/claude-desktop) — 2 minuters konfiguration
- [Claude Code-konfiguration](/docs/mcp/claude-code) — terminalintegration
- [Anpassad MCP-klient](/docs/mcp/custom-client) — bygg er egen