mcp-coinbase-commerce — MCP-сервер для приёма криптооплаты
18 инструментов Coinbase Commerce для агента: выставить счёт в фиате, принять оплату в BTC, ETH или USDC, проверить вебхук.
claude mcp add --env COINBASE_COMMERCE_API_KEY=<COINBASE_COMMERCE_API_KEY> --env COINBASE_COMMERCE_API_VERSION=<COINBASE_COMMERCE_API_VERSION> --env COINBASE_COMMERCE_WEBHOOK_SECRET=<COINBASE_COMMERCE_WEBHOOK_SECRET> --transport stdio coinbase-commerce -- npx -y @codespar/mcp-coinbase-commerceЧто делает mcp-coinbase-commerce
Сервер подключает агента к платёжной стороне Coinbase Commerce. Заказ оценивается в местной валюте, покупатель платит в BTC, ETH, USDC или другом поддерживаемом активе, а расчёт приходит вам в выбранной криптовалюте или фиате. Внутри 18 инструментов: разовые счета, переиспользуемые checkout-ссылки, адресные инвойсы, список событий и курс обмена.
Каждый запрос уходит с двумя заголовками — X-CC-Api-Key и X-CC-Version. Без ключа и версии API ничего не заработает. Ключ берётся в настройках безопасности Coinbase Commerce и кладётся в COINBASE_COMMERCE_API_KEY. Версию API лучше зафиксировать самим, чтобы будущие изменения на стороне Coinbase не сломали интеграцию молча.
Подпись вебхука проверяется локально через HMAC-SHA256, для этого нужен COINBASE_COMMERCE_WEBHOOK_SECRET. Запуск по умолчанию идёт через stdio, для тестов между сервисами есть режим HTTP с MCP_PORT. Отдельно есть ручное подтверждение оплаты через resolve_charge — если платежи сверяются не только по событиям, это стоит держать под контролем.
Какие задачи решает
- выставить счёт покупателю в местной валюте с оплатой в крипте
- сделать переиспользуемую ссылку на оплату для страницы товара
- отменить неоплаченный счёт до истечения срока
- проверить подпись входящего вебхука перед обработкой
- узнать текущий курс базового актива перед выставлением цены
Примеры запросов агенту
- Создай charge на 49.90 EUR и покажи ссылку на оплату
- Выведи последние события по счёту и скажи, какие ещё не подтверждены
- Проверь подпись вебхука из файла
payload.jsonс секретом из окружения
Как установить mcp-coinbase-commerce
Командой платформы
claude mcp add --env COINBASE_COMMERCE_API_KEY=<COINBASE_COMMERCE_API_KEY> --env COINBASE_COMMERCE_API_VERSION=<COINBASE_COMMERCE_API_VERSION> --env COINBASE_COMMERCE_WEBHOOK_SECRET=<COINBASE_COMMERCE_WEBHOOK_SECRET> --transport stdio coinbase-commerce -- npx -y @codespar/mcp-coinbase-commerceВместо <…> подставьте свои значения
Командой платформы
codex mcp add coinbase-commerce --env COINBASE_COMMERCE_API_KEY=<COINBASE_COMMERCE_API_KEY> --env COINBASE_COMMERCE_API_VERSION=<COINBASE_COMMERCE_API_VERSION> --env COINBASE_COMMERCE_WEBHOOK_SECRET=<COINBASE_COMMERCE_WEBHOOK_SECRET> -- npx -y @codespar/mcp-coinbase-commerceВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"coinbase-commerce": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-coinbase-commerce"
],
"env": {
"COINBASE_COMMERCE_API_KEY": "<COINBASE_COMMERCE_API_KEY>",
"COINBASE_COMMERCE_API_VERSION": "<COINBASE_COMMERCE_API_VERSION>",
"COINBASE_COMMERCE_WEBHOOK_SECRET": "<COINBASE_COMMERCE_WEBHOOK_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"coinbase-commerce": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-coinbase-commerce"
],
"env": {
"COINBASE_COMMERCE_API_KEY": "<COINBASE_COMMERCE_API_KEY>",
"COINBASE_COMMERCE_API_VERSION": "<COINBASE_COMMERCE_API_VERSION>",
"COINBASE_COMMERCE_WEBHOOK_SECRET": "<COINBASE_COMMERCE_WEBHOOK_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e COINBASE_COMMERCE_API_KEY=<COINBASE_COMMERCE_API_KEY> -e COINBASE_COMMERCE_API_VERSION=<COINBASE_COMMERCE_API_VERSION> -e COINBASE_COMMERCE_WEBHOOK_SECRET=<COINBASE_COMMERCE_WEBHOOK_SECRET> coinbase-commerce npx -y @codespar/mcp-coinbase-commerceВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-coinbase-commerce
Как установить mcp-coinbase-commerce в Claude Code?
Одной командой: `claude mcp add mcp-coinbase-commerce -e COINBASE_COMMERCE_API_KEY=<COINBASE_COMMERCE_API_KEY> -e COINBASE_COMMERCE_WEBHOOK_SECRET=<COINBASE_COMMERCE_WEBHOOK_SECRET> -- npx -y @codespar/mcp-coinbase-commerce`. Ключ API и секрет вебхука подставьте свои.
Что делает mcp-coinbase-commerce?
Даёт агенту инструменты Coinbase Commerce: создавать счета и checkout-ссылки, выпускать инвойсы, смотреть события и курсы, подтверждать оплату вручную.
Что нужно для работы сервера?
Ключ COINBASE_COMMERCE_API_KEY из настроек Coinbase Commerce. Секрет COINBASE_COMMERCE_WEBHOOK_SECRET нужен для локальной проверки подписей вебхуков через HMAC-SHA256.
