Use a Dcision no Claude Code

Conecte o Claude Code à Dcision com o servidor MCP e a skill da Dcision — liste, cheque e rode decisões, escreva e valide decision schemas, e use a CLI e os SDKs a partir do seu agente.

O Claude Code pode trabalhar com a Dcision de duas formas complementares:

  • O servidor MCP dá as ferramentas ao Claude: listar as suas decisões, ler o contrato delas, checar um estado, rodar uma decisão, ler execuções, listar templates e validar um schema.
  • A skill da Dcision dá o discernimento ao Claude: como as decisões funcionam, como escrever um decision schema válido, quais chamadas são cobradas e as armadilhas a evitar. Ela também ensina o Claude a usar a API com curl quando o servidor MCP não está conectado.

Instale os dois. Cada um leva um comando.

Antes de começar

Crie uma API key em app.dcision.io/api-keys e exporte-a no shell a partir do qual você inicia o Claude Code:

export DCISION_API_KEY="dcs_test_…"

Comece com uma chave de teste

Use uma chave dcs_test_… enquanto experimenta. As execuções com uma chave de teste são reais e contam como uso, mas os destinos entregam com livemode: false, para que o seu CRM e os seus workflows consigam distingui-las. Troque para uma chave dcs_live_… quando um agente rodar decisões em produção.

Conecte o servidor MCP

O servidor MCP da Dcision roda em https://api.dcision.io/mcp (Streamable HTTP) e autentica cada requisição com a sua API key como token Bearer.

claude mcp add --transport http dcision https://api.dcision.io/mcp \
  --header "Authorization: Bearer $DCISION_API_KEY" \
  --scope user

O shell expande $DCISION_API_KEY quando você roda o comando, e o Claude Code guarda o header na sua configuração de usuário (~/.claude.json) — fora do repositório.

Para compartilhar o servidor com o seu time, faça commit de um .mcp.json na raiz do repositório. O Claude Code expande ${DCISION_API_KEY} a partir do ambiente de cada pessoa, então o arquivo não contém nenhum segredo:

.mcp.json
{
  "mcpServers": {
    "dcision": {
      "type": "http",
      "url": "https://api.dcision.io/mcp",
      "headers": { "Authorization": "Bearer ${DCISION_API_KEY}" }
    }
  }
}

Não use claude mcp add --scope project com o header acima: ele grava a chave expandida no .mcp.json. Escreva o arquivo à mão com o placeholder ${DCISION_API_KEY}.

Confira a conexão com claude mcp list, ou com /mcp dentro de uma sessão: dcision deve aparecer como connected com catorze ferramentas. Um 401 significa que a chave está ausente, malformada ou revogada.

Instale a skill

A skill é um único arquivo SKILL.md, publicado junto com esta documentação:

mkdir -p ~/.claude/skills/dcision
curl -fsSL https://docs.dcision.io/skills/dcision/SKILL.md -o ~/.claude/skills/dcision/SKILL.md

O Claude Code a carrega sozinho quando um pedido menciona a Dcision, o slug de uma decisão, um decision schema ou roteamento e classificação com a Dcision. Rode o mesmo comando de novo para atualizá-la. A skill segue o formato aberto Agent Skills, então outros agentes que leem arquivos SKILL.md também podem usá-la.

Experimente

Peça em linguagem natural — o Claude escolhe as ferramentas:

  • "Quais decisões da Dcision eu tenho, e quais estão publicadas?"
  • "Mostre o que lead-qualification espera e um estado de exemplo."
  • "Rode support-routing neste ticket e me diga a rota e a ação."
  • "Confira se estes cinco payloads são estados válidos para lead-qualification — não os rode."
  • "Escreva um decision schema que classifique e-mails recebidos em cobrança, técnico e vendas, escale os urgentes, e valide-o."
  • "Comece pelo template ticket-triage e adapte-o às nossas categorias."
  • "Quantas decisões usamos este mês, e quantas execuções com falha spam-detection teve hoje?"

