Ejecutar en sandbox
Cómo ensayar desde el chat sin costo ni efectos reales.
Todas las herramientas del MCP corren en producción por defecto. Sandbox es opt-in: hay que pedirlo.
Cómo se activa
Dilo en el chat: "corre esto en sandbox", "usa sandbox para todo en esta conversación". El asistente manda sandbox: true en cada llamada.
Revisa la llamada antes de aprobarla: si el parámetro sandbox no aparece o va en false, la ejecución es real.
Default = producciónUn chat nuevo no recuerda que la conversación anterior era de pruebas. Si vas a ensayar, dilo al empezar.
Credencial de sandbox
- En claude.ai (login): no hay nada extra que configurar, tu sesión sirve para los dos modos.
- En Claude Code (api-key): las keys de kiban son por modo. Necesitas mandar también
x-api-key-sandboxal agregar el servidor; si no, las llamadas en sandbox usan la key de producción y el backend responde401.
Escenarios de workfloo
En sandbox, un workfloo se ejecuta contra un escenario de prueba, igual que desde la consola.
workfloo_list_definitionsconsandbox: truedevuelve, por cada workfloo, su lista desceneries(id+name) y si el escenario es obligatorio.workfloo_executerecibe ese id enscenario_id.
Si el workfloo exige escenario y no le pasas uno, la ejecución falla. Si todavía no hay escenarios creados, créalos primero en la consola.
Casos de prueba de link
Para consultas de link, link_list_test_cases devuelve los testCaseId disponibles de un servicio/subservicio. Pásale ese id a link_execute junto con sandbox: true para obtener la respuesta simulada de ese caso.
Qué se simula
| Paso | En sandbox |
|---|---|
NIP (nip_send, nip_resend) | No se manda SMS real. |
Documentos (submit_document) | El procesamiento se simula: no hay validación ni almacenamiento real. |
| Consultas de link | Devuelven la respuesta del caso de prueba, sin pegarle a la fuente externa. |
| Correo, SMS y WhatsApp | Se simulan. En producción se envían de verdad. |
| Costo | Sin costo. |
Updated about 16 hours ago

