Pular para o conteúdo
fernando.moretes.com
BlogEstudosCursosE-booksOpen SourcePodcasts
Loading…
Fernando Azevedo

Arquiteto de TI Especialista

Arquitetura, AWS, IA em produção, sistemas financeiros e FinOps, escritos a partir do que foi operado, com os números.

  • LinkedIn
  • GitHub
  • E-mail

Conteúdo

  • Blog
  • Estudos de arquitetura
  • Cursos
  • E-books
  • Open Source
  • Podcasts
  • Assuntos
  • Trilhas

Ferramentas

  • Moretes Architect MCP
  • Well-Architected self-check
  • Arquitetura deste site
  • Números públicos
  • Histórico de estudo

Sobre

  • Comunidade
  • IA Builder
  • Perfil
  • Currículo (CV)
  • Trabalhe comigo
  • Media kit
  • RSS do blog
  • RSS dos estudos
  • Artigos narrados (podcast)
  • llms.txt
  • Termos, privacidade e uso de IA

(c) 2026 Fernando Francisco Azevedo

Voltar ao site/Architect MCP
Open source · MIT · v0.4.0 · AWS Community Builder (AI Engineering)

Arquitetura com evidências, dentro do seu agente de código

O Moretes Architect é um servidor MCP com 48 ferramentas determinísticas e 10 personas de arquiteto para Claude Code, Codex, Kiro, Cursor e VS Code. Requisitos, ADR, C4, custos auditáveis, revisão de Terraform, Kubernetes, código e segurança de agentes de IA. O servidor nunca chama um modelo, nunca recebe credenciais e não precisa de chave. Eu construí para decidir melhor no meu dia a dia; está aberto para a comunidade usar, auditar e estender.

Conectar em 30 segundosCurso grátis em vídeoGitHub
48
ferramentas públicas
10
personas de arquiteto
20
prompts prontos
0
chamadas a modelo no servidor
5
nuvens mapeadas: AWS, Azure, GCP, OCI e open source

Servidor público no ar: v0.4.1, 48 ferramentas. /health

Novas ferramentas e aulas, uma vez por semana

Arquitetura, AWS e IA em produção, com número e trade-off. Grátis.

Sem spam · cancele quando quiser

Veja funcionando

Dois minutos: o MCP dentro do Claude Code

Vídeo de abertura do curso, narrado na minha voz: o pedido vago vira perguntas, o painel de arquitetos entra, os números aparecem e a decisão vira um ADR. Cada aula tem o seu próprio vídeo.

Apresentação do curso
Narrado por Fernando AzevedoMP4PDF

Passo 1

Conectar em 30 segundos

Sem chave e sem cadastro. Escolha o cliente, copie, cole. Cota pública: 300 requisições por dia por cliente, 3.000 no total. Para volume ou entradas privadas, rode local.

terminal
claude mcp add --transport http moretes-architect https://mcp.moretes.com/mcp

Depois, /mcp dentro da sessão mostra as 48 ferramentas. Para o projeto inteiro, acrescente --scope project.

Endpoint: https://mcp.moretes.com/mcp

Também responde em: https://fernando.moretes.com/api/mcp (passa pelo site, então quem usa esse endereço divide a mesma cota diária; para a sua cota individual, use a URL direta acima)

Depois de conectar, peça ao agente: Use o Moretes Architect. Preciso de uma API de pedidos para um marketplace, 300 pedidos por minuto no pico. Pergunte o que falta antes de sugerir.

Experimente agora

Chame uma ferramenta de verdade, daqui

Esta página chama o mesmo servidor público que o seu agente usaria. Só ferramentas de cálculo puro, sem rede, e com limite de uso para não gastar a cota de quem está conectado de verdade.

Resposta do servidor

// clique em Chamar para ver o JSON estruturado que o seu agente recebe

O que ele faz

48 ferramentas em 8 grupos

Cada uma tem entrada estrita, saída estruturada, proveniência e limitações explícitas. As revisões são heurísticas: triagem para uma pessoa decidir, nunca certificação. Lista viva em tools.json.

