探脉Tanmai文档
本页目录

接入 AI 助手

Markdown 版本

探脉提供标准的远程 MCP（模型上下文协议）接口，AI 助手接入后可以直接查询你授权范围内的经营数据。只读，所有连接都走授权登录，随时可以撤销。

速查

MCP 地址

https://tanmai.mrwish.net/mcp
传输
Streamable HTTP
授权
OAuth 2.1 + PKCE、设备码
权限
mcp:read（只读）
撤销
「AI 接入」页
Markdown 版本（给 AI 读）llms.txt

对助手说一句话就能接入

对助手说「帮我接入探脉：tanmai.mrwish.net」即可，它会按本页说明自己完成接入。

按客户端接入

选择你用的助手，最多三步。

支持的 AI 助手

只写实测过的结论；「据官方文档」的条目附来源，查证日期 2026-10-01。手机端单独一列。

✅ 已实测 · 🔎 据官方文档 · ⬜ 未验证　接入方式：A 支持 OAuth 的客户端 · B 连接程序 · C 手动令牌

「验证状态（电脑 / 网页）」只针对电脑 / 网页；手机端以「手机」列该格内标记为准。

客户端电脑 / 网页手机接入方式skillMCP Apps 卡片验证状态（电脑 / 网页）已知限制
ChatGPT✅ 网页；⬜ 桌面应用（网页里添加后同步）🔎 官方不支持（web only）A—显示✅ 已实测须在网页版打开开发者模式添加；Pro 只能用只读工具，完整 MCP 限 Business / Enterprise / Edu。该客户端不支持本地 skill，依靠 MCP 服务器说明。 来源
Claude（claude.ai / Claude Desktop）✅ 网页、Claude Desktop🔎 可用（在电脑上添加后同步）A—显示✅ 已实测由 Anthropic 云端回连，服务器须公网可达；Free 限 1 个自定义连接器；Team / Enterprise 须 Owner 先添加。该客户端不支持本地 skill，依靠 MCP 服务器说明。 来源
Claude Code✅ 终端—A连接程序 skill 子命令安装（待实测）不显示（文本）✅ 已实测从本机发起连接；令牌自动续期（refresh token）待下次发布后实测。
Codex✅ CLI；⬜ 桌面应用—A（也可 C）连接程序 skill 子命令安装（待实测）不显示（文本）✅ 已实测codex mcp add --url 会自动发起浏览器授权（未弹出时再运行 codex mcp login）；codex exec 须放行 MCP 工具调用审批。
Cursor🔎 编辑器—A（也可 C）—⬜ 未验证🔎 据官方文档mcp.json 里只填 url 即可走 OAuth；也可用 headers 填令牌。该客户端不支持本地 skill，依靠 MCP 服务器说明。 来源
OpenClaw✅ 本机✅ 经 Telegram 等聊天通道B（连接程序驱动自带 OAuth 登录）连接程序自动安装不显示（文本）✅ 已实测连接程序 ≥ 1.4.0：auth: oauth + mcp login --code，令牌由 OpenClaw 自己保管并续期，网关不用重启（需 OpenClaw 2026.9+，旧版会明确报错）；不带连接码时助手发来链接和确认码，在手机上打开、核对确认码一致后点允许即可，授权码经探脉服务端中转（§4.9.1）；聊天通道只转发文本，不转发图片结果。 来源
Hermes Agent✅ 本机⬜ 经聊天通道B（连接程序驱动设备码登录）；A（设备码，已实测）连接程序自动安装不显示（文本）✅ 已实测连接程序 ≥ 1.4.0 用连接码批准 Hermes 自己的设备码登录（令牌归 Hermes 保管并续期，无需重启 / /reload-mcp，需支持 mcp login --flow 的 Hermes，旧版会明确报错）；原生设备码登录已实测（Hermes Agent 0.21.4，2026-10-02）；浏览器授权（hermes mcp add --auth oauth）暂不可用；连接程序的设备码登录路径（不带连接码）未实测。 来源