Criar, editar e publicar decisões continua no app: o Claude escreve e valida o schema, você o cola no editor da decisão, testa no Playground e publica.

Ferramentas

FerramentaCobradaO que faz
get_accountNãoO workspace da chave, a chave, o plano e o uso deste período — como GET /v1/me.
list_decisionsNãoAs decisões do workspace: slug, nome, status e versão ativa — como GET /v1/decisions.
get_decisionNãoO contrato de uma decisão: state schema, perguntas e opções, ações e um estado de exemplo.
check_stateNãoConfere um estado contra o state schema de uma decisão sem rodá-la.
run_decisionSimRoda a versão ativa sobre um estado — como POST /v1/decisions/{slug}.
list_executionsNãoExecuções recentes com respostas, ação e métricas — nunca as entradas.
list_templatesNãoOs templates embutidos.
get_templateNãoO decision schema completo de um template.
validate_schemaNãoValida um decision schema offline, com as regras do editor.
create_decisionNãoCria uma decisão em rascunho a partir de um schema.
update_decisionNãoEdita o schema do rascunho, o nome ou a descrição.
deploy_decisionNãoPublica o rascunho: as próximas execuções o usam.
list_workspacesNãoModo parceiro: os sub-workspaces dos seus clientes.
upsert_workspaceNãoModo parceiro: cria ou renomeia o sub-workspace de um cliente.

run_decision é a única ferramenta com custo. Ela e as três ferramentas de escrita não são anotadas como somente leitura, e deploy_decision é anotada como destrutiva. O Claude Code pede permissão antes de chamar uma ferramenta MCP até você liberá-la: libere à vontade as ferramentas somente leitura e mantenha run_decision e deploy_decision atrás da confirmação. As entradas, saídas e erros de cada ferramenta estão na referência do MCP.

A CLI e os SDKs a partir do Claude Code

O Claude Code também pode usar a CLI num terminal — prático para schemas mantidos no seu repositório:

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

A CLI e os SDKs ainda não estão publicados no npm nem no PyPI: compile-os a partir de um checkout do repositório da Dcision (pnpm --filter "@dcision/cli..." build). A skill diz ao Claude para não instalar pacotes com esses nomes de um registry.

Quando o Claude escrever código de aplicação que chama a Dcision, aponte-o para o SDK TypeScript ou o SDK Python — dcision.decide("lead-qualification", state) com retries seguros — ou para HTTPS puro, como em Executar uma decisão.

Sem o servidor MCP

A skill funciona sem o servidor MCP: com DCISION_API_KEY no ambiente, o Claude chama a API REST com curl, e o mesmo servidor MCP via HTTP puro para as ferramentas que a REST não tem — validate_schema, check_state e os templates. Veja Chame o servidor com curl.

Segurança

  • As chaves ficam fora do repositório. Use o placeholder ${DCISION_API_KEY} no .mcp.json, nunca a chave em si, e não cole chaves no chat.
  • Uma chave pode fazer o que a API pode fazer no workspace dela: ler as decisões e execuções e rodar decisões. Ela não pode criar, editar nem publicar decisões, nem gerenciar membros ou cobrança — isso exige um usuário logado no app.
  • As execuções são cobradas. run_decision conta como qualquer chamada à API: uma decisão por execução, não importa quantas perguntas. Peça ao Claude uma amostra antes de rodar um dataset inteiro, e acompanhe o uso com get_account.
  • As execuções nunca devolvem as entradas. list_executions, como GET /v1/executions, não devolve os estados que você enviou.
  • Revogue uma chave em API Keys se ela vazar; a API e o servidor MCP recusam uma chave revogada.

Outros clientes

Cursor, VS Code, Claude Desktop, Codex e Gemini CLI se conectam ao mesmo servidor — veja Servidor MCP.

Nesta página