Чем помогает MCP Forge

Обновлено 11 декабря 2025

MCP Forge — ключевая технология для интеграции Сбера и партнера при реализации E2E-сценариев.

Model Context Protocol (MCP) — это открытый протокол, стандартизирующий взаимодействие между нейросетями и внешними системами. Он упрощает построение агентских систем, выступая «переводчиком» между языком бизнеса и вашим API.

Какие задачи решает MCP

• Делает универсальной интеграцию внешних систем с нейросетями.
• Сокращает время и ресурсы на разработку.
• Позволяет AI-моделям точнее интерпретировать запросы при решении многоэтапных задач.

Пример работы

Запрос AI-ассистенту: «Сколько заказов у компании «СтройЛюкс» за январь?».

Без MCP

У нейросети нет доступа к вашим системам:

• Она не знает, какая компания соответствует названию «СтройЛюкс».
• Не понимает формат и правил вызова вашего API.
• Не может преобразовать разговорный запрос в структурированные параметры.

С MCP

Процесс автоматизирован:

1. Распознает сущности: извлекает название компании «СтройЛюкс».
2. Определяет период: январь 2024 года.
3. Выполняет подготовительные запросы: find_company_by_name("СтройЛюкс") → получает company_id: "COMP_789".
4. Формирует и выполняет запрос к вашему API: GET /orders?company_id=COMP_789&date_from=2024-01-01&date_to=2024-01-31.
5. Преобразует ответ:
   • От API: {"orders": [...], "total": 5, "sum": 15000}.
   • Клиенту: «У компании «СтройЛюкс» 5 заказов за январь на сумму 15 000 ₽».

Диаграмма процесса взаимодействия API и MCP

JSON-схема взаимодействия с MCP

1. Клиент → AI-ассистент (начальный запрос)

{
  "user_id": "user_12345",
  "session_id": "session_abc789",
  "timestamp": "2024-01-15T10:30:00Z",
  "message": "Получи заказы компании «СтройЛюкс» за январь",
  "channel": "mobile_banking_chat"
}

2. AI-ассистент → MCP Server (запрос первого инструмента)

{
  "request_id": "req_001",
  "session_id": "session_abc789",
  "tool": "find_company_by_name",
  "arguments": {
    "company_name": "СтройЛюкс"
  },
  "context": {
    "user_intent": "get_company_orders",
    "original_query": "Получи заказы компании «СтройЛюкс» за январь",
    "extracted_entities": {
      "company_name": "СтройЛюкс",
      "period": "январь 2024"
    }
  }
}

3. MCP Server → AI-ассистент (результат первого инструмента)

{
  "request_id": "req_001",
  "session_id": "session_abc789",
  "success": true,
  "tool": "find_company_by_name",
  "result": {
    "company_id": "COMP_789",
    "legal_name": "ООО «СтройЛюкс»",
    "tax_id": "7701123456",
    "status": "active",
    "found": true,
    "metadata": {
      "account_manager": "Иванов И.И.",
      "contract_since": "2022-03-15"
    }
  },
  "timestamp": "2024-01-15T10:30:05Z"
}

4. AI-ассистент → MCP Server (запрос второго инструмента)

{
  "request_id": "req_002",
  "session_id": "session_abc789",
  "tool": "get_company_orders",
  "arguments": {
    "company_id": "COMP_789",
    "date_from": "2024-01-01",
    "date_to": "2024-01-31"
  },
  "context": {
    "previous_steps": [
      {
        "tool": "find_company_by_name",
        "result": {
          "company_id": "COMP_789",
          "company_name": "СтройЛюкс"
        }
      }
    ],
    "calculated_period": {
      "human_readable": "январь 2024 года",
      "date_from": "2024-01-01",
      "date_to": "2024-01-31"
    }
  }
}

5. MCP Server → Ваш API (вызов партнёрского эндпоинта)