待实测

  • ChatGPT 手机端（iOS / Android）：官方写明不支持，实际表现未测。
  • Claude 手机端。
  • Codex 桌面应用。
  • Hermes Agent：连接程序的设备码登录路径（不带连接码）；浏览器授权（hermes mcp add --auth oauth），待服务端支持。
  • Cursor。
  • Claude Code 的令牌自动续期（下次发布后）。
  • WorkBuddy（CodeBuddy）等其他助手：尚无一手资料。

端点与授权

客户端会按下列地址自动发现授权信息，一般不用手动填写。

  1. 授权信息自动发现：客户端首次连接收到 401 后，按响应里的地址读取受保护资源元数据，再读取授权服务器元数据。

  2. 浏览器授权：OAuth 2.1 + PKCE（S256）。客户端通过动态注册，或用 https 网址作 Client ID（Client ID Metadata Document）取得身份。

  3. 设备码登录：RFC 8628，适合没有浏览器回调的助手。客户端给出登录链接和核对码，用户核对一致后点「允许」。

  4. 权限范围 mcp:read（只读）。OAuth 登录（含连接程序）的访问令牌 1 小时有效、由客户端自动续期，授权期限按授权页上的选择（浏览器授权默认 90 天，设备码登录与连接码默认 365 天）；手动令牌是长期令牌，不会自动续期。

  5. 连接程序：能执行命令、但自己完成不了登录的助手用（目前支持 openclaw、hermes），需要 Node.js 22 或更高版本；默认同时安装探脉 skill（带一份取数规则，供不读取 MCP 服务器说明的助手使用），加 --no-skill 不安装。用其它方式接入的助手，可以用连接程序的 skill 子命令单独安装 skill（npx -y https://tanmai.mrwish.net/connect/latest.tgz skill --client <openclaw|hermes|claude-code|codex>，不登录、不改配置）。连接码 10 分钟内有效、只能用一次。

终端
npx -y https://tanmai.mrwish.net/connect/latest.tgz --client openclaw --base-url https://tanmai.mrwish.net

校验值 sha256 9fd4572375db1af5440fd18debacd895e3b07602e98c789b39c26d0da8456ef7

MCP 地址
https://tanmai.mrwish.net/mcp
受保护资源元数据（RFC 9728）
https://tanmai.mrwish.net/.well-known/oauth-protected-resource/mcp
授权服务器元数据（RFC 8414）
https://tanmai.mrwish.net/.well-known/oauth-authorization-server
授权端点
https://tanmai.mrwish.net/oauth/authorize
设备码端点（RFC 8628）
https://tanmai.mrwish.net/api/oauth/device_authorization
令牌端点
https://tanmai.mrwish.net/api/oauth/token
动态注册端点（RFC 7591）
https://tanmai.mrwish.net/api/oauth/register
令牌撤销端点（RFC 7009）
https://tanmai.mrwish.net/api/oauth/revoke
权限范围（scope）
mcp:read

权限与撤销

只读

权限范围 mcp:read：查看指标目录与口径、查询经营指标、枚举维度成员；不能修改任何数据，也看不到成员、令牌与设置。

随时撤销

已授权的助手可以在「AI 接入」页（https://tanmai.mrwish.net/me/connections）随时撤销，撤销后立即失效。

给 AI 助手的接入说明

这一节写给 AI 助手：你对它说那句话后，它照这张表操作。人按上面的步骤操作即可。

用户对你说「帮我接入探脉：tanmai.mrwish.net」时按这张表做：先确认你自己是哪个客户端，只走自己那一行，不要借用别家客户端的方法或工具。全程不用用户敲命令，他只需要打开你发给他的链接，点「允许」。连接码以 tmc_ 开头；带连接码的指令会写明是为哪个助手生成的（如「帮我把 OpenClaw 接入探脉，连接码 …」）。连接码只能给句中写明的那个助手用：你不是那个助手时，即使用户要求你代为接入，也不要运行连接程序、不要改 --client；请用户把这句话发给对应助手，或在「AI 接入」页为你重新生成。探脉服务端会拒绝不匹配的兑换。

