LetzAI

Servidor MCP de LetzAI

Dos servidores MCP para LetzAI, en un mismo repositorio.

server/	Alojado — lo que se ejecuta en https://mcp.letz.ai	Remoto, HTTP Streamable, multiusuario
stdio/	Local — la integración original de Claude Desktop	stdio, usuario único, tu propia clave de API

Servidor alojado (server/)

Es al que debes apuntar un cliente MCP. Añade https://mcp.letz.ai/mcp. Con OAuth habilitado, el cliente te envía a LetzAI para iniciar sesión y aprobar — sin necesidad de pegar ninguna clave. Un token de integración de LetzAI como token de portador también funciona, y siempre funcionará para scripts. Consulta server/docs/authentication.md.

Es un adaptador ligero y sin estado sobre la API pública de LetzAI: cada solicitud lleva el token propio del llamante, por lo que los permisos y créditos se resuelven para ese usuario u organización. El servidor no guarda ninguna clave propia. 24 herramientas cubren la generación de imágenes y vídeos, edición de imágenes, ampliación de escala, modelos entrenados y recursos del usuario.

Consulta server/README.md para la lista de herramientas y el desarrollo local, y server/docs/user-guide.md para la guía de configuración del usuario final.

Servidor local stdio (stdio/)

La integración original para Claude Desktop, que se ejecuta en tu propia máquina con tu clave de API en la configuración del cliente. Sin cambios aparte de su ruta. Prefiere el servidor alojado a menos que quieras específicamente un proceso local.

Despliegue

El servidor alojado se ejecuta en GKE (letzai-prod-services-gcp, espacio de nombres mcp), detrás del ingress mcp.letz.ai. Los manifiestos de Kubernetes viven en el repositorio infrastructure bajo gcp/workloads/mcp/.

• Dev — cada push a main que toque server/ compila y despliega en mcp.dev.letz.ai automáticamente.
• Prod — deliberado: ejecuta el flujo de trabajo Deploy MCP (prod), o haz push de una etiqueta v*.