{
  "method": "GET",
  "url": "https://api.partner.com/v1/orders",
  "headers": {
    "Authorization": "Bearer partner_api_token_xyz789",
    "X-Bank-ID": "bank_001",
    "X-Request-ID": "req_002_session_abc789",
    "Content-Type": "application/json"
  },
  "query_params": {
    "company_id": "COMP_789",
    "date_from": "2024-01-01",
    "date_to": "2024-01-31",
    "include_details": true,
    "currency": "RUB"
  },
  "timestamp": "2024-01-15T10:30:10Z"
}

6. Ваш API → MCP Server (ответ)

{
  "status": 200,
  "headers": {
    "Content-Type": "application/json",
    "X-API-Version": "1.2.0"
  },
  "body": {
    "success": true,
    "data": {
      "orders": [
        {
          "order_id": "ORD_20240115001",
          "date": "2024-01-15T09:15:00Z",
          "amount": 5000.00,
          "currency": "RUB",
          "items": ["Кирпич строительный", "Цемент М500"],
          "status": "completed"
        },
        {
          "order_id": "ORD_20240120001",
          "date": "2024-01-20T11:30:00Z",
          "amount": 10000.00,
          "currency": "RUB",
          "items": ["Плитка керамическая", "Клей для плитки"],
          "status": "shipped"
        }
      ],
      "summary": {
        "total_orders": 2,
        "total_amount": 15000.00,
        "currency": "RUB",
        "period": "2024-01-01 - 2024-01-31"
      },
      "company_info": {
        "company_id": "COMP_789",
        "company_name": "ООО «СтройЛюкс»"
      }
    },
    "pagination": {
      "total": 2,
      "page": 1,
      "per_page": 50
    }
  }
}

7. MCP Server → AI-ассистент (финальный результат)

{
  "request_id": "req_002",
  "session_id": "session_abc789",
  "success": true,
  "tool": "get_company_orders",
  "result": {
    "orders": [
      {
        "order_id": "ORD_20240115001",
        "date": "2024-01-15",
        "amount": 5000,
        "status": "completed"
      },
      {
        "order_id": "ORD_20240120001",
        "date": "2024-01-20",
        "amount": 10000,
        "status": "shipped"
      }
    ],
    "summary": {
      "total_orders": 2,
      "total_amount": 15000,
      "currency": "RUB",
      "period": "январь 2024"
    },
    "company": {
      "id": "COMP_789",
      "name": "СтройЛюкс"
    }
  },
  "formatted_for_ai": {
    "human_readable_summary": "За январь 2024 года найдено 2 заказа на общую сумму 15 000 ₽",
    "key_points": [
      "15 января: заказ на 5 000 ₽ (статус: выполнен)",
      "20 января: заказ на 10 000 ₽ (статус: отправлен)"
    ],
    "suggested_response": "У компании «СтройЛюкс» 2 заказа за январь 2024 года на сумму 15 000 ₽. Последний заказ от 20 января на 10 000 ₽ находится в статусе 'отправлен'."
  },
  "timestamp": "2024-01-15T10:30:15Z"
}

8. AI-ассистент → Клиент (финальный ответ)

{
  "session_id": "session_abc789",
  "response": "У компании «СтройЛюкс» 2 заказа за январь 2024 года на общую сумму 15 000 ₽.\n\n1. 15 января — 5 000 ₽ (статус: выполнен)\n2. 20 января — 10 000 ₽ (статус: отправлен)\n\nХотите увидеть детали по конкретному заказу?",
  "type": "text",
  "suggested_actions": [
    {
      "text": "Показать детали заказа от 20 января",
      "action": "show_order_details",
      "params": {"order_id": "ORD_20240120001"}
    },
    {
      "text": "Экспорт в Excel",
      "action": "export_orders",
      "params": {"company_id": "COMP_789", "period": "2024-01"}
    }
  ],
  "timestamp": "2024-01-15T10:30:20Z"
}

Итог

MCP — это не просто «коробка с инструментами», а общий стандарт, который устраняет технический хаос и ускоряет создание сложных ИИ-агентов.