客户端有连接码时没有连接码时用户会看到什么 / 要做什么
OpenClaw在后台运行 npx -y https://tanmai.mrwish.net/connect/latest.tgz --client openclaw --base-url https://tanmai.mrwish.net --code <连接码>在后台运行 npx -y https://tanmai.mrwish.net/connect/latest.tgz --client openclaw --base-url https://tanmai.mrwish.net有连接码时不用操作；没有时收到登录链接，在手机上打开、点「允许」。可能要先批准这条命令。接入后新开一个会话即可，不用重启网关。
Hermes Agent在后台运行 npx -y https://tanmai.mrwish.net/connect/latest.tgz --client hermes --base-url https://tanmai.mrwish.net --code <连接码>，不用走设备码登录设备码登录：写配置后新开终端，后台运行 hermes mcp login tanmai --flow device（见下方第 2 条）；走不通时改运行 npx -y https://tanmai.mrwish.net/connect/latest.tgz --client hermes --base-url https://tanmai.mrwish.net有连接码时不用操作；设备码登录时收到带核对码的登录链接，在手机上打开、核对一致后点「允许」，再回到对话说一声「好了」。
Claude Code不用连接码，按右边做执行 claude mcp add --transport http tanmai https://tanmai.mrwish.net/mcp，再请用户启动 claude、输入 /mcp，选 tanmai → Authenticate；然后执行 npx -y https://tanmai.mrwish.net/connect/latest.tgz skill --client claude-code 安装 skill在浏览器里完成授权。
Codex不用连接码，按右边做执行 codex mcp add tanmai --url https://tanmai.mrwish.net/mcp（会自动发起浏览器授权；没有弹出授权时再执行 codex mcp login tanmai）；然后执行 npx -y https://tanmai.mrwish.net/connect/latest.tgz skill --client codex 安装 skill在浏览器里的探脉授权页点「允许」。
ChatGPT、Claude（网页 / 桌面）不用连接码，按右边做不要执行命令，把本页「按客户端接入」里对应的步骤告诉用户在设置里粘贴 MCP 地址，在探脉授权页点「允许」。
其他客户端不用连接码（连接程序目前只支持 openclaw、hermes），按右边做能自己添加远程 MCP 服务器并完成 OAuth 或设备码登录，就用自带的方式添加 https://tanmai.mrwish.net/mcp（授权信息会自动发现）；做不到就不要执行任何命令，把本页「按客户端接入」里对应客户端的步骤告诉用户收到你原样转来的登录链接和核对码，按提示授权。

