Tavo MCP 服务器
Tavo MCP 服务器可以让 Codex、Claude Code 等 AI agent 连接到 Tavo，辅助创建角色卡、整理世界书、管理聊天或编写插件。
连接后，agent 可以读取当前 Tavo 版本提供的工具和使用文档。
启用服务器
- 打开
更多→设置。 - 进入
创作者→Tavo MCP 服务器。 - 选择访问范围。
- 启用服务器。
- 把 URL 和 bearer token 复制到你的 MCP 客户端。
服务器默认关闭。如果没有手动设置 token，Tavo 会在启用服务器时自动生成一个 bearer token。
请保护 bearer token
任何能访问 MCP endpoint 且拥有 bearer token 的客户端，都可以调用暴露出的 Tavo 工具。不要把 token 粘贴到公开聊天、截图、文档、日志或 issue 里。
Agent 客户端
你不需要手动记命令。最简单的方式是把 Tavo 生成的完整连接配置发给 agent。
- 在「Tavo MCP 服务器」页面底部点击
复制完整连接配置。 - 在和 agent 的聊天里发送：
Tavo MCP Server: 0.91.0
Preferred access: direct HTTP JSON-RPC
Server URL: http://192.168.0.1:7347/mcp
Authorization: Bearer 123456- agent 反馈连接成功。
- 继续对 agent 说：
帮我写一张角色卡，是一位在星际漂泊多年的帝国公主- agent 反馈写卡成功，你就可以在 Tavo 里查看和继续编辑这张角色卡。
连接后如何使用
连接后，让 agent 先调用 initialize，再通过 tools/list、resources/list 和 resources/templates/list 获取可用接口。
| 需要了解的内容 | 文档入口 |
|---|---|
| 工具分类与调用示例 | tavo://docs/tools |
| 工具参数 | tools/list |
| 角色、主题等对象字段 | tavo://schemas/* |
| 写入前预览与重试 | tavo://docs/write-safety |
| 插件编写 | tavo://docs/plugins |
| 角色卡中的 JavaScript | tavo://docs/tavojs |
你可以直接描述任务，例如“帮我整理这张角色卡的世界书”。具体参数由 agent 根据上述文档读取。
Tavo MCP 服务器供外部 agent 连接。聊天中的模型工具见工具调用，插件开发见插件开发指南。
无法连接？
请先检查：
- 确认服务器正在运行。可以尝试关闭后重新开启。
- 确认两台设备在可互通的网络中。VPN、访客网络、防火墙可能会拦截连接。
- 没有 Wi-Fi 时，可用手机热点或 USB 网络共享，并保持局域网模式。
- 如果开启了个人热点，请让对方设备接入该热点。不用热点时可关闭后重试。
- 蜂窝网络显示的 IP 可能是运营商内网地址，其他设备不一定能访问。
- 只有从私有网络外访问时，才使用公共网络。通常还需要端口转发、隧道或反向代理。
常见错误：
- 401：Token 缺失或错误。
- 403：访问范围不允许当前设备连接。
- 404/405：URL 或请求方式不对。应使用 POST 请求。
- 连接超时：通常是网络、IP、端口或防火墙问题。