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ón

Un 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-sandbox al agregar el servidor; si no, las llamadas en sandbox usan la key de producción y el backend responde 401.

Escenarios de workfloo

En sandbox, un workfloo se ejecuta contra un escenario de prueba, igual que desde la consola.

  1. workfloo_list_definitions con sandbox: true devuelve, por cada workfloo, su lista de sceneries (id + name) y si el escenario es obligatorio.
  2. workfloo_execute recibe ese id en scenario_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

PasoEn 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 linkDevuelven la respuesta del caso de prueba, sin pegarle a la fuente externa.
Correo, SMS y WhatsAppSe simulan. En producción se envían de verdad.
CostoSin costo.

Did this page help you?