# MCP 是什么？
SUMMARY: Model Context Protocol 让 LLM 调用外部工具。Synapse 通过官方 MCP Server 暴露 79 个工具。

KEY CONTEXT:
MCP = Model Context Protocol (Anthropic, 2024). Open standard for LLM-tool integration.
Synapse has official MCP server: synapse-mcp-api (npm package, npx -y synapse-mcp-api@latest)
79 tools exposed: 22 memory, 7 chat, 8 scheduler, 4 tasks, 5 scripts, 9 computers, 4 push, 5 user, 3 utility
3 transports: stdio (local), HTTP/SSE (remote), WebSocket (mobile)
Supported clients: Claude Desktop, Claude Code, Cursor, Continue, Cline, any MCP-compatible client
Tool Profiles (v1.4.0): minimal (8 tools), standard (25), full (119) — controlled via MCP_PROFILE env or Mcp-Tool-Profile header

MCP 是什么？
Model Context Protocol (MCP) 是 Anthropic 于 2024 年推出的开放标准，让 LLM 以结构化方式调用外部工具。你不需要把 API 文档粘到 prompt 里，而是把工具注册到 MCP Server，LLM 按需调用 — 类似 function calling，但标准化且与客户端无关。
Synapse MCP Server
Synapse 提供官方 MCP Server（npm 上的 ），暴露覆盖所有 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 | cronlist, croncreate, crondelete, crontoggle, varlist, varget, varset, vardelete | 8 |
| Tasks | tasklist, taskget, taskcreate, taskupdate | 4 |
| Scripts | scriptlist, scriptget, scriptinfo, scriptstore, scriptdelete | 5 |
| Computers | computerlist, computerget, installcode, screenshot, commandqueue, commandstatus, commandslist, disable, delete | 9 |
| Push | vapidpublickey, subscribe, unsubscribe, test | 4 |
| User/Mind | register, login, mindslist, mindcreate, minddelete | 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+ |
工作原理
[CODE BLOCK]
1. 你把 LLM 客户端（Claude Desktop、Cursor 等）配置为使用 Synapse MCP Server
2. 客户端启动 MCP Server（通过 ）
3. MCP Server 用你的 Mind Key 连接到 Synapse API
4. LLM 看到全部 79 个工具，作为可调用的原生函数
5. 当 LLM 需要记住某事时，它调用  — MCP Server 把它翻译为 Synapse 上的 
传输方式
Synapse MCP Server 支持三种传输方式：
stdio（本地，桌面端推荐）
[CODE BLOCK]
HTTP/SSE（远程，多租户）
把你的 MCP 客户端连接到：
[CODE BLOCK]
WebSocket（移动端，高吞吐）
[CODE BLOCK]
工具配置文件（v1.4.0）
为减小较小 LLM 的 token 开销，MCP Server 支持三种工具配置文件：
| 配置文件 | 工具 | Tokens | 适合 |
|---------|-------|--------|----------|
|  | 8（组合分发） | 500 | 上下文 ≤8k 的自托管 LLM |
|  | 25（命名） | 2,500 | 中等大小 LLM（Claude Haiku、GPT-3.5） |
|  | 119（全部） | 8,250 | 大型 LLM（Claude Sonnet/Opus、GPT-4） — 默认 |
控制方式：
- 环境变量：
- 头：
支持的客户端
- Claude Desktop — Anthropic 的桌面应用
- Claude Code — 终端编码 Agent
- Cursor — AI 驱动的 IDE
- Continue.dev — 开源 AI 编码助手
- Cline — VS Code 扩展
- 任何兼容 MCP 的客户端
为什么用 MCP 而非直接 API？
| 方式 | 优点 | 缺点 |
|----------|------|------|
| 直接 API | 简单，无额外层 | LLM 需要知道 URL、请求头、认证 |
| MCP | LLM 看到原生工具，无需记 URL | 多一个 MCP Server 进程 |
对于大多数 LLM Agent 用例，MCP 是更好的选择 — LLM 不需要记 API 路径或认证模式。
下一步
- Claude Desktop 配置 — 2 分钟配置
- Claude Code 配置 — 终端集成
- 自定义 MCP 客户端 — 自建客户端