Что такое сервер Shopify MCP?
Сервер Shopify MCP — легковесный сервер, который предоставляет набор инструментов и подсказок для приложений на основе языковых моделей. Это позволяет им взаимодействовать напрямую с API и документацией разработчиков Shopify. Запустив этот сервер, вы предоставляете AI-агентам простой доступ к ключевым функциям платформы Shopify, таким как поиск документации, исследование схем GraphQL API и получение информации для новичков.
Как настроить
Чтобы настроить сервер Shopify MCP, вам нужно установить Node.js и npx. Используйте следующую команду для его запуска:
npx -y @shopify/dev-mcp@latest
Чтобы интегрировать с AI-приложениями, такими как Cursor или Claude Desktop, добавьте следующую конфигурацию:
{
"mcpServers": {
"shopify-dev-mcp": {
"command": "npx",
"args": ["-y", "@shopify/dev-mcp@latest"]
}
}
}
На Windows вы можете использовать:
{
"mcpServers": {
"shopify-dev-mcp": {
"command": "cmd",
"args": ["/k", "npx", "-y", "@shopify/dev-mcp@latest"]
}
}
}
Чтобы отключить телеметрию, установите переменную окружения OPT_OUT_INSTRUMENTATION:
{
"mcpServers": {
"shopify-dev-mcp": {
"command": "npx",
"args": ["-y", "@shopify/dev-mcp@latest"],
"env": {
"OPT_OUT_INSTRUMENTATION": "true"
}
}
}
}
Для экспериментальной документации по компонентам Polaris Web используйте:
{
"mcpServers": {
"shopify-dev-mcp": {
"command": "npx",
"args": ["-y", "@shopify/dev-mcp@latest"],
"env": {
"POLARIS_UNIFIED": "true"
}
}
}
}
Как использовать
- Запустите сервер Shopify MCP с использованием подходящей команды npx или вашей настроенной интеграции MCP.
- Подключите ваше приложение LLM (например, Cursor или Claude Desktop) к серверу с использованием предоставленной конфигурации. Это позволит получить прямой доступ к инструментам и документации API Shopify.
- Через интерфейс вашего AI-приложения найдите доступные инструменты или подсказки, вызывайте функции, такие как поиск документации для разработчиков, изучение схемы GraphQL Admin или получение документации напрямую.
- При необходимости включите или отключите дополнительные функции, такие как документация Polaris, с помощью переменных окружения.
Основные особенности
- Связывает AI-приложения с API и ресурсами Shopify через стандартизированный протокол
- Предоставляет инструменты для поиска, получения документации и доступа к схемам GraphQL
- Безопасный, локальный хостинг с гибкой конфигурацией переменных окружения
- Поддерживает как базовые, так и расширенные процессы адаптации разработчиков
- Расширяемый через MCP, что делает его совместимым с различными AI/LLM-клиентами
- Дополнительная поддержка документации по компонентам Polaris Web (экспериментальная)
Сценарии использования
- Быстро отвечать на запросы разработчиков о API Shopify и их использовании
- Писать, исследовать и отлаживать запросы и мутации API Admin GraphQL в интерактивном режиме
- Автоматизировать получение и отображение актуальной документации в инструментах разработчиков или чат-ботах
- Помогать новым разработчикам с прямым доступом к справочным материалам и руководствам по API с использованием AI
- Интегрировать возможности бэкэнда Shopify в рабочие процессы агентов или расширения IDE с помощью LLM
Часто задаваемые вопросы
В1: Могу ли я использовать сервер Shopify MCP с AI-инструментами, отличными от Cursor или Claude Desktop?
О1: Да. Если ваше приложение поддерживает протокол MCP, вы можете подключить его к серверу Shopify MCP.
В2: Какие разрешения нужны серверу?
О2: Серверу нужен доступ к сети для связи с API Shopify и доступ к любым локальным ресурсам, с которыми он интегрируется. Дополнительные привилегии не требуются, если не добавляется пользовательский код.
В3: Как мне обновиться до последней версии?
О3: Просто повторно запустите команду npx с "@latest", чтобы всегда получать и использовать самую новую версию пакета.
В4: Передаются ли мои данные Shopify или третьим лицам?
О4: Сервер по умолчанию выполняет ограниченную телеметрию для внутренних улучшений, но вы можете отключить всю телеметрию с помощью переменной окружения OPT_OUT_INSTRUMENTATION.
В5: Как мне добавить собственные инструменты или подсказки?
О5: Вы можете клонировать и изменить исходный код с использованием MCP SDK, а затем запустить свою пользовательскую сборку как сервер MCP. См. раздел разработки для инструкций по сборке.