桌面端可以启动本地 MCP 服务，让支持 MCP 的外部工具读取 Muses 中的笔记、空间、标签、Todo、复习上下文和部分本地知识库信息。
这项能力适合把 Muses 作为本机知识上下文来源。它不是云同步服务，也不是给公网开放的 API。开启前应先理解授权方式、可见数据和写入风险。
---
一、开启服务与访问密钥
进入桌面端「设置 -> AI 与自动化 -> 本地 MCP 服务」，打开服务开关。移动端不会启动外部 HTTP MCP server。
默认地址是：
http://127.0.0.1:18765/mcp首次开启时，Muses 会在本机生成一段 Bearer Token。外部客户端请求本地 MCP 服务时，需要在请求头中携带：
Authorization: Bearer <设置页显示的 Token>Token 保存在本机安全存储中。重置 Token 后，旧客户端需要更新配置；关闭服务后，外部工具无法继续连接。
---
二、外部工具如何连接
Muses 当前使用 Streamable HTTP 传输，不是 SSE。不同客户端的配置字段可能不同，核心信息保持一致：
- 名称：
Muses - 类型：Streamable HTTP 或 HTTP MCP
- URL：
http://127.0.0.1:18765/mcp - 请求头：
Authorization: Bearer <Token>
一个常见的 JSON 配置写法如下，具体字段名以所用客户端文档为准：
{
"mcpServers": {
"muses": {
"type": "streamable-http",
"url": "http://127.0.0.1:18765/mcp",
"headers": {
"Authorization": "Bearer <设置页显示的 Token>"
}
}
}
}如果客户端没有请求头配置能力，就无法按当前鉴权方式连接。不要把 Token 拼到 URL query 中，Muses 当前不使用 ?token= 作为认证方式。
---
三、局域网访问
默认只允许本机访问。开启「允许局域网访问」后，Muses 会监听 0.0.0.0:18765/mcp，设置页会展示优先选择的局域网 IPv4 地址。
局域网模式使用 HTTP 明文传输，Bearer Token 只负责鉴权，不负责加密网络通信。建议只在可信网络中临时开启，使用完及时关闭。
---
四、外部可见工具范围
外部 MCP 客户端通过 tools/list 获取当前可用工具。当前外部可见工具为 27 个，内部维护工具和部分写入工具不会暴露给外部客户端。
| 能力域 | 主要工具 | 说明 |
|---|---|---|
| 笔记读取 | muses_search_notes、muses_get_note、muses_list_recent_notes | 搜索和读取可见笔记，不读取锁定空间。 |
| 空间与标签读取 | muses_list_spaces、muses_list_tags | 帮助外部工具理解当前组织结构。 |
| 本地知识库 | muses_search_local_notes、muses_get_note_clusters、muses_get_related_notes、muses_get_note_stats、muses_get_periodic_report、muses_kb_disabled_hint | 用于语义搜索、主题聚类、相关笔记、统计和周/月报告读取。 |
| 智能整理 | muses_get_organization_context、muses_suggest_scoped_organization、muses_apply_organization_plan_package | 基于显式范围生成整理建议，并在确认后应用整理计划。 |
| Todo | muses_list_todos、muses_get_todo、muses_create_todo、muses_update_todo、muses_set_todo_completion、muses_add_todo_subtask、muses_delete_todo | 查询、创建、修改、完成和删除任务。 |
| Todo 项目 | muses_list_todo_projects、muses_create_todo_project、muses_update_todo_project、muses_delete_todo_project | 管理任务项目，不会因为删除项目而删除任务本身。 |
| 复习上下文 | muses_get_note_context、muses_list_due_review_cards | 读取笔记上下文和到期复习卡。外部客户端不能直接评分复习卡。 |
以下工具只供 App 内部 AI 或维护流程使用，外部客户端看不到：muses_vectorize_batch、muses_cite_notes、muses_resolve_time_range、笔记写入工具、空间/标签写入工具和复习评分工具。
---
五、安全边界与使用建议
MCP 请求没有持续解锁上下文，因此锁定空间会被统一视为不可见。读取、搜索、统计、整理和写入都会遵守这个边界。
写入类工具会真实修改本地数据，并可能触发同步、提醒、日历事件或笔记 Todo 回写。外部 Agent 执行前应展示操作摘要，用户确认后再调用。
如果出现连接失败，建议按顺序检查：桌面端服务开关、Token 是否更新、客户端是否支持 Streamable HTTP、请求头是否正确、防火墙是否拦截 18765 端口。