Iaptic MCP Server Iaptic

🚀 IapticのMCPサーバー

このサーバーは、Iaptic API とのやり取りを行うためのモデルコンテキストプロトコル (MCP) サーバーです。Claude や他のAIシステムが、Iaptic のデータを通じて、顧客、購入、取引、統計情報に関する質問に回答できるようにします。

🚀 クイックスタート

このサーバーを使用することで、Claude や他のAIシステムが Iaptic のデータを利用して、顧客、購入、取引、統計情報に関する質問に回答できるようになります。

📦 インストール

# 直接npxを使用して実行
npx mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

# またはグローバルにインストール
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 を指定して顧客の詳細情報を取得します。

購入

• 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: アプリケーション固有の統計情報を取得します。

🔧 技術詳細

開発に関する手順は以下の通りです。

# 依存関係をインストール
npm install

# 開発モードで実行
npm run dev

# 本番用バージョンをビルド
npm run build

# 本番用ビルドを実行
npm start

必要条件

• Node.js >= 18
• API 認証情報付きの Iaptic アカウント

📄 ライセンス

MIT