コマースAPIとMCPの統合を廃止

MCP (モデル コンテキスト プロトコル) を使用した暗号通貨支払い統合のための堅牢なソリューション。これにより、Claude などの AI アシスタントが Gotas Commerce API を通じて USDT トランザクションを作成および検証できるようになります。

🚀 概要

このプロジェクトは、AI アシスタントと暗号通貨決済サービスの間に橋渡しをします。 MCP サーバーを実装すると、アシスタントはブロックチェーンの専門知識を必要とせずに、支払いリンクを生成し、取引ステータスを確認し、USDT 支払いに関する詳細情報を取得できるようになります。

Related MCP server: MCP Coinbase Commerce Server

✨ リソース

MCPツール

create-payment

新しい USDT 支払いトランザクションを作成し、支払い URL やウォレット アドレスなどの必要な詳細をすべて返します。

パラメータ:

• amount ：支払い金額（例：100.50）

• currency : 通貨コード（現在は「USDT」のみ）

• return_url : 支払い後に顧客をリダイレクトするURL

• description : 支払いの説明（オプション）

戻る：

• すべての支払い詳細を含む完全な JSON オブジェクト:

  • 固有の支払いID

  • 支払いURL

  • ウォレットアドレス

  • ステータス（保留中、完了、失敗、期限切れ）

  • 作成日と有効期限

  • その他の関連メタデータ

check-payment-status

固有の識別子を通じて、既存の支払いの現在のステータスを確認します。

パラメータ:

• payment_id : 検証する支払いの一意のID

戻る：

• 現在の支払いステータスを含む完全な JSON オブジェクト

• 作成、有効期限、完了のタイムスタンプ情報（該当する場合）

• ブロックチェーントランザクションハッシュ（支払いが確認されたとき）

MCPリソース

payment-status://{payment_id}

MCP リソースとして、支払いステータスのフォーマットされた簡略化されたバージョンを提供します。

戻る：

• 最も関連性の高い支払い情報を記載した書式設定されたテキスト

• 識別子、ステータス、値、タイムスタンプ、説明

MCPプロンプト

create-payment-prompt

新しい支払いを作成するために必要な情報をユーザーが提供できるようにするためのガイド付きプロンプト。

🔧 建築

MCP サーバーは Drops Commerce API の抽象化レイヤーとして機能し、API 機能を、Claude のような AI アシスタントが簡単に使用できるツール、リソース、プロンプトに変換します。

┌────────────────┐    ┌───────────────┐    ┌──────────────────┐
│                │    │               │    │                  │
│  Assistente IA ├────┤  Servidor MCP ├────┤  API Gotas       │
│  (Claude)      │    │  (FastAPI)    │    │  Commerce        │
│                │    │               │    │                  │
└────────────────┘    └───────────────┘    └──────────────────┘

📋 前提条件

• Python 3.8以上

• Gotas Commerce API キー ( commerce.gotas.comで取得)

• MCP 対応アシスタント (Claude など) へのアクセス

🔌 インストール

1. このリポジトリをクローンします:

   git clone https://github.com/caiovicentino/mcpGOTAS.git
   cd mcpGOTAS

2. 依存関係をインストールします:

   pip install -r requirements.txt

   または、自動セットアップ スクリプトを使用します。

   ./setup.bat

3. 環境変数を設定します。

   • 次の値を持つ.envファイルを作成します。

     GOTAS_API_KEY=sua_chave_api_aqui
     GOTAS_BASE_URL=https://commerce.gotas.com

🏃‍♂️ 処刑

MCPサーバー

サーバーを実行して、MCP 経由でツールを利用できるようにします。

uvicorn src.gotas_mcp_server:app --host 0.0.0.0 --port 8000

Claude Desktopとの統合

Claude Desktop で直接使用するには:

python install_claude.py

または、手動でインストールします。

mcp install src.gotas_mcp_server.py

直接 API の使用 (テスト スクリプト)

ウィザードを使用せずに直接テストする場合:

• 支払いの作成: python test_client.py

• ステータスを確認する: python check_payment.py

📊 支払いフロー

1. 支払いの初期化：

   • 係員はユーザーから金額やその他の支払い詳細を取得します。

   • ウィザードは必要なパラメータを使用してcreate-paymentツールを呼び出します。

   • Gotas Commerceで新しい支払いが作成されます

   • 支払いリンクがユーザーに返されます