Architect personas and code · 3

  • architect_panelConvene architect personas (solution, enterprise, business, data, infrastructure, software, AI, security, governance, FinOps) on a subject: each returns its questions, checks, deliverables and the workbench tools to call.
  • code_review_architectureHeuristic architecture and security scan of source code pasted as text (any language): secrets, insecure calls, SQL built by concatenation, disabled TLS, hardcoded endpoints, missing timeouts and retry hazards.
  • dependency_manifest_reviewReview a dependency manifest (package.json, requirements.txt, pyproject, go.mod, pom.xml, Gemfile, Cargo.toml as text) for unpinned ranges, git or URL sources, wildcard versions and missing lockfile hints..

Architecture and decisions · 14

  • requirements_checkTurn a workload brief into explicit requirements, gaps and research questions.
  • architecture_patternSelect a reference architecture by explicit workload pattern; returns tradeoffs, questions and Mermaid.
  • service_compareCompare curated AWS service families against user constraints.
  • decision_recordGenerate an ADR from explicit alternatives, decision and consequences.
  • well_architected_reviewOrganize evidence by six pillars.
  • threat_modelCreate STRIDE review prompts for explicitly supplied assets and trust boundaries.
  • failure_rehearsalDesign a controlled failure drill with observable success criteria and stop conditions; never executes it..
  • capacity_planCalculate concurrency and daily data volume from explicit traffic assumptions.
  • cost_modelCalculate an auditable scenario using caller-supplied unit rates and source URLs.
  • slo_budgetCalculate an availability error budget for a chosen period..
  • migration_planPrepare phased discovery, pilot, migration and rollback gates; includes AWS Transform integration discovery..
  • architecture_diagramBuild Mermaid from explicit nodes and edges.
  • implementation_planTurn an architecture decision into a delivery checklist with validation gates..
  • agent_tool_contractDesign a per-operation authorization and recovery contract for an agent tool..

Design: diagrams, data, contracts · 6

  • c4_modelBuild C4 context or container diagrams (Mermaid) from explicit people, systems, containers and relations.
  • sequence_diagramBuild a Mermaid sequence diagram from participants and ordered messages, with optional activation, notes and alt/loop blocks.
  • service_equivalentsMap a cloud capability to equivalent managed services on AWS, Azure, Google Cloud, OCI and open source.
  • data_classificationClassify data elements, map them to regulation hints (LGPD, GDPR, PCI DSS, HIPAA) and list handling controls and open questions.
  • openapi_reviewHeuristic review of an OpenAPI 3.x document (JSON): security, pagination, error responses, idempotency, versioning and documentation gaps.
  • event_contractDesign an event contract: envelope fields, schema evolution rules, idempotency, ordering, DLQ and replay decisions for a named business event.

Reliability, operations and FinOps · 8

  • latency_budgetSplit an end-to-end latency objective across hops and show which hops exceed their share.
  • queue_sizingSize consumers with Little's law and stable Erlang C: utilization, wait probability, backlog drain time and target consumers.
  • dr_strategyCompare disaster recovery tiers (backup-and-restore, pilot light, warm standby, active-active) against RTO, RPO and data constraints; returns feasible tiers and required capabilities, not a guarantee..
  • retry_policyCompute an exponential backoff schedule with jitter, the worst-case wait and whether it fits a deadline; adds idempotency and circuit-breaker guidance..
  • storage_growthProject storage volume and relative cost over time from ingest, retention, compression, replication and growth; suggests tiering thresholds..
  • finops_unit_economicsCompute cost per unit (request, customer, transaction), fixed versus variable split and the volume at which the marginal cost crosses a target.
  • postmortemGenerate a blameless postmortem document from incident facts: timeline, impact, detection, contributing factors and owned action items.
  • runbookGenerate an operational runbook from service facts: alerts, diagnostic steps, remediation, rollback, escalation and verification.

