MCP Server Iaptic

🚀 Iaptic モデルコンテキストプロトコル (MCP) サーバー

このサーバーは、Iaptic API とのインタラクションを可能にするモデルコンテキストプロトコルサーバーです。Claude やその他の AI が、Iaptic のデータとやり取りし、顧客、購入、取引、統計情報に関する質問に回答できるようになります。

🚀 クイックスタート

このサーバーを使用することで、Claude などの AI が Iaptic のデータを活用し、様々な質問に回答できるようになります。以下に、インストール方法や使用例を説明します。

📦 インストール

Smithery を使用したインストール

Smithery を通じて、Iaptic を自動的にインストールできます。

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

手動インストール

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

イベント

• event_list: ページングと日付フィルタリングを持つ最近のイベントを一覧表示します。
  • limit: 返される最大イベント数（デフォルト: 100）
  • offset: ページングでスキップする数
  • startdate: イベント日以降のレコードをフィルタリング（ISO 形式、例: 2024-01-01）
  • enddate: イベント日以前のレコードをフィルタリング（ISO 形式、例: 2024-12-31）

アプリケーション管理

• iaptic_switch_app: 異なる Iaptic アプリケーションに切り替えます。
  • appName: 切り替えるアプリケーションの名前
  • api-key: 新しいアプリケーションの API キー
• iaptic_get_apps: 利用可能なすべての Iaptic アプリケーションを取得します。

🔧 技術詳細

開発

依存関係をインストールするには、以下のコマンドを実行します。

npm install

開発モードでサーバーを起動するには、以下のコマンドを実行します。

npm run dev

要件

• Node.js: 最低バージョン 16.0.0
• 有効な Iaptic アカウントと API キーが必要です。