Iaptic用MCPサーバー

Iaptic APIと対話するためのModel Context Protocolサーバーです。このサーバーを使用すると、Claudeやその他のAIがIapticデータと対話し、顧客、購入、取引、統計に関する質問に回答できるようになります。

インストール

Smithery経由でのインストール

Smitheryを使用してClaude Desktop用のIapticを自動的にインストールするには：

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

Related MCP server: MCP Unified Server

Claude Desktopでの使用方法

Claude Desktopの設定ファイルに追加してください：

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

利用可能なツール

顧客 (Customers)

• customer_list: ページネーションを使用して顧客を一覧表示

• customer_get: IDで詳細な顧客情報を取得

• customer_subscription: 顧客の有効なサブスクリプションステータスを取得

• customer_transactions: 顧客の取引履歴を取得

• customer_add_purchase: 手動で顧客に購入を関連付け

購入 (Purchases)

• purchase_list: 購入を一覧表示

  • limit: 返す購入の最大数（デフォルト: 100、最大: 1000）

  • offset: ページネーションのためにスキップする購入数

  • startdate: この日付以降の購入をフィルタリング（ISO形式、例: 2024-01-01）

  • enddate: この日付以前の購入をフィルタリング（ISO形式、例: 2024-12-31）

  • customerId: 顧客IDでフィルタリング

• purchase_get: IDで購入詳細を取得

取引 (Transactions)

• transaction_list: ページネーションと日付フィルタリングを使用して取引を一覧表示

  • limit: 返す取引の最大数（デフォルト: 100、最大: 1000）

  • offset: ページネーションのためにスキップする取引数

  • startdate: この日付以降の取引をフィルタリング（ISO形式、例: 2024-01-01）

  • enddate: この日付以前の取引をフィルタリング（ISO形式、例: 2024-12-31）

  • purchaseId: 購入IDでフィルタリング

• transaction_get: IDで取引詳細を取得

統計 (Statistics)

• stats_get: 取引と収益に関する一般的な統計を取得

• stats_app: アプリ固有の統計を取得

イベント (Events)

• event_list: ページネーションと日付フィルタリングを使用して最近のイベントを一覧表示

  • limit: 返すイベントの最大数（デフォルト: 100）

  • offset: ページネーションのためにスキップするイベント数

  • startdate: この日付以降のイベントをフィルタリング（ISO形式、例: 2024-01-01）

  • enddate: この日付以前のイベントをフィルタリング（ISO形式、例: 2024-12-31）

  • raw: フォーマットされた出力の代わりに生のJSONを返す（デフォルト: false）

• event_details: 特定のイベントに関する詳細情報を取得（バリデーター 3.12以降）

  • eventId: 詳細を取得するイベントID

  • receipts: レシート検証の詳細を含める（デフォルト: false）

Stripe

• stripe_prices: 利用可能なStripe製品と価格を取得

アプリ管理 (App Management)

• 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