mcp-openpay — MCP-сервер для Claude Code
Подключает Openpay к ИИ-агенту для платежей, клиентов, подписок и выплат в MXN. Нужен для интеграций с мексиканским шлюзом.
claude mcp add --env OPENPAY_MERCHANT_ID=<OPENPAY_MERCHANT_ID> --env OPENPAY_PRIVATE_KEY=<OPENPAY_PRIVATE_KEY> --env OPENPAY_ENV=<OPENPAY_ENV> --transport stdio openpay -- npx -y @codespar/mcp-openpayЧто делает mcp-openpay
mcp-openpay добавляет агенту инструменты Openpay: создание и возврат платежей, работу с клиентами и картами, планы и подписки, выплаты в MXN, вебхуки и банковские счета. Всего доступно 23 инструмента. Платежи можно адресовать на уровне продавца или клиента через параметр customer_id.
Сервер запускается через npx в режиме stdio; для серверного тестирования есть HTTP-режим с MCP_HTTP=true MCP_PORT=3000. Он использует HTTP Basic и сам кодирует ключ в Base64. Для подключения нужны OPENPAY_MERCHANT_ID и OPENPAY_PRIVATE_KEY; OPENPAY_ENV задаёт sandbox или production, причём sandbox выбран по умолчанию.
Для карт лучше передавать токен, созданный на клиентской стороне через Openpay.js. Передача сырых PAN и CVV на сервер допустима только при соответствии PCI-DSS.
Какие задачи решает
- создать и вернуть платёж через Openpay
- завести клиента и сохранить токенизированную карту
- оформить подписку по плану
- выплатить MXN на банковский счёт
- зарегистрировать или удалить вебхук
Примеры запросов агенту
- Создай платёж Openpay для заказа из
orders.jsonи верни его идентификатор. - Создай план подписки и подключи к нему клиента с идентификатором
customer_id. - Проверь список выплат Openpay и зарегистрируй вебхук для новых событий.
Как установить mcp-openpay
Командой платформы
claude mcp add --env OPENPAY_MERCHANT_ID=<OPENPAY_MERCHANT_ID> --env OPENPAY_PRIVATE_KEY=<OPENPAY_PRIVATE_KEY> --env OPENPAY_ENV=<OPENPAY_ENV> --transport stdio openpay -- npx -y @codespar/mcp-openpayВместо <…> подставьте свои значения
Командой платформы
codex mcp add openpay --env OPENPAY_MERCHANT_ID=<OPENPAY_MERCHANT_ID> --env OPENPAY_PRIVATE_KEY=<OPENPAY_PRIVATE_KEY> --env OPENPAY_ENV=<OPENPAY_ENV> -- npx -y @codespar/mcp-openpayВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"openpay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-openpay"
],
"env": {
"OPENPAY_MERCHANT_ID": "<OPENPAY_MERCHANT_ID>",
"OPENPAY_PRIVATE_KEY": "<OPENPAY_PRIVATE_KEY>",
"OPENPAY_ENV": "<OPENPAY_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"openpay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-openpay"
],
"env": {
"OPENPAY_MERCHANT_ID": "<OPENPAY_MERCHANT_ID>",
"OPENPAY_PRIVATE_KEY": "<OPENPAY_PRIVATE_KEY>",
"OPENPAY_ENV": "<OPENPAY_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e OPENPAY_MERCHANT_ID=<OPENPAY_MERCHANT_ID> -e OPENPAY_PRIVATE_KEY=<OPENPAY_PRIVATE_KEY> -e OPENPAY_ENV=<OPENPAY_ENV> openpay npx -y @codespar/mcp-openpayВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-openpay
Как установить mcp-openpay в Claude Code?
Выполните claude mcp add mcp-openpay -e OPENPAY_MERCHANT_ID=<OPENPAY_MERCHANT_ID> -e OPENPAY_PRIVATE_KEY=<OPENPAY_PRIVATE_KEY> -- npx -y @codespar/mcp-openpay.
Что делает mcp-openpay?
Он даёт агенту 23 инструмента для платежей Openpay: клиентов, карт, подписок, выплат, банковских счетов и вебхуков.
Что нужно для работы mcp-openpay с картами?
Для подключения нужны OPENPAY_MERCHANT_ID и OPENPAY_PRIVATE_KEY. Для карт рекомендуется передавать токен Openpay.js; сырые PAN и CVV требуют соответствия PCI-DSS.
