MCP no Laravel: o que é o Model Context Protocol e como ligar o Claude Code ao seu projeto

O MCP (Model Context Protocol) é um padrão aberto, publicado pela Anthropic em 2024, que define como um agente de IA se conecta a ferramentas e dados de fora. No MadBuilder, ele deixa o Claude Code, o Cursor ou outro cliente MCP criar telas, gerar cadastros, modelar o banco e publicar um projeto Laravel, com um token por projeto e cada chamada registrada.

O que é o MCP (Model Context Protocol)

Um agente de IA só sabe o que está na conversa. Pra consultar um banco ou mexer num sistema, alguém precisa ligá-lo a essas coisas, e antes do MCP cada ligação era feita de um jeito, pra cada ferramenta e cada agente.

O MCP padroniza essa conversa. De um lado, o servidor MCP expõe ferramentas: ações com nome, descrição e parâmetros, como “listar pedidos”. Do outro, o cliente MCP, o app onde o agente roda, pergunta o que o servidor oferece, e o modelo decide quando chamar cada ferramenta.

Dois pontos ajudam a não confundir:

• O MCP não é um modelo de IA. É o protocolo entre o agente e as ferramentas, e um servidor atende qualquer cliente que fale MCP.
• O protocolo define como pedir. Quais ferramentas existem e quem pode usar cada uma é decisão de quem monta o servidor.

O Claude Code, o agente de programação da Anthropic que roda no terminal, é um cliente MCP. O Cursor também é.

Por que o MCP importa pra quem mantém sistemas Laravel

Se você já usa o Claude Code num repositório Laravel, conhece o jeito dele de trabalhar: lê os arquivos, deduz a estrutura e escreve código. Funciona, mas cada cadastro novo sai escrito à mão: migration, model, controller, view, validação e o HTML, o CSS e o JS de cada campo.

Com um servidor MCP, o agente troca parte dessa dedução por ferramentas feitas pro trabalho. Em vez de escrever vários arquivos pra montar um cadastro, ele chama uma ação que gera o cadastro, no mesmo projeto onde o seu time trabalha.

O outro motivo é controle. Dar a um agente permissão de escrita num sistema de verdade pede respostas claras: o que ele pode fazer, como cortar o acesso e onde fica o registro. Quem responde isso é o servidor que você conecta, não o protocolo.

O que o MadBuilder expõe por MCP

O MadBuilder gera um projeto Laravel comum: models Eloquent, migrations, controllers, rotas e views em Blade com Alpine. O projeto também traz o framework MAD na pasta packages/, de onde vêm os componentes <mad-*> e a classe base MadComponent. Veja em detalhe o que entra no projeto Laravel gerado.

O MCP Gateway deixa você usar as ferramentas do agente do MadBuilder fora do editor. Pelo MCP, o seu agente consegue:

• criar telas;
• gerar cadastros;
• modelar o banco;
• publicar.

Tudo acontece no mesmo projeto que o time edita no visual, no PHP e no Blade. Quer ler o código antes de conectar um agente? A página do MadBuilder para devs mostra os arquivos que uma tela gera.

Como conectar o Claude Code a um projeto no MadBuilder

A conexão é um comando só:

claude mcp add madbuilder --token mgw_… --project 1042

• madbuilder é o nome com que o servidor aparece no seu Claude Code.
• --token recebe o token do projeto, que começa com mgw_.
• --project indica o projeto em que o agente vai trabalhar. O 1042 é só o exemplo.

Depois, é só pedir em português. Não usa o Claude Code? O Cursor ou qualquer outro cliente MCP também conecta.

Os controles de acesso

• Um token por projeto. Cada projeto tem o seu token exclusivo.
• Ferramenta por ferramenta. Cada token tem uma lista de ferramentas liberadas, e você decide o que entra nela.
• Revogação na hora. Se o token vazar ou o trabalho acabar, você revoga e o acesso para ali.
• Cada chamada registrada. Toda chamada fica auditada, então dá pra conferir depois o que o agente fez.

