Solución de problemas

401 — falta credencial: Authorization: Bearer <token> o header x-api-key

El servidor respondió, pero la llamada llegó sin credencial.

• Claude Code: el header no quedó guardado. Revisa claude mcp list y vuelve a agregar el servidor con --header "x-api-key: …".
• claude.ai: el conector no está conectado o la sesión venció. Entra a Settings → Connectors, dale Connect y vuelve a autorizar.

401 en las consultas de link, pero los workfloos sí corren (o al revés)

Estás mandando la api-key de la otra herramienta. Las keys de kiban son por herramienta: la de workfloo no autentica en link ni viceversa. Registra el MCP una vez por herramienta, o conéctate con login desde claude.ai y olvídate de las keys — ver Conectar Claude Code.

401 al ejecutar en sandbox, pero producción funciona

Estás usando una api-key de producción para una llamada en sandbox. Agrega el header x-api-key-sandbox con tu key de sandbox (cómo).

No aparecen las herramientas en el chat

1. Confirma que el servidor está conectado (/mcp en Claude Code; Settings → Connectors en claude.ai).
2. Abre una conversación nueva: las herramientas se cargan al iniciar el chat.
3. Comprueba la URL: debe terminar en /mcp.

"rekon requiere Bearer OAuth (login de kiban); no disponible con api-key"

El módulo de pagos solo funciona con la conexión por login. Conéctalo desde claude.ai.

El asistente no encuentra el workfloo que quiero correr

workfloo_list_definitions solo devuelve los workfloos ejecutables por tu usuario en el espacio conectado. Si falta uno, casi siempre es porque:

• está en otro espacio — reconecta el conector y elige ese espacio;
• tu usuario no tiene el derecho de ejecución;
• no está publicado.

En sandbox falla con que falta el escenario

El workfloo exige escenario. Pide workfloo_list_definitions con sandbox: true, toma un id de sceneries y pásalo como scenario_id. Si la lista viene vacía, crea el escenario en la consola.

El NIP no se valida

workfloo_nip_validate falla si el código es incorrecto o si ya expiró. Pide el código vigente y reintenta; si la persona no lo recibió, usa workfloo_nip_resend (con country_code + phone_number si hay que cambiar de número).

workfloo_get_file devuelve tooLarge

Es el comportamiento esperado para archivos de más de ~100 KB (por ejemplo un PDF de reporte). Abre el downloadUrl que viene en la respuesta: descarga el archivo desde la consola con tu sesión.

Un servicio de link no aparece o devuelve error de política

Buró, círculo de crédito, TransUnion y los subservicios del SAT que piden la CIEC están bloqueados a propósito. Ver Seguridad y límites. Úsalos desde la consola o la API.

El asistente ejecutó en producción y yo quería sandbox

Producción es el default. Al empezar la conversación pide explícitamente sandbox y revisa el parámetro sandbox en cada llamada antes de aprobarla. Una ejecución en producción ya cobrada no se revierte; si quedó a medias, puedes cancelarla desde el histórico de la consola.