LetzAI

MCP do LetzAI

Dois servidores MCP para LetzAI, em um único repositório.

server/	Hospedado — o que roda em https://mcp.letz.ai	Remoto, HTTP Streamable, multiusuário
stdio/	Local — a integração original do Claude Desktop	stdio, usuário único, sua própria chave de API

Servidor hospedado (server/)

É o que você deve apontar para um cliente MCP. Adicione https://mcp.letz.ai/mcp. Com OAuth habilitado, o cliente envia você para o LetzAI para fazer login e aprovar — sem necessidade de colar chave. Um token de integração do LetzAI como token bearer também funciona, e sempre funcionará para scripts. Consulte server/docs/authentication.md.

É um adaptador fino e sem estado sobre a API pública do LetzAI: cada requisição carrega o token do próprio chamador, então permissões e créditos são resolvidos para aquele usuário ou organização. O servidor não guarda chave própria. 24 ferramentas cobrem geração de imagem e vídeo, edição de imagem, upscaling, modelos treinados e ativos do usuário.

Consulte server/README.md para a lista de ferramentas e desenvolvimento local, e server/docs/user-guide.md para o guia de configuração do usuário final.

Servidor local stdio (stdio/)

A integração original para o Claude Desktop, que roda na sua própria máquina com sua chave de API na configuração do cliente. Inalterado, exceto pelo caminho. Prefira o servidor hospedado, a menos que você queira especificamente um processo local.

Implantação

O servidor hospedado roda no GKE (letzai-prod-services-gcp, namespace mcp), atrás do ingress mcp.letz.ai. Os manifestos do Kubernetes ficam no repositório infrastructure em gcp/workloads/mcp/.

• Dev — todo push para main que toque em server/ compila e faz rollout para mcp.dev.letz.ai automaticamente.
• Prod — deliberado: execute o workflow Deploy MCP (prod), ou faça push de uma tag v*.