TMS para Claude: patrón de conexión por API o herramientas

API HTTP y MCP son capas distintas. Un adaptador puede traducir herramientas de lectura a endpoints, pero debe conservar autorización, auditoría y errores. Publica primero búsqueda, consulta de estados y explicación de datos.

No entregues secretos al modelo ni permitas herramientas genéricas como “ejecuta cualquier endpoint”. El servidor debe imponer allowlist y límites.

1. Define objetivo, actor, fuente de verdad y criterio de éxito.
2. Entrega datos mínimos y limita la herramienta a lectura o borrador.
3. Valida esquema, permisos, fecha y errores antes de mostrar el resultado.
4. Solicita aprobación humana para cualquier escritura y guarda auditoría.

Prompt base: “Con estos datos sintéticos y herramientas de solo lectura, explica el estado del viaje. Cita sourceIds y asOf, declara unknowns y no llames herramientas de escritura. Si no hay herramienta compatible, describe el adaptador necesario. Devuelve: hechos, supuestos, datos faltantes, siguiente acción y nivel de aprobación requerido.”

Un contrato mínimo puede devolver{ "answer": "...", "sourceIds": [], "asOf": "ISO-8601", "needsHumanApproval": true, "unknowns": [] }. Valida JSON en el gateway, registra correlación y rechaza campos desconocidos. El prompt no sustituye autenticación, autorización ni validación de negocio.

Prompt de prueba: “Analiza solo los registros incluidos. Separa hechos de supuestos. Si falta un dato, escribe DESCONOCIDO. Devuelve la salida con el contrato acordado y no ejecutes ninguna mutación.”