mcpField
M
mcp-efi

mcp-efi

ローカル
github.com/codespar金融データ2754 週間前に更新
リポジトリ

mcp-efi について

mcp-efi は、EFI（旧 Gerencianet）向けの MCP サーバーで、Pix 決済、boleto、クレジットカード決済、carnet を扱います。MCP クライアントからブラジルの決済や請求フローを構築する開発者に向いています。README にはサンドボックスと認証情報の設定手順があります。

主な機能

  1. 01即時および期日付き Pix 請求
  2. 02boleto とクレジットカード決済
  3. 03複数回払いの carnet
  4. 04Pix キー、返金、webhook の管理

活用シーン

  1. 01分割払い用の carnet の作成
  2. 02Pix 請求の作成と支払い状況の追跡
  3. 03Pix キーと webhook 通知の管理

MCP 対応

MCP クライアントに 18 個のツールを公開する MCP サーバーで、EFI の請求、Pix、webhook API を呼び出します。

設定

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

mcp.json · 共通設定
{
  "mcpServers": {
    "codespar-mcp-efi": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-efi"
      ],
      "env": {
        "EFI_CLIENT_SECRET": "<EFI_CLIENT_SECRET>"
      }
    }
  }
}
起動コマンドnpx -y @codespar/mcp-efi
設定が必要な環境変数
EFI_CLIENT_SECRETシークレットAPI key for efi

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

パッケージ
npm@codespar/mcp-efi0.2.2

ツール

18

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

パラメーター型必須説明
txidstringいいえ取引 ID（26～35 文字の英数字）
chavestringはい受取人の Pix キー
valorobjectはい請求金額
valor.originalstringはい金額の文字列（例：'10.00'）
devedorobjectいいえ債務者情報
devedor.cpfstringいいえ債務者の CPF
devedor.nomestringいいえ債務者名
calendarioobjectいいえ有効期限の設定
calendario.expiracaonumberいいえ有効期限（秒、デフォルトは 3600）
solicitacaoPagadorstringいいえ支払人へのメッセージ

詳細

@codespar/mcp-efi

**EFI（Gerencianet）**向けMCP サーバー — Pix の請求、銀行伝票、クレジットカード、分割払い

npm License: MIT

クイックスタート

Claude Desktop

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

{
  "mcpServers": {
    "efi": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-efi"],
      "env": {
        "EFI_CLIENT_ID": "your-client-id",
        "EFI_CLIENT_SECRET": "your-client-secret",
        "EFI_SANDBOX": "true"
      }
    }
  }
}
Claude Code
claude mcp add efi -- npx @codespar/mcp-efi
Cursor / VS Code

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

{
  "servers": {
    "efi": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-efi"],
      "env": {
        "EFI_CLIENT_ID": "your-client-id",
        "EFI_CLIENT_SECRET": "your-client-secret",
        "EFI_SANDBOX": "true"
      }
    }
  }
}

ツール（18）

ツール目的
create_cob即時 Pix 請求（cobranca imediata）を作成
get_cobtxid から Pix 請求の詳細を取得
list_cobs日付範囲を指定して Pix 請求を一覧表示
create_charge請求（銀行伝票またはクレジットカード）を作成
get_chargeID から請求の詳細を取得
create_carnet分割払いの冊子（複数回分の支払い伝票）を作成
get_pix_key登録済み Pix キーの詳細を取得
create_pix_evpランダムな Pix キー（EVP／エイリアス）を作成
create_cobv支払期限付きの Pix 請求（cobranca com vencimento）を作成。
get_cobvtxid から支払期限付き Pix 請求（cobv）の詳細を取得
update_cobvtxid で既存の支払期限付き Pix 請求（cobv）を更新
create_devolucao受け取った Pix 取引の返金（払い戻し）をリクエスト
get_devolucaoe2eId と返金 ID から Pix 返金の詳細を取得
list_pix_received日付範囲を指定して受け取った Pix 取引（recebidos）を一覧表示
delete_pix_key登録済み Pix キー（DICT）を削除
register_webhook指定した Pix キーの Webhook URL を登録
list_webhooks登録済み Webhook を日付範囲で一覧表示
delete_webhookPix キーに登録された Webhook を削除

認証

EFI は OAuth2 クライアント認証情報を使用します。サーバーはトークンの更新を自動的に管理します。

サンドボックス／テスト

EFI は pix-h.api.efipay.com.br にサンドボックスを提供しています。使用するには EFI_SANDBOX=true を設定します。

認証情報の取得
  1. EFI Pay ダッシュボードにアクセスします
  2. アカウントを作成します
  3. アプリケーションを登録して OAuth2 認証情報を取得します
  4. 環境変数を設定します

環境変数

変数必須説明
EFI_CLIENT_IDはいOAuth2 クライアント ID
EFI_CLIENT_SECRETはいOAuth2 クライアントシークレット
EFI_SANDBOXいいえサンドボックスモードを使用する場合は "true" を設定

ロードマップ

v0.2（予定）
  • create_devolucao — Pix の返金（devolucao）を作成
  • get_devolucao — Pix 返金の詳細を取得
  • list_locations — Pix ペイロードのロケーションを一覧表示
  • create_webhook — Pix 通知用の Webhook を登録
  • update_cob — 既存の Pix 請求を更新
v0.3（予定）
  • batch_charges — 1 回のリクエストで複数の請求を作成
  • split_payments — 分割支払いのルールを設定

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

リンク

エンタープライズ

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

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

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

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