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
curlquando 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 userO 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:
{
"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.mdO 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-qualificationespera e um estado de exemplo." - "Rode
support-routingneste 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-triagee adapte-o às nossas categorias." - "Quantas decisões usamos este mês, e quantas execuções com falha
spam-detectionteve 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
| Ferramenta | Cobrada | O que faz |
|---|---|---|
get_account | Não | O workspace da chave, a chave, o plano e o uso deste período — como GET /v1/me. |
list_decisions | Não | As decisões do workspace: slug, nome, status e versão ativa — como GET /v1/decisions. |
get_decision | Não | O contrato de uma decisão: state schema, perguntas e opções, ações e um estado de exemplo. |
check_state | Não | Confere um estado contra o state schema de uma decisão sem rodá-la. |
run_decision | Sim | Roda a versão ativa sobre um estado — como POST /v1/decisions/{slug}. |
list_executions | Não | Execuções recentes com respostas, ação e métricas — nunca as entradas. |
list_templates | Não | Os templates embutidos. |
get_template | Não | O decision schema completo de um template. |
validate_schema | Não | Valida um decision schema offline, com as regras do editor. |
create_decision | Não | Cria uma decisão em rascunho a partir de um schema. |
update_decision | Não | Edita o schema do rascunho, o nome ou a descrição. |
deploy_decision | Não | Publica o rascunho: as próximas execuções o usam. |
list_workspaces | Não | Modo parceiro: os sub-workspaces dos seus clientes. |
upsert_workspace | Não | Modo 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 --jsonA 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_decisionconta 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 comget_account. - As execuções nunca devolvem as entradas.
list_executions, comoGET /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.
Incorporar o editor
Deixe os seus clientes criarem, editarem, testarem e publicarem as decisões deles dentro do seu app — sessões de embed pelo seu backend, o script @dcision/embed, permissões e eventos.
Servidor MCP
O servidor MCP da Dcision em https://api.dcision.io/mcp — autenticação, as catorze ferramentas com entradas e saídas, erros e configuração para Claude Code, Cursor, VS Code, Claude Desktop, Codex, Gemini CLI e curl.