O Angular CLI MCP server: setup, tools e como conectar no seu assistente de IA

O que o servidor é de fato#

O Angular CLI MCP server é um processo de dev-time. Ele roda na sua máquina enquanto você escreve código e expõe tools com contexto de Angular pra um assistente de IA compatível, pelo Model Context Protocol, o padrão aberto que a Anthropic lançou em novembro de 2024. O propósito é estreito e útil: o assistente ganha um caminho pra documentação atual do Angular, exemplos curados e o formato do seu workspace, e com isso para de gerar Angular do ano errado.

Antes do setup, duas observações, porque a sigla carrega coisas demais. Isto não é o WebMCP: o WebMCP é de runtime, onde o seu app publicado expõe tools tipadas pra um agente do browser, e eu separo os dois em WebMCP vs Angular CLI MCP server. E isto também não substitui o review: ele melhora o ponto de partida do assistente, mas não aprova o diff. O lado de review está em Angular CLI MCP e código Angular gerado por IA. Este texto é o encanamento: como você sobe o servidor e conecta um client.

Suba o servidor e aponte um client pra ele#

Existem dois caminhos de entrada, e em geral você usa os dois. Rode ng mcp num terminal pra subir o servidor de forma interativa; a doc diz que ele então imprime as instruções pra configurar um host. O formato que o seu editor de fato guarda é uma config de client que sobe o mesmo servidor via npx, e aí o client cuida do ciclo de vida do processo. A invocação canônica nessa config é npx -y @angular/cli mcp.

Um detalhe que pega o pessoal: o nome da chave muda por client. O VS Code espera um objeto servers; o Cursor, as IDEs da JetBrains, o Gemini CLI e a maioria dos outros esperam mcpServers. O mesmo comando, os mesmos args, uma chave de fora diferente. A config abaixo está no formato mcpServers, que a maioria dos clients lê.

# sobe de forma interativa (imprime as instruções de config do host)
ng mcp

# confirma a versão do CLI que traz o servidor
ng version

O formato da config do client#

Este é o bloco que um client guarda. Pro VS Code, troque a chave de fora de mcpServers pra servers e mantenha o resto. O -y no npx pula o prompt de instalação, então o client consegue subir o servidor sem precisar de você.

# mcp.json
# VS Code: renomeie a chave de fora de mcpServers pra servers
{
  "mcpServers": {
    "angular-cli": {
      "command": "npx",
      "args": ["-y", "@angular/cli", "mcp"]
    }
  }
}

As tools que ele expõe#

O servidor registra um conjunto padrão de tools de leitura e um segundo conjunto, atrás de uma flag, que consegue mexer no projeto. Essa separação importa pra política: as tools padrão respondem perguntas, as experimentais rodam builds e testes. Os nomes abaixo vêm direto da página oficial; não inventei nenhum. Trate a lista exata como sensível à versão e confira ela no seu próprio CLI, já que o servidor ainda é descrito como experimental.

Duas flags moldam a superfície sem você escolher tool por tool. O --read-only registra só as tools que não mudam o projeto (a doc faz a ressalva honesta de que o seu editor ainda pode editar por conta própria). O --local-only registra só as tools que funcionam offline. As tools experimentais entram por opção, via --experimental-tool (apelido -E); elas não vêm ligadas por padrão.

Conectando no seu client#

Leia a linha que casa com o seu editor. O Claude Code recebe um comando de CLI e escreve a config do servidor pra você; o -- separa as flags do próprio Claude do comando que ele deve rodar, e o --scope project guarda tudo num .mcp.json compartilhado na raiz do repo, em vez da sua config pessoal. O Cursor e o VS Code recebem um arquivo JSON direto, com aquela diferença de chave que mencionei acima.

# adiciona o Angular CLI MCP server (compartilhado com o time)
claude mcp add angular-cli --scope project -- npx -y @angular/cli mcp

# confere o CLI pelo qual o servidor roda
ng version

Quando ele se paga em vez de um arquivo de regras simples#

O servidor vale o esforço quando o seu assistente precisa de respostas vivas que um arquivo estático não dá: docs atuais de uma API cujo status você não tem certeza, a lista real de projetos de um workspace, ou um plano de migração gerado contra o seu código. Se a sua necessidade é só ensinar as convenções do time pro assistente, um arquivo de regras vai mais longe com menos máquina rodando, e o ng generate ai-config escreve um no formato que a sua ferramenta já lê. Eu uso os dois: o AGENTS.md pras regras fixas, o MCP server pras consultas vivas. Se eu tivesse que largar um num projeto pequeno, ficaria com o arquivo de regras, porque uma sugestão de API desatualizada sai mais barato de pegar no review do que uma convenção faltando sai de reexplicar em cada prompt.