Архитектура MCP: клиенты, серверы, инструменты, ресурсы и промпты

Понимание того, как Model Context Protocol работает изнутри, помогает создавать лучшие интеграции и устранять неполадки. Это руководство объясняет основные архитектурные концепции MCP.

Обзор архитектуры MCP

MCP построен по клиент-серверной архитектуре, где ИИ-ассистенты (клиенты) подключаются к сервисам (серверам), предоставляющим инструменты и данные. Вот как это работает:

┌─────────────────┐
│  ИИ-ассистент   │
│   (клиент MCP)  │
│                 │
│  - Claude       │
│  - Cursor       │
│  - Windsurf     │
└────────┬────────┘
         │
         │ Соединение HTTP/SSE
         │ (с заголовком Auth)
         │
         ▼
┌─────────────────┐
│  Сервер MCP 1   │  ┌─────────────────┐
│   (Workify)     │  │  Сервер MCP 2   │
│                 │  │  (другой сервис)│
│  Инструменты:   │  │                 │
│  - list_tasks   │  │  Инструменты:   │
│  - create_task  │  │  - read_file    │
│  - start_timer  │  │  - search_code  │
└─────────────────┘  └─────────────────┘
         │                     │
         └─────────┬───────────┘
                   │
         ┌─────────▼─────────┐
         │  Источники данных │
         │  (БД Workify,     │
         │   файловая система)│
         └───────────────────┘

Один клиент MCP может подключаться к нескольким серверам MCP одновременно, давая ИИ-ассистенту доступ к инструментам разных сервисов в одном разговоре.

Клиент MCP: ИИ-ассистент

Клиент MCP — это приложение ИИ-ассистента, с которым взаимодействуют пользователи. Оно отвечает за:

• Управление соединениями: установление и поддержание соединений с серверами MCP
• Обнаружение инструментов: запрос и кэширование доступных инструментов с каждого сервера
• Маршрутизацию запросов: определение, к какому серверу обращаться для каждого инструмента
• Обработку ответов: обработку результатов инструментов и представление их пользователям
• Управление ошибками: корректную обработку сбоев соединения, таймаутов и ошибок

Сервер MCP: поставщик сервиса

Сервер MCP предоставляет клиентам инструменты, ресурсы и промпты. Сервер MCP Workify предоставляет возможности управления проектами:

Обнаружение инструментов: как клиенты находят инструменты

Когда клиент MCP подключается к серверу, он сначала обнаруживает доступные инструменты через эндпоинт tools/list:

Каждый инструмент имеет схему, которая описывает:

• Имя: уникальный идентификатор (например, list_tasks)
• Описание: что делает инструмент
• Параметры: обязательные и опциональные входные данные
• Возвращает: ожидаемый формат вывода

Как проходят вызовы инструментов

Когда вы просите ИИ-ассистента выполнить действие, вот что происходит за кулисами:

1. Пользователь: «Создай задачу связаться с Acme Corp»

2. ИИ-ассистент (клиент):
   - Анализирует запрос
   - Определяет, что нужен инструмент create_task
   - Определяет, что инструмент с сервера MCP Workify
   - Извлекает параметры: title, description и т. д.

3. Запрос клиент → сервер:
   POST https://app.workify.ru/mcp
   Headers: Authorization: Bearer API_KEY
   Body: {
     "tool": "create_task",
     "arguments": {
       "title": "Follow up with Acme Corp",
       "description": "...",
       "due_date": "..."
     }
   }

4. Обработка на сервере:
   - Проверяет API-ключ
   - Проверяет права доступа
   - Создаёт задачу в базе данных
   - Возвращает объект задачи

5. Ответ сервер → клиент:
   {
     "task": {
       "id": 123,
       "title": "Follow up with Acme Corp",
       "status": "open",
       ...
     }
   }

6. ИИ-ассистент (клиент):
   - Получает ответ
   - Форматирует для пользователя
   - Подтверждает создание задачи

7. Пользователь видит: «Я создал задачу #123: связаться с Acme Corp»

Инструменты MCP Workify в действии

Вот как инструменты MCP Workify соотносятся с типичными действиями по управлению проектами:

Несколько серверов, один разговор

Одна из мощных возможностей MCP — способность подключаться к нескольким серверам одновременно. Ваш ИИ-ассистент может использовать инструменты разных сервисов в одном разговоре:

Транспортный уровень: HTTP vs STDIO

MCP поддерживает два транспортных механизма:

Узнайте больше о компромиссах в нашем руководстве по удалённым и локальным серверам MCP.

Обработка ошибок и отказоустойчивость

MCP включает встроенную обработку ошибок:

• Ошибки соединения: клиенты повторяют попытки с экспоненциальной задержкой
• Сбои аутентификации: понятные сообщения об ошибках подсказывают пользователям, как исправить API-ключи
• Ошибки валидации: серверы возвращают подробные сообщения об ошибках для неверных параметров
• Ограничение частоты: серверы могут сигнализировать о лимитах, клиенты снижают нагрузку соответственно
• Обработка таймаутов: длительные операции можно отменить или опрашивать