在 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},因此该文件不包含任何机密:

.mcp.json
{
  "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 --json

CLI 和 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 服务器。

本页内容