MCP 与开放 API

让 AI 直接查询系统里的客户档案、指标趋势与时间线；或让你的系统通过标准接口对接。 凭证由你本机保存，返回内容按白名单脱敏。

怎么接入 接口示例

数据怎么流

一句话：凭证不经过云端，服务端也拿不回明文。

先说清楚它与 Skill 的区别

选错了会白折腾，两个问题就能定。

要读系统里的数据 → MCP

查档案、看趋势、写服务记录

数据在服务端，需要接入 Key。适合"客户资料已经在系统里、想让 AI 直接查"的场景。

只整理手头材料 → Skill

材料在手上，不出网

不需要 Key、不联网调用我们。去 Skill 页看看。

接入三步

三步之后就能用自然语言查档案。装一次，之后都省了。

  1. 1

    拿到接入 Key

    由管理员发放，形如 sk-shenlan-…，明文只显示一次，请立即保存。

  2. 2

    在 AI 里装连接器

    任何支持 MCP 的客户端都能装（WorkBuddy、Claude、Cursor 等）：添加「深岚陪诊档案」连接器， 在「服务对接配置」表单里填入 Key。不同客户端入口位置不同，字段名一致。

  3. 3

    说一句话试试

    例如「查一下孙**最近的指标趋势」 —— 读操作可直接执行，写操作会先向你确认。

关于凭证

接入 Key 只保存在你本机（WorkBuddy 为 ~/.workbuddy， 其他客户端为各自的配置目录），连接时注入，不经过云端。 服务端只保存它的 SHA-256 摘要，明文无法找回；遗失请让管理员轮换（旧 Key 立即失效）。

连接器配置（给开发者）

协议为 MCP Streamable HTTP。

{
  "type": "streamableHttp",
  "url": "https://agent.deeplycare.cn/api/v1/mcp",
  "headers": { "Authorization": "Bearer ${SHENLAN_API_KEY}" },
  "timeout": 30000
}

提供的工具

写操作会改动客户档案，AI 在执行前会向你确认。

工具做什么参数类型
subject_lookup按姓名 / 业务号 / 手机号 / 病种查客户query, limit只读
subject_indicators_trend指标趋势（已跨院归一）+ 风险等级评分subject_id只读
subject_timeline客户全周期事件时间线subject_id, event_type, limit只读
insight_list历史解读结论列表subject_id只读
subject_events_write写入一条服务事件subject_id, event_type, title, content写
insight_run运行一个解读维度并产出结论subject_id, dimension写

返回的敏感级别

每次调用都可以指定，默认 standard。

级别返回什么用在什么时候
strict去掉直接标识与临床数值展示性场景、未签约、跨机构
standard掩码 + 保留临床信号常见业务（已获授权）
insight额外返回结论文本已单独同意的用途

开放 API 示例

同一套 Key 与工具，可用任意 HTTP 客户端调用。

POST https://agent.deeplycare.cn/api/v1/mcp
Authorization: Bearer sk-shenlan-...
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list"}
未鉴权时返回 401

Key 无效、被轮换、或出口未启用，都会返回 401。若持续 401，请联系管理员确认出口状态。