MCP ドキュメント

AgentClick MCP Server v1.0.0 — 24ツール

AgentClickはModel Context Protocol（MCP）に対応。Claude Code、Cursor、その他のMCP対応AIエージェントから案件検索・提携・成果計測を自動化できます。

1. クイックスタート

Step 1: APIキーを取得

ログイン後、ダッシュボードの「APIキー」メニューからキーを発行します。形式は aa_ + 48文字の英数字（計51文字）です。

Step 2: .mcp.json を設定

プロジェクトのルートに.mcp.jsonを作成：

{
  "mcpServers": {
    "aiasp": {
      "command": "npx",
      "args": ["@ai-asp/mcp"],
      "env": {
        "AIASP_API_KEY": "aa_your_api_key_here"
      }
    }
  }
}

Step 3: 使い始める

AIエージェント（Claude Code等）を起動すると、自動的にMCPサーバーが接続されます。「AIチャットボットの案件を探して」などと指示するだけで、エージェントがpublisher_programs_searchツールを呼び出します。

2. 認証（APIキー）

全てのリクエスト（healthを除く）にはAPIキーが必要です。

形式	`aa_` + 48文字hex = 51文字
認証方式	環境変数 `AIASP_API_KEY`
最大発行数	1アカウント10個まで
ロール	`publisher` / `advertiser` / `agent`

APIキーはダッシュボードの「APIキー」ページでいつでも発行・無効化・削除できます。

3. レート制限

操作	上限	備考
読み取り（Read）	200回/分	検索・一覧取得・レポート等
書き込み（Write）	30回/分	提携申請・クリック記録・CV記録等

制限超過時は 429 Too Many Requests が返されます。1分待ってからリトライしてください。

4. 共通ツール（5）

全ロールで利用可能。

`health`

ヘルスチェック。認証不要。サーバーの稼働状況を確認。

パラメータ: なし

`common_categories`

AIツールカテゴリ一覧を取得。案件検索のフィルタに使用。

パラメータ: なし

レスポンス: categories[] — id, name, slug, description, sort_order

`common_stats`

プラットフォーム公開統計。アクティブ案件数・メディア数・広告主数・承認済み成果数。

パラメータ: なし

`common_profile`

認証ユーザーのプロフィール情報を取得。

パラメータ: なし

レスポンス: user情報 + ロール別プロフィール（サイト情報 or 会社情報）

`common_api_key_info`

APIキーの利用状況。利用回数・許可アクション・最終利用日時。

パラメータ: なし

5. メディア向けツール（13）

publisher または agent ロールで利用可能。

`publisher_programs_search`

公開案件を検索。カテゴリ・報酬タイプ・キーワード・最低報酬額でフィルタ。

パラメータ	型	説明
`category_id`	integer	カテゴリID
`category_slug`	string	カテゴリスラッグ（例: ai-chatbot）
`reward_type`	string	cpa / cpc / cpi / recurring
`keyword`	string	キーワード検索（案件名・説明文）
`min_reward`	integer	最低報酬額（円）
`self_affiliate`	boolean	セルフバック可能のみ
`sort`	string	newest / reward_desc / reward_asc / name
`page`	integer	ページ番号（デフォルト: 1）
`per_page`	integer	件数（デフォルト: 20、最大: 50）

`publisher_programs_detail`

案件詳細。報酬条件・Cookie期間・素材一覧・LP URL・現在の提携状況。

パラメータ	型	必須	説明
`program_id`	integer	必須	案件ID

`publisher_partnerships_apply`

案件に提携申請。auto_approveの案件は即時承認。

パラメータ	型	必須	説明
`program_id`	integer	必須	提携する案件ID

レスポンス: partnership_id, status, tracking_code

`publisher_partnerships_cancel`

pending状態の提携申請を取消。

パラメータ	型	必須	説明
`partnership_id`	integer	必須	取消する提携ID

`publisher_partnerships_list`

提携一覧。tracking_code含む。ステータスでフィルタ可能。

パラメータ	型	説明
`status`	string	pending / approved / rejected / suspended
`page`	integer	ページ番号
`per_page`	integer	件数

`publisher_links_generate`

トラッキングリンク生成。URL・HTMLタグ・JSタグの3形式 + PR表示テンプレート。

パラメータ	型	必須	説明
`partnership_id`	integer	必須	承認済み提携ID

`publisher_selfback_list`

セルフバック（自己申込）可能な案件一覧。報酬額順。

パラメータ	型	説明
`page`	integer	ページ番号
`per_page`	integer	件数

`publisher_selfback_apply`

セルフバック申請。提携+クリック+遷移URLをワンショットで処理。1案件1回限り。

パラメータ	型	必須	説明
`program_id`	integer	必須	案件ID

`publisher_report`

成果レポート。期間指定、案件別・日別集計。クリック統計含む。

パラメータ	型	説明
`start_date`	string	YYYY-MM-DD（デフォルト: 月初）
`end_date`	string	YYYY-MM-DD（デフォルト: 今日）
`group_by`	string	program / daily

`publisher_earnings_summary`

報酬サマリー。未振込残高・今月報酬・累計・振込済み・月別推移6ヶ月。

パラメータ: なし

`publisher_earnings_payouts`

振込履歴。総報酬・源泉徴収・手数料・振込額を含む。

パラメータ	型	説明
`page`	integer	ページ番号
`per_page`	integer	件数

`publisher_notifications_list`

通知一覧。未読のみフィルタ可能。

パラメータ	型	説明
`unread_only`	boolean	未読のみ取得
`page`	integer	ページ番号
`per_page`	integer	件数

`publisher_notifications_read`

