在 Claude Code 中使用 Dcision
通过 MCP 服务器和 Dcision skill 把 Claude Code 连接到 Dcision——列出、检查和运行决策,编写并校验决策 schema,并在智能体中使用 CLI 和 SDK。
Claude Code 可以通过两种互补的方式使用 Dcision:
- MCP 服务器为 Claude 提供工具:列出你的决策、读取它们的契约、检查状态、运行决策、读取执行记录、列出模板和校验 schema。
- Dcision skill 为 Claude 提供判断力:决策如何运作、如何编写有效的决策 schema、哪些调用会计费,以及需要避免的陷阱。它还会教 Claude 在 MCP 服务器未连接时用
curl调用 API。
两者都请安装。每个只需一条命令。
开始之前
在 app.dcision.io/api-keys 创建一个 API 密钥,并在你启动 Claude Code 的 shell 中导出它:
export DCISION_API_KEY="dcs_test_…"从 test 密钥开始
在实验阶段请使用 dcs_test_… 密钥。使用 test 密钥的运行是真实的,也会计入用量,但目的地会以 livemode: false 投递,这样你的 CRM 和工作流就能把它们区分开。当智能体为生产环境运行决策时,再切换到 dcs_live_… 密钥。
连接 MCP 服务器
Dcision MCP 服务器运行在 https://api.dcision.io/mcp(Streamable HTTP),并以 Bearer token 的形式用你的 API 密钥对每个请求进行身份验证。
claude mcp add --transport http dcision https://api.dcision.io/mcp \
--header "Authorization: Bearer $DCISION_API_KEY" \
--scope user运行命令时,shell 会展开 $DCISION_API_KEY,Claude Code 会把请求头保存在你的用户配置(~/.claude.json)中——位于代码仓库之外。
要与团队共享该服务器,请改为在仓库根目录提交一个 .mcp.json。Claude Code 会从每个人的环境中展开 ${DCISION_API_KEY},因此该文件不包含任何机密:
{
"mcpServers": {
"dcision": {
"type": "http",
"url": "https://api.dcision.io/mcp",
"headers": { "Authorization": "Bearer ${DCISION_API_KEY}" }
}
}
}不要配合上面的请求头使用 claude mcp add --scope project:它会把展开后的密钥写入 .mcp.json。请用 ${DCISION_API_KEY} 占位符手动编写该文件。
使用 claude mcp list 或在会话中使用 /mcp 检查连接:dcision 应显示为 connected,并带有十四个工具。401 表示密钥缺失、格式错误或已被撤销。
安装 skill
该 skill 是一个单独的 SKILL.md 文件,随本文档一起发布:
mkdir -p ~/.claude/skills/dcision
curl -fsSL https://docs.dcision.io/skills/dcision/SKILL.md -o ~/.claude/skills/dcision/SKILL.md当请求中提到 Dcision、决策 slug、决策 schema 或用 Dcision 进行路由和分类时,Claude Code 会自动加载它。再次运行同一条命令即可更新。该 skill 遵循开放的 Agent Skills 格式,因此其他能读取 SKILL.md 文件的智能体也可以使用它。
试一试
用自然语言提问——Claude 会自己选择工具:
- “我有哪些 Dcision 决策,哪些已经部署了?”
- “告诉我
lead-qualification需要什么输入,并给一个示例状态。” - “用这个工单运行
support-routing,告诉我路由和行动。” - “检查这五个 payload 对
lead-qualification来说是否是有效的状态——不要运行它们。” - “编写一个决策 schema,把入站邮件分类为账单、技术和销售,对紧急邮件进行升级处理,并校验它。”
- “从
ticket-triage模板开始,把它改成适合我们的类别。” - “我们这个月用了多少次决策?
spam-detection今天有多少次运行失败?”
创建、编辑和部署决策仍在应用中完成:Claude 编写并校验 schema,你把它粘贴到决策的编辑器中,在 Playground 中测试并部署。
工具
| 工具 | 计费 | 作用 |
|---|---|---|
get_account | 否 | 密钥所属的工作区、密钥本身、套餐和本周期的用量——类似 GET /v1/me。 |
list_decisions | 否 | 工作区的决策:slug、名称、状态和当前生效版本——类似 GET /v1/decisions。 |
get_decision | 否 | 某个决策的契约:状态 schema、问题和选项、行动以及示例状态。 |
check_state | 否 | 根据决策的状态 schema 检查一个状态,但不运行它。 |
run_decision | 是 | 在一个状态上运行当前生效版本——类似 POST /v1/decisions/{slug}。 |
list_executions | 否 | 最近的运行,包含回答、行动和指标——从不包含输入。 |
list_templates | 否 | 内置模板。 |
get_template | 否 | 某个模板的完整决策 schema。 |
validate_schema | 否 | 使用编辑器的规则离线校验决策 schema。 |
create_decision | 否 | 根据 schema 创建一个草稿决策。 |
update_decision | 否 | 编辑草稿的 schema、名称或描述。 |
deploy_decision | 否 | 发布草稿:之后的运行都会使用它。 |
list_workspaces | 否 | 合作伙伴模式:你的客户的子工作区。 |
upsert_workspace | 否 | 合作伙伴模式:创建客户的子工作区或为其重命名。 |
run_decision 是唯一有成本的工具。它和三个写入工具没有被标注为只读,deploy_decision 被标注为破坏性操作。在你允许之前,Claude Code 每次调用 MCP 工具前都会询问:可以放心允许只读工具,而让 run_decision 和 deploy_decision 保留确认提示。每个工具的输入、输出和错误请参见 MCP 参考。
在 Claude Code 中使用 CLI 和 SDK
Claude Code 也可以在终端中驱动 CLI——对于保存在你仓库中的 schema 很方便:
dcision validate decision.json
dcision check-state decision.json --state-file samples/lead-1.json
dcision decide lead-qualification --state-file samples/lead-1.json --jsonCLI 和 SDK 尚未发布到 npm 或 PyPI:请从 Dcision 仓库的检出副本构建它们(pnpm --filter "@dcision/cli..." build)。该 skill 会告诉 Claude 不要从注册表安装同名的包。
当 Claude 编写调用 Dcision 的应用代码时,请引导它使用 TypeScript SDK 或 Python SDK——带安全重试的 dcision.decide("lead-qualification", state)——或者像运行决策中那样直接使用 HTTPS。
不使用 MCP 服务器
该 skill 不依赖 MCP 服务器也能工作:只要环境中有 DCISION_API_KEY,Claude 就会用 curl 调用 REST API,并通过普通 HTTP 调用同一个 MCP 服务器来使用 REST 没有的工具——validate_schema、check_state 和模板。参见用 curl 调用服务器。
安全
- 密钥不进入代码仓库。 在
.mcp.json中使用${DCISION_API_KEY}占位符,绝不写入密钥本身,也不要把密钥粘贴到聊天中。 - 密钥能做 API 能做的事,范围是其所属工作区:读取决策和执行记录,以及运行决策。它不能创建、编辑或部署决策,也不能管理成员或计费——这些需要在应用中登录的用户。
- 运行会计费。
run_decision与任何 API 调用一样计费:每次运行计一次决策,无论有多少个问题。在 Claude 运行整个数据集之前,先让它跑一个样本,并用get_account关注用量。 - 执行记录从不返回输入。
list_executions与GET /v1/executions一样,不会返回你发送的状态。 - 如果密钥泄露,请在 API 密钥中撤销它;API 和 MCP 服务器都会拒绝已撤销的密钥。
其他客户端
Cursor、VS Code、Claude Desktop、Codex 和 Gemini CLI 都可以连接同一个服务器——参见 MCP 服务器。