mcp-getnet

Name: mcp-getnet
Author: codespar

ローカル

github.com/codespar金融データ2754 週間前に更新

リポジトリ

mcp-getnet について

@codespar/mcp-getnet は、サンタンデール傘下のブラジルのカード加盟店契約会社 Getnet 向けの MCP サーバーです。サンタンデールとの商用契約を持つ加盟店が、PSP を介さず直接連携する用途を想定しています。クレジットカード、デビットカード、Pix、boleto、マーケットプレイスの分配処理に対応しています。

主な機能

01クレジットカードの承認、売上確定、取消、返金
02Pix と boleto の請求作成および照会
03カードのトークン化と numtoken の生成
04マーケットプレイス販売者のオンボーディングと分配ルール
05注文 ID または決済 ID による明細の取得

活用シーン

01Getnet 経由でのクレジットカードおよび Pix 決済の受付
02マーケットプレイスでの販売者登録と分配設定
03期間を指定した販売者の売上・手数料・支払いの確認

MCP 対応

本プロジェクトは MCP サーバーとして動作し、決済関連の 20 個のツールを MCP クライアントに公開します。トランスポートは stdio と HTTP に対応しています。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "codespar-mcp-getnet": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-getnet"
      ],
      "env": {
        "GETNET_CLIENT_ID": "<GETNET_CLIENT_ID>",
        "GETNET_CLIENT_SECRET": "<GETNET_CLIENT_SECRET>",
        "GETNET_SELLER_ID": "<GETNET_SELLER_ID>",
        "GETNET_BASE_URL": "<GETNET_BASE_URL>"
      }
    }
  }
}

起動コマンドnpx -y @codespar/mcp-getnet

設定が必要な環境変数

GETNET_CLIENT_IDGetnet OAuth client_id

GETNET_CLIENT_SECRETシークレットGetnet OAuth client_secret

GETNET_SELLER_IDGetnet seller_id issued with your merchant contract

GETNET_BASE_URLGetnet API base URL. Defaults to production (https://api.getnet.com.br). Use https://api-homologacao.getnet.com.br for sandbox.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@codespar/mcp-getnet0.2.2stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須	説明
amount	number	はい	金額はセント単位です
credit	object	はい	カードデータ（number_token による事前トークン化を推奨）
credit.brand	string	はい	Visa, Mastercard, Elo, Amex, Hipercard
credit.number_token	string	はい	tokenize_card のトークン
credit.security_code	string	はい
credit.save_card_data	boolean	いいえ
credit.cardholder_name	string	はい
credit.expiration_year	string	はい
credit.soft_descriptor	string	いいえ
credit.expiration_month	string	はい
credit.transaction_type	enum	いいえ	FULL \| INSTALL_NO_INTEREST \| INSTALL_WITH_INTEREST
credit.number_installments	number	いいえ
delayed	boolean	はい	true = オーソリのみ；false = オーソリ + 売上確定
currency	string	いいえ	ISO-4217 通貨コード（デフォルトは BRL）
customer	object	はい	顧客の識別情報
customer.name	string	いいえ
customer.email	string	はい
customer.last_name	string	はい
customer.first_name	string	はい
customer.customer_id	string	はい	加盟店側の顧客 ID
customer.phone_number	string	いいえ
customer.document_type	enum	はい	CPF \| CNPJ
customer.document_number	string	はい	CPF または CNPJ の数字のみ
order_id	string	はい	加盟店側の注文識別子

詳細

@codespar/mcp-getnet

Getnet 向け MCP サーバー — Santander 傘下のブラジルのカードアクワイアラーです。

Cielo、Stone、Efi とともに、Getnet はブラジルの「大手 4 社」のアクワイアラーのうち 3 社を占めます。PSP ごとのサーバー（Zoop、Pagar.me、Asaas）とは異なり、Getnet はアクワイアラーです。そのため、Santander と商業契約を結んでいる加盟店は、PSP を介さずに直接連携できます。

ツール（20）

ツール	用途
`authorize_credit`	Getnet でクレジットカード決済をオーソリします。
`capture_credit`	事前にオーソリされたクレジット決済を売上確定します（`delayed=true` を指定した場合）。
`cancel_credit`	オーソリ済みで売上確定前のクレジット決済をキャンセルします。
`refund_credit`	売上確定済みのクレジット決済を返金します。
`create_pix`	Pix の請求を作成します。
`create_boleto`	boleto の請求を作成します。
`get_payment`	Getnet の payment_id を指定して決済情報を取得します。
`tokenize_card`	PCI に準拠した安全な再利用のため、カードをトークン化します。
`create_seller`	Getnet Marketplace Management を通じてマーケットプレイスの販売者を登録します。
`get_seller`	Getnet の seller_id を指定して販売者情報を取得します。
`list_sellers`	任意のフィルターを指定してマーケットプレイスの販売者を一覧表示します。
`cancel_debit`	Getnet の payment_id を指定してデビットカード決済をキャンセルします。
`query_pix`	Getnet の payment_id を指定して Pix の請求情報を取得します。
`query_boleto`	Getnet の payment_id を指定して boleto の情報を取得します。
`cancel_boleto`	まだ支払いが行われていない boleto をキャンセルします。
`get_payment_by_order`	加盟店側の order_id を使って決済情報を取得します（Getnet の payment_id を紛失した場合に便利です）。
`query_installments`	指定した金額とカードブランドについて、Getnet が提供する分割払いプランを照会します（利息あり／なし、最大分割回数…
`create_numtoken`	numtoken（Getnet のカード保存用 PAN レベルトークン）を作成します。
`create_split`	決済の一部をサブ販売者に振り分けるマーケットプレイスの分割ルールを設定します。
`get_statement`	指定した期間のサブ販売者のマーケットプレイス取引明細（売上、手数料、支払い）を取得します。

インストール

npm install @codespar/mcp-getnet

環境変数

GETNET_CLIENT_ID="..."       # OAuth client_id
GETNET_CLIENT_SECRET="..."   # OAuth client_secret
GETNET_SELLER_ID="..."       # seller_id from your merchant contract
GETNET_BASE_URL="..."        # Optional. Default: https://api.getnet.com.br
                             # Sandbox: https://api-homologacao.getnet.com.br

認証

OAuth 2.0 クライアントクレデンシャルを使用します。サーバーは Basic 認証で POST /auth/oauth/v2/token を呼び出し、有効期限の 60 秒前までベアラートークンをメモリにキャッシュします。呼び出し元から意識する必要はありません。

実行

# stdio (default)
npx @codespar/mcp-getnet

# HTTP
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-getnet

エンタープライズ

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

ライセンス

MIT

Markdown 対応

ログインしてコメント

基本情報

作者: codespar
言語: node
バージョン: 0.2.2
トランスポート: stdio
掲載日: 2026年6月22日
最終更新: 4 週間前
公式 Registry: io.github.codespar/mcp-getnet

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

mcp-getnet

mcp-getnet について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

@codespar/mcp-getnet

ツール（20）

インストール

環境変数

認証

実行

エンタープライズ

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？