AI agents and MCP safety · 5

  • agent_eval_planDesign an evaluation plan for an AI agent: golden set sizing, metrics, judge rubric, red-team cases and regression cadence from explicit capabilities and risks..
  • prompt_injection_checklistEnumerate injection paths and controls for an agent from its tools and untrusted data sources; produces a checklist with status to fill, not a scan..
  • rag_pipeline_planPlan a retrieval-augmented generation pipeline from corpus facts: chunking, embedding, indexing, authorization, evaluation and cost drivers, with open questions.
  • mcp_server_reviewHeuristic safety review of ANOTHER MCP server from its tools/list output: tool-poisoning text, missing annotations, risky parameters, free-form schemas, name shadowing and context cost.
  • mcp_config_reviewReview an MCP client configuration JSON (mcpServers map) for unpinned packages, inline secrets, plain HTTP, auto-approved tools and unreviewed enablement..

Infrastructure as code review · 4

  • iam_policy_reviewInspect an IAM document for broad grants: AWS policy JSON (default), Azure custom role definition or Google Cloud IAM policy bindings (provider).
  • cloudformation_reviewReview a CloudFormation JSON template for selected risky configuration patterns.
  • terraform_plan_reviewReview a Terraform or OpenTofu plan exported as JSON (terraform show -json): deletions and replacements of stateful resources, public exposure, disabled encryption, literal credentials, broad policies and unpinned providers.
  • kubernetes_manifest_reviewReview Kubernetes manifests (parsed JSON objects) for probes, resources, security context, image pinning, host access, secrets in env, PDB and NetworkPolicy coverage.

Live AWS Knowledge · 5

  • aws_knowledge_searchexternaSearch live official AWS documentation.
  • aws_knowledge_readexternaRead an official document returned by search when its excerpt is insufficient.
  • aws_regionsexternaList current AWS regions from the official Knowledge MCP..
  • aws_regional_availabilityexternaCheck current regional support.
  • aws_skillexternaRetrieve an official AWS skill by the exact ID returned by aws_knowledge_search with agent_skills topic.

Official AWS integrations and GitHub · 3

  • integration_catalogSearch the snapshot of the complete official AWS MCP catalog.
  • integration_configGenerate a version-pinned local configuration for an official AWS server, or a remote Knowledge config.
  • github_public_repositoryexternaRead public GitHub repository metadata and contribution links.

Dez lentes

Convoque os arquitetos

Cada persona é uma lente: as perguntas que faz primeiro, o que confere, o que entrega e quais ferramentas chama. Use o prompt architect_<papel>, a ferramenta architect_panel ou o resource moretes://personas/<id>. A persona não decide por você: ela garante que a pergunta certa foi feita.

  • architect_solution

    Arquiteto de Soluções

    Do problema de negócio a um desenho implantável, com trade-offs, números e ADR.

  • architect_enterprise

    Arquiteto Enterprise

    Alinha ao portfólio: capacidades, padrões, reuso, dívida e roadmap entre times.

  • architect_business

    Arquiteto de Negócio

    Valor, processo e métrica explícitos: quem ganha, o que muda e como medir.

  • architect_data

    Arquiteto de Dados

    Modelo, armazenamento, movimento, governança e descarte, com dono e qualidade.

  • architect_infrastructure

    Arquiteto de Infraestrutura

    Plataforma reproduzível, observável e recuperável: IaC, rede, identidade, capacidade, DR.

  • architect_software

    Arquiteto de Software

    Código evolutivo: fronteiras, contratos, erros, idempotência, testes e dependências.

  • architect_ai

    Arquiteto de IA

    Modelos e agentes em produção com grounding, autorização, avaliação e custo sob controle.

  • architect_security

    Arquiteto de Segurança

    Fronteiras de confiança, identidades, segredos e detecção explícitos; assume o comprometimento.

  • architect_governance

    Arquiteto de Governança

    Obrigação, controle e evidência: regulação, auditoria, apetite a risco e responsabilidade.

  • architect_finops

    Arquiteto FinOps

    Custo como entrada de projeto: economia unitária, alocação, compromissos e desperdício.

Tutorial em vídeo

O curso: dez aulas, cada uma com vídeo, áudio e texto

