开放平台 · 机构 / 系统对接方

让 AI 直接查档案，
或把接口接进你的系统

MCP Streamable HTTP / JSON-RPC 2.0：查客户档案、指标趋势与时间线，或写入服务事件。

凭证只在你本机；服务端只存 SHA-256 摘要；返回按白名单脱敏。

端点 /api/v1/mcp · 未鉴权返回 401 · 出口开通前所有调用都是 401

POST /api/v1/mcp JSON-RPC 2.0

$ curl -s https://agent.deeplycare.cn/api/v1/mcp \  -H "Authorization: Bearer $SHENLAN_API_KEY" \  -H "Content-Type: application/json" \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",       "params":{"name":"subject_lookup",                 "arguments":{"query":"陈","limit":1}}}'

200 OKapplication/jsonid 1

{  "jsonrpc": "2.0", "id": 1,  "result": {    "structuredContent": {      "total": 1,      "items": [{        "subject_ref": "客户#0117",        "patient_no": "PT-2026-000117",        "name": "陈**", "gender": "男", "age": "67",        "phone": "138****6012", "diagnosis": "2型糖尿病"      }],      "sensitivity": "standard"    },    "isError": false  }}

示例响应 · 由真实 MCP 代码生成，节选（省略 content 镜像与计量字段）

live 端点在线 · 未鉴权 401 工具清单 →

数据怎么流

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

你的 AIWorkBuddy / Claude / Cursor…

→

本机连接器接入 Key 只在这里

→

深岚服务端只存 Key 的 SHA-256 摘要

→

你的数据客户档案 · 指标序列 · 时间线

先说清楚它与 Skill 的区别

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

要读系统里的数据 → MCP

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

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

只整理手头材料 → Skill

材料在手上，不出网

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

接入三步

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

1
拿到接入 Key

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

联系开通（微信客服）→
2
在 AI 里装连接器

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

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

关于凭证

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

若调用持续返回 401：Key 无效 / 被轮换 / 或出口未启用 —— 请联系管理员确认出口状态（首屏示例下方也标了「未鉴权 401」）。联系开通 ↗

连接器配置（给开发者）

协议为 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`	额外返回结论文本	已单独同意的用途

让 AI 直接查档案，或把接口接进你的系统