Pra começar, libere as ferramentas de modelar o banco e criar telas, confira o resultado no editor e só depois libere a publicação, como faria com um dev novo no time.

Em qual plano o MCP Gateway está

Na tabela de preços, o item “Acesso por outros agentes de IA (MCP Gateway)” está incluso no plano Pro IA, de R$ 1.997 por desenvolvedor, por ano. Os planos abaixo dele não trazem o item. Já o Mad Coding Plan, complemento mensal a partir de R$ 97, libera o agente, o MCP Gateway e o Embed Chat no plano Pro.

O seu agente ou o nosso

Conectar o Claude Code não tira nada do editor. O MadBuilder tem um agente próprio, que lê o banco, cria tabelas e gera telas no mesmo projeto. Ele escreve a tag do componente MAD, não o HTML, o CSS e o JS por trás dela, e por isso gasta de 65% a 75% menos tokens. Veja um recorte de um formulário gerado:

<mad-form-grid :cols="2">
    <mad-money-field name="total" label="Total" prefix="R$" :decimals="2" :readonly="true" />
    <mad-input-field data-mad-column-id="4536" data-mad-entity-id="693" name="status" label="Status" />
</mad-form-grid>

Cada linha é um campo inteiro. O resto mora no componente, dentro do framework MAD.

Nele, você usa a sua chave (Anthropic, OpenRouter, xAI, Z.AI ou Ark) ou o Mad Coding Plan. No modo de planejamento, ele propõe um plano sem mexer em nada e só escreve o que você aprovar, item por item. Veja mais sobre o agente de IA que monta telas e banco.

O outro lado: o sistema gerado vira ferramenta de IA

Até aqui, o MCP serviu pra construir. Ele também serve pra operar: publicado como ferramenta de IA, o sistema que você gerou passa a ser operado pelos agentes de IA da sua empresa, pelo MCP, com permissões definidas e auditoria de cada ação. No passo a passo do MadBuilder, isso aparece como etapa opcional, depois da publicação.

A configuração desse servidor MCP fica em 9 telas. Algumas delas:

• Visão geral: mostra se a configuração é válida, o endereço do servidor e o que falta pro agente trabalhar bem.
• Contexto do sistema: o texto que o agente lê antes de qualquer chamada.
• Entidades e ferramentas: você escolhe quais models viram ferramenta e com quais ações.
• Permissões por perfil: a matriz que decide quem pode fazer o quê.

Você também protege dados pessoais campo a campo, e uma configuração com erro é recusada. Veja as telas em configuração e governança do sistema gerado.

O copiloto que você pode embutir no app do cliente segue a mesma lógica: opera os dados por MCP, só usa as ferramentas que o usuário tem permissão de usar e registra cada ação.

Ponto	Seu agente no MadBuilder	Agentes no sistema publicado
Pra quê	Construir: telas, cadastros, banco e publicação	Operar o sistema e os dados dele
Quem conecta	O dev, com Claude Code, Cursor ou outro cliente MCP	Os agentes de IA da empresa
Controle	Token por projeto, ferramenta por ferramenta, revogação na hora	Ferramentas escolhidas, permissões por perfil, dados pessoais protegidos
Registro	Cada chamada registrada	Auditoria de cada ação

Perguntas frequentes

O que é MCP, em poucas palavras?

É um padrão aberto, publicado pela Anthropic em 2024, pra ligar agentes de IA a ferramentas externas. Um servidor MCP expõe ações, e qualquer cliente compatível consegue chamá-las.

Preciso usar o Claude Code pra trabalhar com o MadBuilder?

Não. O Cursor ou qualquer cliente MCP também conecta. Ou use o agente do próprio MadBuilder, com a sua chave de API ou com o Mad Coding Plan.

Dá pra cortar o acesso de um agente conectado?

Dá. O token é por projeto e pode ser revogado na hora. E, como cada chamada fica registrada, você vê o que o agente fez até ali.

O MCP Gateway está em qual plano?

No Pro IA. No Pro, ele é liberado pelo Mad Coding Plan, a partir de R$ 97 por mês. Veja também a resposta sobre conectar o seu próprio agente de IA.