Gratuito, bilíngue, com quizzes e certificado. Os vídeos mostram o MCP funcionando dentro do agente, com as chamadas de ferramenta e as respostas reais, narrados na minha voz.

  1. 01O que é MCP e o que é o Moretes ArchitectO protocolo que liga seu agente a ferramentas, um servidor de arquitetura que calcula em vez de opinar, e o caso de marketplace que atravessa as 10 aulas. vídeo
  2. 02Conectar em 30 segundos: Claude Code, Codex, Kiro, Cursor e VS CodeUm comando ou seis linhas de JSON ligam o Moretes Architect MCP ao seu agente, sem chave de API. Depois, dois testes provam que a conexão funciona e a cota pública fica explicada antes de morder. vídeo
  3. 03Da ideia à decisão: requisitos, painel de arquitetos e ADRO fluxo de descoberta no marketplace de pedidos: requirements_check expõe o que falta, architect_panel traz quatro lentes, architecture_pattern, service_compare e service_equivalents comparam sem eleger vencedor, e decision_record fecha num ADR de verdade. vídeo
  4. 04Desenhar e contratar: C4, sequência, eventos e OpenAPIQuatro ferramentas que transformam uma lista de elementos em diagrama Mermaid validado e uma quinta que lê o contrato da API e devolve achados por severidade. Tudo sobre a plataforma de pedidos do marketplace, com a saída real de cada chamada. vídeo
  5. 05Números que defendem a decisão: capacidade, latência, filas e custoSete ferramentas de cálculo do MCP aplicadas à plataforma de pedidos do marketplace: concorrência, orçamento de latência, consumidores de fila, orçamento de erro, custo mensal, custo por pedido e crescimento de armazenamento. Todo número sai de uma entrada que você pode auditar. vídeo
  6. 06Revisar com evidências: Well-Architected, ameaças, dados e IAMQuatro ferramentas de revisão do Orders, uma regra que muda tudo (controle sem prova vira unknown) e a anatomia de um achado que vale alguma coisa. vídeo
  7. 07IaC e código no pipeline: Terraform, CloudFormation, Kubernetes e o CLICinco revisões heurísticas sobre artefatos exportados (plano do Terraform, template do CloudFormation, manifestos do Kubernetes, código e package.json) e o CLI que transforma cada uma em código de saída, Markdown e SARIF dentro do GitHub Actions. vídeo
  8. 08Operar e recuperar: DR, retries, ensaio de falha, runbook e postmortemCinco ferramentas e dois prompts para a parte que o desenho não cobre: escolher o tier de DR com RTO e RPO reais, calcular quanto custa insistir, ensaiar a falha antes de ela acontecer, escrever o runbook e fechar o incidente com um postmortem que a ferramenta se recusa a aceitar incompleto. vídeo
  9. 09Agentes de IA em produção e segurança de MCPOs seis tools do grupo "AI agents and MCP safety" aplicados ao agente de suporte da plataforma Orders: contrato de autorização por operação, plano de avaliação, checklist de injeção, plano de RAG e a revisão heurística de outros servidores MCP e da sua própria configuração. vídeo
  10. 10Personas, fontes oficiais, modo local e como contribuirAs dez lentes de arquiteto, as cinco ferramentas que consultam a documentação oficial da AWS ao vivo, o catálogo de servidores oficiais, o modo local com a sua conta, os limites de privacidade e custo, e o caminho para reportar, propor e estender o projeto. vídeo
Abrir o curso completo

No pipeline

As mesmas ferramentas, offline, com exit code

O CLI vem no pacote npm e roda qualquer ferramenta sem cliente MCP e sem rede, com saída JSON, Markdown ou SARIF. Revisão de plano Terraform, template CloudFormation, manifestos Kubernetes, código e dependências antes do apply, no GitHub Actions, GitLab CI ou pre-commit.

terraform show -json tfplan > plan.json
npx -y -p moretes-aws-architect-mcp@0.4.0 moretes-architect call terraform_plan_review \
  --input plan.json --format sarif --fail-on high > review.sarif
