mcp-iniciador — MCP-сервер для Claude Code: возможности и установка
Управляет исходящими платежами Pix через Open Finance Brasil в сервисе Iniciador. Помогает агенту запрашивать согласия на списание и отправлять переводы.
claude mcp add --env INICIADOR_CLIENT_ID=<INICIADOR_CLIENT_ID> --env INICIADOR_CLIENT_SECRET=<INICIADOR_CLIENT_SECRET> --env INICIADOR_API_BASE=<INICIADOR_API_BASE> --transport stdio iniciador -- npx -y @codespar/mcp-iniciadorЧто делает mcp-iniciador
Сервер подключает языковую модель к API Iniciador, выступающего платёжным агрегатором (PISP) в экосистеме Open Finance Brasil. Внутри заложено 9 инструментов. Они позволяют агенту запрашивать перечень доступных бразильских банков, создавать платёжные согласия, отслеживать статус их подтверждения и формировать адрес для авторизации плательщика.
Когда клиент подтверждает согласие в приложении своего банка, модель может отправить перевод Pix вызовом create_payment. Дополнительно доступны просмотр статуса транзакции, фильтрация истории и отзыв платежа до момента его окончательного расчёта. Для безопасной отладки предусмотрено переключение на тестовую среду https://sandbox.iniciador.com.br.
Без учётных данных из личного кабинета Iniciador запросы работать не будут. Сервер требует передачи ключей через переменные окружения, а фактическое списание средств всегда зависит от явного подтверждения операции на стороне банка.
Какие задачи решает
- получить список бразильских банков с поддержкой Pix
- создать платёжное согласие для клиента
- сгенерировать ссылку авторизации в банке плательщика
- инициировать перевод Pix после подтверждения согласия
- проверить статус транзакции и причину отклонения
Примеры запросов агенту
- Запроси список банков, поддерживающих переводы Pix через Iniciador
- Создай платёжное согласие для перевода и сформируй ссылку на авторизацию
- Проверь статус платежа по идентификатору
pay_12345
Как установить mcp-iniciador
Командой платформы
claude mcp add --env INICIADOR_CLIENT_ID=<INICIADOR_CLIENT_ID> --env INICIADOR_CLIENT_SECRET=<INICIADOR_CLIENT_SECRET> --env INICIADOR_API_BASE=<INICIADOR_API_BASE> --transport stdio iniciador -- npx -y @codespar/mcp-iniciadorВместо <…> подставьте свои значения
Командой платформы
codex mcp add iniciador --env INICIADOR_CLIENT_ID=<INICIADOR_CLIENT_ID> --env INICIADOR_CLIENT_SECRET=<INICIADOR_CLIENT_SECRET> --env INICIADOR_API_BASE=<INICIADOR_API_BASE> -- npx -y @codespar/mcp-iniciadorВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"iniciador": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-iniciador"
],
"env": {
"INICIADOR_CLIENT_ID": "<INICIADOR_CLIENT_ID>",
"INICIADOR_CLIENT_SECRET": "<INICIADOR_CLIENT_SECRET>",
"INICIADOR_API_BASE": "<INICIADOR_API_BASE>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"iniciador": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-iniciador"
],
"env": {
"INICIADOR_CLIENT_ID": "<INICIADOR_CLIENT_ID>",
"INICIADOR_CLIENT_SECRET": "<INICIADOR_CLIENT_SECRET>",
"INICIADOR_API_BASE": "<INICIADOR_API_BASE>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e INICIADOR_CLIENT_ID=<INICIADOR_CLIENT_ID> -e INICIADOR_CLIENT_SECRET=<INICIADOR_CLIENT_SECRET> -e INICIADOR_API_BASE=<INICIADOR_API_BASE> iniciador npx -y @codespar/mcp-iniciadorВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-iniciador
Как установить mcp-iniciador в Claude Code?
Выполните в терминале команду `claude mcp add mcp-iniciador -e INICIADOR_CLIENT_ID=<INICIADOR_CLIENT_ID> -e INICIADOR_CLIENT_SECRET=<INICIADOR_CLIENT_SECRET> -- npx -y @codespar/mcp-iniciador`. Замените плейсхолдеры в угловых скобках на учётные данные из кабинета Iniciador.
Что делает mcp-iniciador?
Сервер даёт ИИ-агенту доступ к операциям PISP в Open Finance Brasil. Через него можно создавать и проверять согласия, генерировать ссылки для клиентов и отправлять переводы Pix.
Как переключить сервер на тестовую среду Iniciador?
Передайте переменную окружения INICIADOR_API_BASE со значением https://sandbox.iniciador.com.br. При добавлении сервера укажите её через флаг --env или добавьте в конфигурационный JSON-файл.
