Adyen MCP Server

Что умеет сервер

Сервер Adyen в альфа-версии открывает ИИ-клиенту часть API Adyen. Инструменты Checkout API: создание сессии платежа, получение результата сессии и доступных способов оплаты, создание, проверка и принудительное закрытие платёжных ссылок, отмена авторизованного платежа и возврат захваченного платежа.

Инструменты Management API: список торговых аккаунтов, терминалы (список, переназначение, действия, настройки), приложения и сертификаты Android, вебхуки (список, получение, тест), способы оплаты, пользователи, учётные данные API и разрешённые источники.

Когда использовать

Подходит для эксплуатации платёжной инфраструктуры Adyen: выпустить платёжную ссылку для клиента, проверить статус сессии, найти вебхуки торгового аккаунта, оформить возврат. Разработчикам удобно, когда ассистент отвечает на вопросы об аккаунте, не заходя в панель.

Авторы советуют запускать только нужное подмножество инструментов параметром --tools, а не все сразу.

Ограничения и безопасность

Статус проекта: альфа. Возвраты, отмены, переназначение терминалов и изменение настроек терминалов затрагивают боевую инфраструктуру, поэтому начинайте с тестовой среды (--env=TEST). Для боевой среды нужен также префикс боевых адресов (--livePrefix).

Ключ API задавайте через переменную окружения ADYEN_API_KEY так, чтобы он не попал в историю командной строки. Adyen рекомендует создать для этого приложения нового пользователя веб-сервиса с отдельным ключом и выдать ему только роли, нужные для выбранных инструментов (например, Checkout Webservice Role, Management API – Webhooks read, Terminals read).

Запуск через npx

Сначала задайте ключ без попадания в историю оболочки:

read -s ADYEN_API_KEY
export ADYEN_API_KEY

Тестовая среда:

npx -y @adyen/mcp --env=TEST

Боевая среда с префиксом боевых адресов:

npx -y @adyen/mcp --env=LIVE --livePrefix=YOUR_PREFIX_URL

Только нужное подмножество инструментов:

npx -y @adyen/mcp --env=TEST --tools=list_all_company_webhooks,list_all_merchant_webhooks

VS Code

Пример для .vscode:

{
  "servers": {
    "adyen-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@adyen/mcp", "--env=TEST"],
      "env": {
        "ADYEN_API_KEY": "${ADYEN_API_KEY}"
      }
    }
  }
}