Как подключить Payhip к Cursor через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Payhip, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Payhip + Cursor

Управляйте купонами магазина Payhip и проверяйте лицензионные ключи вашего ПО из AI-агента: список и детали купонов, создание новых после вашего одобрения, проверка лицензионного ключа покупателя, а с вашего разрешения также отключение, повторное включение и учёт активаций ключа.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

PAYHIP_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужен магазин Payhip и его API-ключ. Для лицензионных ключей нужен ещё товар, у которого включены лицензионные ключи.

1. В Payhip откройте Settings → Developer и скопируйте API key.
2. Вставьте только сам ключ в PAYHIP_API_KEY. Его используют инструменты для купонов.
3. По желанию, для лицензионных ключей: откройте товар в Payhip, отметьте Generate unique license keys, если это ещё не включено, и скопируйте product secret key, который показан под этим флажком, в PAYHIP_PRODUCT_SECRET_KEY.
4. Установите коннектор и запустите payhip_list_coupons: он покажет ваши купоны и подтвердит, что API-ключ работает. Если вы указали product secret key, запустите payhip_verify_license с ключом, который получил один из ваших покупателей, чтобы проверить и лицензии.

Один лицензируемый товар на установку: product secret key относится к одному товару. Чтобы проверять ключи нескольких товаров, установите коннектор отдельно для каждого и назовите каждую установку по товару. Купоны работают в любой установке, потому что используют API-ключ магазина.

Что он читает: купоны вашего магазина с кодом, типом (один товар, все товары или одна коллекция), скидкой в процентах или суммой, датами начала и окончания, минимальной суммой покупки, лимитом использований и заметками; а для настроенного товара состояние лицензионного ключа: включён ли он, email покупателя, товар и вариант, сколько раз он использован и когда выдан.

Только купоны и лицензионные ключи: сейчас API Payhip охватывает только эти две области. Товары, продажи, клиенты и выплаты через него недоступны.

Как читать данные: суммы (фиксированная скидка, минимальная сумма покупки) указаны в центах, процентная скидка в процентах. Пустой ответ payhip_verify_license значит, что для этого товара такого ключа нет. При возврате денег за покупку Payhip отключает ключ автоматически. Число использований ключа это счётчик, который увеличивает и уменьшает ваша программа; Payhip не следит за лимитом, это делает ваша программа.

Отключено при установке: payhip_create_coupon, payhip_disable_license, payhip_enable_license, payhip_increase_license_usage и payhip_decrease_license_usage. Новый купон действует при оформлении заказа сразу после создания, а отключённый ключ лишает покупателя доступа к вашей программе, пока его снова не включат. Товарам по подписке нельзя назначить купоны через API. Администратор включает те инструменты, которые вам нужны.

Спрашивает перед каждым изменением: когда инструмент записи включён, ИИ показывает код, скидку и на что она распространяется или лицензионный ключ и что с ним произойдёт, и ждёт вашего согласия.

Ограничения: списки купонов приходят страницами до 100 штук, поэтому в большом магазине ИИ листает их постранично, а не запрашивает всё сразу.

Частые ошибки: 401 authentication_fail означает, что API-ключ или product secret key неверный либо не указан: снова скопируйте PAYHIP_API_KEY из Settings → Developer, а для инструментов лицензий проверьте PAYHIP_PRODUCT_SECRET_KEY на странице товара. Файрвол Payhip устраивает проверку запросам по купонам с адресов дата-центров, поэтому они идут через исходящий прокси AnythingMCP там, где он настроен (как в AnythingMCP Cloud). На собственном сервере без CONNECTOR_PROXY_URL запросы по купонам могут отвечать 403 с HTML-страницей.

Коннектор не читает товары, продажи, клиентов и выплаты, не оформляет возвраты и не выдаёт новые лицензионные ключи.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты Payhip.

Доступные инструменты

Примеры запросов

• «Действителен ли лицензионный ключ 7XK2-9QPL-44MZ-H1TR? Кто его купил и сколько раз он использован?»
• «Покажи наши купоны со скидкой по каждому и скажи, у каких срок заканчивается в этом месяце.»
• «Какие условия у купона OSEN20: минимальная сумма покупки, лимит использований и к какому товару он относится?»
• «Покупатель пишет, что после возврата денег его ключ перестал работать. Проверь, включён ли он ещё и к какому email привязан.»
• «Какие из наших купонов действуют на все товары, а какие только на один товар или коллекцию?»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot