# 接入 AI 助手 · 探脉 Tanmai

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

MCP 地址：https://tanmai.mrwish.net/mcp（Streamable HTTP，OAuth 2.1，只读）

对助手说「帮我接入探脉：tanmai.mrwish.net」即可，它会按本页说明完成接入。AI 助手请直接看末尾「给 AI 助手的接入说明」。

## 按客户端接入

### OpenClaw

1. 对助手说「帮我接入探脉：tanmai.mrwish.net」；也可以在「AI 接入」页（https://tanmai.mrwish.net/me/connections）生成带连接码的一句话发给它。
2. 助手会运行连接程序，并发给你一个登录链接和确认码（用连接码时不用登录）；在手机上打开链接，核对确认码一致后点「允许」。
3. 如果助手请你审批这条命令，批准后它才会继续。

连接程序替你完成 OpenClaw 自带的授权登录，令牌由 OpenClaw 自己保管并自动续期，不用了在「AI 接入」页撤销。网关不用重启，接入后新开一个会话即可使用。需要 OpenClaw 2026.9 及以上；用连接码时授权在后台自动完成；不带连接码时，助手会发来一个链接和确认码，在手机上打开链接，核对确认码一致后点「允许」，就能自动接好。

### Hermes Agent

1. 对助手说「帮我接入探脉：tanmai.mrwish.net」；也可以在「AI 接入」页（https://tanmai.mrwish.net/me/connections）生成带连接码的一句话发给它。
2. 助手会发给你带核对码的登录链接（用连接码时不用登录）；在手机上打开，核对一致后点「允许」，再回到对话告诉它「好了」。

用连接码接入时授权 365 天有效（设备码登录按授权页上的选择），期间访问令牌由 Hermes 每小时自动续期，不用了在「AI 接入」页撤销。接入后大约 1 分钟，新开的对话才能用上探脉。想自己在终端配置，见本页「给 AI 助手的接入说明」。

### ChatGPT

1. 在 chatgpt.com 网页版的设置里打开「开发者模式」（Business / Enterprise / Edu 工作区须管理员先允许）。手机 App 不支持添加。
2. 新建一个应用（App），「MCP 服务器 URL」填 https://tanmai.mrwish.net/mcp，认证方式选 OAuth，Client ID 和 Secret 留空，点「创建」。
3. 在探脉授权页点「允许」，之后在对话里选用探脉即可提问；桌面应用会同步网页里添加的应用。

菜单名称变化较快，以 OpenAI 帮助中心「Developer mode and MCP apps」为准（https://help.openai.com/en/articles/12584461）。

### Claude（claude.ai / Claude Desktop）

1. 打开「自定义 → 连接器」（https://claude.ai/customize/connectors），点「+」→「添加自定义连接器」。
2. 「远程 MCP 服务器 URL」填 https://tanmai.mrwish.net/mcp，Client ID 和 Secret 留空，点「添加」；再点「连接」，在探脉授权页点「允许」。
3. 在对话输入框左下点「+」→「连接器」，打开探脉就可以提问。

### Claude Code

```bash
claude mcp add --transport http tanmai https://tanmai.mrwish.net/mcp
```

1. 在终端执行上面的命令。
2. 启动 claude，输入 /mcp，选 tanmai → Authenticate，在浏览器里完成授权。
3. 安装探脉 skill（带一份取数规则；不装也能查询）：在终端执行 npx -y https://tanmai.mrwish.net/connect/latest.tgz skill --client claude-code，装好后新开一个会话。

### Codex

```bash
codex mcp add tanmai --url https://tanmai.mrwish.net/mcp
```

1. 在终端执行上面的命令；它会自动打开浏览器发起授权，在探脉授权页点「允许」，看到「Successfully logged in」后新开一个会话即可使用。
2. 上一步没有弹出授权（或授权失败、令牌失效）时，再执行 codex mcp login tanmai。
3. 安装探脉 skill（带一份取数规则；不装也能查询）：在终端执行 npx -y https://tanmai.mrwish.net/connect/latest.tgz skill --client codex，装好后新开一个会话。

不方便用浏览器登录时，在「AI 接入」页（https://tanmai.mrwish.net/me/connections）的「手动令牌」生成令牌，按页面上的说明配置。

### 其他客户端

1. 在客户端里添加远程 MCP 服务器 https://tanmai.mrwish.net/mcp（Streamable HTTP），按提示完成浏览器授权或设备码登录；不用填 Client ID、Secret 或令牌。
2. 只能填地址和请求头时：在「AI 接入」页（https://tanmai.mrwish.net/me/connections）的「手动令牌」生成只读令牌，请求头填 Authorization: Bearer <令牌>。
3. 各客户端的支持情况见本页「支持的 AI 助手」。

手动令牌只显示一次、绑定当前商户、不会自动续期，建议每个客户端单独一枚。

## 支持的 AI 助手

验证状态：✅ 已实测 / 🔎 据官方文档 / ⬜ 未验证。接入方式：A 支持 OAuth 的客户端 / B 连接程序 / C 手动令牌。官方文档查证日期 2026-10-01。

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

| 客户端 | 电脑 / 网页 | 手机 | 接入方式 | skill | MCP Apps 卡片 | 验证状态（电脑 / 网页） | 已知限制 | 来源 |
|---|---|---|---|---|---|---|---|---|
| ChatGPT | ✅ 网页；⬜ 桌面应用（网页里添加后同步） | 🔎 官方不支持（web only） | A | — | 显示 | ✅ 已实测 | 须在网页版打开开发者模式添加；Pro 只能用只读工具，完整 MCP 限 Business / Enterprise / Edu。该客户端不支持本地 skill，依靠 MCP 服务器说明。 | [OpenAI 帮助中心：Developer mode and MCP apps](https://help.openai.com/en/articles/12584461) |
| Claude（claude.ai / Claude Desktop） | ✅ 网页、Claude Desktop | 🔎 可用（在电脑上添加后同步） | A | — | 显示 | ✅ 已实测 | 由 Anthropic 云端回连，服务器须公网可达；Free 限 1 个自定义连接器；Team / Enterprise 须 Owner 先添加。该客户端不支持本地 skill，依靠 MCP 服务器说明。 | [Claude 帮助中心：custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-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 服务器说明。 | [Cursor 文档：Model Context Protocol](https://cursor.com/docs/mcp) |
| OpenClaw | ✅ 本机 | ✅ 经 Telegram 等聊天通道 | B（连接程序驱动自带 OAuth 登录） | 连接程序自动安装 | 不显示（文本） | ✅ 已实测 | 连接程序 ≥ 1.4.0：auth: oauth + mcp login --code，令牌由 OpenClaw 自己保管并续期，网关不用重启（需 OpenClaw 2026.9+，旧版会明确报错）；不带连接码时助手发来链接和确认码，在手机上打开、核对确认码一致后点允许即可，授权码经探脉服务端中转（§4.9.1）；聊天通道只转发文本，不转发图片结果。 | [OpenClaw 文档：Connect MCP servers](https://docs.openclaw.ai/tools/mcp) |
| 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）暂不可用；连接程序的设备码登录路径（不带连接码）未实测。 | [Hermes Agent 文档：MCP Config Reference](https://hermes-agent.nousresearch.com/docs/reference/mcp-config-reference) |

待实测：

- 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 分钟内有效、只能用一次。

```bash
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

## 给 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. 不要让用户在聊天里发令牌、密码或验证码；只执行本页列出的命令；接入完成后，接着回答用户原来的问题。