mcp-matera — MCP-сервер для Claude Code: Pix и DICT, установка
MCP-сервер для Matera, банковской инфраструктуры Бразилии: эмитирует Pix-счета, ищет ключи DICT, проводит платежи. Пакет помечен как deprecated: хост api.matera.com не резолвится в DNS.
claude mcp add --env MATERA_CLIENT_ID=<MATERA_CLIENT_ID> --env MATERA_CLIENT_SECRET=<MATERA_CLIENT_SECRET> --env MATERA_BASE_URL=<MATERA_BASE_URL> --transport stdio matera -- npx -y @codespar/mcp-materaЧто делает mcp-matera
Сервер даёт агенту 22 инструмента: статические и динамические Pix-сборы, сборы с датой платежа, исходящие переводы и возвраты, приём входящих Pix, регистрация и удаление ключей DICT, оформление повторяющихся соглашений Pix Automático, баланс и выписка по счёту, внутренний перевод между двумя счетами на Matera. Всё это для финтеха, который строит поверх Pix, а не для магазина, принимающего оплату. Устанавливается через npx пакета @codespar/mcp-matera.
В версии 0.1.0-alpha.1 набор инструментов объявлен стабильным, а пути запросов не проверены на живом стенде. Автор прямо сомневается в выбранной схеме: в коде стоит OAuth2 через POST /auth/token, а документация Matera описывает для серверных интеграций заголовки secret-key и data-signature. Пути к сборкам и платежам тоже под вопросом — предполагается, что Matera следует стандарту BCB (/cob, /cobv, /rec). Без MATERA_CLIENT_ID и MATERA_CLIENT_SECRET сервер не запустится; MATERA_BASE_URL задаёт адрес API вместо https://api.matera.com.
Главное — пакет помечен как deprecated на npm, а хост, к которому он обращается, не разрешается по DNS. Это значит, что ни один инструмент не достучится до сервиса, и ставить его есть смысл только тогда, когда у вас уже есть рабочий адрес Matera для MATERA_BASE_URL.
Какие задачи решает
- создать статический или динамический сбор Pix по счёту, выпущенному самим финтехом
- найти владельца Pix-ключа через DICT перед переводом
- оформить соглашение Pix Automático на регулярные списания
- вернуть исходящий Pix-платёж по
endToEndId - выгрузить выписку или баланс счёта на Matera
Примеры запросов агенту
- Создай статический сбор Pix на 150 реалов по ключу магазина
- Проверь в DICT, кому принадлежит ключ
[email protected], и покажи ISPB - Оформи Pix Automático на ежемесячное списание 49.90 и верни
idRec
Как установить mcp-matera
Командой платформы
claude mcp add --env MATERA_CLIENT_ID=<MATERA_CLIENT_ID> --env MATERA_CLIENT_SECRET=<MATERA_CLIENT_SECRET> --env MATERA_BASE_URL=<MATERA_BASE_URL> --transport stdio matera -- npx -y @codespar/mcp-materaВместо <…> подставьте свои значения
Командой платформы
codex mcp add matera --env MATERA_CLIENT_ID=<MATERA_CLIENT_ID> --env MATERA_CLIENT_SECRET=<MATERA_CLIENT_SECRET> --env MATERA_BASE_URL=<MATERA_BASE_URL> -- npx -y @codespar/mcp-materaВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"matera": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-matera"
],
"env": {
"MATERA_CLIENT_ID": "<MATERA_CLIENT_ID>",
"MATERA_CLIENT_SECRET": "<MATERA_CLIENT_SECRET>",
"MATERA_BASE_URL": "<MATERA_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"matera": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-matera"
],
"env": {
"MATERA_CLIENT_ID": "<MATERA_CLIENT_ID>",
"MATERA_CLIENT_SECRET": "<MATERA_CLIENT_SECRET>",
"MATERA_BASE_URL": "<MATERA_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e MATERA_CLIENT_ID=<MATERA_CLIENT_ID> -e MATERA_CLIENT_SECRET=<MATERA_CLIENT_SECRET> -e MATERA_BASE_URL=<MATERA_BASE_URL> matera npx -y @codespar/mcp-materaВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-matera
Как установить mcp-matera в Claude Code?
Выполните claude mcp add mcp-matera -e MATERA_CLIENT_ID=<MATERA_CLIENT_ID> -e MATERA_CLIENT_SECRET=<MATERA_CLIENT_SECRET> -- npx -y @codespar/mcp-matera. Если нужен свой адрес API, есть вариант с --transport stdio и переменной MATERA_BASE_URL.
Что делает mcp-matera?
Даёт агенту инструменты Matera для работы с Pix: сборы, переводы, возвраты, ключи DICT, повторяющиеся соглашения Pix Automático, баланс и выписка по счёту на Matera.
Почему сервер помечен как deprecated?
Хост api.matera.com, к которому обращается сервер, не разрешается в DNS, поэтому запросы не доходят до сервиса. Пакет остался в репозитории для справки; с рабочим адресом его можно направить через MATERA_BASE_URL.
