mcp-cielo

@codespar/mcp-cielo

Cielo 向け MCP サーバー — カード決済、ボレート、継続課金

クイックスタート

Claude Desktop

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

{
  "mcpServers": {
    "cielo": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-cielo"],
      "env": {
        "CIELO_MERCHANT_ID": "your-merchant-id",
        "CIELO_MERCHANT_KEY": "your-merchant-key",
        "CIELO_SANDBOX": "true"
      }
    }
  }
}

Claude Code

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

Cursor / VS Code

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

{
  "servers": {
    "cielo": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-cielo"],
      "env": {
        "CIELO_MERCHANT_ID": "your-merchant-id",
        "CIELO_MERCHANT_KEY": "your-merchant-key",
        "CIELO_SANDBOX": "true"
      }
    }
  }
}

ツール（22）

ツール	目的
create_sale	Cielo でクレジットカード／デビットカードの決済を作成します
get_sale	PaymentId を指定して決済の詳細を取得します
capture_sale	事前承認済みの決済を売上確定します
cancel_sale	決済を取り消します（全額または一部）
create_recurrent	クレジットカードの継続課金を作成します
get_recurrent	継続課金の詳細を取得します
tokenize_card	今後の利用に備えてクレジットカードをトークン化します
create_boleto	Cielo でボレート決済を作成します
create_pix	Cielo で Pix 決済を作成します（QR コードを生成）
get_pix	PaymentId を指定して Pix 決済の詳細と QR コードを取得します
create_debit	Cielo でデビットカード決済を作成します（3DS 認証が必要です）
create_ewallet	デジタルウォレット決済を作成します（Google Pay、Samsung Pay、Apple Pay）
get_antifraud	決済の不正利用対策分析の詳細を取得します
create_sale_with_token	保存済みの CardToken を使ってクレジットカード決済を作成します（カード情報の再入力は不要です）
update_recurrent_amount	既存の継続課金の金額を更新します
update_recurrent_next_date	既存の継続課金の次回請求日を更新します
deactivate_recurrent	継続課金を無効化（一時停止）して、請求を停止します
reactivate_recurrent	以前に無効化した継続課金を再有効化します
create_payment_link	Cielo の Link de Pagamento（共有可能なチェックアウト URL）を作成します
get_payment_link	ID を指定して Cielo の Link de Pagamento を取得します
zero_auth	請求せずにカードを検証するゼロ金額の与信を行います（カードまたは CardToken）
create_sale_with_3ds	3DS 2.0 認証データ（3DS フローから取得）を使ってクレジットカード決済を作成します

認証

Cielo は認証に MerchantId および MerchantKey ヘッダーを使用します。

サンドボックス／テスト

Cielo は apisandbox.cieloecommerce.cielo.com.br にサンドボックスを提供しています。使用するには CIELO_SANDBOX=true を設定します。

認証情報の取得

1. Cielo Developer Portal にアクセスします
2. 開発者アカウントを作成します
3. MerchantId と MerchantKey を取得します
4. 環境変数を設定します

環境変数

変数	必須	説明
CIELO_MERCHANT_ID	はい	Cielo の Merchant ID
CIELO_MERCHANT_KEY	はい	Cielo の Merchant Key
CIELO_SANDBOX	いいえ	サンドボックスモードでは "true" に設定します

ロードマップ

v0.2（予定）

• create_pix — Pix 決済を作成します
• get_pix — Pix 決済の詳細を取得します
• create_debit — デビットカード決済を作成します
• create_ewallet — デジタルウォレット決済を作成します（Apple Pay、Google Pay）
• get_antifraud — 取引の不正利用対策分析を取得します

v0.3（予定）

• batch_captures — 複数の事前承認済み取引を売上確定します
• velocity_rules — 取引頻度／不正利用対策ルールを設定します

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

リンク

• Cielo のウェブサイト
• Cielo API ドキュメント
• MCP Dev LATAM
• ランディングページ

エンタープライズ

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

ライセンス

MIT