MCP Server for Iaptic

Iaptic 用 MCP サーバー

Iaptic API と連携するための Model Context Protocol サーバーです。このサーバーを使うと、Claude などの AI が Iaptic のデータを参照し、顧客、購入、取引、統計についての質問に回答できます。

対象範囲

このサーバーは Iaptic のデータに対して読み取り専用です。ツールを使って顧客、購入、取引、イベント、統計を照会できますが、レコードの変更、返金処理、Iaptic の設定変更はできません。保存データ以外を扱うツールは 3 グループあります。stripe_checkout / stripe_portal は、何かを作成する唯一のツールです。Stripe のチェックアウトセッションまたは請求ポータルセッション（顧客が支払いを行ったり、サブスクリプションを管理したりするためのリンク）を作成しますが、Iaptic のレコードは作成しません。stripe_purchases は、チェックアウトセッションのアクセストークンを使って顧客の購入を検索します。iaptic_switch_app / iaptic_reset_app は、以降の照会に使うアプリの認証情報を切り替えます。

インストール

Smithery 経由でのインストール

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

npx -y @smithery/cli install mcp-server-iaptic --client claude

手動インストール

# Run directly with npx
npx mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

# Or install globally
npm install -g mcp-server-iaptic
mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

Claude Desktop での使用方法

Claude Desktop の設定ファイルに追加します：

{
  "iaptic": {
    "command": "npx",
    "args": [
      "mcp-server-iaptic",
      "--api-key", "your-api-key-here",
      "--app-name", "your-app-name-here"
    ]
  }
}

利用可能なツール

顧客

• customer_list：ページネーション付きで顧客を一覧表示
• customer_get：ID を指定して顧客の詳細情報を取得
• customer_subscription：顧客の有効なサブスクリプションの状態を取得
• customer_transactions：顧客の取引履歴を取得

購入

• purchase_list：購入を一覧表示
  • limit：返す購入の最大数（デフォルト：100、最大：1000）
  • offset：ページネーションでスキップする購入数
  • startdate：この日付以降の購入に絞り込み（ISO 形式、例：2024-01-01）
  • enddate：この日付以前の購入に絞り込み（ISO 形式、例：2024-12-31）
  • customerId：顧客 ID で絞り込み
• purchase_get：ID を指定して購入の詳細を取得

取引

• transaction_list：ページネーションと日付フィルターを使って取引を一覧表示
  • limit：返す取引の最大数（デフォルト：100、最大：1000）
  • offset：ページネーションでスキップする取引数
  • startdate：この日付以降の取引に絞り込み（ISO 形式、例：2024-01-01）
  • enddate：この日付以前の取引に絞り込み（ISO 形式、例：2024-12-31）
  • purchaseId：購入 ID で絞り込み
• transaction_get：ID を指定して取引の詳細を取得

統計

• stats_get：取引と売上に関する一般統計を取得
• stats_app：アプリ固有の統計を取得

イベント

• event_list：ページネーションと日付フィルターを使って最近のイベントを一覧表示
  • limit：返すイベントの最大数（デフォルト：100）
  • offset：ページネーションでスキップするイベント数
  • startdate：この日付以降のイベントに絞り込み（ISO 形式、例：2024-01-01）
  • enddate：この日付以前のイベントに絞り込み（ISO 形式、例：2024-12-31）
  • raw：整形済み出力ではなく、生の JSON を返す（デフォルト：false）
• event_details：特定のイベントの詳細情報を取得（validator 3.12+）
  • eventId：詳細を取得するイベント ID
  • receipts：レシートの検証詳細を含める（デフォルト：false）

Stripe

• stripe_prices：利用可能なStripe製品と価格を取得します
• stripe_checkout：Stripe Checkoutセッションを作成し、支払いリンクを返します
  • offerId：購入するオファーID。stripe_pricesから返されます
  • successUrl：支払いが成功した後に顧客をリダイレクトするURL
  • cancelUrl：顧客がキャンセルした場合にリダイレクトするURL
  • applicationUsername：アプリケーション内のユーザー識別子（任意）
  • mode：paymentまたはsubscription（任意。価格タイプに応じて既定値が設定されます）
  • accessToken：以前の購入で取得したアクセストークン。既存のStripe顧客を再利用します（任意）
• stripe_portal：Stripe Customer Portalセッションを作成し、そのURLを返します
  • accessToken：Stripe Checkoutセッションの作成時に受け取ったアクセストークン
  • returnUrl：サブスクリプションの管理後に顧客を戻すURL
• stripe_purchases：アクセストークンを使用して顧客のStripe購入情報を取得します
  • accessToken：Stripe Checkoutセッションの作成時に受け取ったアクセストークン

アプリ管理

• iaptic_switch_app：別のIapticアプリに切り替えます
  • appName：切り替え先のアプリ名
  • apiKey：アプリのAPIキー
• iaptic_reset_app：既定のIapticアプリにリセットします
• iaptic_current_app：現在アクティブなアプリの情報を取得します

開発

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run production build
npm start

要件

• Node.js >= 18
• API認証情報を持つIapticアカウント

ライセンス

MIT