Payman API MCP Server

Payman API MCP サーバー

Payman AI の決済 API とシームレスに連携し、AI アシスタントが自然言語で受取人の作成、既存の受取人の検索、支払いの送金、残高の確認を行える MCP（Model Context Protocol）サーバーです。

概要

この MCP サーバーは、Claude などの LLM アプリケーションが利用できるツールとして、Payman AI の決済機能を公開します。AI アシスタントは次の操作を実行できます。

• 認証用の API キーを設定する
• さまざまな種類の受取人を作成する（TEST_RAILS、US_ACH、CRYPTO_ADDRESS）
• 登録済みの受取人に支払いを送金する
• さまざまな条件で受取人を検索する
• アカウント残高を確認する

この実装は Model Context Protocol（MCP）標準に準拠しており、MCP 対応クライアントとの互換性を確保しています。

機能

• 安全な API 認証：セッション内で API キーを安全に管理します
• 複数の受取人の種類：
  • テスト用の TEST_RAILS 受取人
  • 米国の銀行振込用の US_ACH 受取人
  • 暗号資産の取引用の CRYPTO_ADDRESS 受取人
• 決済操作：
  • 任意の金額とメモを指定して支払いを送金する
  • 現在の残高を取得する
• 検索機能：
  • 名前、連絡先情報、アカウント情報などで受取人を検索する
• エラー処理：すべての API 操作に対する包括的なエラー処理
• 安全なトランスポート：stdio と SSE（Server-Sent Events）の両方のトランスポートに対応

前提条件

• Node.js（v14 以降）
• npm または yarn
• Payman AI API キー

インストール

Smithery 経由でのインストール

Smithery 経由で payman_mcp を Claude Desktop に自動的にインストールするには：

npx -y @smithery/cli install @hrishi0102/payman_mcp --client claude

1. リポジトリをクローンします：

   git clone https://github.com/yourusername/payman-mcp-server.git
   cd payman-mcp-server
   

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

   npm install
   # OR
   yarn install
   

3. TypeScript コードをビルドします：

   npm run build
   # OR
   yarn build
   

設定

このサーバーに設定ファイルは必要ありません。API キーは実行時に set-api-key ツールを使用して設定します。

サーバーの実行

標準入出力モード（Claude Desktop など向け）

Claude Desktop などの MCP クライアントと互換性のある stdio モードでサーバーを実行します。

サーバーが正しくセットアップされているか確認します：

node /ABSOLUTE/PATH/TO/PARENT/FOLDER/payman-mcp/build/payman-server.js

問題がなければ、任意のクライアントに Payman MCP サーバーを追加できます。

• Claude Desktop の場合：こちら
• Cursor の場合：こちら

Server-Sent Events（SSE）モード（ウェブ連携向け）

SSE トランスポートを使用してサーバーを実行するには、追加の依存関係（express と cors）が必要です。

node build/payman-server-sse.js

これにより、次のエンドポイントを備えたウェブサーバーがポート 3001 で起動します。

• /sse - サーバーからクライアントへの通信に使用する SSE エンドポイント
• /messages - クライアントからサーバーへのメッセージに使用するエンドポイント

MCP クライアントとの連携

Claude Desktop

1. Claude Desktop の設定ファイルを開きます：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. サーバー設定を追加します：

   {
     "mcpServers": {
       "payman": {
         "command": "node",
         "args": ["/ABSOLUTE/PATH/TO/payman-mcp-server/build/payman-server.js"]
       }
     }
   }
   

3. Claude Desktop を再起動します

その他の MCP クライアント

Cursor などのその他の MCP クライアントについては、MCP サーバーの追加方法に関する各クライアントのドキュメントを参照してください。

使い方ガイド

サーバーを MCP クライアントに接続すると、次のツールを使用できます。

API キーの設定

まず、Payman API キーを設定します：

Please use the set-api-key tool with my Payman API key: YOUR_API_KEY_HERE

受取人の作成

Test Rails 受取人

Create a test payee named "Test User" with the tag "test"

US ACH 受取人

Create a US ACH payee with these details:
- Name: John Doe
- Account Type: checking
- Account Number: 12345678
- Routing Number: 123456789
- Account Holder Name: John Doe
- Account Holder Type: individual

暗号資産の受取人

Create a crypto payee with:
- Name: Crypto Wallet
- Address: 0x1234567890abcdef
- Chain: ethereum
- Currency: ETH

支払いの送金

Send a payment of 100 to payee ID "pay_123abc" with the memo "Monthly service"

受取人の検索

Search for all payees with the name "John"

残高の確認

What's my current balance?

ツールのリファレンス

set-api-key

認証用の Payman API キーを設定します。

• パラメーター：
  • apiKey（string）：Payman API キー

create-test-rails-payee

テスト用の TEST_RAILS 受取人を作成します。

• パラメーター：
  • name (string)：受取人の名前
  • type (string)：「TEST_RAILS」（デフォルト）
  • tags (string[])：受取人に付ける任意のタグ

create-us-ach-payee

銀行振込用の US_ACH 受取人を作成します。

• パラメーター：
  • type (string)：「US_ACH」（デフォルト）
  • accountType (enum)：「checking」または「savings」
  • accountNumber (string)：銀行口座番号
  • routingNumber (string)：ルーティング番号
  • accountHolderName (string)：口座名義人の名前
  • accountHolderType (enum)：「individual」または「business」
  • name (string)：この受取人の名前
  • その他の任意パラメーター（tags、contactDetails）

create-crypto-payee

暗号資産の支払い用に CRYPTO_ADDRESS 受取人を作成します。

• パラメーター：
  • type (string)：「CRYPTO_ADDRESS」（デフォルト）
  • address (string)：暗号資産のアドレス
  • chain (string)：使用するブロックチェーン
  • currency (string)：暗号資産／トークン
  • name (string)：この受取人の名前
  • その他の任意パラメーター（tags、contactDetails）

send-payment

受取人に支払いを送金します。

• パラメーター：
  • payeeId (string)：支払い先の受取人の ID
  • amountDecimal (number)：送金する金額
  • walletId (string, optional)：使用する特定のウォレット
  • memo (string, optional)：支払いメモ
  • metadata (object, optional)：追加のメタデータ

search-payees

さまざまな条件で受取人を検索します。

• パラメーター：複数の任意の検索パラメーター
  • name、contactEmail、accountNumber など

get-balance

現在の口座残高を取得します。

• パラメーター：なし

エラー処理

すべてのツールには適切なエラー処理が含まれており、次の場合には説明的なエラーメッセージを返します。

• API キーが設定されていない
• API リクエストが失敗した
• 無効なパラメーターが指定された
• ネットワークの問題が発生した

セキュリティに関する考慮事項

• API キーはセッション中、メモリに保存されます

• サーバーは認証情報をディスクに永続化しません

• Payman API へのすべてのリクエストでは、適切な認証ヘッダーを使用します

• MCP の仕様については、Model Context Protocol

• 決済 API については、Payman AI

• 入力検証については、Zod