WebMCP vs Angular CLI MCP server: tools em runtime vs ajuda em dev-time

Duas features do Angular dividem as letras MCP e o pessoal confunde as duas. O Angular CLI MCP server é de dev-time: entrega docs e contexto do projeto para o assistente que escreve seu código. O WebMCP é de runtime: seu app publicado entrega tools tipadas para um agente no browser. As mesmas três letras, pontas opostas.

Por que essas duas se confundem

Quem busca por "Angular MCP" cai em duas coisas que dizem MCP e que envolvem um agente de IA, então é justo achar que são a mesma feature em níveis diferentes de maturidade. Não são. Elas ficam em pontas opostas da vida do mesmo app.

O Angular CLI MCP server roda enquanto você escreve código. Você sobe ele com ng mcp, e ele dá ao seu assistente um caminho para a doc atual do Angular, exemplos e contexto do workspace, para o agente parar de gerar Angular do ano errado. Quem consome é o seu editor. O raio de impacto é a sua máquina.

O WebMCP roda depois que você publica. Seu app em produção registra tools tipadas, e um agente de IA no browser do usuário final chama essas tools pelo nome em vez de clicar pelo DOM. Quem consome é o agente do browser do usuário. O raio de impacto é o app em produção. O eixo que importa aqui não é maturidade, é quando a coisa roda e quem está do outro lado dela.

A diferença na prática

Coloque as duas lado a lado e a confusão se desfaz. Uma ajuda você a escrever Angular na sua mesa. A outra deixa o app que você já publicou ser chamado por um agente lá fora. Leia a tabela pela linha que casa com o seu objetivo de verdade, não pela sigla que as duas compartilham.

EixoAngular CLI MCP (dev-time)WebMCP (runtime)
Quando rodaEnquanto você escreve código, na sua máquinaDepois de publicar, no browser do usuário
Quem consomeSeu editor ou assistente de códigoO agente de IA no browser do usuário final
O que expõeDoc, exemplos e contexto de workspace do AngularTools tipadas que o app declara com provideExperimentalWebMcpTools
Rótulo de maturidadeHabilitado por padrão desde a v21; a doc ainda chama de experimentalExperimental; um draft de Community Group do W3C, não um padrão
RiscoBaixo: o pior caso é uma sugestão de código que você recusa no reviewAlto: seu app publicado fica exposto a um agente em produção
Raio de impactoSua máquina de devSeu app em produção
Como você sobeng mcp, mais ng generate ai-configRegistrar tools, ponto de entrada document.modelContext

Qual delas você quer de verdade

Se o seu problema é que o Angular escrito por IA sai desatualizado ou fora do estilo, você quer o lado de dev-time. Suba o ng mcp para o assistente ler a doc atual e o seu workspace, e rode o ng generate ai-config para deixar no repo as regras que o assistente segue. O servidor vem habilitado por padrão desde a v21, e a doc ainda chama de experimental, mas ele roda em dev-time, então o pior caso é uma sugestão ruim que você recusa no review. O setup completo está em Angular CLI MCP e código Angular gerado por IA.

Se o seu problema é querer que um agente de IA opere o app publicado por tools tipadas em vez de cliques sintéticos, você quer o WebMCP. Essa capacidade é real e a ligação no Angular é limpa, mas ela é experimental: a spec é um draft de Community Group, e mesmo no v22 ela segue atrás das APIs experimentais. Então você faz um spike atrás de uma flag numa rota de baixo risco, e não coloca isso num fluxo de pagamento.

A armadilha é correr para o WebMCP quando tudo que você queria era um autocomplete melhor no editor, ou correr para o CLI MCP server quando o que você precisa é que o app responda a um agente em runtime. Case a ferramenta com a ponta do app em que você está: você está escrevendo o código, ou o seu código está sendo chamado?

O lado de dev-time: suba o CLI MCP server e escreva as regras do repobash
ng mcp
ng generate ai-config --tool agents

Artefato para reaproveitar

Qual MCP eu uso?

  • Objetivo: Angular escrito por IA com mais qualidade na sua mesa → Angular CLI MCP server (ng mcp) com ng generate ai-config. Habilitado por padrão desde a v21, dev-time, baixo risco.
  • Objetivo: app publicado chamável por um agente do browser via tools tipadas → WebMCP (provideExperimentalWebMcpTools). Experimental; faça spike atrás de uma flag.
  • Se quem consome é o seu editor, é o CLI MCP server de dev-time. Se quem consome é o agente do browser do usuário, é o WebMCP de runtime.
  • Se um passo errado te custa uma sugestão recusada, você está no lado de dev-time. Se te custa um incidente em produção, você está no lado do WebMCP.
  • Precisa dos dois? Eles se combinam: use o CLI MCP server para ajudar a escrever as tools do WebMCP, e publique essas tools atrás de uma flag.

Perguntas frequentes

WebMCP e o Angular CLI MCP server são a mesma coisa?

Não. O Angular CLI MCP server é de dev-time e entrega docs e contexto do workspace para o assistente que escreve seu código. O WebMCP é de runtime e deixa um agente do browser chamar tools tipadas que seu app publicado expõe. As mesmas três letras, pontas opostas.

Qual delas eu devo usar?

Se você quer Angular escrito por IA com mais qualidade, use o CLI MCP server (ng mcp) e o ng generate ai-config; ele vem habilitado por padrão desde a v21 e roda em dev-time, então uma sugestão ruim só é recusada no review. Se você quer o app publicado chamável por um agente do browser, use o WebMCP, mas ele é experimental, então faça um spike atrás de uma flag em vez de colocar num fluxo crítico.

Alguma das duas é estável?

As duas ainda carregam o rótulo de experimental, então a pergunta útil é o risco, não o rótulo. O CLI MCP server vem habilitado por padrão desde a v21, e a doc ainda chama de experimental, mas ele roda em dev-time, então uma chamada ruim te custa uma sugestão recusada. O WebMCP também é experimental, um draft de Community Group do W3C, não um padrão, e o Angular ainda o entrega atrás das APIs experimentais, agora no v22 (releases); uma chamada ruim ali chega no seu app em produção.

Fontes consultadas

Modern Angular Playbook

Este artigo é um play.

O Playbook do Angular Moderno reúne o diagnóstico, a matriz de adoção, onze jogadas e o plano de 30 dias. Grátis, em inglês e português.

Você recebe os dois PDFs por email, pela lista do Dojo IA.

Abrir playbook →

André Ramosdisponível para vagas remotas, UTC−3Entre em contato →

Leia também

Guia · 12 min

WebMCP no Angular: como expor tools ao agente de IA do browser (e quando esperar)

Como o Angular expõe tools WebMCP para um agente de IA do browser (bootstrap, rotas, services e Signal Forms), mais a superfície de segurança que se abre e onde eu ainda esperaria antes de colocar em produção.

Ler artigo →

Guia · 7 min

Transformando Signal Forms em tools de agente de IA

Como o Angular transforma um Signal Form numa tool que o agente consegue chamar, o que a inferência de schema precisa do seu modelo e onde eu usaria isso antes de sair do status experimental.

Ler artigo →

Guia · 8 min

Segurança de WebMCP no Angular: o agente que chama suas tools pode ser sequestrado

Um guia de segurança para o WebMCP do Angular: por que uma tool exposta age com a autoridade do usuário, por que o JSON schema não é fronteira de confiança, e as defesas antes de expor qualquer coisa que altera dado.

Ler artigo →