Servidor MCP: Converse com Sua Arquitetura a Partir das Suas Ferramentas de IA Favoritas - Archyl Blog

Acabamos de lançar a funcionalidade que mais me empolga: um servidor MCP que permite consultar e modificar sua documentação de arquitetura diretamente do Claude Code, Cursor ou qualquer assistente de IA compatível com MCP. Aqui está por que isso muda tudo.

Servidor MCP: Converse com Sua Arquitetura a Partir das Suas Ferramentas de IA Favoritas

Uso assistentes de codificação com IA diariamente há mais de um ano. Claude Code para refatorações complexas, Cursor para edições rápidas, GitHub Copilot para autocomplete. Mas sempre havia uma lacuna frustrante: essas ferramentas não conseguiam ver minha documentação de arquitetura.

Toda vez que eu pedia ao Claude para "adicionar um novo endpoint ao serviço de pagamento", ele adivinhava. Ele não sabia que nosso serviço de pagamento se comunica com o Stripe, usa Redis para cache e tem requisitos específicos de segurança documentados em nossos ADRs. Eu gastava mais tempo corrigindo a IA do que escrevendo código eu mesmo.

Hoje, estamos fechando essa lacuna. O Archyl agora expõe um servidor MCP (Model Context Protocol) completo com 56 ferramentas que dão aos assistentes de IA visibilidade completa da sua arquitetura.

O Que é MCP?

Model Context Protocol é o padrão aberto da Anthropic para conectar assistentes de IA a ferramentas e fontes de dados externas. Pense nele como um adaptador universal entre LLMs e os sistemas com os quais precisam interagir.

Ao invés de copiar e colar contexto nos prompts, o MCP permite que assistentes de IA consultem suas ferramentas diretamente. Eles podem ler dados, realizar ações e se manter sincronizados com seus sistemas reais.

E o servidor MCP do Archyl significa que sua documentação de arquitetura se torna uma fonte de dados de primeira classe para qualquer assistente de IA.

O Que Você Pode Fazer Com Ele?

Aqui é onde fica empolgante. Com o servidor MCP do Archyl, seu assistente de IA pode:

Consultar Sua Arquitetura

Faça perguntas naturais e receba respostas reais:

  • "Quais elementos estão vinculados ao sistema Processador de Pagamentos?"
  • "De quais containers o Serviço de Usuários depende?"
  • "Mostre todos os sistemas que interagem com nosso banco de dados PostgreSQL"
  • "Quais ADRs afetam o fluxo de autenticação?"

A IA não adivinha. Ela consulta sua arquitetura real documentada e retorna informações precisas e estruturadas.

Claude Code consultando arquitetura via MCP

Navegar no Modelo C4

Sua IA entende toda a hierarquia:

  • Listar todos os projetos na sua organização
  • Detalhar de sistemas para containers para componentes
  • Explorar relacionamentos e dependências
  • Entender o stack tecnológico em cada nível

Quando você pergunta "quais tecnologias o Serviço de Pedidos usa?", a IA retorna o stack real documentado, não uma suposição.

Modificar Documentação

Esta é a funcionalidade matadora. O servidor MCP suporta operações de escrita:

  • Criar novos sistemas, containers e componentes
  • Adicionar relacionamentos entre elementos
  • Criar e atualizar ADRs
  • Escrever documentação de projeto
  • Definir fluxos de usuário

Peça ao Claude para "documentar o novo serviço de notificação que acabamos de construir" e ele pode criar os elementos C4, vinculá-los a sistemas existentes e até rascunhar um ADR explicando a decisão de design.

Manter-se Sincronizado

A IA sempre vê o estado mais recente. Sem contexto desatualizado, sem documentação obsoleta. Quando seu colega atualiza a arquitetura, seu assistente de IA vê imediatamente.

56 Ferramentas, Uma Integração

Não construímos uma prova de conceito mínima. O servidor MCP expõe funcionalidade abrangente:

Projetos e Configurações: Listar, obter e gerenciar projetos. Configurar provedores de IA e configurações de descoberta.

Modelo C4 (Todos os 4 Níveis): CRUD completo para sistemas, containers, componentes e elementos de código. Criar relacionamentos, gerenciar overlays, manipular toda a hierarquia do modelo.

Documentação: Criar e atualizar documentação de arquitetura. Vincular docs a elementos C4 específicos.

ADRs: Gerenciamento completo de Architecture Decision Records. Criar, atualizar, listar e vincular ADRs aos elementos que afetam.

Fluxos de Usuário: Definir e visualizar jornadas de usuário pelo seu sistema.

Descoberta: Disparar descoberta de arquitetura com IA nos seus repositórios conectados.

Equipes: Consultar estrutura de equipe e acesso a projetos.

Cada ferramenta retorna dados estruturados sobre os quais assistentes de IA podem raciocinar. Sem parsear HTML, sem scraping de UIs, sem integrações frágeis.

