# Laravel MCP

Pacote oficial Laravel para construir rapidamente servidores Model Context Protocol (MCP), permitindo interações perfeitas de clientes de IA com aplicações Laravel através de ferramentas, recursos e prompts.

Canonical URL: https://a2a-mcp.org/entry/laravel-mcp-pt

Language: pt

Category: MCP Servers

Updated: 2026-03-24

## Visão Geral

O Laravel MCP é o pacote oficial desenvolvido pela equipe do Laravel para permitir que desenvolvedores construam servidores de **Model Context Protocol (MCP)** diretamente dentro de aplicações Laravel. Lançado em 2025 como parte do conjunto de ferramentas de IA do Laravel, ele fornece uma interface fluida e nativa do Laravel para definir servidores, ferramentas, recursos e prompts que permitem que qualquer cliente de IA compatível com MCP (Claude, ChatGPT, Cursor, GitHub Copilot, etc.) interaja de forma segura e eficiente com sua aplicação Laravel.

Ao integrar o Laravel MCP, as aplicações ganham a capacidade de expor capacidades estruturadas para agentes de IA sem APIs personalizadas, seguindo o padrão MCP aberto originalmente introduzido pela Anthropic e agora administrado pela Linux Foundation.

## Principais Recursos

- **Definição Expressiva de Servidor**: Use atributos e APIs fluentes para configurar metadados do servidor (nome, versão, instruções).
- **Ferramentas, Recursos & Prompts**: Registre classes personalizadas para ferramentas executáveis, recursos legíveis e modelos de prompt reutilizáveis.
- **Scaffolding Artisan**: Gere esqueletos completos de servidor MCP com `php artisan make:mcp-server`.
- **Integração Nativa do Laravel**: Aproveita Eloquent, cache, filas, autenticação Sanctum e o container de serviço.
- **Suporte a HTTP & SSE Transmissíveis**: Construído sobre transportes MCP modernos para interações em tempo real e escaláveis.
- **Segurança & Autenticação**: Fácil integração com Laravel Sanctum ou Passport para autenticação baseada em token.
- **Suporte a Testes**: Funciona perfeitamente com Pest/PHPUnit para testar ferramentas e comportamento do servidor.

## Instalação & Início Rápido

Instale via Composer:

```bash
composer require laravel/mcp
```

Publique rotas e configuração (opcional):

```bash
php artisan vendor:publish --tag=mcp-config
php artisan vendor:publish --tag=mcp-routes
```

Crie seu primeiro servidor:

```bash
php artisan make:mcp-server WeatherServer
```

Exemplo de classe de servidor:

```php
<?php

namespace App\Mcp\Servers;

use Laravel\Mcp\Server;
use Laravel\Mcp\Server\Attributes\Name;
use Laravel\Mcp\Server\Attributes\Version;
use Laravel\Mcp\Server\Attributes\Instructions;

#[Name('Weather Server')]
#[Version('1.0.0')]
#[Instructions('Provides current weather and forecasts for locations worldwide.')]
class WeatherServer extends Server
{
    protected array $tools = [
        \App\Mcp\Tools\GetCurrentWeather::class,
    ];

    protected array $resources = [
        \App\Mcp\Resources\WeatherGuidelines::class,
    ];
}
```

## Casos de Uso

- **Ferramentas de Desenvolvimento com IA**: Expor contextos específicos do Laravel (rotas, modelos, migrações) para agentes de codificação, como Claude Code ou Cursor.
- **Integração de Aplicações de Negócio**: Permitir que assistentes de IA consultem dados de CRM, gerenciem tarefas ou interajam com funcionalidades de e-commerce.
- **Servidores Locais e Remotos**: Executar servidores MCP localmente para desenvolvimento ou implantá-los remotamente para integrações de IA em produção.
- **Compatibilidade Multi-Cliente**: Um único servidor funciona em todas as principais plataformas de IA que suportam MCP (Anthropic, OpenAI, Google, Microsoft).

Os benchmarks da comunidade mostram que o Laravel MCP reduz o tempo de integração para funcionalidades de IA em 5–8× comparado a endpoints personalizados, com zero lock-in de fornecedor, graças ao protocolo aberto.

## Dicas Avançadas e Armadilhas Comuns

- Use o middleware Sanctum em servidores de produção para proteger a execução de ferramentas.
- Implemente limitação de taxa (rate limiting) em chamadas de ferramentas para prevenir abusos.
- Utilize templates de recursos para exposição dinâmica de dados (ex: resultados de consultas Eloquent).
- **Armadilha**: Esquecer de registrar rotas — sempre execute `php artisan route:cache` após alterações.
- **Avançado**: Combine com o Laravel Boost (outro servidor MCP de primeira parte) para uma experiência de desenvolvimento local aprimorada.

## Conclusão e Recursos

O Laravel MCP representa o compromisso oficial do Laravel com o emergente ecossistema de agentes de IA. Conforme a adoção do MCP cresce em 2026, ter um servidor MCP em seu aplicativo Laravel o posiciona como uma infraestrutura nativa para IA.

Comece a construir hoje:
- Documentação Oficial: https://laravel.com/docs/12.x/mcp
- GitHub: https://github.com/laravel/mcp
- Explore o aplicativo de demonstração Locket: https://github.com/laravel/locket

Contribua para o pacote ou construa seu primeiro servidor MCP — o futuro do desenvolvimento Laravel assistido por IA está aqui.

## Tags

- laravel
- mcp
- ia
- php
- servidor
- protocolo-de-contexto-de-modelo
- ferramentas
- recursos
- prompts

## Sources

- [Project website](https://github.com/laravel/mcp)