mcp-epayco — MCP-сервер для Claude Code: что делает и как установить
Подключает платёжный шлюз ePayco к AI-агенту: списывает средства с банковских карт и выставляет счета для колумбийской системы PSE.
claude mcp add --env EPAYCO_PUBLIC_KEY=<EPAYCO_PUBLIC_KEY> --env EPAYCO_PRIVATE_KEY=<EPAYCO_PRIVATE_KEY> --env EPAYCO_TEST=<EPAYCO_TEST> --transport stdio epayco -- npx -y @codespar/mcp-epaycoЧто делает mcp-epayco
Сервер предоставляет восемь инструментов для работы с эквайрингом ePayco. Среди них — токенизация карт, списание средств и проверка статуса платежа по коду referencePayco. Поддерживаются колумбийские межбанковские переводы через PSE с получением ссылки на оплату и актуального перечня банков.
Для наличных расчётов шлюз формирует квитанции в сетях Efecty, Gana, Red Servi, Punto Red и Su Red. Архитектура повторяет официальную библиотеку epayco-node. Запросы по картам уходят на api.secure.payco.co, а операции с PSE и наличными — на secure.payco.co.
Без действующих ключей сервер работать не будет. Для авторизации обязательны EPAYCO_PUBLIC_KEY и EPAYCO_PRIVATE_KEY. Тестовый режим не требует отдельного хоста. Переменная EPAYCO_TEST со значением true просто передаёт специальный флаг в теле каждого запроса.
Какие задачи решает
- токенизировать банковские карты и проводить списания
- получить актуальный перечень банков Колумбии для PSE
- сгенерировать ссылку для дебетового перевода через PSE
- выписать квитанцию на оплату наличными в сетях Efecty или Su Red
- проверить статус транзакции по её идентификатору
Примеры запросов агенту
- Сформируй платёжный ваучер Efecty на 50000 COP для заказа 104
- Запроси список банков в PSE и оформи дебетовый платёж
- Проверь статус транзакции с referencePayco 987654
Как установить mcp-epayco
Командой платформы
claude mcp add --env EPAYCO_PUBLIC_KEY=<EPAYCO_PUBLIC_KEY> --env EPAYCO_PRIVATE_KEY=<EPAYCO_PRIVATE_KEY> --env EPAYCO_TEST=<EPAYCO_TEST> --transport stdio epayco -- npx -y @codespar/mcp-epaycoВместо <…> подставьте свои значения
Командой платформы
codex mcp add epayco --env EPAYCO_PUBLIC_KEY=<EPAYCO_PUBLIC_KEY> --env EPAYCO_PRIVATE_KEY=<EPAYCO_PRIVATE_KEY> --env EPAYCO_TEST=<EPAYCO_TEST> -- npx -y @codespar/mcp-epaycoВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"epayco": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-epayco"
],
"env": {
"EPAYCO_PUBLIC_KEY": "<EPAYCO_PUBLIC_KEY>",
"EPAYCO_PRIVATE_KEY": "<EPAYCO_PRIVATE_KEY>",
"EPAYCO_TEST": "<EPAYCO_TEST>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"epayco": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-epayco"
],
"env": {
"EPAYCO_PUBLIC_KEY": "<EPAYCO_PUBLIC_KEY>",
"EPAYCO_PRIVATE_KEY": "<EPAYCO_PRIVATE_KEY>",
"EPAYCO_TEST": "<EPAYCO_TEST>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e EPAYCO_PUBLIC_KEY=<EPAYCO_PUBLIC_KEY> -e EPAYCO_PRIVATE_KEY=<EPAYCO_PRIVATE_KEY> -e EPAYCO_TEST=<EPAYCO_TEST> epayco npx -y @codespar/mcp-epaycoВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-epayco
Как установить mcp-epayco в Claude Code?
Выполните команду claude mcp add mcp-epayco -e EPAYCO_PUBLIC_KEY=<EPAYCO_PUBLIC_KEY> -e EPAYCO_PRIVATE_KEY=<EPAYCO_PRIVATE_KEY> -- npx -y @codespar/mcp-epayco, указав значения своих ключей.
Что делает mcp-epayco?
Сервер открывает ассистенту доступ к колумбийскому шлюзу ePayco для приёма карточных оплат, проведения переводов PSE и генерации наличных ваучеров.
Нужен ли отдельный адрес для тестовой среды?
Нет, запросы отправляются на стандартные рабочие хосты. Песочница активируется через переменную окружения EPAYCO_TEST="true", которая помечает тела запросов тестовым флагом.
