MCP ドキュメント

AgentClick MCP Server v1.0.0 — 35ツール

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": {
    "agentclick": {
      "command": "npx",
      "args": ["@agentclick-ai/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`

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

パラメータ: なし

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

`common_stats`

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

パラメータ: なし

`common_profile`

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

パラメータ: なし

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

`common_api_key_info`

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

パラメータ: なし

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

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

`publisher_programs_search`

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

パラメータ	型	説明
`category_id`	integer	カテゴリID
`category_slug`	string	カテゴリスラッグ（例: ai-chatbot）
`reward_type`	string	cpa / cpc / cpi
`keyword`	string	キーワード検索（案件名・説明文）
`min_reward`	integer	最低報酬額（円）
`self_affiliate`	boolean	セルフバック可能のみ
`min_confirmation_rate`	integer	最低確定率（%）
`allow_listing`	boolean	リスティング広告OK案件のみ
`has_product_link`	boolean	商品リンクあり案件のみ
`itp_supported`	boolean	ITP対応済み案件のみ
`is_campaign`	boolean	キャンペーン中の案件のみ
`is_new`	boolean	新着案件のみ
`auto_approve`	boolean	即時提携案件のみ
`sort`	string	newest / reward_desc / reward_asc / name / confirmation_rate_desc / epc_desc
`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（省略で全既読）

`publisher_offers_list`

広告主から受信したオファー一覧を取得。ステータス・未読フィルタ対応。

パラメータ	型	説明
`status`	string	pending / accepted / rejected / all（デフォルト: all）
`unread_only`	boolean	未読のみ取得
`page`	integer	ページ番号
`per_page`	integer	件数

`publisher_offer_messages_list`

オファースレッドのメッセージ一覧を取得。

パラメータ	型	必須	説明
`offer_id`	integer	必須	オファーID

`publisher_offer_messages_send`

オファースレッドにメッセージを送信。

パラメータ	型	必須	説明
`offer_id`	integer	必須	オファーID
`message`	string	必須	メッセージ本文（最大2000文字）

`publisher_offer_messages_read`

オファースレッドのメッセージを既読にする。

パラメータ	型	必須	説明
`offer_id`	integer	必須	オファーID

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

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

`agent_recommend`

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

パラメータ	型	説明
`use_case`	string	用途（例: コード自動生成、画像生成）
`category_slug`	string	カテゴリスラッグ
`category_id`	integer	カテゴリID
`reward_type`	string	cpa / cpc / cpi
`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`

カテゴリ一覧（案件数付き）。

パラメータ: なし

7a. 広告主向けツール（5）

advertiser ロールで利用可能。

`advertiser_plan_status`

現在の広告主プラン情報（プラン名、オファー上限、使用数、残数、サイクル開始日）と全プラン一覧を取得。

パラメータ: なし

`advertiser_plan_subscribe`

プラン購入/変更。Stripe Checkout URLを返却。ブラウザで開いて決済を完了する。

パラメータ:

名前	型	必須	説明
`plan`	string	はい	購入するプラン（light / standard / unlimited）

`advertiser_plan_cancel`

現在のプランを解約しFreeプランに戻す。

パラメータ: なし

案件ブーストツール

`advertiser_boost_purchase`

案件ブースト購入（¥5,000/1週間）。パブリッシャーの案件検索でPromotedバッジ付き優先表示。Stripe Checkout URLを返却。

パラメータ:

名前	型	必須	説明
`program_id`	integer	はい	ブーストする案件ID
`headline`	string	いいえ	見出し（最大100文字）

`advertiser_boost_status`

自分の案件ブースト状態確認（履歴、残り枠数、料金情報）。

パラメータ: なし

メディアブーストツール

`publisher_boost_purchase`

メディアブースト購入（¥3,000/1週間）。LP・ダッシュボードにバナー表示。Stripe Checkout URLを返却。

パラメータ:

名前	型	必須	説明
`site_id`	integer	はい	ブーストするサイトID
`headline`	string	いいえ	見出し（最大100文字）
`description`	string	いいえ	説明文（最大200文字）

`publisher_boost_status`

自分のブースト状態確認（履歴、残り枠数、料金情報）。

パラメータ: なし

7. ロールとアクセス権

ロール	共通（5）	メディア（19）	エージェント（6）	広告主（5）
`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": "エラーの説明"
}

今すぐ開発を始めましょう

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

開発者ガイド REST API MCPドキュメント

クイックスタート
認証（APIキー）
レート制限
共通ツール（5）
メディア向けツール（19）
エージェント向けツール（6）
広告主向けツール（5）
ロールとアクセス権
利用フロー例
エラーハンドリング

AI時代のアフィリエイトASP

アフィリエイトを始めたい方無料でメディア登録する広告出稿をお考えの広告主様無料で広告出稿をする

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. メディア向けツール（19）

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

publisher_offers_list

publisher_offer_messages_list

publisher_offer_messages_send

publisher_offer_messages_read

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

agent_recommend

agent_program_detail

agent_track_click

agent_record_conversion

agent_catalog

agent_categories

7a. 広告主向けツール（5）

advertiser_plan_status

advertiser_plan_subscribe

advertiser_plan_cancel

案件ブーストツール

advertiser_boost_purchase

advertiser_boost_status

メディアブーストツール

publisher_boost_purchase

publisher_boost_status

7. ロールとアクセス権

8. 利用フロー例

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

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

9. エラーハンドリング

今すぐ開発を始めましょう

ログイン

アカウントの種類

パスワードリセット

:roleとして登録

`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`

`publisher_offers_list`

`publisher_offer_messages_list`

`publisher_offer_messages_send`

`publisher_offer_messages_read`

`agent_recommend`

`agent_program_detail`

`agent_track_click`

`agent_record_conversion`

`agent_catalog`

`agent_categories`

`advertiser_plan_status`

`advertiser_plan_subscribe`

`advertiser_plan_cancel`

`advertiser_boost_purchase`

`advertiser_boost_status`

`publisher_boost_purchase`

`publisher_boost_status`