← Docs/

§ MCP 接入 · Model Context Protocol

MCP 接入.

把 HiPMM 的 PMM-8+ 编码能力当成 MCP tools 接入任何兼容客户端 — 解析编码、为名人评估画像、构建 AI 军团、生成 system prompt,所有调用按你的账户计量,在控制台 → 「查看详情」看个人统计.

01

是什么

pmm8-mcp 是一个远程 MCP server,通过 https://www.hipmm8.com/mcp 暴露 6 个 PMM-8+ 工具.任何支持 MCP 协议的客户端都能接入 — 拿你的 hipmm_sk_* 当 Bearer token 即可.

所有调用按用户聚合计量 (跟 SDK API 用量同一套账户体系), 一个用户的多把 key 数据合在一起,无需关心用哪一把.

MCP = Model Context Protocol

一个让 LLM 客户端 (IDE、CLI 工具、对话桌面端) 调用外部工具的开放协议. HiPMM 通过 MCP 把 PMM-8+ 引擎以"工具"形式提供给你的 AI 工作流.
02

6 个 Tool 概览

Tool用途什么时候调用
pmm8_get_encoding_guide8 维 × 5 段位编码规范 + 常见错误 + 范例生成任何编码前必读
pmm8_assess_persona ⭐8 维段位 + 证据 → 校准编码 + 完整画像为名人/公众人物建编码
pmm8_lookup_persona查持久化人物库 (跨会话/跨客户端一致)每次评估前先查
pmm8_analyze_personality_code解析已有编码 → 八维画像 + 行为提示手上已有编码做解读
pmm8_build_ai_legion指挥官编码 + 场景 → 互补 AI 军团组团队 / 角色匹配
pmm8_mirror_persona编码 → 可灌入 LLM 的 system prompt让 LLM 扮演某个画像
03

拿 token

访问 /dashboard → 点 创建新 Key → 复制一次性显示的 hipmm_sk_xxx.

一个用户最多 5 把活跃 key,任意一把都能用,**调用全部计入同一账户**.下面所有示例的 <你的 token> 都填这一把.

只显示一次

API key 创建时只在屏幕上显示一次. 复制到 1Password 或你的 secret manager.
04

接入示例 · 通用 HTTP MCP

大多数 MCP 客户端支持 HTTP transport, 用统一 JSON 配置:

MCP client config · 通用

{
  "mcpServers": {
    "pmm8": {
      "type": "http",
      "url": "https://www.hipmm8.com/mcp",
      "headers": {
        "Authorization": "Bearer <你的 token>"
      }
    }
  }
}
05

接入示例 · Claude Code (CLI)

bash

# 装新的 (远程 + 鉴权)
claude mcp add --transport http --scope user pmm8 https://www.hipmm8.com/mcp \
  --header "Authorization: Bearer <你的 token>"

# 检查
claude mcp list

重启客户端后,在对话里输入 /mcp 应显示 pmm8 ✔ connected 和 6 个 tool.

06

接入示例 · Codex CLI

编辑 ~/.codex/config.toml:

toml · ~/.codex/config.toml

[mcp_servers.pmm8]
type = "http"
url  = "https://www.hipmm8.com/mcp"

[mcp_servers.pmm8.headers]
Authorization = "Bearer <你的 token>"

若 Codex 版本不支持 http transport,改用 stdio + mcp-remote 桥接:

toml · 兼容旧版

[mcp_servers.pmm8]
command = "npx"
args    = ["-y", "mcp-remote", "https://www.hipmm8.com/mcp", "--header", "Authorization:Bearer <你的 token>"]
07

接入示例 · IDE 编辑器扩展 (Cursor / Cline / Continue 等)

所有走 MCP 协议的 IDE 扩展都用统一 JSON 配置 (跟 #04 一致):

JSON · 任意支持 MCP 的客户端

{
  "mcpServers": {
    "pmm8": {
      "type": "http",
      "url": "https://www.hipmm8.com/mcp",
      "headers": { "Authorization": "Bearer <你的 token>" }
    }
  }
}
08

自然语言调用示例

配置好之后,直接在你的客户端里用自然语言提:

对话示例

用 pmm8 解析 O(I)CLB|X-ID-PR(AR)-SE-LT 这个编码

用 pmm8 给段永平生成镜像, 要先读编码指南、走标准评估流程

用 pmm8 给我 (编码 I(22)A(78)L(18)X(82)-ID(20)-AR(PR)(68)-SE(78)-LT(75)) 组一支做 SaaS MVP 的军团

客户端会自动识别需要调用哪个 tool, 串联多个 tool 完成任务.

09

查看你的 MCP 用量

每次调用 (无论从哪个 MCP 客户端、哪一把 key) 都会按你的账户分桶计量.两个地方可看:

控制台首页

/dashboard

「§ PMM-8 MCP」section — 本月调用总数 / 错误数 / 活跃 tool / 按 tool 横条 / 最近 10 条

完整后台

/user

KPI + 14 天趋势 + 按 tool 分布 + 持久化人物库 + 最近 200 条 (含参数 / IP / 错误)

从控制台点 查看详情 ↗ 跳转到 /user,自动以你的登录态进入,零额外输入.

10

安全与计量

  • token 即用户身份:任意一把 hipmm_sk_* 都映射到你的账户,调用合并计量
  • token 泄漏自救:dashboard → 撤销那把 key (revoke), 其它 key 不受影响
  • 计量周期:Redis hash 按月分桶,过期 32 天自动清,跨月用量自然分开
  • per-call 数据:每次调用记录 timestamp / tool name / 耗时 / 客户端 IP / 参数摘要 (≤ 80 字) / 错误 (如果有), 保留最近 200 条
  • 持久化人物库:assess_persona 生成的编码全站共享 (同一名字所有用户拿到相同结果, 保证一致性), 不计入个人配额
11

常见问题

Q: 我用 Claude Code / Cursor / Codex 调 pmm8 时,LLM 调用是计哪边的额度?

A: pmm8-mcp 本身不烧 LLM token, 是纯本地计算 (编码解析、画像生成都是算法/规则). 只有调用方客户端用的 LLM (你的 IDE 自己配置的) 烧 token, 那部分跟 HiPMM 无关.

Q: 多人共用一个 token 行吗?

A: 技术上能跑通, 但数据会混在一个账户里看不清谁调的. 推荐每人创建自己的 key.

Q: 同一个名字两次 assess 拿到的编码会一样吗?

A: 一样. lookup_persona 命中即直接返回,assess 加 overwrite=true 强制重算.这是为了跨会话/跨客户端的一致性保障.

Q: 自建一个独立 pmm8-mcp 实例?

A: 源码在 HiPMM 仓库 pmm8-mcp/ 子目录, 含 Dockerfile 和 docker-compose override. 自建后请用本地 token (跟我们的远程 token 体系不互通).