猫金灵开放平台 · API Key 获取与使用

MCP over Streamable HTTP   单一端点 /mcp/v1,三件套工具 receiveArchiveCallback / runRuleEngine / getBrief

猫金灵(CatJinLing) · 企微会话情报第三方服务。面向房产、保险等行业的会话存档数据做情报加工,自动提炼客资、客诉与舆情信号。明文数据不离开你的受控环境——本页是接入文档,也是我们的数据与隐私承诺。

① 获取 API Key

  1. 登录开发者控制台
  2. 进入「开放平台 → API」
  3. 新建密钥:选租户、绑定行业场景(realestate / insurance;medical_aesthetic 暂未开放)
  4. 复制系统生成的 32 字节 hex 字符串并妥善保存(仅生成时显示一次)

② 最小调用验证

curl -sk https://mcp.tapres.cn/mcp/v1 \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

③ 在 WorkBuddy 开放平台中连接

连接器 → 搜「猫金灵企微存档 (catjinling-wecom-archive)」→ 填入 API Key → 完成。私有化客户改 CATJINLING_BASE_URL 指向贵司机房地址(如 https://catjinling.yourcompany.local)。

采集三件套 · 价值深挖方向

猫金灵专注企微三条独立采集链路的「深度加工」,按场景组合使用

采集链路边界明确:①走外部联系人 API(4 年前开放,无需付费),②③走会话内容存档(需客户自购席位 + 专用 SDK)。本产品不与官方通用入口竞争,是这三条链路上的「行业规则引擎 + 脱敏流水线」提供者。

协议栈兼容(事实陈述)

完整兼容企微 5.0.10+ 官方 CLI/MCP 协议栈(开放的 10 大模块:消息 / 邮件 / 文档 / 表格 / 智能表 / 智能文档 / 待办 / 日程 / 会议 / 微盘 / 通讯录)。客户内部已接入官方 WecomTeam/wecom-unified Skill 的 Agent 可编排调用本产品做行业分类打标与脱敏加工。

注:朋友圈 / 客户群 / 私聊三条采集链路不在企微 5.0.10 开放的 10 大模块内——本产品在三条自有链路上提供深度价值,工具调用广度由官方提供。

数据流向承诺

明文不出你的受控环境。会话原文/对象字节永不进入 WorkBuddy 侧——外部只接收:脱敏向量、结构化摘要、规则命中事件、客体存储引用(预签名 URL,15 分钟有效)。
明文落点:SaaS 模式仅存于猫金灵后端解密模块并加密落库(AES-256-GCM),30 天自动清理;私有化模式只在客户机房内解密与向量化。
密钥随时可吊销:在控制台可即时注销/轮换 API Key,吊销后立即失效,数据加工随之停止。

隐私与合规声明

错误码速查

codeHTTP含义客户端动作
0200成功
40001401API Key 无效 / 过期检查 Bearer 或在轮换期换新钥
40002400schema 校验失败修正字段;白名单外字段视为明文误传
40003400taskId 与 range 二选一冲突二选一
40004400自然语言 query 解析失败按返回建议语句改写
40301403租户无该 rulePack 权限控制台开通或换包
40302403行业场景未开通联系商务
42901429触发限流Retry-After 头退避
50002503依赖降级降级链自动生效;规则命中仍可获取

运行状态

健康检查:GET /healthz(公开)。运营统计:GET /admin/stats(需 CJ_ADMIN_KEY,默认关闭)。

关于我们 & 支持

猫金灵(CatJinLing)是企微会话情报工具链:本 MCP 服务 + WorkBuddy 开放平台三件套(连接器「企微会话存档」/ 技能「企微高意向客户提炼」/ 专家「企微会话情报台」),由同一团队开发与运营。