# exit 0: ok · 1: achados no nível --fail-on ou acima · 2: erro de uso ou entrada
Exemplos completos de pipeline

Novo na v0.4.0

Onde mais ele roda

As mesmas 48 ferramentas fora do chat: no workflow do GitHub, no commit, como plugin ou skill do agente e em contêiner. Tudo versionado pela tag da release.

GitHub Action

Revisa arquivos no workflow, escreve o relatório no resumo do job, gera SARIF opcional e falha na severidade que você escolher.

- uses: fernando-moretes/moretes-aws-architect-mcp@v0.4.0
  with:
    tool: terraform_plan_review
    files: plan.json
    fail-on: high
    sarif: review.sarif

pre-commit

Barra o commit que põe token dentro do .mcp.json, aprova toda ferramenta ou usa versão curinga no manifesto. Roda offline pela imagem de contêiner.

repos:
  - repo: https://github.com/fernando-moretes/moretes-aws-architect-mcp
    rev: v0.4.0
    hooks:
      - id: mcp-config-review
      - id: dependency-manifest-review

Claude Code (plugin)

Conecta o endpoint público e instala a skill que manda o agente perguntar antes de supor e tirar número da ferramenta.

/plugin marketplace add fernando-moretes/moretes-aws-architect-mcp
/plugin install moretes-architect@moretes

Agent Skill

As regras e os fluxos de uso das ferramentas, para qualquer cliente que carrega Agent Skills.

npx skills add fernando-moretes/moretes-aws-architect-mcp

Gemini CLI

Extensão com o servidor remoto e a skill como arquivo de contexto.

gemini extensions install https://github.com/fernando-moretes/moretes-aws-architect-mcp

Docker

MCP por stdio, HTTP local ou o CLI sem Node na máquina. Usuário sem privilégio, sem credencial AWS, amd64 e arm64.

docker run -i --rm ghcr.io/fernando-moretes/moretes-aws-architect-mcp:0.4
Guia de cada integração

Segurança e privacidade

O que sai da sua máquina, e o que não sai

  • O servidor público processa a entrada em memória e registra só id da requisição, status e duração. Nunca argumentos, prompts ou resultados.
  • Só aws_knowledge_* (consulta ao MCP oficial de documentação da AWS) e github_public_repository (api.github.com) fazem chamadas externas. O resto é cálculo local.
  • A Lambda pública só escreve na própria tabela de cota e nos próprios logs. Não recebe credenciais, não assume roles, não invoca modelos, não implanta nada.
  • Ferramentas de conta AWS e federação existem só no modo local, por opt-in, com guarda de conta por STS. O HTTP nunca as expõe.
  • A cota por cliente usa sha256(dia + IP) com validade de dois dias; o IP bruto não é guardado.
  • Não envie segredos, dados de clientes ou arquitetura confidencial ao endpoint público. Para isso existe o modo local.

PRIVACY.md · SECURITY.md

Deu errado?

Troubleshooting

SintomaO que fazer
405 ao abrir /mcp no navegadorEsperado: o endpoint aceita POST do cliente MCP. A página humana é a raiz do host.
403 OriginOrigem de navegador é negada por padrão. Use um cliente MCP nativo ou o playground desta página.
429Cota diária ou throttle. Espere o Retry-After ou rode local.
As ferramentas não aparecemRecarregue o cliente, confirme a URL termina em /mcp e peça ao agente para listar as ferramentas (espere 48).
Ferramentas antigas depois de atualizarNo modo local, recompile (npm run build) e recarregue o cliente.
Ferramenta de conta AWS rejeitadaSó no stdio, com ENABLE_AWS_ACCOUNT_TOOLS=true, EXPECTED_AWS_ACCOUNT_ID de 12 dígitos e AWS_REGION=us-east-1.

Guia completo de troubleshooting

FAQ

Perguntas frequentes

O que é um servidor MCP?

MCP (Model Context Protocol) é o protocolo aberto que liga um agente de código (Claude Code, Codex, Kiro, Cursor, VS Code) a ferramentas externas. O servidor publica ferramentas com schema, prompts e resources; o modelo do cliente decide quando chamar cada uma e recebe a saída estruturada.