通知を既読にする。ID指定で単一、省略で全既読。

パラメータ	型	説明
`notification_id`	integer	通知ID（省略で全既読）

6. エージェント向けツール（6）

agent ロール専用。A2A送客・IoTデバイス連携に最適。

`agent_recommend`

ユーザーの要件からマッチするAIツール案件を推薦。A2A送客に最適。

パラメータ	型	説明
`use_case`	string	用途（例: コード自動生成、画像生成）
`category_slug`	string	カテゴリスラッグ
`category_id`	integer	カテゴリID
`reward_type`	string	cpa / cpc / cpi / recurring
`limit`	integer	取得件数（デフォルト: 5、最大: 20）

`agent_program_detail`

案件の公開情報+素材一覧を取得。推薦結果の詳細確認用。

パラメータ	型	必須	説明
`program_id`	integer	必須	案件ID

`agent_track_click`

エージェント経由のクリックを記録。contextでデバイス種別を記録可能。

パラメータ	型	必須	説明
`partnership_id`	integer	必須	提携ID
`context`	string		voice-assistant / iot-device / chatbot 等
`user_agent`	string		ユーザーエージェント

レスポンス: click_id, tracking_url, lp_url

`agent_record_conversion`

コンバージョン記録。order_idで重複防止。

パラメータ	型	必須	説明
`tracking_code`	string	必須	トラッキングコード（32桁hex）
`order_id`	string		注文ID（重複防止用）
`amount`	integer		成果金額（円）

`agent_catalog`

全公開案件カタログ（軽量版: 名前・カテゴリ・報酬のみ）。初回ロードやキャッシュ用。

パラメータ: なし

`agent_categories`

AIツールカテゴリ一覧（案件数付き）。

パラメータ: なし

7. ロールとアクセス権

ロール	共通（5）	メディア（13）	エージェント（6）
`publisher`	利用可	利用可	利用不可
`advertiser`	利用可	利用不可	利用不可
`agent`	利用可	利用可	利用可

agentロールはメディア向け+エージェント向けの全ツールにアクセスできます。AIエージェントによる自律的な運用に最適です。

8. 利用フロー例

A. メディア: 案件を探して提携する

// 1. カテゴリ一覧を取得
common_categories()

// 2. AIチャットボット案件を検索
publisher_programs_search({ category_slug: "ai-chatbot" })

// 3. 案件詳細を確認
publisher_programs_detail({ program_id: 42 })

// 4. 提携申請
publisher_partnerships_apply({ program_id: 42 })
// → { partnership_id: 15, status: "approved", tracking_code: "abc123..." }

// 5. トラッキングリンク生成
publisher_links_generate({ partnership_id: 15 })

B. エージェント: A2A送客フロー

// 1. ユーザーのニーズに合う案件を推薦
agent_recommend({ use_case: "画像生成" })

// 2. クリックを記録（IoTデバイスからの場合）
agent_track_click({
  partnership_id: 15,
  context: "voice-assistant"
})
// → { tracking_url: "https://...", lp_url: "https://..." }

// 3. ユーザーが申込み後、コンバージョンを記録
agent_record_conversion({
  tracking_code: "abc123...",
  order_id: "ORDER-001",
  amount: 9800
})

9. エラーハンドリング

HTTPステータス	意味	対処
`400`	Bad Request	パラメータを確認
`401`	Unauthorized	APIキーが無効または未設定
`403`	Forbidden	ロールに権限がないアクション
`404`	Not Found	指定リソースが存在しない
`409`	Conflict	重複（既存提携、order_id重複等）
`422`	Unprocessable	必須パラメータの不足
`429`	Too Many Requests	レート制限超過。1分待って再試行

エラーレスポンスの形式:

{
  "success": false,
  "message": "エラーの説明"
}

MCPで自動化を始めましょう

無料登録してAPIキーを発行。すぐにAIエージェント連携を開始できます。

メディアとして登録広告主として登録

MCP ドキュメント

1. クイックスタート

Step 1: APIキーを取得

Step 2: .mcp.json を設定

Step 3: 使い始める

2. 認証（APIキー）

3. レート制限

4. 共通ツール（5）

health

common_categories

common_stats

common_profile

common_api_key_info

5. メディア向けツール（13）

publisher_programs_search

publisher_programs_detail

publisher_partnerships_apply

publisher_partnerships_cancel

publisher_partnerships_list

publisher_links_generate

publisher_selfback_list

publisher_selfback_apply

publisher_report

publisher_earnings_summary

publisher_earnings_payouts

publisher_notifications_list

publisher_notifications_read

6. エージェント向けツール（6）

agent_recommend

agent_program_detail

agent_track_click

agent_record_conversion

agent_catalog

agent_categories

7. ロールとアクセス権

8. 利用フロー例

A. メディア: 案件を探して提携する

B. エージェント: A2A送客フロー

9. エラーハンドリング

MCPで自動化を始めましょう

ログイン

アカウントの種類

新規登録

メールを送信しました

`health`

`common_categories`

`common_stats`

`common_profile`

`common_api_key_info`

`publisher_programs_search`

`publisher_programs_detail`

`publisher_partnerships_apply`

`publisher_partnerships_cancel`

`publisher_partnerships_list`

`publisher_links_generate`

`publisher_selfback_list`

`publisher_selfback_apply`

`publisher_report`

`publisher_earnings_summary`

`publisher_earnings_payouts`

`publisher_notifications_list`

`publisher_notifications_read`

`agent_recommend`

`agent_program_detail`

`agent_track_click`

`agent_record_conversion`

`agent_catalog`

`agent_categories`