Se você utiliza inteligência artificial para programar, provavelmente já percebeu uma limitação: por mais avançado que seja o modelo, ele não conhece automaticamente todos os detalhes do seu projeto. Às vezes, você precisa copiar migrations, colar logs, explicar a estrutura do banco de dados ou abrir o painel da VPS para descobrir por que um deploy falhou.
É justamente nesse tipo de situação que entra o MCP. Neste artigo, vou mostrar como utilizo o Model Context Protocol no meu fluxo de desenvolvimento com Cursor, Laravel e Coolify, conectando o agente a ferramentas que permitem consultar informações do projeto e da infraestrutura sem precisar ficar levando tudo manualmente para o chat.
O que é MCP e por que ele faz diferença no desenvolvimento?
MCP é a sigla para Model Context Protocol, um protocolo aberto que padroniza a comunicação entre aplicações de inteligência artificial e ferramentas ou fontes externas de informação.
Na prática, ele permite que um agente de IA acesse recursos de outros sistemas por meio de uma interface padronizada. Em vez de depender exclusivamente das informações que você escreve no prompt, o agente pode chamar ferramentas específicas, receber os resultados e utilizá-los para executar uma tarefa.
Imagine que você esteja trabalhando em uma aplicação Laravel e peça ao Cursor para investigar um erro 500.
Sem uma integração desse tipo, provavelmente precisaria abrir o arquivo de log, copiar a exceção, explicar qual versão do Laravel está utilizando e talvez enviar também a estrutura das tabelas envolvidas.
Com MCP, o agente pode consultar ferramentas que fornecem essas informações diretamente. Ele consegue, por exemplo, verificar os dados da aplicação, consultar o schema do banco e buscar a documentação correspondente às versões instaladas.
A diferença é que o agente deixa de depender tanto de informações que você precisa fornecer manualmente.
MCP não torna a inteligência artificial mais inteligente por conta própria. Ele permite que ela consulte ferramentas e dados que antes não estavam disponíveis no contexto da conversa.
Como funciona a comunicação entre o agente e as ferramentas?
Para entender o funcionamento, vale conhecer três componentes principais:
- Host: é a aplicação que oferece o ambiente para o agente, como o Cursor.
- MCP Client: é o componente responsável por estabelecer a comunicação com os servidores MCP.
- MCP Server: é o servidor que disponibiliza ferramentas e outros recursos para o cliente.
O servidor pode ser desenvolvido em diferentes linguagens e conectado a sistemas distintos. O importante é implementar o protocolo para que clientes compatíveis consigam descobrir e utilizar suas funcionalidades.
O MCP também define algumas capacidades que podem ser disponibilizadas:
| Componente | Função |
|---|---|
| Tools | Ferramentas que o agente pode executar, como consultar o banco ou listar aplicações |
| Resources | Dados que podem ser disponibilizados para leitura pelo cliente |
| Prompts | Modelos de instruções e fluxos reutilizáveis oferecidos pelo servidor |
Uma ferramenta, por exemplo, não é apenas uma função jogada para a IA. Ela possui um nome, uma descrição e um schema que define os parâmetros esperados. Isso ajuda o modelo a entender quando e como utilizá-la.
O fluxo simplificado fica assim:
Você
|
v
Cursor (Host)
|
v
Agente de IA
|
v
MCP Client
|
+--------------------+
| |
v v
Laravel Boost Coolify MCP
| |
v v
Aplicação Laravel VPS / Infraestrutura
O Cursor pode trabalhar com vários servidores MCP ao mesmo tempo. Cada um disponibiliza suas próprias ferramentas, e o agente escolhe quais utilizar de acordo com a tarefa.
Quais são os transportes utilizados pelo MCP?
Além de padronizar as ferramentas, o protocolo também define como cliente e servidor se comunicam. Dois transportes importantes são:
stdio (Standard Input/Output)
Nesse modelo, o cliente inicia o servidor como um processo local e conversa com ele por meio da entrada e saída padrão do sistema.
É bastante utilizado em ferramentas que rodam junto ao projeto. No caso do Laravel Boost, por exemplo, o Cursor pode executar um comando Artisan para iniciar o servidor MCP.
Streamable HTTP
Aqui, o servidor funciona como um serviço independente, acessível por uma URL HTTP. O cliente envia as mensagens do protocolo para esse endpoint.
É uma alternativa interessante para ferramentas que já estão hospedadas em algum servidor, como o MCP do Coolify na minha VPS.
Existe também o transporte antigo baseado em HTTP+SSE, que aparece em algumas integrações e documentações anteriores. Para novas configurações, vale conferir qual transporte o servidor realmente suporta.
Como utilizo MCP com Laravel Boost no Cursor

