🤖 GraphQL для ИИ-агента: как мы превращаем GraphQL операции в MCP-инструменты
**СберТех рассказал, как подключить GraphQL API DataSpace к ИИ-агентам через MCP**
Данил, TypeScript-разработчик в команде Platform V DataSpace в СберТехе, описал, как модуль DataSpace подключается к ИИ-агентам через Model Context Protocol (MCP). DataSpace — это модуль платформы для визуальной (low-code) разработки бизнес-приложений и управления данными, который предоставляет GraphQL API для работы с базой данных. Продукт развивается уже несколько лет, но бурное развитие ИИ и MCP поставило задачу подключить этот API к агентам. MCP нужен, чтобы ИИ-клиент мог обнаруживать инструменты, понимать их входные параметры и вызывать внешние системы через стандартный протокол.
Автор отмечает, что подключить GraphQL к MCP можно, и вопрос не в самой возможности, а в том, какой формы должен быть MCP-адаптер. Схема GraphQL уже описывает типы, входные аргументы и форму результата, но не отвечает на главный вопрос: какую часть API и с каким уровнем свободы следует открыть агенту. При этом есть ИИ-агент, которому нужно выполнять прикладные действия, а команда бэкенда хочет сохранить контроль над контрактом, типами и безопасностью.
В статье разобраны несколько вариантов адаптера. Самый гибкий — универсальный MCP-инструмент, который принимает GraphQL-запрос и переменные: агент сам формирует запрос, выбирает поля и передаёт переменные, но берёт на себя ответственность за корректность запроса, включая выбор полей, названия, правила работы с null и переменные. Такой подход даёт максимум свободы и подходит для исследований, локальной разработки, прототипирования, изучения незнакомой схемы и создания инструментов разработчика. Другой вариант — генерировать MCP-инструменты из корневых полей типов Query и Mutation: агент получает готовый набор инструментов с именами и аргументами, близкими к корневым полям, но набор следует за схемой GraphQL, которая часто шире и детальнее прикладного контракта. Примеры таких реализаций — Apollo MCP Server, WunderGraph Cosmo MCP Gateway и GraphQL Hive MCP plugin.
Команда DataSpace выбрала третий путь: генерировать MCP-инструменты из заранее подготовленных GraphQL-операций. В этом случае агент выбирает инструмент и заполняет переменные, а текст GraphQL-операции заранее задаёт разработчик. По структуре GraphQL-операция близка к MCP-инструменту: у неё есть имя, входные переменные, selection set и форма результата. Разработчик может прочитать операцию, провести ревизию и проверить по схеме; операции хранятся в репозитории, обсуждаются в pull request и используются как allowlist для доступной агенту поверхности API.
Для пользователей ИИ это важно тем, что подход даёт предсказуемый selection set, понятный аудит и полный контроль команды бэкенда над API-контрактом, поэтому он хорошо подходит для production-сценариев, корпоративных API и чувствительных данных. Кроме того, набор операций становится отдельным артефактом, который команда может поддерживать вместе с кодом, а сам подход хорошо ложится на динамические GraphQL-шлюзы Apollo, WunderGraph и Hive: они собирают доступные операции во время запуска и сразу предоставляют по ним API MCP.
Категория: ИИ
Теги: #ИИ #AI #Нейросети #Искра