IntakeQ MCP

@oktopeak/intakeq-mcp

由 Oktopeak 构建 — 为医疗机构提供 AI 转型与自动化服务

为医疗和法律行业企业提供数字化转型服务。 我们构建 AI 集成、工作流自动化和定制软件，让您的机构完全拥有这些成果——包括此连接器。→ 预约 30 分钟通话

用于 Claude 的 IntakeQ/PracticeQ MCP 连接器。通过模型上下文协议，让 Claude 能够访问您的 IntakeQ 排期、接诊表、治疗记录、发票和客户记录。

每次 PHI 读取和写入都会在本地记录，以符合 HIPAA §164.312(b)。

---

⚠️ 将此连接器连接到真实患者数据之前

在 PHI 通过此连接器传输之前，必须满足以下两项要求：

1. IntakeQ BAA — IntakeQ/PracticeQ 提供业务伙伴协议。 上线前，请在 IntakeQ 账户中签署该协议（Settings → HIPAA）。 这是 IntakeQ 的一项优势：BAA 可自行在线签署，且所有套餐均包含此协议。

2. 启用 ZDR 的 Anthropic 企业版 — 使用托管版 Claude + MCP 时，PHI 会发送给 Anthropic 进行推理。稳妥的说法是：禁用训练 + 企业版下的零数据保留 （Zero Data Retention）+ BAA——而不是数据本地化。“访问”（即模型处理了这些数据） 才是暴露风险所在，而不只是数据保留。 使用真实患者数据之前，请注册 Anthropic 企业版并申请 BAA。

此连接器的功能：

• 代理经过身份验证的 IntakeQ REST API 调用
• 将每次 PHI 读取和写入记录到 ~/.intakeq-mcp/audit.log（HIPAA §164.312(b)）
• 在本地加密存储您的 API 密钥（AES-256-GCM）——不存储 PHI 内容（审计条目仅包含访问轨迹标识符）

---

安装

npm install -g @oktopeak/intakeq-mcp

Claude Desktop 配置

{
  "mcpServers": {
    "intakeq": {
      "command": "intakeq-mcp"
    }
  }
}

身份验证

在 IntakeQ 中生成 API 密钥：Settings → Integrations → Developer API

然后告诉 Claude：

“将我的 IntakeQ API 密钥设置为 [your-key]”

或直接使用 MCP 工具：set_api_key

工具

工具	描述	R/W
set_api_key	存储 IntakeQ API 密钥	W
auth_status	验证 API 连接	R
clear_api_key	移除已存储的密钥	W
list_clients	搜索/列出客户	R
get_client	单个客户档案	R
list_practitioners	账户中的所有执业人员	R
list_services	账户中配置的服务	R
list_locations	账户中配置的地点	R
list_appointments	按客户/日期列出预约	R
get_appointment	单个预约	R
create_appointment	预约	W
update_appointment	重新安排/更新	W
list_intake_forms	已提交的接诊表	R
get_form	包含答案的完整表单	R
list_questionnaire_templates	可用的表单模板	R
send_intake_form	向客户发送表单	W
list_notes	治疗记录（IntakeQ API 中仅支持读取）	R
get_note	完整记录	R
list_invoices	客户发票	R
get_invoice	单张发票	R
list_files	客户文件元数据	R
audit_export	导出 HIPAA 审计追踪记录	R

提示： 调用 create_appointment 之前，先调用 list_practitioners、list_services 和 list_locations，获取该工具所需的有效 ID。

MCP 资源

资源 URI	描述
intakeq://compliance-notice	HIPAA 合规须知——BAA 要求及连接器记录的内容
intakeq://auth-status	实时身份验证状态（JSON）

HIPAA 审计日志

每次 PHI 读取和写入都会追加到 ~/.intakeq-mcp/audit.log（JSONL 格式）。 每条记录包含：时间戳、会话 ID、机器 IP、工具名称、参数（已清理）、 结果、执业人员 ID、客户端 ID 和结果数量。

随时导出审计日志：让 Claude 运行 audit_export。

审计日志采用故障开放策略。 如果无法写入日志文件（磁盘已满、权限不足）， 工具调用仍会完成，不会阻碍临床工作 — 失败信息会写入 stderr，并带有 [audit-log-failure] 前缀，便于监控/告警。如果 你需要确保 PHI 访问绝不会在没有日志记录的情况下发生，请在部署中监控进程的 stderr，查找该前缀。

