Medusa MCP: Революция в управлении данными для коммерческих приложений

Недавно была анонсирована Medusa MCP — удаленный сервер MCP, который упрощает доступ к данным для ваших агентов. Этот инструмент повышает эффективность операций и разработки, интегрируясь в повседневные рабочие процессы агентов, позволяя извлекать данные, создавать отчеты по продажам, исследовать неудачные развертывания и многое другое.

Интеграция с бизнес-логикой

Medusa MCP не ограничивается только основными моделями данных и рабочими процессами Medusa. Он также поддерживает бизнес-логику и функциональность из коробки. Это означает, что любые функции, которые вы открываете через API, могут быть доступны с сервера MCP. Это включает в себя подписки, аналитику и интегрированные платформы CMS.

Ограничения традиционных подходов к серверам MCP

Большинство коммерческих платформ, предлагающих серверы MCP, предоставляют специфические инструменты для каждой операции. Например, существует инструмент `read_product` для получения информации о продукте и отдельный `create_cart` для создания корзины. Несмотря на то, что такой подход работает, у него есть несколько ограничений:

Ограничения инструментов: Клиенты MCP имеют лимит на количество инструментов, принимаемых от сервера MCP. Например, VS Code принимает 128 инструментов, в то время как Cursor — 40. Это означает, что некоторые операции могут быть недоступны.

Пользовательские инструменты: У вас нет возможности добавлять инструменты для вашей бизнес-логики, и если такая возможность есть, вам придется самостоятельно реализовывать и поддерживать эти инструменты.

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

Решение проблем с Medusa MCP

При создании Medusa MCP наша цель заключалась не только в предоставлении операций через сервер MCP, но и в решении вышеуказанных проблем для пользователей. Medusa MCP предлагает сервер, который работает с данными вашего магазина и поддерживает любые ваши сценарии использования.

Два инструмента для каждого API-роута

Вместо того чтобы создавать отдельные инструменты для каждой основной коммерческой операции, Medusa MCP предлагает два универсальных инструмента для доступа к данным вашего магазина:

`read_admin_api`: Выполняет операцию чтения по любому API-роуту, начинающемуся с `/admin`. Этот инструмент обрабатывает необходимую аутентификацию, что позволяет избежать передачи учетных данных агенту.

`read_store_api`: Выполняет операцию чтения по любому API-роуту, начинающемуся с `/store`. Он обрабатывает передачу необходимых заголовков, таких как открытый API-ключ вашего магазина.

Поиск доступных API-роутов

Как агент узнает, какие API-роуты доступны, особенно если это пользовательские маршруты? Medusa Cloud хранит API-роуты среды в виде индекса поиска Medusa, преобразуя спецификации OpenAPI (OAS) в записи индекса.

Что такое спецификация OpenAPI?

Спецификация OpenAPI — это стандартный документ для описания HTTP и REST API. Он используется для документирования, чтобы информировать о том, что набор API делает и как его можно использовать. Каждая запись в индексе поиска содержит информацию о методе API-роута, его описании и необходимых параметрах. Medusa MCP предоставляет следующие инструменты:

`find_commerce_api`: Позволяет искать по записям OAS среды пользователя, находя 10 наиболее релевантных API-роутов для запроса.

`describe_commerce_api`: Позволяет получить все детали о конкретном API-роуте, включая ожидаемые параметры.

Обнаружение пользовательских API-роутов

При создании вашего проекта для нового развертывания на Medusa Cloud мы обнаруживаем доступные API-роуты вашего магазина. Для основных API-роутов мы определяем версию вашего приложения Medusa и получаем OAS, который мы храним для этой версии. Для пользовательских API-роутов мы используем API компилятора TypeScript для их обнаружения и преобразования в OAS.

Заключение: Без ограничений для ваших коммерческих операций

С помощью этой реализации Medusa MCP решает три ограничения, которые накладывают традиционные подходы к серверам MCP. Теперь нет необходимости учитывать лимиты инструментов, пользовательские API-роуты и рабочие процессы обрабатываются как часть инструментов чтения и записи, и доступ к ним доступен из коробки при развертывании на Medusa Cloud.

Начало работы с Medusa Cloud

Чтобы начать использовать Medusa MCP, вам нужно развернуть ваш проект на Medusa Cloud. После этого вы сможете управлять им с помощью вашего AI-агента. Дополнительную информацию можно найти в документации по Medusa MCP.