mcp-dock

@codespar/mcp-dock

非推奨：稼働中のエンドポイントはありません。 2026-09-27 に、2 つの公開 DNS リゾルバー（8.8.8.8 と 1.1.1.1）を使用して測定した結果、api.dock.tech（本番環境）と sandbox.api.dock.tech（サンドボックス）は DNS で解決できません。このサーバーのどのツールもサービスに接続できません。このパッケージは npm で非推奨となっており、参考用としてこのリポジトリに残されています。利用可能なエンドポイントがある場合は、DOCK_BASE_URL を使ってサーバーの接続先を指定してください。パッケージの再開を希望する場合は、プロバイダーが公開しているベース URL を記載して、mcp-dev-latam でイシューを作成してください。

Dock 向け MCP サーバー — フィンテックおよび組み込み型金融プロダクト向けの、ブラジルの Banking-as-a-Service（口座、Pix、カード発行）

Dock を選ぶ理由

Dock はブラジルの主要な BaaS プロバイダー 2 社のうちの 1 社です。Matera とともに、ブラジルのフィンテックの大半を支えています。

Matera と Dock の比較 — どちらかを選んでも、コマースのパターンは同じです：

	Matera	Dock
主な強み	Pix に特化したコアバンキング	より幅広い BaaS：口座 + Pix + カード発行
歴史的な起点	コアバンキングプラットフォーム	口座 + Pix へと拡大したカード発行プラットフォーム
典型的な顧客	Pix を基盤に構築するフィンテック	ブランドカード + 口座を発行するフィンテック／小売業者
Pix Automático	稼働中（2025 年の BCB プロダクト）	ロードマップ

ブラジルのフィンテックは通常、契約条件と価格に基づいてどちらかを選びます。フィンテックプロダクトを構築するエージェントは、両方を対象にできます。コマースのパターンは同じで、変わるのはベンダーとの関係だけです。 このサーバーは、@codespar/mcp-matera と同じ形式で Dock の機能を公開するため、エージェントはツール呼び出しのロジックを書き換えずにバックエンドを切り替えられます。

エージェントで次の操作が必要な場合は、Dock を使用してください：

• エンドユーザー（CPF 保有者）向けにデジタル口座を開設する
• Pix で送金する（請求、振込、DICT、返金）
• 口座に紐付けてカードを発行する（デビット／クレジット／プリペイド／バーチャル）。これが Dock の主な差別化要因です

クイックスタート

Claude Desktop

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

{
  "mcpServers": {
    "dock": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-dock"],
      "env": {
        "DOCK_CLIENT_ID": "your-client-id",
        "DOCK_CLIENT_SECRET": "your-client-secret",
        "DOCK_ENV": "sandbox"
      }
    }
  }
}

Claude Code

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

Cursor / VS Code

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

{
  "servers": {
    "dock": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-dock"],
      "env": {
        "DOCK_CLIENT_ID": "your-client-id",
        "DOCK_CLIENT_SECRET": "your-client-secret",
        "DOCK_ENV": "sandbox"
      }
    }
  }
}

ツール（20）

ツール	目的
create_account	Dock でエンドユーザー（CPF 保有者）のデジタル口座を開設します。
get_account	ID を指定して Dock の口座を取得します。
send_pix	Dock の口座からブラジル国内の任意の Pix キーへ Pix 振込を開始します。
get_pix	endToEndId を指定して、送信済みの Pix 決済を取得します。
create_pix_qr_static	静的 Pix QR コードを作成します（再利用可能で、加盟店の Pix キーに紐付けられます）。
create_pix_qr_dynamic	動的 Pix QR コードを作成します（1 回限りの使用で、有効期限があります）。
refund_pix	Pix 決済を返金（devolução）します。
resolve_dict_key	Pix DICT キーを解決し、口座名義人の身元情報と ISPB／支店／口座を取得します。
issue_card	Dock の口座に紐付けてカードを発行します（デビット／クレジット／プリペイド／バーチャル）。
get_card	ID を指定してカードを取得します。
list_accounts	加盟店の Dock 口座を一覧表示します。
freeze_account	Dock の口座を凍結（ブロック）します。
unfreeze_account	凍結済みの口座を凍結解除し、Pix とカードの操作を再開します。
block_card	カードを一時的にブロックします（解除可能）。
unblock_card	ブロック済みのカードをブロック解除します（再度ブロック可能）。
change_card_status	カードのライフサイクルステータスを変更します：ACTIVE / BLOCKED / CANCELED。
list_transactions	Dock の口座の取引を一覧表示します（Pix の入出金、カードのオーソリ、手数料、振込）。
get_transaction	ID を指定して単一の取引を取得します。
create_webhook	Dock のイベント通知（account.、pix.、card.、transaction.）を受信する Webhook エンドポイントを登録します。
list_webhooks	加盟店に登録されているすべての Webhook エンドポイントを一覧表示します。

認証

OAuth 2.0 クライアントクレデンシャルです。サーバーは Basic 認証（client_id:client_secret）を使用して POST /oauth/token を呼び出し、有効期限の1分前までベアラートークンをメモリ内にキャッシュします。

環境変数

変数	必須	説明
DOCK_CLIENT_ID	はい	Dock が発行した OAuth2 client_id
DOCK_CLIENT_SECRET	はい	OAuth2 client_secret（シークレット）
DOCK_ENV	いいえ	sandbox（デフォルト）または production

ベース URL は DOCK_ENV から決まります。https://sandbox.api.dock.tech（sandbox）または https://api.dock.tech（production）です。

ステータス

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

Dock の開発者ポータル developers.dock.tech は ReadMe.com のログイン画面にリダイレクトされます。Dock の加盟店契約がないと公開ドキュメントにアクセスできないため、2026-04-21 時点では正確な URL パスを検証できませんでした。

src/index.ts のエンドポイントパスは、標準的な BR BaaS の慣例（Matera の構造および BCB Pix 仕様に準拠）に基づく推定値です。疑わしい箇所には、インラインで TODO(verify) コメントを付けています。

領域	コード内の値	疑わしい理由
トークンエンドポイント	POST /oauth/token	標準的な候補ですが、/oauth2/token や /auth/v1/token もよく使われます
Pix の返金	POST /pix/payments/{e2eid}/refund	BCB 仕様では返金のパス名は /pix/{e2eid}/devolucao/{id} です
DICT 照会	GET /pix/dict/{key}	BCB DICT は RSFN 経由のアクセスが必要です。Dock のラッパーパスは未検証です

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

Dock のサンドボックスを利用できる方からの PR を歓迎します。

ロードマップ

v0.2（予定）

• Dock のサンドボックスでパスを検証
• カード管理：block_card、unblock_card、set_card_limits
• 口座明細と取引一覧
• Webhook イベント用ヘルパー

v0.3（予定）

• Boleto の発行
• TED／銀行振込（Pix 以外の決済経路）
• 信用審査エンドポイント（Dock の信用サービス）

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

リンク

• Dock
• Dock Developers（アクセス制限あり — 加盟店ログインが必要）
• MCP Dev LATAM
• ランディングページ

エンタープライズ

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

ライセンス

MIT