# MCP 是什么？

**Model Context Protocol (MCP)** 是 Anthropic 于 2024 年推出的开放标准，让 LLM 以结构化方式调用外部工具。你不需要把 API 文档粘到 prompt 里，而是把工具注册到 MCP Server，LLM 按需调用 — 类似 function calling，但标准化且与客户端无关。

## Synapse MCP Server

Synapse 提供官方 MCP Server（npm 上的 `synapse-mcp-api`），暴露覆盖所有 Synapse 功能的 **79 个工具**：

| 分类 | 工具 | 数量 |
|----------|-------|-------|
| 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 协议     ┌──────────────────┐    HTTP    ┌──────────┐
│  LLM 客户端      │ ◀─────────────────▶│  Synapse MCP     │ ─────────▶ │ Synapse  │
│ (Claude/Cursor)  │   (stdio/SSE/WS)   │  Server          │            │ API      │
└──────────────────┘                    └──────────────────┘            └──────────┘
```

1. 你把 LLM 客户端（Claude Desktop、Cursor 等）配置为使用 Synapse MCP Server
2. 客户端启动 MCP Server（通过 `npx -y synapse-mcp-api@latest`）
3. MCP Server 用你的 Mind Key 连接到 Synapse API
4. LLM 看到全部 79 个工具，作为可调用的原生函数
5. 当 LLM 需要记住某事时，它调用 `memory_store` — MCP Server 把它翻译为 Synapse 上的 `POST /memory`

## 传输方式

Synapse MCP Server 支持三种传输方式：

### 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 的 token 开销，MCP Server 支持三种工具配置文件：

| 配置文件 | 工具 | Tokens | 适合 |
|---------|-------|--------|----------|
| `minimal` | 8（组合分发） | ~500 | 上下文 ≤8k 的自托管 LLM |
| `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) — 终端编码 Agent
- [Cursor](/docs/mcp/cursor) — AI 驱动的 IDE
- [Continue.dev](/docs/mcp/continue) — 开源 AI 编码助手
- [Cline](/docs/mcp/claude-code) — VS Code 扩展
- 任何兼容 MCP 的客户端

## 为什么用 MCP 而非直接 API？

| 方式 | 优点 | 缺点 |
|----------|------|------|
| 直接 API | 简单，无额外层 | LLM 需要知道 URL、请求头、认证 |
| MCP | LLM 看到原生工具，无需记 URL | 多一个 MCP Server 进程 |

对于大多数 LLM Agent 用例，MCP 是更好的选择 — LLM 不需要记 API 路径或认证模式。

## 下一步

- [Claude Desktop 配置](/docs/mcp/claude-desktop) — 2 分钟配置
- [Claude Code 配置](/docs/mcp/claude-code) — 终端集成
- [自定义 MCP 客户端](/docs/mcp/custom-client) — 自建客户端