Começando em 2 Minutos

Veja como conectar o Claude Code (ou qualquer ferramenta compatível com MCP):

Passo 1: Criar uma Chave de API

Vá ao seu perfil do Archyl, clique em "Chaves de API" e crie uma nova chave. Dê um nome descritivo como "Claude Code" e selecione os escopos que precisa (somente leitura ou acesso completo).

Copie a chave imediatamente — você não a verá novamente.

Passo 2: Configurar Seu Cliente MCP

Adicione o Archyl à sua configuração MCP. Para o Claude Code, adicione isto às suas configurações:

{
  "mcpServers": {
    "archyl": {
      "url": "https://api.archyl.com/mcp",
      "transport": "http",
      "headers": {
        "X-API-Key": "sua_chave_api_aqui"
      }
    }
  }
}

Passo 3: Comece a Conversar com Sua Arquitetura

É isso. Pergunte ao seu assistente de IA sobre sua arquitetura e veja-o buscar dados reais do Archyl.

Tente estes prompts:

  • "Liste todos os meus projetos do Archyl"
  • "Quais sistemas existem no projeto Plataforma de E-commerce?"
  • "Mostre os relacionamentos do Gateway de Pagamentos"
  • "Crie um novo ADR explicando por que escolhemos PostgreSQL"

Por Que Isso Importa

A documentação de arquitetura sempre teve um problema de descobribilidade. Você a escreve, ela vive em um wiki ou diagrama em algum lugar, e então ninguém a lê. Engenheiros perguntam no Slack ao invés de consultar os docs.

O MCP muda o modelo de interação. Documentação não é algo que você vai ler — é algo que seu assistente de IA sabe. Quando você pergunta "como funciona o processamento de pagamento?", a resposta vem da sua arquitetura real, não dos dados de treinamento da IA.

Isso tem implicações profundas:

Onboarding se torna instantâneo. Novos engenheiros perguntam à IA sobre a arquitetura do sistema e recebem respostas precisas desde o primeiro dia.

Contexto está sempre disponível. Ao escrever código, a IA sabe exatamente quais serviços existem, como se conectam e quais decisões os moldaram.

Documentação se mantém atual. Porque é usada ativamente, imprecisões são notadas e corrigidas. Documentação morta é documentação que ninguém lê.

Sugestões da IA são fundamentadas. Quando o Claude sugere um design, ele é informado pela sua arquitetura real, não por padrões genéricos.

O Quadro Maior

Estamos entrando em uma era onde assistentes de IA são colaboradores genuínos no desenvolvimento de software. Mas eles são tão bons quanto o contexto que têm acesso.

A maioria das interações com IA hoje são pobres em contexto. Você cola algum código, adiciona uma breve descrição e espera que a IA descubra o resto. Os resultados são medíocres porque a IA está trabalhando às cegas.

Integrações alimentadas por MCP invertem esse modelo. Sua IA tem acesso persistente e consultável a tudo que precisa: seu código (via integração de repositório), sua arquitetura (via Archyl), suas issues (via integrações Jira/Linear), sua documentação (via integrações Notion/Confluence).

A IA se torna um verdadeiro membro da equipe com acesso ao conhecimento da equipe.

O servidor MCP do Archyl é nossa contribuição para essa visão. Sua arquitetura não deveria estar presa em uma ferramenta de diagramas. Deveria ser acessível para toda ferramenta que sua equipe usa, incluindo seus assistentes de IA.

O Que Vem a Seguir

Esta é a versão 1. Aqui está o que estamos construindo a seguir:

Sugestões proativas: O servidor MCP poderia observar mudanças na arquitetura e sugerir atualizações de documentação.

Links de referência cruzada: Conectar ADRs a commits específicos, vincular documentação a eventos de CI/CD, criar uma rede de conhecimento interconectado.

Consultas personalizadas: Definir consultas específicas da organização como "mostre todos os serviços pertencentes à equipe de pagamentos."

Registro de auditoria: Rastrear cada interação MCP para conformidade e debugging.

Experimente Agora

O servidor MCP está disponível hoje em todos os planos do Archyl. Se você já usa Claude Code, Cursor ou outra ferramenta compatível com MCP, pode se conectar em minutos.

Crie uma chave de API, adicione a configuração e comece a conversar com sua arquitetura.

E se você ainda não usa o Archyl, cadastre-se gratuitamente e veja como funciona a documentação de arquitetura com IA. Conecte um repositório, execute a descoberta e depois conecte seu assistente de IA favorito.

Sua arquitetura é importante demais para ficar presa em diagramas estáticos. Deixe seus assistentes de IA explorá-la.

Quer aprender mais sobre as capacidades de IA do Archyl? Confira nosso post sobre Descoberta de Arquitetura com IA, ou comece com o básico na nossa Introdução ao Modelo C4.