﻿---
title: "MCP: протокол инструментов"
description: "Model Context Protocol: как подключить данные и инструменты к агенту один раз и использовать в любом клиенте."
---

Model Context Protocol (MCP) — открытый протокол, который описывает, как агент
получает доступ к внешним возможностям: файлам, базам, API, поиску. Вместо того
чтобы писать отдельную обёртку под каждый фреймворк, сервер объявляет свои
возможности один раз, а любой клиент их подключает.

## Зачем нужен протокол

До MCP интеграция была матрицей «фреймворк × сервис». Каждый фреймворк описывал
инструменты по-своему, и один и тот же доступ к базе приходилось реализовывать
несколько раз. MCP сводит это к двум ролям:

- **Сервер** объявляет инструменты (tools), ресурсы (resources) и подсказки
  (prompts).
- **Клиент** — агент или приложение — обнаруживает их и вызывает.

```mermaid
flowchart LR
  A["Агент (клиент)"] -->|"list_tools"| S["MCP-сервер"]
  S -->|"схемы инструментов"| A
  A -->|"call_tool(name, args)"| S
  S -->|"результат"| A
```

## Что объявляет сервер

| Примитив | Назначение | Пример |
| --- | --- | --- |
| Tools | Действия, которые модель может вызвать | `search_orders`, `create_ticket` |
| Resources | Данные для чтения по ссылке | файл, запись, документ |
| Prompts | Готовые шаблоны запросов | разбор инцидента, ревью |

Разделение важно: tools меняют состояние или выполняют работу, resources только
читаются. Клиент может ограничить одно и не давать другое.

## Транспорт

Спецификация описывает несколько транспортов: стандартный ввод-вывод для
локального процесса и HTTP с потоковой передачей для удалённого сервера. Выбор
влияет на модель угроз: локальный сервер работает с правами процесса, удалённый
требует аутентификации и сетевой изоляции.

## MCP и безопасность

MCP не отменяет правил из [«Инструментов»](https://wpcraft.ru/aia/foundations/tools.md) и
[«Безопасности агента»](https://wpcraft.ru/aia/production/security.md):

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

Последний пункт — самый частый источник проблем: подключение «удобного» сервера из
непроверенного источника даёт агенту канал записи в вашу инфраструктуру.

## MCP на практике

Рабочий сценарий — три шага: настроить CrewAI с доступом к MCP-серверу, обернуть
FastMCP как обычный инструмент и собрать иерархический процесс. Главный вывод:
MCP-сервер подключается к агенту как инструмент, а маршрутизация остаётся за
фреймворком — протокол и оркестрация не конфликтуют.

Пошаговый разбор связки — в [«CrewAI»](https://wpcraft.ru/aia/frameworks/crewai.md).

## Когда MCP не нужен

- Один агент и один инструмент: прямая функция проще.
- Высокие требования к задержке: лишний сетевой хоп заметен.
- Закрытый контур без переиспользования: протокол даёт ценность при нескольких
  клиентах.

MCP выигрывает там, где инструменты переиспользуются между агентами, командами и
фреймворками.

## Материалы и источники

- [Model Context Protocol](https://modelcontextprotocol.io) — спецификация, транспорты и примитивы.