Um dos cenários em que mais aproveito MCP é durante o desenvolvimento de aplicações Laravel.
O Laravel Boost é uma ferramenta mantida pelo ecossistema Laravel que ajuda agentes de IA a trabalhar de acordo com as convenções do framework. Além das diretrizes e skills, ele disponibiliza um servidor MCP com ferramentas para consultar informações da aplicação.
Isso resolve um problema que aparece bastante quando trabalhamos com IA: o modelo pode conhecer muito bem o Laravel, mas não necessariamente sabe qual versão está instalada no projeto, quais pacotes estão sendo utilizados ou como o banco de dados foi estruturado.
Com o Boost, essas informações podem ser consultadas diretamente.
Instalando o Laravel Boost
O primeiro passo é adicionar o pacote ao projeto como dependência de desenvolvimento:
composer require laravel/boost --dev
Depois, execute o instalador:
php artisan boost:install
O instalador prepara os recursos do Boost e permite configurar a integração com os agentes compatíveis.
Se precisar registrar o servidor manualmente no Cursor, também é possível utilizar a configuração abaixo.
Crie o arquivo .cursor/mcp.json na raiz do projeto:
{
"mcpServers": {
"laravel-boost": {
"command": "php",
"args": ["artisan", "boost:mcp"]
}
}
}
Nesse exemplo, o Cursor inicia o servidor executando o comando Artisan dentro do contexto do projeto.
O comando php precisa estar disponível no ambiente em que o Cursor executa o processo. Se você utiliza múltiplas versões do PHP, vale conferir qual executável está sendo encontrado pelo sistema.
Depois de salvar a configuração, habilite o servidor nas configurações MCP do Cursor, caso ele ainda não esteja ativo.
Quais informações o Laravel Boost disponibiliza?
O interessante do Boost é que ele não oferece apenas uma conexão genérica com a aplicação. Existem ferramentas específicas para consultar diferentes partes do projeto.
Algumas das funcionalidades disponíveis são:
| Ferramenta | Como utilizo no desenvolvimento |
|---|---|
| Application Info | Consultar versões do PHP, Laravel, banco de dados e pacotes instalados |
| Database Schema | Conhecer tabelas, colunas e relacionamentos |
| Database Query | Consultar informações diretamente no banco de dados |
| Search Docs | Buscar documentação relacionada às versões e pacotes do projeto |
| Last Error | Consultar o último erro registrado na aplicação |
| Read Log Entries | Ler registros recentes dos logs |
| Browser Logs | Investigar erros e mensagens do JavaScript |
| Get Absolute URL | Obter URLs absolutas a partir de caminhos relativos |
| Record Rule | Registrar convenções do projeto em arquivos de regras |
Os nomes acima são os apresentados na documentação do Laravel Boost. A disponibilidade e o comportamento de cada ferramenta dependem da versão instalada e da configuração do projeto.
Exemplos de uso no meu workflow
É aqui que a integração começa a fazer diferença na rotina.
Imagine que estou implementando uma funcionalidade que depende de uma tabela existente. Posso pedir ao agente para consultar o schema antes de propor uma migration.
Em vez de assumir que a tabela possui determinada coluna, ele pode utilizar a ferramenta Database Schema para verificar a estrutura real.
Outro cenário é quando aparece um erro 500. Em vez de abrir o arquivo de log e copiar toda a exceção para o chat, posso pedir que o agente consulte o último erro utilizando Last Error.
Também é bastante útil quando preciso trabalhar com alguma funcionalidade específica do Laravel. Posso solicitar uma implementação e orientar o agente a consultar Search Docs antes de sugerir uma solução.
Isso reduz a chance de receber código baseado em métodos antigos, funcionalidades inexistentes ou exemplos de versões diferentes daquela utilizada no projeto.
E tem outro detalhe interessante: com Record Rule, posso solicitar que o agente registre uma convenção específica da aplicação. Essas regras ficam armazenadas em .ai/rules e podem ser compartilhadas com o restante da equipe por meio do Git.
Ou seja, não é apenas uma forma de consultar informações. O Boost também ajuda a manter o contexto e as convenções do projeto organizados.
Como conecto o MCP do Coolify à minha VPS
O segundo cenário é um pouco diferente. Em vez de conectar o agente a uma aplicação Laravel local, utilizo o MCP do Coolify para disponibilizar informações da infraestrutura hospedada na minha VPS.
Para quem não conhece, o Coolify é uma plataforma open source de self-hosting que facilita o gerenciamento de aplicações, bancos de dados, serviços e deploys em servidores próprios.
Como utilizo o Coolify para gerenciar meus projetos e serviços, ter essa integração com o Cursor é bastante útil.
Antes, quando precisava investigar algum problema de infraestrutura, era necessário abrir o painel, localizar a aplicação, conferir o estado dos recursos e consultar as informações do deploy.
Com o MCP, o agente pode fazer parte dessas consultas diretamente.
Configurando o Coolify MCP no Cursor
Diferentemente do Laravel Boost, que inicia um processo local, o MCP do Coolify funciona por meio de uma conexão HTTP.
O endpoint segue este padrão:
https://seu-coolify.example/mcp
No caso de uma instalação self-hosted, é necessário habilitar o servidor MCP nas configurações do Coolify. A documentação indica o caminho Settings → Advanced → API and MCP.
Também é necessário criar um token de API para a equipe que terá seus recursos acessíveis pelo agente.
Depois, podemos configurar o servidor no Cursor.
Como essa integração pode ser utilizada em diferentes projetos, faz sentido registrá-la na configuração global, localizada em ~/.cursor/mcp.json.
Exemplo:
{
"mcpServers": {
"coolify": {
"url": "https://seu-coolify.example/mcp",
"headers": {
"Authorization": "Bearer ${env:COOLIFY_TOKEN}"
}
}
}
}
Observe que não coloquei o token diretamente no arquivo. A variável COOLIFY_TOKEN deve estar disponível no ambiente em que o Cursor é executado.
O Cursor oferece suporte à interpolação de variáveis de ambiente na configuração MCP, permitindo manter credenciais fora do JSON.
Depois de salvar a configuração e disponibilizar a variável, basta habilitar a integração no Cursor.
O que consigo fazer com o MCP do Coolify?
A integração disponibiliza ferramentas para consultar e operar recursos da infraestrutura, respeitando as permissões do token utilizado.
Algumas ferramentas interessantes são:
| Ferramenta | Utilidade |
|---|---|
get_infrastructure_overview |
Consultar um resumo da infraestrutura |
list_unhealthy_resources |
Identificar recursos que apresentam problemas |
search_resources |
Localizar aplicações e outros recursos |
list_deployments |
Consultar o histórico de deploys |
get_deployment |
Obter informações de um deploy específico |
get_logs |
Consultar logs, conforme as permissões disponíveis |
Os nomes e as permissões das ferramentas podem variar conforme a versão e os recursos disponíveis no Coolify. Depois de conectar, a própria ferramenta coolify_help ajuda a descobrir as operações disponíveis.
Um exemplo prático: investigar um deploy com problema
Imagine que você publicou uma nova versão de uma aplicação e ela não iniciou corretamente.
Em vez de abrir o painel do Coolify e procurar manualmente o que aconteceu, pode pedir ao agente:
Consulte a infraestrutura do Coolify, identifique aplicações com problemas e verifique se existe algum deploy recente que possa estar relacionado.
O agente pode começar consultando get_infrastructure_overview, procurar recursos com problemas usando list_unhealthy_resources e localizar a aplicação com search_resources.
Dependendo das permissões disponíveis, também pode consultar informações do deploy e os logs necessários para investigar a falha.
É importante entender que isso não significa que o agente esteja acessando o servidor por SSH ou executando comandos diretamente no sistema operacional. Ele está utilizando as ferramentas disponibilizadas pelo servidor MCP do Coolify.
E essa diferença importa bastante, principalmente quando estamos falando de infraestrutura de produção.
O Browser do Cursor também faz parte desse workflow
O terceiro cenário é um pouco diferente dos anteriores.
O Cursor possui uma integração nativa com navegador que permite ao Agent navegar por páginas, interagir com elementos, preencher formulários, capturar screenshots e consultar informações do console e do tráfego de rede.
Não é necessário instalar um servidor MCP externo nem cadastrar outro endpoint no mcp.json. É uma ferramenta integrada ao próprio Cursor.
Mesmo assim, ela complementa muito bem o trabalho com MCP, porque permite que o agente não fique limitado ao código-fonte: ele também consegue observar o comportamento da aplicação no navegador.
Como utilizo o navegador no desenvolvimento?
Imagine que estou desenvolvendo uma tela administrativa em Laravel e preciso verificar se determinada funcionalidade está funcionando corretamente.
Posso pedir ao Agent para abrir a aplicação, acessar uma página específica, preencher um formulário e verificar o resultado.
Um fluxo de trabalho possível seria:
- Navegar até a URL da aplicação.
- Identificar os elementos disponíveis na página.
- Interagir com botões, links e campos de formulário.
- Preencher os dados necessários para reproduzir um cenário.
- Capturar uma screenshot para verificar o resultado visual.
- Consultar o console do navegador para identificar erros JavaScript.
- Analisar as requisições de rede quando houver algum problema na comunicação com a API.
Isso é particularmente interessante em aplicações que possuem uma interface mais complexa, com formulários, componentes dinâmicos e chamadas para APIs.
Também existe uma diferença importante entre essa integração e o recurso Browser Logs do Laravel Boost.
O Boost disponibiliza uma ferramenta para consultar os erros e mensagens do navegador. Já o Browser nativo do Cursor permite interagir com a página e executar tarefas de navegação e validação.
São recursos complementares, não a mesma coisa.
MCP é seguro? Cuidados antes de conectar suas ferramentas
Uma das coisas que considero mais importantes ao trabalhar com integrações desse tipo é entender exatamente o que estamos disponibilizando para o agente.
O MCP não ignora as permissões dos sistemas conectados. Se você fornece um token com acesso para consultar, modificar ou excluir recursos, o agente poderá utilizar as ferramentas correspondentes, respeitando as permissões configuradas.
Por isso, alguns cuidados são fundamentais.
Não coloque tokens diretamente no repositório
Arquivos de configuração MCP podem conter informações sensíveis, principalmente quando utilizam autenticação por Bearer Token.
Evite colocar credenciais diretamente no JSON e nunca envie tokens reais para um repositório público.
Prefira variáveis de ambiente ou mecanismos de armazenamento de segredos disponibilizados pelo cliente.
Utilize permissões mínimas
No Coolify, por exemplo, existem diferentes níveis de permissão para os tokens:
read: permite operações de consulta.read:sensitive: libera acesso a informações sensíveis, como determinados logs e valores de variáveis.deploy: permite operações relacionadas a deploy e ciclo de vida dos recursos.write: permite criar ou modificar recursos.delete: permite operações de exclusão.
Para começar, faz mais sentido utilizar um token com permissões de leitura e adicionar outras somente quando houver necessidade.
Não existe motivo para entregar acesso administrativo completo ao agente se ele precisa apenas consultar o estado das aplicações.
Tenha cuidado com ferramentas que modificam a infraestrutura
Algumas ferramentas MCP não apenas consultam informações. Elas podem iniciar deploys, reiniciar serviços, modificar configurações e até excluir recursos.
Por isso, recomendo começar com operações de leitura e manter a confirmação humana para ações que possam afetar ambientes importantes.
Também vale lembrar que ferramentas de consulta ao banco de dados não devem ser consideradas automaticamente seguras só porque são chamadas de ferramentas de leitura. É importante entender o comportamento de cada operação e o acesso que ela possui.
A ideia é facilitar o trabalho do agente, não entregar as chaves da produção e torcer para dar tudo certo.
MCP substitui Skills, Rules ou instruções do projeto?
Não. Apesar de trabalharem juntos, esses recursos possuem objetivos diferentes.
MCP disponibiliza ferramentas e fontes de dados. Já Skills e Rules ajudam a orientar o comportamento do agente e fornecer conhecimento específico para determinadas tarefas.
Por exemplo, no desenvolvimento Laravel:
- MCP: permite consultar o schema do banco, os logs e a documentação.
- Rules: definem convenções e decisões que o agente deve respeitar no projeto.
- Skills: fornecem instruções especializadas para tarefas específicas, como trabalhar com determinado pacote ou implementar uma funcionalidade.
Imagine que você tenha uma regra determinando que todos os controllers da aplicação devem utilizar uma classe base específica.
Essa informação pode estar registrada em uma Rule. Já o MCP permite que o agente consulte a estrutura real da aplicação para entender quais controllers existem e como estão organizados.
Um recurso complementa o outro.
Também não adianta instalar dezenas de servidores MCP esperando que a IA passe a desenvolver perfeitamente. A qualidade das ferramentas, das instruções e do contexto disponibilizado continua fazendo diferença.
Vale a pena utilizar MCP no desenvolvimento?
Na minha experiência com Cursor, Laravel Boost e Coolify, MCP é uma das integrações que mais fazem sentido quando começamos a utilizar agentes de IA no desenvolvimento.
O principal ganho não está em fazer a IA escrever mais código, mas em permitir que ela trabalhe com informações reais do ambiente em que estamos desenvolvendo.
Em vez de ficar copiando logs, explicando a estrutura do banco ou procurando informações no painel de deploy, posso disponibilizar ferramentas para que o agente consulte esses dados quando necessário.
E isso não fica limitado ao Laravel ou ao Coolify. Qualquer sistema que implemente o protocolo pode, em princípio, disponibilizar ferramentas para clientes compatíveis.
Se você trabalha com agentes de IA e ainda não utiliza MCP, minha sugestão é começar pequeno. Escolha uma ferramenta que resolva um problema recorrente no seu trabalho, conecte ao Cursor e experimente algumas consultas.
Depois que você entende como funciona, fica muito mais fácil perceber onde outras integrações podem ajudar.