连接程序输出与注意事项

  1. 连接程序（校验值 sha256 9fd4572375db1af5440fd18debacd895e3b07602e98c789b39c26d0da8456ef7）：--client 填你自己真实的类型（目前支持 openclaw、hermes），本机只有一个支持的客户端时可以省略（npx -y https://tanmai.mrwish.net/connect/latest.tgz --base-url https://tanmai.mrwish.net）。用户主动要求重新登录、重新授权、重新接入或换成新的登录方式时，同样按表重新运行（旧版写在本机的长期令牌会在新登录成功后删除并在服务端作废）。用户说不要安装 skill 时加上 --no-skill（只接入 MCP 服务器，不安装 skill 里的取数规则）。需要用户审批这条命令时先请他批准，否则命令会一直等待；输出里出现 TANMAI_LOGIN_URL= 时把链接写成 Markdown 链接发给用户，形如 [点这里打开探脉授权页](<TANMAI_LOGIN_URL 的值>)，并说「在手机上打开，点允许就行」；下一行再原样附上完整网址（链接点不开时可复制）；不要把网址放进代码块或反引号里（那样点不了）；同时出现 TANMAI_CONFIRM_CODE= 时把确认码和链接一起发给用户，并说「页面上显示的确认码应该和这里一致，不一致就不要点允许」；输出里的每条 TANMAI_NOTE= 都原样转告用户（OpenClaw 与 Hermes 接入后都不需要重启：OpenClaw 新开会话即可，Hermes 大约 1 分钟后新开的对话才能用上，当前对话可能还没有）；看到 TANMAI_CONNECTED 就说明已接入；看到 TANMAI_ERROR=，把原因转述给用户。

  2. Hermes Agent 设备码登录：不要用 hermes mcp add tanmai --url https://tanmai.mrwish.net/mcp --auth oauth——它走浏览器授权，目前接不上探脉，而且要等人交互，在聊天里也用不了；一律用设备码登录。先在当前 profile 的 config.yaml（hermes config path 会打印它的路径：默认是 ~/.hermes/config.yaml，用了 profile 时是 ~/.hermes/profiles/<profile 名>/config.yaml）的 mcp_servers 下加一项 tanmai（url: https://tanmai.mrwish.net/mcp、auth: oauth、oauth 下 flow: device）；改完配置不要在当前会话里登录——正在运行的 Hermes 发现配置变化会自动重连，只等 30 秒，不够完成登录——要新开一个终端。在新终端里把 hermes mcp login tanmai --flow device 当后台进程运行，并像运行其他阻塞命令一样轮询它的输出。登录命令只运行一次，不要同时开第二个；不要用 || 或 ; 串接备用命令；用 profile 时每条命令都要带 -p <profile>（如 hermes -p <profile> mcp login tanmai --flow device、hermes -p <profile> mcp test tanmai）。出现登录链接和核对码时，发给用户带核对码的完整链接 https://tanmai.mrwish.net/device?user_code=<核对码>（输出里已有这样的链接就直接用它），写成 Markdown 链接，形如 [点这里打开探脉授权页](<完整链接>)，下一行再原样附上完整网址（链接点不开时可复制），不要把网址放进代码块或反引号里（那样点不了）；他打开后核对码已经填好，核对一致后点「允许」即可；同时告诉他：点完后回到这里说一声「好了」。命令会一直等到他点完；你这一轮回复如果已经结束，就等他回来说「好了」后再继续。完成后执行 hermes [-p <profile>] mcp test tanmai 确认能列出工具；接着安装 skill：运行 npx -y https://tanmai.mrwish.net/connect/latest.tgz skill --client hermes [--hermes-profile <profile>]（用 profile 时带上，与上面的 -p 同名）；装好后新开一个会话。

  3. 连接程序是兜底：只给 OpenClaw 这类自己不能完成登录的客户端用；用户主动给了连接码时例外，按表里「有连接码时」一列做。它替客户端完成自带的授权登录，访问令牌由客户端每小时自动续期。--client 只能填你真实的类型；程序回答「暂不支持自动接入 <类型>」时立刻停止，不要改填别的类型（比如 openclaw），改走表里「其他客户端」那一行，把步骤告诉用户。

  4. 接入完成后安装探脉 skill：连接程序接入会自动装；其它方式接入后用 skill 子命令（npx -y https://tanmai.mrwish.net/connect/latest.tgz skill --client <openclaw|hermes|claude-code|codex>，--client 填你自己真实的类型；不是这几种的客户端改用 --skills-dir <你的 skills 目录>）。可以告诉用户并给出这条命令；经用户同意后可代为执行，也可由用户自己在终端运行；不安装也能查询。调用 whoami 后看到「探脉 skill：」安装提示时同样处理。服务端无法感知本地安装，装好后提示仍会出现，不代表没装成功。ChatGPT、Claude（网页 / 桌面）、Cursor 不支持本地 skill，跳过这一步，依靠 MCP 服务器说明。

  5. 不要让用户在聊天里发令牌、密码或验证码；只执行本页列出的命令；接入完成后，接着回答用户原来的问题。