mcp-matera

@codespar/mcp-matera

非推奨：稼働中のエンドポイントはありません。 2026-09-27に2つのパブリックDNSリゾルバー（8.8.8.8および1.1.1.1）で確認したところ、このサーバーが呼び出すホスト api.matera.com はDNSで解決されません。このサーバーのどのツールもサービスに到達できません。このパッケージはnpmで非推奨となっており、参考用としてのみこのリポジトリに残されています。利用可能なエンドポイントをお持ちの場合は、MATERA_BASE_URL を使ってサーバーの接続先を指定してください。パッケージを復活させるには、プロバイダーが公開しているベースURLを添えて mcp-dev-latam にイシューを作成してください。

Matera 向けのMCPサーバー — Pix、DICT、Pix Automáticoを活用するフィンテック向けのブラジルのコアバンキングインフラストラクチャ（BaaS）

Materaを選ぶ理由

Materaはコアバンキングインフラストラクチャであり、PSPではありません。ベンダーの導入事例によると、ブラジルのPix取引のおよそ10%を処理しています。顧客はPixを基盤に構築するフィンテックです。口座を発行し、DICTを通じて資金を移動し、Pix Automáticoの契約を登録します。Pixで決済を受け付ける加盟店ではありません（それにはZoop／Asaas／Mercado Pagoを利用します）。

これにより、CodeSparのカタログにPSPサーバーとは異なるセグメント、Pixを基盤に構築するフィンテックが加わります。Materaは payments ではなく、Stark BankやOpen Financeとともに banking に分類されます。

エージェントが次の操作を行う必要がある場合はMateraを使用してください。

