Keitaro TDS API MCP プラグイン

説明

Keitaro TDS API と統合するための MCP サーバー。キャンペーン、ストリーム、オファー、およびその他の Keitaro エンティティを操作するためのツールを提供します。

Related MCP server: mcp-keap

インストール

カーソルにプラグインをインストールする

1. リポジトリをクローンする

git clone <repository-url>
cd mcp-keitaro-tds

2. 依存関係をインストールする

npm install

3. パッケージをグローバルにインストールする

npm install -g .

4. カーソルにプラグインをインストールする

node install-cursor-plugin.js

5. カーソルを再開

代替案: カーソルでの手動設定

また、Keitaro MCP サーバーを Cursor 構成に手動で追加することもできます。

1. カーソル MCP 構成ファイルを開きます。

# On macOS
open ~/.cursor/mcp.json

# On Windows
notepad %USERPROFILE%\.cursor\mcp.json

# On Linux
nano ~/.cursor/mcp.json

2. 「mcpServers」オブジェクトに次のエントリを追加します。

"Keitaro": {
  "command": "mcp-keitaro-tds",
  "args": []
}

3. ファイルを保存してカーソルを再起動します

APIキーの設定

次のパラメータを使用して、プロジェクト ルートに.envファイルを作成します。

KEITARO_API_URL=http://your-keitaro-domain.com/admin_api/v1
KEITARO_API_KEY=your-api-key

カーソルでの使用

1. カーソルを起動

2. コマンドパレットを開きます（macOSの場合はCmd+P、Windows/Linuxの場合はCtrl+P）

3. 「Keitaro」を見つけて選択してください

4. Cursor経由でKeitaro APIが使用できるようになりました

利用可能なツール

キャンペーン

• list_campaigns - キャンペーンのリストを取得する

• get_campaign - 特定のキャンペーンに関する情報を取得する

• create_campaign - 新しいキャンペーンを作成する

• update_campaign - 既存のキャンペーンを更新する

• delete_campaign - キャンペーンを削除する

トラフィックストリーム

• list_streams - キャンペーンのトラフィックストリームのリストを取得します

• get_stream - 特定のストリームに関する情報を取得する

トラフィックソース

• list_traffic_sources - トラフィックソースのリストを取得する

• get_traffic_source - 特定のトラフィックソースに関する情報を取得する

オファー

• list_offers - オファーのリストを取得する

• get_offer - 特定のオファーに関する情報を取得する

クリックとコンバージョン

• list_clicks - クリックのリストを取得する

• get_click - 特定のクリックに関する情報を取得する

• list_conversions - コンバージョンのリストを取得する

• get_conversion - 特定のコンバージョンに関する情報を取得する

レポート

• get_report - 指定されたパラメータでレポートを生成する

ドメイン

• list_domains - ドメインのリストを取得する

• get_domain - 特定のドメインに関する情報を取得する

使用例

キャンペーンのリストを取得する

list_campaigns({
  limit: 10,
  page: 1,
  search: "search query"
})

新しいキャンペーンを作成する

create_campaign({
  name: "New Campaign",
  type: "position",
  cost_type: "CPC",
  cost_value: 1.5,
  group_id: 1,
  state: "active",
  traffic_source_id: 1
})

レポートの取得

get_report({
  from: "2025-01-01",
  to: "2025-01-31",
  group: "campaign",
  filters: {
    campaign_id: 123
  }
})

発達

開発モードで実行中

npm run dev

MCPサーバーのテスト

npm run inspect