Урок 01

Что такое MCP и зачем он нужен

MCP (Model Context Protocol) — открытый стандарт, который определяет, как AI-агенты общаются с внешними инструментами и источниками данных. Его представил Anthropic в ноябре 2024 года.

Проблема до MCP

Каждый AI-клиент (ChatGPT, Claude, Cursor) строил свои интеграции с приложениями. Разработчики писали отдельные адаптеры под каждый клиент.

MCP заменяет всё это одним стандартом. Любой MCP-совместимый клиент может подключиться к любому MCP-серверу.

Что даёт MCP для Laravel-приложения

Твоё приложение становится новой точкой входа. Раньше были:

  • Веб-интерфейс
  • JSON API

Теперь добавляется MCP-сервер.

Пользователи ChatGPT, Claude, Cursor могут:

  • Спрашивать данные из твоего приложения
  • Выполнять действия (создать заказ, отправить счёт)
  • Получать контекст без твоего участия

Три примитива MCP

Tools — функции, которые агент может вызывать. Создать заказ, найти клиента, отправить счёт.

Resources — данные, доступные по URI. Записи из БД, конфиги, документы.

Prompts — переиспользуемые шаблоны диалога. Например, «Проверь код» или «Проанализируй отзыв».

Когда MCP оправдан

Для одного разработчика — часто избыточно. Проще CLI или curl.

Для команды или пользователей — MCP даёт единую поверхность для интеграции. Не нужно писать адаптеры под каждый AI-клиент.

В энтерпрайзе — MCP растёт быстрее всего. Компаниям нужны централизованная авторизация и безопасность.

Архитектура

  • Host — AI-приложение (ChatGPT, Cursor, Claude Code)
  • Client — компонент хоста для подключения к серверам
  • Server — твой MCP-сервер в Laravel

Установка

composer require laravel/mcp
php artisan vendor:publish --tag=ai-routes

Создаётся routes/ai.php.

Требования

  • PHP 8.1+
  • Laravel 10, 11, 12 или 13

Итоги

  • MCP — стандарт для AI-интеграций
  • Заменяет кастомные адаптеры
  • Три примитива: Tools, Resources, Prompts
  • Для команд и пользователей
  • composer require laravel/mcp