mcp-dlocal — MCP-сервер для Claude Code: платежи и установка
Подключает агента к dLocal для платежей, выплат и возвратов в странах Латинской Америки. Пригодится для работы с локальными способами оплаты через API.
claude mcp add --env DLOCAL_LOGIN=<DLOCAL_LOGIN> --env DLOCAL_TRANS_KEY=<DLOCAL_TRANS_KEY> --env DLOCAL_SECRET_KEY=<DLOCAL_SECRET_KEY> --env DLOCAL_BASE_URL=<DLOCAL_BASE_URL> --transport stdio dlocal -- npx -y @codespar/mcp-dlocalЧто делает mcp-dlocal
mcp-dlocal добавляет агенту инструменты dLocal для создания и проверки платежей, захвата или отмены авторизаций, возвратов и выплат. Сервер также умеет получать баланс, курс валют, список способов оплаты и проверять налоговые документы. Поддерживаются локальные методы вроде Pix, OXXO, PSE, SPEI, Boleto и карт.
По умолчанию сервер работает через stdio и запускается командой npx @codespar/mcp-dlocal; для серверного тестирования есть HTTP-режим с MCP_HTTP=true MCP_PORT=3000. Каждый запрос подписывается автоматически через V2 HMAC-SHA256. Для аутентификации нужны DLOCAL_LOGIN, DLOCAL_TRANS_KEY и DLOCAL_SECRET_KEY; без них запросы dLocal не пройдут.
Какие задачи решает
- создавать платежи через локальные методы оплаты
- проверять статус по payment id или order_id
- отправлять выплаты получателям в странах Латинской Америки
- оформлять возвраты по захваченным платежам
- получать баланс, курс и доступные способы оплаты
Примеры запросов агенту
- Создай платёж для Бразилии через доступный локальный способ и покажи его статус.
- Найди выплату по
external_idи объясни текущий результат. - Проверь документ клиента и перечисли доступные способы оплаты для страны.
Как установить mcp-dlocal
Командой платформы
claude mcp add --env DLOCAL_LOGIN=<DLOCAL_LOGIN> --env DLOCAL_TRANS_KEY=<DLOCAL_TRANS_KEY> --env DLOCAL_SECRET_KEY=<DLOCAL_SECRET_KEY> --env DLOCAL_BASE_URL=<DLOCAL_BASE_URL> --transport stdio dlocal -- npx -y @codespar/mcp-dlocalВместо <…> подставьте свои значения
Командой платформы
codex mcp add dlocal --env DLOCAL_LOGIN=<DLOCAL_LOGIN> --env DLOCAL_TRANS_KEY=<DLOCAL_TRANS_KEY> --env DLOCAL_SECRET_KEY=<DLOCAL_SECRET_KEY> --env DLOCAL_BASE_URL=<DLOCAL_BASE_URL> -- npx -y @codespar/mcp-dlocalВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"dlocal": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-dlocal"
],
"env": {
"DLOCAL_LOGIN": "<DLOCAL_LOGIN>",
"DLOCAL_TRANS_KEY": "<DLOCAL_TRANS_KEY>",
"DLOCAL_SECRET_KEY": "<DLOCAL_SECRET_KEY>",
"DLOCAL_BASE_URL": "<DLOCAL_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"dlocal": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-dlocal"
],
"env": {
"DLOCAL_LOGIN": "<DLOCAL_LOGIN>",
"DLOCAL_TRANS_KEY": "<DLOCAL_TRANS_KEY>",
"DLOCAL_SECRET_KEY": "<DLOCAL_SECRET_KEY>",
"DLOCAL_BASE_URL": "<DLOCAL_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e DLOCAL_LOGIN=<DLOCAL_LOGIN> -e DLOCAL_TRANS_KEY=<DLOCAL_TRANS_KEY> -e DLOCAL_SECRET_KEY=<DLOCAL_SECRET_KEY> -e DLOCAL_BASE_URL=<DLOCAL_BASE_URL> dlocal npx -y @codespar/mcp-dlocalВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-dlocal
Как установить mcp-dlocal в Claude Code?
Выполните `claude mcp add mcp-dlocal -e DLOCAL_LOGIN=<DLOCAL_LOGIN> -e DLOCAL_TRANS_KEY=<DLOCAL_TRANS_KEY> -e DLOCAL_SECRET_KEY=<DLOCAL_SECRET_KEY> -- npx -y @codespar/mcp-dlocal`.
Что делает mcp-dlocal?
Сервер даёт агенту инструменты dLocal для платежей, выплат, возвратов, баланса, курсов, способов оплаты и проверки документов в странах Латинской Америки.
Какие данные нужны для подключения?
Нужны DLOCAL_LOGIN, DLOCAL_TRANS_KEY и DLOCAL_SECRET_KEY. Для sandbox можно задать DLOCAL_BASE_URL со значением https://sandbox.dlocal.com.