• フィンテック自身が発行した口座に対してPix請求を開始する
• 資金を移動する前にPixキーを解決するため、DICTで照会する
• 定期的なPix Automático契約を登録する（BCB 2025年のプロダクトで、これに対応して稼働中のプロバイダーはわずかです）
• フィンテック独自のMatera決済網を通じて、銀行間で資金を移動する

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "matera": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-matera"],
      "env": {
        "MATERA_CLIENT_ID": "your-client-id",
        "MATERA_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude Code

claude mcp add matera -- npx @codespar/mcp-matera

Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します。

{
  "servers": {
    "matera": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-matera"],
      "env": {
        "MATERA_CLIENT_ID": "your-client-id",
        "MATERA_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

ツール（22）

ツール	目的
create_pix_charge_static	静的 Pix 請求を作成します（加盟店の Pix キーに紐付けられた再利用可能な QR コード）。
create_pix_charge_dynamic	動的 Pix 請求を作成します（有効期限付きの1回限りの QR コード）。
get_pix_charge	txid で Pix 請求（静的または動的）を取得します。
list_pix_charges	日付とステータスで絞り込み、即時 Pix 請求（BCB /cob）を一覧表示します。
update_pix_charge	即時 Pix 請求を更新します（BCB PATCH /cob/{txid}）。
create_pix_charge_due	支払期日付き Pix 請求を作成します（BCB /cobv — Pix com Vencimento）。
get_pix_charge_due	支払期日付き Pix 請求を取得します（BCB GET /cobv/{txid}）。
create_pix_payment	外向きの Pix 振込（ordem de pagamento）を開始します。
get_pix_payment	endToEndId で外向きの Pix 支払いを取得します。
refund_pix_payment	Pix 支払いを返金（devolução）します。
list_pix_payments	任意のフィルターを指定して、外向きの Pix 支払いを一覧表示します。
list_pix_received	日付範囲を指定して、加盟店の口座に入金された受取 Pix（Pix recebidos）を一覧表示します。
resolve_pix_key	Pix DICT キーを照会し、口座名義人の本人情報と ISPB／支店／口座を取得します。
list_dict_keys	Matera 上の加盟店の口座に登録されている DICT キーを一覧表示します。
register_dict_key	Matera 上の加盟店口座に DICT キーを登録（取得）します。
delete_dict_key	加盟店が所有する DICT キーを削除します。
create_pix_automatico	Pix Automático の定期利用を登録します（BCB 2025 年の定期 Pix サービス、/rec）。
get_pix_automatico	idRec で Pix Automático の定期利用を取得します。
cancel_pix_automatico	有効な Pix Automático の定期利用をキャンセルします。
get_account_balance	Matera が管理する口座の現在残高を取得します。
get_account_statement	日付範囲を指定して、Matera が管理する口座の明細（extrato）を取得します。
internal_transfer	Matera 上にある2つの口座間の振込を記帳します（TED-interno／transferência interna）。

認証

Matera の公開ドキュメントインデックスによると、サーバー連携には secret-key と data-signature ヘッダーを使用し、OAuth2 はモバイル／Web UI との連携に限定されます（doc-api.matera.com）。v0.1-alpha のスキャフォールドでは現在、POST /auth/token に対する OAuth2 クライアントクレデンシャルのフローを実装しています。この組み合わせはサーバー間通信にはほぼ確実に適しておらず、稼働中のサンドボックスで検証でき次第、署名付きリクエスト方式に置き換える予定です。詳しくは以下の「ステータス」セクションをご覧ください。

環境変数

変数	必須	説明
MATERA_CLIENT_ID	はい	Matera が発行した OAuth2 client_id
MATERA_CLIENT_SECRET	はい	OAuth2 client_secret（シークレット）
MATERA_BASE_URL	いいえ	API のベース URL。既定値は https://api.matera.com です。サンドボックス URL は製品ラインごとに異なります。Matera の担当者にお問い合わせください。

ステータス

v0.1.0-alpha.1 — ツールのインターフェースは安定していますが、通信パスはまだ検証されていません。

2026-04-24 に、すべてのエンドポイントパスを doc-api.matera.com に対して検証しようとしました。ドキュメントサイトはブラウザーからアクセスできますが、自動化環境からは取得できませんでした（DNS／ネットワークによる制限。ログイン画面は確認されていません）。公開されている検索結果のスニペットやサードパーティーの情報から、製品の機能（Pix 請求、Pix 決済、DICT、Pix Automático）と認証モデル（サーバー＝secret-key + data-signature、OAuth2＝エンドユーザーのみ）は確認できますが、正確な URL パスは明らかになっていません。

ライブの Matera サンドボックスに対してサーバーを実行できるようになるまでは、以下は推定であり、未検証です。

領域	コード内の値	疑わしい理由
トークンエンドポイント	POST /auth/token（Basic 認証、grant_type=client_credentials）	サーバー連携には誤っている可能性が高いです。「認証」を参照してください
Pix 請求	/pix/charges/static、/pix/charges/dynamic、/pix/charges/{txid}	Matera は BCB の /cob（即時）／/cobv（期日指定）の命名に従っている可能性が高いです
Pix 決済	/pix/payments、/pix/payments/{e2eid}、/pix/payments/{e2eid}/refund	BCB 仕様では返金のパス名は /pix/{e2eid}/devolucao/{id} です
DICT 検索	GET /pix/dict/{key}、GET /pix/dict/keys	BCB DICT は RSFN 経由のアクセスに制限されています。Matera は独自のラッパーを公開しています。正確なパスは不明です
Pix Automático	POST /pix/automatico	ほぼ間違いなくプレースホルダーです。BCB の 2025 年仕様では、POST /rec（定期支払い登録）と /cobr/{txid}（定期請求）が使われます

上記の 10 個のツールの名前と入力スキーマは公開契約であり、今後も安定して維持されます。サンドボックスで検証でき次第、変更するのは src/index.ts 内部の HTTP 呼び出しのみです。現在、このサーバーを実際の Matera テナントで使用すると、ほとんどの呼び出しで 404 が返されます。

検証作業の進捗はリポジトリの issue で追跡しています。Matera のサンドボックスをお持ちの方からの PR も歓迎します。

ロードマップ

v0.2（予定）

• 認証が必要なエンドポイント向けの署名付きリクエスト認証（secret-key + data-signature）
• 口座開設（abertura de conta）— Matera IB 製品
• TED／銀行振込（Pix 以外の決済レール）
• Webhook イベント用ヘルパー

v0.3（予定）

• インターネットバンキングサーバーのツール（明細、残高、カード管理）
• Boleto の発行
• Pix MED（返金の特別な仕組み）フロー

貢献をご希望ですか？ PR を作成するか、ツールをリクエストしてください。

リンク

• Matera
• Matera API ドキュメント
• MCP Dev LATAM
• ランディングページ

エンタープライズ

エージェントが開始する銀行振込に、ガバナンス、予算上限、監査証跡が必要ですか？ CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT