MyFatoorah MCP

MyFatoorah API向けの、LLMフレンドリーなModel Context Protocolサーバーです。Claude、VS Code、Cursor、その他のMCPホストは、専用ツールを通じて、決済手段の検出、支払いリンクの作成、支払いの検証、請求書の確認、返金の管理を行うことができます。

これは独立したコミュニティプロジェクトであり、MyFatoorahの公式製品ではありません。本番アカウントを使用する前に、サンドボックスでテストしてください。

ホストのセットアップ手順、Inspectorでのテスト、エージェントプロンプト、支払い検証、返金、トラブルシューティングについては、使用ガイドを参照してください。

要件

• Node.js 20以降

• 使用するツールに必要な権限のみを持つMyFatoorah APIトークン

Related MCP server: AgentPay

セットアップ

npm install
cp .env.example .env
npm run build

MCPホストの環境でMYFATOORAH_API_TOKENを設定してください。サーバーは.envを自動的には読み込みません。読み込むのはVS Codeのデバッグ構成です。

環境変数

クウェートの環境は、バーレーン、ヨルダン、オマーン共通のAPIオリジンもカバーします。複数国対応アカウントでは、国ごとに個別のトークンを使用します。

MCPホストを接続する

ホスト構成では絶対パスを使用してください。/absolute/path/to/myfatoorah-mcpとトークンのプレースホルダーは、ローカル環境に合わせて置き換えてください。

Claude Desktop

Claude DesktopのMCP構成にこのサーバーを追加します：

{
  "mcpServers": {
    "myfatoorah": {
      "command": "node",
      "args": ["/absolute/path/to/myfatoorah-mcp/dist/index.js"],
      "env": {
        "MYFATOORAH_API_TOKEN": "YOUR_TOKEN",
        "MYFATOORAH_ENVIRONMENT": "test"
      }
    }
  }
}

構成を保存したら、Claude Desktopを再起動してください。

Claude Code

プロジェクトスコープの構成では.mcp.jsonを使用できます（トークンを含む場合はコミットしないでください）：

{
  "mcpServers": {
    "myfatoorah": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/myfatoorah-mcp/dist/index.js"],
      "env": {
        "MYFATOORAH_API_TOKEN": "YOUR_TOKEN",
        "MYFATOORAH_ENVIRONMENT": "test"
      }
    }
  }
}

VS Code / GitHub Copilot

同梱の.vscode/mcp.jsonは、ビルド済みのサーバーを起動し、トークンを安全に入力するよう促します。一度ビルドしてから、MCPサーバービューを開き、myfatoorahを起動してください。トークンはリポジトリに保存されません。

Cursorおよび一般的なstdioホスト

Claude Desktopの例と同じcommand、args、envの値を使用してください。MCPプロトコルのメッセージはstdin/stdoutを使用し、サーバーの診断情報はstderrを使用する必要があります。

npmに公開した後は、ホストは代わりにnpx -y myfatoorah-mcpで起動することもできます。

ツール

サーバーは以下も公開しています：

• リソースmyfatoorah://configuration：環境、ベースURL、タイムアウト、トークンが設定されているかどうか。トークン自体は含まれません。

• プロンプトcreate-payment-safely：再利用可能なガイド付き支払いリンクワークフロー。

成功したツールは、簡潔なテキスト要約と、MyFatoorahのレスポンスを含む機械可読なstructuredContentを返します。

安全な支払いワークフロー

1. myfatoorah://configurationを読み取り、テスト環境と本番環境を確認します。

2. ゲートウェイを選択する場合は、myfatoorah_get_payment_methodsを呼び出して、そのApiNameを使用します。

3. 金額、通貨、顧客、通知方法、コールバックURLを確認します。

4. myfatoorah_create_paymentを呼び出し、顧客にそのPaymentURLを渡します。

5. コールバック後、返されたPaymentIdを指定してmyfatoorah_get_paymentを呼び出します。リダイレクトは支払いの証明にはなりません。請求書ステータスがPAID、取引ステータスがSUCCESSであることを確認してください。

返金は本番モードで資金を移動させます。confirm: trueを渡す前に、正確なPaymentIdと金額についてユーザーの明示的な承認を得てください。

開発

npm run format
npm run lint
npm run typecheck
npm test
npm run build
npm run inspect

npm run inspectは、コンパイル済みのstdioサーバーに対して公式のMCP Inspectorを起動します。VS Codeにはビルド/テストタスクとデバッグ構成も含まれています。

テストはすべてのMyFatoorahリクエストをモックします。ネットワーク呼び出しやトークンは必要ありません。

セキュリティ

• 最小権限のMyFatoorah APIキーを使用し、定期的にローテーションしてください。

• 認証情報はホスト環境またはシークレットマネージャーに保管し、ソース管理やモデルコンテキストには絶対に置かないでください。

• 汎用リクエストツールは、認証情報の外部流出を防ぐため、絶対URL、プロトコル相対URL、トラバーサル、/v2/と/v3/以外のパスを拒否します。

• APIエラーとBearer値は、モデルに到達する前にマスクされます。

• サポート対象の変更操作では冪等性キーを優先し、安定した注文識別子を使用してください。

• このstdioプロセスを、認証なしのネットワークサービスとして公開しないでください。

• 直接のカード処理は、意図的に専用ツールとしてはモデル化されていません。PCI準拠が必要です。

APIスコープとリファレンス

専用ツールは、2026年8月時点でMyFatoorahが公開しているv3ルートを使用します：

• GET /v3/payment-methods

• POST /v3/payments

• GET /v3/payments/{paymentId}

• GET /v3/invoices/{invoiceId}

• GET /v3/invoices/externalIdentifier/{externalIdentifier}

• POST /v3/refunds

• GET /v3/refunds/{refundId}

リファレンス：

• MyFatoorah APIキーと地域別URL

• MCP TypeScript SDK v2

• Model Context Protocol仕様

ライセンス

MIT