Quanto custa usar?

Nada. O endpoint público é gratuito, sem chave e sem cadastro, com cota de 300 requisições por dia por cliente e 3.000 por dia no total. Rodar local não tem cota. Não há SLA: é um serviço comunitário mantido por uma pessoa, com orçamento alvo de US$ 30 por mês.

O servidor chama algum modelo de IA?

Não. Todas as 48 ferramentas são determinísticas: cálculos, estruturas, revisões heurísticas e consultas a fontes oficiais. Quem raciocina é o modelo do seu cliente. Isso mantém o custo de inferência em zero no servidor e torna a saída reproduzível.

O que sai da minha máquina?

No endpoint público, os argumentos da ferramenta viajam até o servidor, são processados em memória e não são registrados: o log guarda só id da requisição, status e duração. Só duas famílias saem para fora: aws_knowledge_* envia a consulta ao MCP oficial de documentação da AWS e github_public_repository consulta api.github.com. Para entradas confidenciais, use o modo local.

É só para AWS?

Não. As ferramentas de desenho, números, revisão de código, IaC, operação e agentes são agnósticas. service_equivalents mapeia 43 capacidades entre AWS, Azure, GCP, OCI e open source, architecture_pattern aceita o provedor como parâmetro e iam_policy_review lê política da AWS, role do Azure e bindings do Google Cloud. O que é AWS de verdade são os cinco adaptadores de documentação oficial e o catálogo de servidores awslabs.

As revisões substituem um linter, um scanner ou uma auditoria?

Não. São heurísticas: triagem para uma pessoa decidir. Cada saída diz o que não cobre e qual ferramenta de enforcement usar (IAM Access Analyzer, OPA, Checkov, Kyverno, Semgrep). Uma lista vazia de achados não é aprovação.

Ele pode mexer na minha conta AWS?

Pela internet, nunca: a Lambda pública só tem permissão para a própria tabela de cota e os próprios logs, e não recebe credenciais. No modo local, por opt-in explícito, existem três ferramentas somente leitura (identidade STS, recursos por tag, histórico de custo) e uma ponte para servidores oficiais com allowlist exata. Essas nunca aparecem no HTTP.

Como uso no pipeline?

No GitHub, com a Action fernando-moretes/moretes-aws-architect-mcp@v0.4.0. Em qualquer outro CI, com o CLI do pacote npm: npx -p moretes-aws-architect-mcp moretes-architect call <ferramenta> --input arquivo.json --format sarif --fail-on high. Roda offline, sem cota, e devolve código de saída por severidade. O SARIF entra no code scanning do GitHub; o Markdown vai para o resumo do job.

Por que 429?

Cota diária esgotada (300 por cliente ou 3.000 no total) ou throttle da API (5 requisições por segundo, rajada de 20). O cabeçalho Retry-After diz quanto esperar. Para volume, rode local.

Como contribuo?

Abra uma issue com o template de proposta de ferramenta (problema, entrada, saída esperada, limite) ou um PR com schema estrito, fronteira de dados externos explícita, limitações na saída e teste. Português ou inglês. O projeto é MIT.

Por que você construiu isso?

Os servidores MCP de nuvem são operacionais: executam na conta. Faltava o antes: levantar requisitos, comparar com honestidade, calcular em vez de chutar, revisar com evidências e registrar a decisão. É o que eu uso para decidir no dia a dia, e como AWS Community Builder quis deixar aberto para a comunidade usar, auditar e estender.

Open source

Use, audite, estenda

Issues e PRs em português ou inglês. Proponha uma ferramenta com o template (problema, entrada, saída esperada, limite), relate um bug com o JSON sanitizado, ou traga a sua persona. Uma ferramenta nova precisa de schema estrito, fronteira de dados externos explícita, limitações na saída e teste. Se você é AWS Community Builder, User Group ou dá aula: o curso e os vídeos são livres para usar em sala.

Abrir uma issue CONTRIBUTING.mdRoadmap