mcp-bold-co — MCP-сервер для Claude Code: платёжные ссылки Bold
MCP-сервер mcp-bold-co для Bold — колумбийского эквайера. Создаёт платёжные ссылки на карты, PSE, Nequi и Botón Bancolombia прямо из агента.
MIT ★ 279 обновлён 2026-09-27
claude mcp add mcp-bold-co -e BOLD_API_KEY=<BOLD_API_KEY> -e BOLD_SECRET_KEY=<BOLD_SECRET_KEY> -- npx -y @codespar/mcp-bold-coЧто делает mcp-bold-co
Bold работает по принципу link-first: вы создаёте платёжную ссылку с фиксированной или открытой суммой, отдаёте плательщику payload.url и опрашиваете статус, пока ссылка не станет PAID. Сервер оборачивает этот API в семь инструментов: создание ссылки, два удобных метода для PSE и карт, проверка статуса, список методов оплаты и два локальных хелпера для подписи.
Локальные инструменты — generate_checkout_signature и validate_webhook_signature — считают SHA-256 для кнопки встроенного чекаута и проверяют HMAC-подпись вебхуков. Они не ходят в сеть, всё считается у вас. Для них нужен BOLD_SECRET_KEY, который API-ключом не является и в обычных запросах не участвует.
Тестовый режим без отдельного sandbox-хоста: Bold даёт тестовые ключи из своего дашборда. Если агент должен принимать платежи от колумбийских покупателей, этот сервер закрывает вопрос без написания обёртки над REST вручную.
Какие задачи решает
- создать платёжную ссылку на карту, PSE, Nequi или Botón Bancolombia
- ограничить ссылку одним методом — только PSE или только карты
- проверить статус ссылки: ACTIVE, PROCESSING, PAID, REJECTED, EXPIRED
- посчитать SHA-256 подпись для встроенной кнопки чекаута
- проверить HMAC-подпись входящего вебхука Bold
Примеры запросов агенту
- Создай платёжную ссылку на 50 000 COP для карт через
create_card_payment_link - Проверь статус ссылки по её id через
get_payment_link - Посчитай integrity-подпись для кнопки чекаута
Как установить mcp-bold-co
Командой платформы
claude mcp add mcp-bold-co -e BOLD_API_KEY=<BOLD_API_KEY> -e BOLD_SECRET_KEY=<BOLD_SECRET_KEY> -- npx -y @codespar/mcp-bold-coВместо <…> подставьте свои значения
Командой платформы
codex mcp add bold-co --env BOLD_API_KEY=<BOLD_API_KEY> --env BOLD_SECRET_KEY=<BOLD_SECRET_KEY> -- npx -y @codespar/mcp-bold-coВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"bold-co": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-bold-co"
],
"env": {
"BOLD_API_KEY": "<BOLD_API_KEY>",
"BOLD_SECRET_KEY": "<BOLD_SECRET_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"bold-co": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-bold-co"
],
"env": {
"BOLD_API_KEY": "<BOLD_API_KEY>",
"BOLD_SECRET_KEY": "<BOLD_SECRET_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e BOLD_API_KEY=<BOLD_API_KEY> -e BOLD_SECRET_KEY=<BOLD_SECRET_KEY> bold-co npx -y @codespar/mcp-bold-coВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-bold-co
Как установить mcp-bold-co в Claude Code?
Выполните claude mcp add mcp-bold-co -e BOLD_API_KEY=<BOLD_API_KEY> -e BOLD_SECRET_KEY=<BOLD_SECRET_KEY> -- npx -y @codespar/mcp-bold-co. После этого сервер доступен в сессии Claude Code.
Что делает mcp-bold-co?
Даёт агенту семь инструментов для работы с платёжным API Bold: создание ссылок на карты, PSE, Nequi и Botón Bancolombia, проверка статуса, список методов оплаты и локальные хелперы для подписей чекаута и вебхуков.
Нужен ли BOLD_SECRET_KEY?
Для создания платёжных ссылок достаточно BOLD_API_KEY. Секретный ключ нужен только для локальных инструментов подписи — generate_checkout_signature и validate_webhook_signature.