# 探脉 Tanmai

> 你的 AI 经营分析师：给电商经营数据把脉，接上 ERP。今天生意怎么样，问探脉。

探脉是面向电商商户的经营数据分析平台。任何支持远程 MCP 与 OAuth 登录（浏览器授权或设备码）的 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. 不要让用户在聊天里发令牌、密码或验证码；只执行本页列出的命令；接入完成后，接着回答用户原来的问题。

## 接入

- [接入说明](https://tanmai.mrwish.net/docs/mcp.md): 按客户端接入、支持的 AI 助手、端点与授权与给 AI 助手的接入说明
- [MCP 地址](https://tanmai.mrwish.net/mcp): 远程 MCP 服务器（Streamable HTTP，OAuth 2.1 + PKCE 或设备码，scope mcp:read，只读）
- [受保护资源元数据](https://tanmai.mrwish.net/.well-known/oauth-protected-resource/mcp): RFC 9728，指向授权服务器
- [授权服务器元数据](https://tanmai.mrwish.net/.well-known/oauth-authorization-server): RFC 8414，授权 / 设备码 / 令牌 / 注册端点
- [连接程序](https://tanmai.mrwish.net/connect/latest.tgz): 客户端自己不支持 OAuth 登录时用，npx 运行（当前版本 1.4.4，sha256 9fd4572375db1af5440fd18debacd895e3b07602e98c789b39c26d0da8456ef7）

## Optional

- [首页](https://tanmai.mrwish.net/): 登录入口