HTTP 传输

默认情况下，服务以 stdio 模式运行。要将其作为 HTTP 服务运行（例如用于多用户或远程部署）：

MCP_API_KEY=your-secret TRANSPORT=http PORT=3000 intakeq-mcp

MCP 端点位于 /mcp，并由必需的 Bearer token（MCP_API_KEY）保护。如果未设置 MCP_API_KEY，服务将拒绝以 HTTP 模式启动，因为未经身份验证的端点会向任何能够访问该端口的人开放所有 PHI 工具。若要明确启用仅供本地开发使用的未验证端点，请设置 MCP_ALLOW_NO_AUTH=true — 切勿将其用于真实患者数据。

HTTP 传输本身不会终止 TLS。请将其部署在负责终止 HTTPS 的反向代理（nginx、Caddy、 你的云服务提供商的负载均衡器等）之后 — 否则，Bearer token 和所有传输中的 PHI 都会以明文形式通过网络发送。

每个 HTTP 会话都会在内存中保存自己的 API 密钥 — set_api_key 工具会将密钥限定在该会话中，绝不会将其写入共享磁盘文件。会话会在 24 小时后进行垃圾回收。

健康检查：GET /health → { "ok": true, "sessions": <count> }

环境变量

变量	默认值	描述
INTAKEQ_API_KEY	—	用于 CI / 无头模式的备用 API 密钥（建议优先使用 set_api_key 工具）
INTAKEQ_API_BASE	https://intakeq.com/api/v1	覆盖 IntakeQ API 基础 URL
TRANSPORT	stdio	传输模式：stdio 或 http
PORT	3000	HTTP 服务端口（仅限 HTTP 模式）
MCP_BASE_URL	http://127.0.0.1:3000	HTTP 启动日志中打印的基础 URL
MCP_API_KEY	—	用于保护 HTTP /mcp 端点的 Bearer token。HTTP 模式下必需，除非设置了 MCP_ALLOW_NO_AUTH=true
MCP_ALLOW_NO_AUTH	—	设置为 true，以明确允许 HTTP 模式不设置 MCP_API_KEY（仅限本地开发）

速率限制

IntakeQ 限制为约 10 次请求/分钟。连接器会在遇到 HTTP 429 时自动重试（最多 3 次，退避间隔为 10 s / 20 s / 30 s）。3 次失败后会显示错误，而不是无限期挂起。

尚未支持

• 保险理赔 / CMS-1500 写入
• Webhook
• 批量操作
• 创建治疗记录（IntakeQ API 不支持）

Oktopeak 的其他开源连接器

架构相同（加密密钥存储、审计日志、速率限制），平台不同：

• Clio MCP — Claude + Clio 业务管理（@oktopeak/clio-mcp）
• MyCase MCP — Claude + MyCase 法律业务管理（@oktopeak/mycase-mcp）
• Filevine MCP — Claude + Filevine 业务管理（@oktopeak/filevine-mcp）

支持本项目

此连接器免费提供，采用 MIT 许可，并由 Oktopeak 维护。今后也会一直如此——我们不接受捐赠。如果它为你节省了时间，以下做法才真正有帮助：

• 为这个仓库点 Star。 这确实是其他公司发现它的方式。
• 告诉另一家 使用 IntakeQ 的公司。
• 如果我们直接帮到了你，留下评价。
• 需要为你的公司部署、扩展或维护吗？商业支持——这正是资助免费工作的方式。
• 在整个诊所范围内部署： 将 Claude 和此连接器推广到整个诊所（Claude Cowork、多用户、安全审查）？请参阅 Firm Deployment。

关于我们

Oktopeak——为医疗和律所提供数字化转型服务。

我们是一支由 7 人组成的内部产品团队，为受监管行业构建 AI 解决方案：AI 集成、工作流自动化，以及由客户完全拥有的定制软件。我们维护四个开源 MCP 连接器——Clio、MyCase、Filevine 和 IntakeQ——并将它们部署到实际诊所中，使用权限范围明确的凭据、审计日志，以及围绕团队实际工作方式构建的工作流。

• 🌐 oktopeak.com
• 📅 预约 30 分钟通话
• ✉️ [email protected] — 欢迎提交安全问题报告
• 💼 LinkedIn