mcp-khipu — MCP-сервер для Claude Code: что делает и как установить
Позволяет агенту принимать прямые банковские переводы в Чили через шлюз Khipu, оформлять возвраты и управлять вебхуками.
claude mcp add --env KHIPU_API_KEY=<KHIPU_API_KEY> --env KHIPU_RECEIVER_ID=<KHIPU_RECEIVER_ID> --env KHIPU_SECRET=<KHIPU_SECRET> --env KHIPU_BASE_URL=<KHIPU_BASE_URL> --transport stdio khipu -- npx -y @codespar/mcp-khipuЧто делает mcp-khipu
Сервер даёт агенту 21 инструмент для работы с чилийским платёжным сервисом Khipu. Через него модель может формировать счета на банковские переводы, проверять и отменять незавершённые операции, а также делать полные или частичные возвраты. Дополнительно поддерживаются регулярные списания по подписке, создание сессий для физических POS-терминалов и выгрузка списка поддерживаемых чилийских банков.
Для авторизации сервер ожидает переменную KHIPU_API_KEY для третьей версии API, которая отправляется в заголовке x-api-key. Если этот ключ не задан, сервер переключается на базовую HTTP-аутентификацию через KHIPU_RECEIVER_ID и KHIPU_SECRET. Без одного из этих вариантов авторизации обращения к шлюзу завершатся ошибкой.
Запросы отправляются в формате JSON. Запустить сервер можно локально через stdio либо как отдельный HTTP-сервис, передав флаг MCP_HTTP=true и порт в MCP_PORT.
Какие задачи решает
- создать платёж для прямого банковского перевода в Чили
- оформить частичный или полный возврат средств покупателю
- получить список доступных чилийских банков
- зарегистрировать обработчик вебхуков для уведомлений о статусе оплаты
Примеры запросов агенту
- Создай платёж в Khipu на сумму 25000 CLP за заказ 1042
- Покажи статус банковского перевода по идентификатору
pay-884 - Выведи список чилийских банков, которые сейчас поддерживает Khipu
Как установить mcp-khipu
Командой платформы
claude mcp add --env KHIPU_API_KEY=<KHIPU_API_KEY> --env KHIPU_RECEIVER_ID=<KHIPU_RECEIVER_ID> --env KHIPU_SECRET=<KHIPU_SECRET> --env KHIPU_BASE_URL=<KHIPU_BASE_URL> --transport stdio khipu -- npx -y @codespar/mcp-khipuВместо <…> подставьте свои значения
Командой платформы
codex mcp add khipu --env KHIPU_API_KEY=<KHIPU_API_KEY> --env KHIPU_RECEIVER_ID=<KHIPU_RECEIVER_ID> --env KHIPU_SECRET=<KHIPU_SECRET> --env KHIPU_BASE_URL=<KHIPU_BASE_URL> -- npx -y @codespar/mcp-khipuВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"khipu": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-khipu"
],
"env": {
"KHIPU_API_KEY": "<KHIPU_API_KEY>",
"KHIPU_RECEIVER_ID": "<KHIPU_RECEIVER_ID>",
"KHIPU_SECRET": "<KHIPU_SECRET>",
"KHIPU_BASE_URL": "<KHIPU_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"khipu": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-khipu"
],
"env": {
"KHIPU_API_KEY": "<KHIPU_API_KEY>",
"KHIPU_RECEIVER_ID": "<KHIPU_RECEIVER_ID>",
"KHIPU_SECRET": "<KHIPU_SECRET>",
"KHIPU_BASE_URL": "<KHIPU_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e KHIPU_API_KEY=<KHIPU_API_KEY> -e KHIPU_RECEIVER_ID=<KHIPU_RECEIVER_ID> -e KHIPU_SECRET=<KHIPU_SECRET> -e KHIPU_BASE_URL=<KHIPU_BASE_URL> khipu npx -y @codespar/mcp-khipuВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-khipu
Как установить mcp-khipu в Claude Code?
Выполните в терминале команду claude mcp add mcp-khipu -e KHIPU_API_KEY=<KHIPU_API_KEY> -e KHIPU_SECRET=<KHIPU_SECRET> -- npx -y @codespar/mcp-khipu, передав свои учётные данные.
Что делает mcp-khipu?
Он связывает ассистента с чилийским шлюзом Khipu, позволяя выставлять счета на банковские переводы в реальном времени, запрашивать список транзакций и регистрировать вебхуки.
Как настроить аутентификацию для шлюза?
Основной вариант — указать ключ KHIPU_API_KEY для API v3. Для старых интеграций v2 можно передать пару KHIPU_RECEIVER_ID и KHIPU_SECRET.
