mcp-belvo — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер для подключения к Open Finance платформе Belvo. Позволяет запрашивать банковские транзакции, остатки на счетах и налоговые отчёты в странах Латинской Америки прямо через агента.
claude mcp add --env BELVO_SECRET_ID=<BELVO_SECRET_ID> --env BELVO_SECRET_PASSWORD=<BELVO_SECRET_PASSWORD> --env BELVO_SANDBOX=<BELVO_SANDBOX> --transport stdio belvo -- npx -y @codespar/mcp-belvoЧто делает mcp-belvo
MCP-сервер связывает ассистента со шлюзом Belvo в Мексике, Аргентине и Колумбии. Всего доступно 24 инструмента для взаимодействия с финансовыми учреждениями. Агент может проверять перечень банков, создавать новые подключения и обновлять авторизационные данные при запросе второго фактора.
Инструменты считывают списки счетов, текущие остатки, историю переводов и подтверждённый доход владельца. Дополнительно поддерживается выгрузка налоговых деклараций, данных по эквайрингу и записей о трудоустройстве из поддерживаемых реестров.
Запросы идут по протоколу stdio либо через локальный HTTP-сервер на порту 3000. Без действующих ключей BELVO_SECRET_ID и BELVO_SECRET_PASSWORD все вызовы к шлюзу отклоняются. По умолчанию включена рабочая среда, поэтому для отладки требуется явно задать BELVO_SANDBOX="true".
Какие задачи решает
- получать выписки и историю транзакций по банковским счетам в Латинской Америке
- проверять подтверждённые доходы и официальные трудовые записи
- запрашивать налоговые декларации и инвойсы из фискальных органов
- создавать одноразовые токены сессий для виджета Belvo Connect
Примеры запросов агенту
- Вызови
list_institutionsи покажи банки, доступные для интеграции. - Запроси последние операции по счёту через
get_transactionsдля указанного идентификатора ссылки. - Сгенерируй временный токен авторизации с помощью
create_widget_token.
Как установить mcp-belvo
Командой платформы
claude mcp add --env BELVO_SECRET_ID=<BELVO_SECRET_ID> --env BELVO_SECRET_PASSWORD=<BELVO_SECRET_PASSWORD> --env BELVO_SANDBOX=<BELVO_SANDBOX> --transport stdio belvo -- npx -y @codespar/mcp-belvoВместо <…> подставьте свои значения
Командой платформы
codex mcp add belvo --env BELVO_SECRET_ID=<BELVO_SECRET_ID> --env BELVO_SECRET_PASSWORD=<BELVO_SECRET_PASSWORD> --env BELVO_SANDBOX=<BELVO_SANDBOX> -- npx -y @codespar/mcp-belvoВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"belvo": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-belvo"
],
"env": {
"BELVO_SECRET_ID": "<BELVO_SECRET_ID>",
"BELVO_SECRET_PASSWORD": "<BELVO_SECRET_PASSWORD>",
"BELVO_SANDBOX": "<BELVO_SANDBOX>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"belvo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-belvo"
],
"env": {
"BELVO_SECRET_ID": "<BELVO_SECRET_ID>",
"BELVO_SECRET_PASSWORD": "<BELVO_SECRET_PASSWORD>",
"BELVO_SANDBOX": "<BELVO_SANDBOX>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e BELVO_SECRET_ID=<BELVO_SECRET_ID> -e BELVO_SECRET_PASSWORD=<BELVO_SECRET_PASSWORD> -e BELVO_SANDBOX=<BELVO_SANDBOX> belvo npx -y @codespar/mcp-belvoВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-belvo
Как установить mcp-belvo в Claude Code?
Выполните команду claude mcp add mcp-belvo -e BELVO_SECRET_ID=<BELVO_SECRET_ID> -e BELVO_SECRET_PASSWORD=<BELVO_SECRET_PASSWORD> -- npx -y @codespar/mcp-belvo. Замените плейсхолдеры ключами из панели разработчика Belvo.
Что делает mcp-belvo?
Сервер даёт ИИ-агенту доступ к финансовым данным через шлюз Belvo. Он позволяет смотреть банковские балансы, транзакции, налоговые отчёты и сведения о доходах в регионе LATAM.
Как включить режим песочницы для тестирования?
Передайте переменную окружения BELVO_SANDBOX="true" при запуске или регистрации MCP-сервера. Без неё запросы отправляются напрямую в рабочую среду Belvo.
