mcp-conekta — MCP-сервер для Claude Code: что делает и как установить
Подключает платёжный шлюз Conekta к ИИ-ассистенту. Помогает создавать заказы, управлять клиентами, списывать платежи и настраивать вебхуки через чат.
claude mcp add mcp-conekta -e CONEKTA_API_KEY=<CONEKTA_API_KEY> -- npx -y @codespar/mcp-conektaЧто делает mcp-conekta
Инструмент связывает агента с API мексиканского платёжного сервиса Conekta версии v2.2.0. Через 21 инструмент модель умеет выставлять счета, оформлять возвраты средств, принимать транзакции по картам, банковским переводам SPEI и наличными через сеть OXXO.
Сервер работает через протокол stdio или как отдельный HTTP-сервер на порту 3000 (порт можно переопределить через MCP_PORT). Авторизация устроена через Basic auth, где логином выступает токен сервиса, а пароль остаётся пустым. Без действующего CONEKTA_API_KEY в переменных окружения инструмент не выполнит ни одного запроса к API.
Какие задачи решает
- создать платёжный заказ и привязать к нему позиции товаров
- сформировать реквизиты для оплаты через OXXO или перевод SPEI
- оформить частичный или полный возврат по транзакции
- зарегистрировать и протестировать эндпоинты вебхуков
Примеры запросов агенту
- Создай заказ в Conekta на сумму 450 MXN с методом оплаты через OXXO для клиента
cust_123 - Найди последние события вебхуков и покажи статус платежа по заказу
ord_456 - Оформи возврат средств по транзакции
ch_789и отмени связанный заказ
Как установить mcp-conekta
Командой платформы
claude mcp add mcp-conekta -e CONEKTA_API_KEY=<CONEKTA_API_KEY> -- npx -y @codespar/mcp-conektaВместо <…> подставьте свои значения
Командой платформы
codex mcp add conekta --env CONEKTA_API_KEY=<CONEKTA_API_KEY> -- npx -y @codespar/mcp-conektaВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"conekta": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-conekta"
],
"env": {
"CONEKTA_API_KEY": "<CONEKTA_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"conekta": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-conekta"
],
"env": {
"CONEKTA_API_KEY": "<CONEKTA_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e CONEKTA_API_KEY=<CONEKTA_API_KEY> conekta npx -y @codespar/mcp-conektaВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-conekta
Как установить mcp-conekta в Claude Code?
Выполните команду в терминале: claude mcp add mcp-conekta -e CONEKTA_API_KEY=<CONEKTA_API_KEY> -- npx -y @codespar/mcp-conekta. Замените <CONEKTA_API_KEY> на действующий ключ из личного кабинета Conekta.
Что делает mcp-conekta?
Сервер даёт ассистенту 21 инструмент для работы с мексиканским платёжным шлюзом Conekta. Модель может заводить профили клиентов, списывать деньги, управлять привязанными картами и регистрировать вебхуки.
Можно ли запустить сервер через HTTP вместо stdio?
Да, для этого нужно передать переменную MCP_HTTP=true. По умолчанию трафик пойдёт на порт 3000, но номер порта можно изменить через переменную MCP_PORT.
