TengineAI
Ejecuta herramientas MCP en producción sin gestionar tu propio servidor: reintentos, permisos y observabilidad integrados.
Documentación
¿Qué es TengineAI?
TengineAI es una infraestructura de ejecución para llamadas a herramientas de IA.
Proporciona un servidor MCP remoto que expone tus APIs HTTP como herramientas para los entornos de ejecución de IA. Tú defines qué endpoints puede llamar el modelo. TengineAI gestiona la autenticación, la ejecución, la inyección de identidad y el control de uso, y devuelve resultados estructurados al modelo.
TengineAI no proporciona integraciones de terceros preconstruidas. En su lugar, defines las APIs HTTP que tu modelo puede llamar, y TengineAI se encarga del resto. Piénsalo como la capa de ejecución entre el modelo y tus servicios.
TengineAI es a las herramientas MCP lo que API Gateway es a las APIs REST.
TengineAI funciona con cualquier SDK o cliente de modelo compatible con MCP. Anthropic se utiliza en toda la documentación como implementación de referencia porque es la más utilizada y probada en la actualidad.
¿Para quién es esto?
TengineAI está diseñado para desarrolladores que crean productos impulsados por IA y necesitan que las llamadas a herramientas se ejecuten de forma segura contra APIs reales.
TengineAI es la opción adecuada si:
- Estás construyendo un SaaS de IA multiinquilino y necesitas que las llamadas a herramientas se atribuyan a usuarios individuales
- Quieres exponer tus propias APIs internas o externas a un modelo sin construir herramientas MCP desde cero
- Necesitas control centralizado sobre qué herramientas están disponibles, con la capacidad de habilitarlas/deshabilitarlas sin volver a implementar
- Quieres visibilidad de uso para las llamadas a herramientas en tu proyecto
- Quieres que las solicitudes salientes a tus APIs estén autenticadas (firmadas con HMAC o token de portador) y lleven contexto de identidad de miembro
TengineAI no es la opción adecuada si:
- Solo necesitas que el modelo llame a un único endpoint estático: una llamada directa a la API en tu código es más simple
- Quieres ejecutar herramientas completamente sin conexión, sin acceso a red externa
- Necesitas que el modelo ejecute código arbitrario o gestione infraestructura: TengineAI es ejecución de herramientas, no un runtime de agentes
Cómo funciona TengineAI
┌─────────────┐ ┌──────────────────┐ ┌─────────────────────┐
│ │ │ │ │ │
│ MCP Client │────────▶│ TengineAI │────────▶│ Your APIs │
│ (Runtime) │ │ (Execution Layer)│ │ (CRM, billing, │
│ │◀────────│ │◀────────│ internal services, │
└─────────────┘ └──────────────────┘ │ public APIs) │
└─────────────────────┘
Flujo:
- Un cliente MCP (Claude Desktop, Cursor o SDK programático) se conecta a TengineAI
- El cliente se autentica usando una clave de API o un token de sesión con ámbito de usuario
- TengineAI devuelve las herramientas habilitadas del proyecto: solo las que definiste
- El modelo selecciona una herramienta para ejecutar
- TengineAI renderiza la plantilla de solicitud, inyecta la identidad del miembro, firma la solicitud (si está configurado) y la reenvía a tu API
- Tu API ejecuta la solicitud y devuelve una respuesta
- TengineAI devuelve la respuesta al modelo
- El modelo recibe el resultado y continúa la ejecución
Conceptos principales
TengineAI utiliza cinco primitivas:
Proyectos
Entornos de ejecución aislados. Cada proyecto tiene sus propias claves de API, integraciones y herramientas habilitadas. Un token de un proyecto no puede acceder a las herramientas o configuración de otro proyecto.
Herramientas
Endpoints HTTP que registras con TengineAI y que el modelo puede llamar. Defines el nombre, la descripción, el método HTTP, la plantilla de URL, el esquema de entrada y la estrategia de autenticación. TengineAI se encarga de la ejecución.
Las herramientas son opcionales por proyecto. El modelo solo ve lo que habilitas.
Integraciones
Conexiones de clientes MCP. Una integración define cómo un runtime de modelo (Claude Desktop, Cursor, SDK personalizado) se autentica con TengineAI.
Claves de API
Credenciales con ámbito de proyecto (tengine_...). Autentican solicitudes desde tu aplicación a TengineAI. Úsalas para flujos de trabajo servidor a servidor y pipelines de automatización donde todas las llamadas comparten una identidad de proyecto única.
Sesiones con ámbito de usuario (tokens de sesión de miembro)
JWTs de corta duración (tng_mst_..., TTL de 15 minutos) que limitan una sesión MCP a un usuario final específico. Tu backend los genera en el lado del servidor presentando un member_assertion firmado criptográficamente. TengineAI lo verifica y emite el token de sesión.
Usa tokens de sesión de miembro cuando cada usuario final deba tener sus llamadas a herramientas atribuidas individualmente.
Garantías de fiabilidad
- Los reintentos no duplicarán escrituras — El manejo seguro de reintentos evita efectos secundarios duplicados cuando el modelo o SDK reintenta
- Las llamadas a herramientas se registran — Cada invocación tiene un ID de ejecución y aparece en el historial de ejecuciones
- Las claves se revocan en todas las sesiones — La revocación tiene efecto inmediato en todas las sesiones activas
Consulta Modelo de ejecución para obtener detalles sobre reintentos, IDs de solicitud y comportamiento de revocación de claves.
Modos de autenticación
TengineAI admite dos modos de autenticación de cliente:
| Modo | Token | Caso de uso |
|---|---|---|
| Clave de API | tengine_... | Flujos de trabajo, automatización, servidor a servidor |
| Con ámbito de usuario | tng_mst_... | Aplicaciones multiinquilino, ejecución de herramientas por usuario |
Ambos modos pasan la credencial como authorization_token en la configuración mcp_servers del SDK de Anthropic.
Consulta Claves de API y Sesiones con ámbito de usuario para obtener todos los detalles.
Lo que TengineAI no es
TengineAI no es:
- Un catálogo de integraciones preconstruidas (sin conector de Gmail, sin conector de Reddit, sin flujos OAuth de SaaS)
- Un framework de agentes
- Un servicio de alojamiento de modelos
- Un orquestador de flujos de trabajo
- Un sistema de gestión de prompts
Es infraestructura de ejecución. Tú defines las herramientas. El modelo decide qué llamar. TengineAI lo ejecuta de forma segura.
El modelo solo puede llamar a herramientas que hayas registrado y habilitado explícitamente. TengineAI no obtiene URLs arbitrarias: cada endpoint al que el modelo puede acceder fue configurado por ti.
Próximos pasos
- Comienza en 5 minutos – Registra una herramienta y ejecuta tu primera llamada a API invocada por el modelo
- Descripción general de la arquitectura – Comprende el flujo de ejecución completo
- Modelo de ejecución – Reintentos, IDs de solicitud, revocación de claves
- Claves de API – Autenticación con ámbito de proyecto
- Sesiones con ámbito de usuario – Tokens de sesión por usuario para aplicaciones multiinquilino
- Herramientas personalizadas – Cómo definir y configurar herramientas