2. 支払い手続き：

   • ユーザーは提供された支払いリンクにアクセスする

   • ユーザーは表示されたウォレットアドレスにUSDTを送金する

   • ゴタスコマースは取引を確認するためにブロックチェーンを監視する

3. ステータスチェック:

   • アシスタントはcheck-payment-status statusを呼び出すことで支払い状況を確認できます。

   • ステータスは、保留中、完了、期限切れ、または失敗のいずれかになります。

   • 支払いが確認されると、ブロックチェーンのトランザクションハッシュが利用可能になる。

🔍 技術仕様

APIの詳細

コマース API エンドポイントを削除します:

1. 支払いを作成する

   • POST /api/v1/payments

   • リクエスト本文:

     {
       "amount": "100.00",
       "currency": "USDT",
       "return_url": "https://exemplo.com/retorno",
       "description": "Descrição do pagamento"
     }

2. 支払い状況を確認する

   • GET /api/v1/payments/{payment_id}

MCPコミュニケーション

• トランスポート: SSE (サーバー送信イベント)

• フォーマット: アシスタントとMCPサーバー間の通信用のJSON

• 認証: APIキーは環境変数として保存されます

📂 プロジェクト構造

├── src/
│   └── gotas_mcp_server.py  # Implementação principal do servidor MCP
├── .env                     # Variáveis de ambiente (API key, etc.)
├── .smithery.json           # Configuração para Smithery CLI
├── check_payment.py         # Utilitário para verificar status de pagamentos
├── docsdaapigotas.md        # Documentação detalhada da API
├── install_claude.py        # Script para instalação no Claude Desktop
├── mcp.md                   # Documentação do servidor MCP
├── MCPPROTOCOLpython.MD     # Documentação do protocolo MCP em Python
├── requirements.txt         # Dependências do projeto
├── setup.bat                # Script de configuração para Windows
├── smithery.json            # Schema para integração com Smithery
└── test_client.py           # Cliente de teste para criação de pagamentos

🔒 セキュリティ

• APIキーはソースコードではなく環境変数として保存されます

• Gotas Commerce APIとの通信はHTTPS経由で行われます

• MCPサーバーはAPIに送信する前にすべてのパラメータを検証します。

• 機密情報の漏洩を防ぐための適切なエラー処理

🧩 拡張性

このプロジェクトは簡単に拡張できるように設計されています。

1. 新機能: サーバー上で@mcp.tool()で装飾された関数を実装する新しいMCPツールを追加します。

2. 他のサービスとの統合: このアーキテクチャにより、Gotas Commerce以外の他のサービスを簡単に統合できます。

3. 新しいコインのサポート：フレームワークは将来的にUSDT以外の暗号通貨をサポートする準備ができています

📚 使用例

支払いの作成（Claude経由）

Usuário: Preciso gerar um link de pagamento de 50 USDT.

Claude: Vou gerar um link de pagamento para você. Para qual URL devo configurar o redirecionamento após o pagamento?

Usuário: https://meusite.com.br/obrigado

Claude: [Utilizando ferramenta create-payment]
Criando pagamento de 50 USDT com redirecionamento para https://meusite.com.br/obrigado...

Pronto! Criei um link de pagamento para 50 USDT.

Link de pagamento: [URL gerado pela API]
Este link expirará em 30 minutos. O cliente deve transferir exatamente 50 USDT para o endereço da carteira mostrado na página de pagamento.

ステータスの確認（Claude経由）

Usuário: Verifique o status do meu pagamento com ID xyz123.

Claude: [Utilizando ferramenta check-payment-status]
Verificando o status do pagamento ID xyz123...

O status atual do pagamento é: PENDENTE
- Valor: 50.00 USDT
- Criado em: [timestamp]
- Expira em: [timestamp]

O pagamento ainda não foi confirmado na blockchain. Você pode acompanhar usando o link de pagamento ou me pedir para verificar novamente mais tarde.

📞 サポートとお問い合わせ

サポートまたは追加情報については、Gotas 開発チームに問い合わせるか、GitHub リポジトリで問題を開いてください。

📜 ライセンス

MITライセンス