mcp-wompi — MCP-сервер для Claude Code: что делает и как установить
Подключает колумбийский платёжный шлюз Wompi от Bancolombia к ИИ-агентам для работы с платежами через PSE и кошельки Nequi.
claude mcp add mcp-wompi -e WOMPI_PUBLIC_KEY=<WOMPI_PUBLIC_KEY> -e WOMPI_PRIVATE_KEY=<WOMPI_PRIVATE_KEY> -e WOMPI_EVENTS_SECRET=<WOMPI_EVENTS_SECRET> -- npx -y @codespar/mcp-wompiЧто делает mcp-wompi
Сервер даёт доступ к 22 инструментам для управления шлюзом Wompi. С их помощью агент может генерировать ссылки на оплату, проверять историю транзакций и создавать возвраты средств. Поддерживается асинхронная токенизация мобильных кошельков Nequi, работа с банковскими картами и получение актуального перечня банков для PSE.
Запуск возможен через stdio или как локальный HTTP-сервис на порту 3000. Для отправки запросов обязательно нужны ключи WOMPI_PUBLIC_KEY и WOMPI_PRIVATE_KEY. Если планируется сверка подписей входящих событий, дополнительно задаётся WOMPI_EVENTS_SECRET. Без действующих ключей из личного кабинета Wompi вызовы API завершаются ошибкой авторизации.
Какие задачи решает
- генерировать платёжные ссылки Wompi прямо из диалога с агентом
- оформлять возвраты средств по идентификаторам транзакций
- токенизировать кошельки Nequi и банковские карты для повторных списаний
- проверять подлинность подписей входящих вебхуков
Примеры запросов агенту
- Сгенерируй платёжную ссылку Wompi для счёта #842 на 45000 COP
- Проверь статус транзакции
tx_test_9012в Wompi - Запроси список банков, доступных для платежей через PSE
Как установить mcp-wompi
Командой платформы
claude mcp add mcp-wompi -e WOMPI_PUBLIC_KEY=<WOMPI_PUBLIC_KEY> -e WOMPI_PRIVATE_KEY=<WOMPI_PRIVATE_KEY> -e WOMPI_EVENTS_SECRET=<WOMPI_EVENTS_SECRET> -- npx -y @codespar/mcp-wompiВместо <…> подставьте свои значения
Командой платформы
codex mcp add wompi --env WOMPI_PUBLIC_KEY=<WOMPI_PUBLIC_KEY> --env WOMPI_PRIVATE_KEY=<WOMPI_PRIVATE_KEY> --env WOMPI_EVENTS_SECRET=<WOMPI_EVENTS_SECRET> -- npx -y @codespar/mcp-wompiВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"wompi": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-wompi"
],
"env": {
"WOMPI_PUBLIC_KEY": "<WOMPI_PUBLIC_KEY>",
"WOMPI_PRIVATE_KEY": "<WOMPI_PRIVATE_KEY>",
"WOMPI_EVENTS_SECRET": "<WOMPI_EVENTS_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"wompi": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-wompi"
],
"env": {
"WOMPI_PUBLIC_KEY": "<WOMPI_PUBLIC_KEY>",
"WOMPI_PRIVATE_KEY": "<WOMPI_PRIVATE_KEY>",
"WOMPI_EVENTS_SECRET": "<WOMPI_EVENTS_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e WOMPI_PUBLIC_KEY=<WOMPI_PUBLIC_KEY> -e WOMPI_PRIVATE_KEY=<WOMPI_PRIVATE_KEY> -e WOMPI_EVENTS_SECRET=<WOMPI_EVENTS_SECRET> wompi npx -y @codespar/mcp-wompiВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-wompi
Как установить mcp-wompi в Claude Code?
Выполните команду `claude mcp add mcp-wompi -e WOMPI_PUBLIC_KEY=<WOMPI_PUBLIC_KEY> -e WOMPI_PRIVATE_KEY=<WOMPI_PRIVATE_KEY> -e WOMPI_EVENTS_SECRET=<WOMPI_EVENTS_SECRET> -- npx -y @codespar/mcp-wompi` в терминале.
Что делает mcp-wompi?
Сервер связывает ИИ-ассистента с API Wompi, позволяя управлять операциями эквайринга, формировать ссылки для покупателей и сверять статусы платежей.
Какие платёжные направления поддерживаются?
Инструменты рассчитаны на работу с колумбийскими реквизитами, включая систему межбанковских платежей PSE, кошельки Nequi и банковские карты.
