GraphQL для ИИ-агента: как мы превращаем GraphQL операции в MCP-инструменты
Привет! На связи Данил, TypeScript‑разработчик в команде Platform V DataSpace в СберТехе. DataSpace — это модуль платформы для визуальной (low‑code) разработки бизнес‑приложений и управления данными. Он предоставляет GraphQL API для работы с базой данных. Мы развиваем продукт уже несколько лет, но сейчас из‑за бурного развития ИИ и MCP появилась вполне ожидаемая задача: подключить этот API к ИИ‑агентам через Model Context Protocol (МСP).MCP нужен, чтобы ИИ‑клиент мог обнаруживать инструменты, понимать их входные параметры и вызывать внешние системы через стандартный протокол. На первый взгляд GraphQL хорошо подходит на роль источника MCP‑инструментов: схема уже описывает типы, входные аргументы и форму результата, но сама по себе не отвечает на главный вопрос: «какую часть API и с каким уровнем свободы следует открыть агенту?».В DataSpace сценарий получился таким:- есть API GraphQL поверх модели данных;- есть ИИ‑агент, которому нужно выполнять прикладные действия;- между ними нужен MCP‑адаптер;- команда бэкенда хочет сохранить контроль над контрактом, типами и безопасностью.Вопрос оказался не в том, можно ли подключить GraphQL к MCP. Можно. Интереснее другое: какой формы должен быть MCP‑адаптер для API GraphQL?В этой статье я расскажу про несколько вариантов таких адаптеров и про наш выбор: генерировать MCP‑инструменты из заранее подготовленных GraphQL-операций. Читать далее