Conectar em 30 segundos: Claude Code, Codex, Kiro, Cursor e VS Code

O servidor público roda em Lambda atrás do API Gateway, em us-east-1, e fala Streamable HTTP, o transporte remoto padrão do MCP. O endereço técnico é https://mcp.moretes.com/mcp. O alias https://fernando.moretes.com/api/mcp aponta para o mesmo servidor: é mais fácil de ditar e sobrevive a uma troca de API Gateway, mas acrescenta um salto pelo site. Quando o cliente aceita os dois, eu uso o alias em arquivo versionado no repositório da equipe e o endereço do API Gateway em teste de conectividade, porque remove uma variável quando algo falha. Se o alias responder 404 no seu cliente, use o endereço do API Gateway: é o mesmo servidor.

Não há chave de API, cadastro nem OAuth. Isso é uma escolha de desenho, não um descuido: o servidor é determinístico, não chama modelo nenhum e não acessa conta nenhuma, então o pior que uma pessoa consegue fazer com ele é gastar a cota pública do dia. O preço de não ter chave é a cota compartilhada que explico mais abaixo.

Na mesma origem existem três páginas que abrem no navegador: / é a landing com a lista de ferramentas, /health devolve um JSON com versão e contagem de ferramentas, e /tools.json devolve o inventário agrupado. O /mcp em si não abre no navegador, e isso é esperado: ele só aceita POST.

A versão desta aula é a 0.2.0, publicada em 24 de outubro de 2026, com 48 ferramentas em 8 grupos. Se /health mostrar outra versão, o inventário pode ter mudado; 48 é a referência desta versão, não uma promessa.

Os clientes de terminal (Claude Code, Codex, Gemini CLI) recebem a URL por um comando mcp add e guardam a configuração por conta própria; claude mcp list e codex mcp list mostram o que ficou registrado. Os clientes de editor (Kiro, Cursor, VS Code, Amazon Q Developer CLI) leem um arquivo JSON no projeto ou na home do usuário. Os quatro arquivos dizem a mesma coisa com três diferenças pequenas que costumam custar dez minutos a quem copia de um para o outro:

• O VS Code usa a chave servers, não mcpServers, e exige "type": "http".
• O Amazon Q Developer CLI usa mcpServers como os outros, mas também pede "type": "http".
• O Kiro aceita disabled e autoApprove. Deixe autoApprove vazio: aprovar ferramenta por ferramenta é o que permite ver o que o agente está chamando, e é assim que você aprende o inventário nas primeiras semanas.

O nome moretes-architect é só um rótulo local. Pode mudar, mas os prompts desta série assumem esse nome, então "use o moretes-architect" funciona sem tradução.

Arquivo no projeto (.kiro/settings/mcp.json, .cursor/mcp.json, .vscode/mcp.json) vale só para aquele repositório e pode ser versionado, o que coloca a equipe inteira no mesmo servidor com um commit. Arquivo na home vale para todos os projetos. Em qualquer caso, depois de editar, recarregue o cliente: a lista de ferramentas é lida no initialize e não muda sozinha no meio da sessão.

O repositório é MIT e ainda não tem publicação no npm, então o caminho local é clonar e compilar. São quatro comandos e menos de dois minutos numa máquina com Node.js 22 ou 24. npm ci --ignore-scripts instala exatamente o que está no lockfile e impede que qualquer dependência execute script na instalação; npm run build gera dist/; node dist/stdio.js sobe o servidor falando MCP pela entrada e saída padrão. Não espere interface: ele só fala protocolo, e qualquer diagnóstico vai para stderr. npm run http sobe a mesma coisa em http://127.0.0.1:8787/mcp, com a landing page, para clientes que só falam HTTP.

O Claude Desktop é o caso em que o stdio é o caminho principal: a configuração aponta command para node e args para o caminho absoluto de dist/stdio.js. Caminho relativo falha em silêncio, porque o cliente não sobe a partir da pasta do projeto.

Quando preferir o local, mesmo com o endpoint público a um comando de distância:

• Entrada confidencial. Plano Terraform, template CloudFormation, política IAM, código de produção. Em modo local isso não sai da máquina. As únicas ferramentas que saem são as aws_knowledge_* (para o AWS Knowledge MCP oficial) e github_public_repository (api.github.com), e levam só a consulta que você digitou.
• Volume. Revisar 40 políticas num loop de CI consome a cota do dia em minutos; local não tem cota.
• Conta AWS. aws_account_identity, aws_tagged_resources e aws_cost_history só existem em stdio, com opt-in explícito. O módulo 3 trata disso.

O endpoint público é para experimentar, aprender e para conversas de desenho sem dado sensível. Não envie segredo, dado de cliente ou arquitetura confidencial para ele: os logs guardam só id da requisição, status e duração, mas o tráfego passa pela minha conta, e você não tem como auditar isso.

O serviço público tem dois contadores por dia UTC, guardados no DynamoDB: 300 requisições por chamador e 3.000 no total. O chamador é identificado por um hash SHA-256 de dia + IP de origem, truncado em 24 caracteres: pseudônimo, muda todo dia, expira em dois dias, e o IP bruto nunca é gravado. Quando qualquer um dos dois estoura, o servidor responde 429 com o texto "Daily service limit reached; use local stdio mode." e o cabeçalho Retry-After: 3600. Os contadores são fail-closed: se o DynamoDB não responder em 1,5 segundo, a requisição é negada em vez de passar sem contar. Prefiro negar uma requisição a perder o controle do custo.

O que conta: cada operação MCP é um POST, e cada POST conta. initialize, tools/list, resources/read e cada tools/call são requisições separadas. Um cliente que recarrega a lista de ferramentas a cada mensagem gasta cota sem você perceber; 300 ainda dá uma tarde inteira de uso interativo, mas não dá um loop de CI.

Na frente do Lambda, o API Gateway impõe um limite de taxa: 5 requisições por segundo com burst de 20. Esse limite também devolve 429, mas vem do gateway e sem o Retry-After de uma hora; é caso de esperar alguns segundos. Em qualquer 429, não repita em loop apertado: aguarde ou troque para o modo local, que não tem nenhum dos dois limites.

O servidor também rejeita corpo acima de 128 KB (413), requisição em lote JSON-RPC (400) e Content-Type diferente de application/json (415). Isso raramente aparece num cliente MCP de verdade; aparece quando alguém testa com curl.