Usar Dcision en Claude Code
Conecta Claude Code a Dcision con el servidor MCP y la skill de Dcision — lista, comprueba y ejecuta decisiones, escribe y valida esquemas de decisión, y usa la CLI y los SDKs desde tu agente.
Claude Code puede trabajar con Dcision de dos formas complementarias:
- El servidor MCP le da a Claude las herramientas: listar tus decisiones, leer su contrato, comprobar un estado, ejecutar una decisión, leer ejecuciones, listar plantillas y validar un esquema.
- La skill de Dcision le da a Claude el criterio: cómo funcionan las decisiones, cómo escribir un esquema de decisión válido, qué llamadas se facturan y qué errores evitar. También le enseña a Claude a usar la API con
curlcuando el servidor MCP no está conectado.
Instala ambos. Cada uno requiere un solo comando.
Antes de empezar
Crea una clave de API en app.dcision.io/api-keys y expórtala en la shell desde la que inicias Claude Code:
export DCISION_API_KEY="dcs_test_…"Empieza con una clave de test
Usa una clave dcs_test_… mientras experimentas. Las ejecuciones con una clave de test son reales y cuentan como uso, pero los destinos entregan con livemode: false, así tu CRM y tus workflows pueden distinguirlas. Cambia a una clave dcs_live_… cuando un agente ejecute decisiones para producción.
Conecta el servidor MCP
El servidor MCP de Dcision se ejecuta en https://api.dcision.io/mcp (Streamable HTTP) y autentica cada solicitud con tu clave de API como token Bearer.
claude mcp add --transport http dcision https://api.dcision.io/mcp \
--header "Authorization: Bearer $DCISION_API_KEY" \
--scope userLa shell expande $DCISION_API_KEY cuando ejecutas el comando, y Claude Code guarda el header en tu configuración de usuario (~/.claude.json) — fuera del repositorio.
Para compartir el servidor con tu equipo, haz commit de un .mcp.json en la raíz del repositorio en su lugar. Claude Code expande ${DCISION_API_KEY} a partir del entorno de cada persona, así que el archivo no contiene ningún secreto:
{
"mcpServers": {
"dcision": {
"type": "http",
"url": "https://api.dcision.io/mcp",
"headers": { "Authorization": "Bearer ${DCISION_API_KEY}" }
}
}
}No uses claude mcp add --scope project con el header de arriba: escribe la clave expandida en .mcp.json. Escribe el archivo a mano con el marcador ${DCISION_API_KEY}.
Comprueba la conexión con claude mcp list, o con /mcp dentro de una sesión: dcision debe aparecer como connected con catorce herramientas. Un 401 significa que la clave falta, está mal formada o fue revocada.
Instala la skill
La skill es un único archivo SKILL.md, publicado con esta documentación:
mkdir -p ~/.claude/skills/dcision
curl -fsSL https://docs.dcision.io/skills/dcision/SKILL.md -o ~/.claude/skills/dcision/SKILL.mdClaude Code la carga por sí solo cuando una solicitud menciona Dcision, el slug de una decisión, un esquema de decisión o enrutar y clasificar con Dcision. Ejecuta el mismo comando otra vez para actualizarla. La skill sigue el formato abierto Agent Skills, así que otros agentes que leen archivos SKILL.md también pueden usarla.
Pruébalo
Pregunta en lenguaje natural — Claude elige las herramientas:
- "¿Qué decisiones de Dcision tengo y cuáles están desplegadas?"
- "Muéstrame qué espera
lead-qualificationy un estado de ejemplo." - "Ejecuta
support-routingsobre este ticket y dime la ruta y la acción." - "Comprueba si estos cinco payloads son estados válidos para
lead-qualification— no los ejecutes." - "Escribe un esquema de decisión que clasifique los e-mails entrantes en facturación, técnico y ventas, escale los urgentes, y valídalo."
- "Parte de la plantilla
ticket-triagey adáptala a nuestras categorías." - "¿Cuántas decisiones hemos usado este mes y cuántas ejecuciones fallidas tuvo
spam-detectionhoy?"
Crear, editar y desplegar decisiones sigue en la app: Claude escribe y valida el esquema, tú lo pegas en el editor de la decisión, lo pruebas en el Playground y lo despliegas.
Herramientas
| Herramienta | Se factura | Qué hace |
|---|---|---|
get_account | No | El workspace de la clave, la clave, el plan y el uso de este período — como GET /v1/me. |
list_decisions | No | Las decisiones del workspace: slug, nombre, estado y versión activa — como GET /v1/decisions. |
get_decision | No | El contrato de una decisión: esquema del estado, preguntas y opciones, acciones y un estado de ejemplo. |
check_state | No | Comprueba un estado contra el esquema del estado de una decisión sin ejecutarla. |
run_decision | Sí | Ejecuta la versión activa sobre un estado — como POST /v1/decisions/{slug}. |
list_executions | No | Ejecuciones recientes con respuestas, acción y métricas — nunca las entradas. |
list_templates | No | Las plantillas integradas. |
get_template | No | El esquema de decisión completo de una plantilla. |
validate_schema | No | Valida un esquema de decisión sin conexión, con las reglas del editor. |
create_decision | No | Crea una decisión en borrador a partir de un esquema. |
update_decision | No | Edita el esquema, el nombre o la descripción del borrador. |
deploy_decision | No | Publica el borrador: las siguientes ejecuciones lo usan. |
list_workspaces | No | Modo socio: los subespacios de tus clientes. |
upsert_workspace | No | Modo socio: crea o renombra el subespacio de un cliente. |
run_decision es la única herramienta con costo. Ella y las tres herramientas de escritura no se anotan como de solo lectura, y deploy_decision se anota como destructiva. Claude Code pregunta antes de llamar a una herramienta MCP hasta que la permitas: permite libremente las herramientas de solo lectura y deja run_decision y deploy_decision detrás de la confirmación. Las entradas, salidas y errores de cada herramienta están en la referencia de MCP.
La CLI y los SDKs desde Claude Code
Claude Code también puede manejar la CLI en una terminal — práctico para esquemas guardados en tu repositorio:
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 --jsonLa CLI y los SDKs todavía no están publicados en npm ni en PyPI: compílalos desde un checkout del repositorio de Dcision (pnpm --filter "@dcision/cli..." build). La skill le indica a Claude que no instale paquetes con estos nombres desde un registro.
Cuando Claude escriba código de aplicación que llame a Dcision, oriéntalo al SDK de TypeScript o al SDK de Python — dcision.decide("lead-qualification", state) con reintentos seguros — o a HTTPS simple como en Ejecutar una decisión.
Sin el servidor MCP
La skill funciona sin el servidor MCP: con DCISION_API_KEY en el entorno, Claude llama a la API REST con curl, y al mismo servidor MCP por HTTP simple para las herramientas que REST no tiene — validate_schema, check_state y las plantillas. Consulta Llamar al servidor con curl.
Seguridad
- Las claves se quedan fuera del repositorio. Usa el marcador
${DCISION_API_KEY}en.mcp.json, nunca la clave en sí, y no pegues claves en el chat. - Una clave puede hacer lo que puede hacer la API en su workspace: leer sus decisiones y ejecuciones y ejecutar decisiones. No puede crear, editar ni desplegar decisiones, ni gestionar miembros o facturación — eso requiere un usuario con sesión iniciada en la app.
- Las ejecuciones se facturan.
run_decisioncuenta como cualquier llamada a la API: una decisión por ejecución, sin importar cuántas preguntas. Pide a Claude una muestra antes de que ejecute un dataset completo, y vigila el uso conget_account. - Las ejecuciones nunca devuelven las entradas.
list_executions, comoGET /v1/executions, no devuelve los estados que enviaste. - Revoca una clave en API Keys si se filtra; la API y el servidor MCP rechazan una clave revocada.
Otros clientes
Cursor, VS Code, Claude Desktop, Codex y Gemini CLI se conectan al mismo servidor — consulta Servidor MCP.
Integra el editor
Permite que tus clientes creen, editen, prueben y publiquen sus decisiones dentro de tu app con sesiones de embed desde tu backend, el script @dcision/embed, permisos y eventos.
Servidor MCP
Servidor MCP de Dcision en https://api.dcision.io/mcp — autenticación, las catorce herramientas con entradas y salidas, errores y configuración para Claude Code, Cursor, VS Code, Claude Desktop, Codex, Gemini CLI y curl.