Adako: ad ops for AI assistants

Adako：AI アシスタント向け広告運用

アダコ · adako.ai

Adako は、Claude、ChatGPT、Cursor などのアシスタントを Google Ads、Meta Ads、ChatGPT Ads、TikTok Ads、LinkedIn Ads に接続する MCP サーバーと REST API です。

https://adako.ai/mcp

「先月のキャンペーンの成果はどうでしたか？」と尋ねると、アカウントの通貨で、実際のアカウントからの回答が得られます。「その予算を1日40に増やして」と頼むと、変更が行われる前に承認できる提案が表示されます。作成されたキャンペーンは常に一時停止状態です。

このリポジトリには、Agent Skills、クライアントごとの設定、単一ファイルのインストーラー、Claude Code プラグイン、MCP Registry のエントリーなど、公開されている部分が含まれています。サーバー本体はホストされています。

---

できること

5つのプラットフォームと Adako 独自のツールを合わせ、233個のツールを利用できます。

プラットフォーム	ツール数	対応範囲
Google Ads	70	検索広告と Performance Max、キーワードと検索語句、予算と入札戦略、アセットと拡張機能、コンバージョン アクション、ラベル、スケジュール、地域、時間別・デバイス別レポート
Meta Ads	44	キャンペーン、広告セットと広告、画像・動画・カルーセル・アプリインストールの配信、オーディエンスと配置、ピクセル、リードフォーム、クリエイティブの疲弊
LinkedIn Ads	34	キャンペーングループとキャンペーン、画像・動画・カルーセル・テキスト広告、B2B ターゲティング、オーディエンス予測、コンバージョンルール、エンゲージメント指標
TikTok Ads	30	キャンペーン、広告グループとインフィード動画広告、Spark Ads、動画指標、アイデンティティ、ピクセル、クリエイティブの疲弊
ChatGPT Ads	23	Chat Card キャンペーン全般、アカウント制限、ピクセル、審査結果
Adako	32	接続と利用状況、ツールの検索、提案、診断、モニター、概要とレポート

クライアントに表示されるのは233個のエントリーではありません。名前を指定して呼び出せる16個のツールと、13個のルーターが表示されます。各プラットフォームには読み取り用ルーター（google_ads、meta_ads、chatgpt_ads、tiktok_ads、linkedin_ads）と、その隣に書き込み用ルーター（google_ads_write、meta_ads_write、chatgpt_ads_write、tiktok_ads_write、linkedin_ads_write）があります。モニターには monitoring と monitoring_write があり、diagnostics は読み取り専用です。読み取りは google_ads(action="execute", tool_name="google_list_campaigns", arguments={...}) のようになり、変更は google_ads_write(action="execute", tool_name="google_pause_campaign", arguments={...}) のようになります。

情報を調べてもアカウントは変更されないため、ツールごとに許可を求めるアシスタントには、読み取りを一度だけ許可すれば十分です。変更はすべて _write ツールを通じて行われ、その都度確認を求め、提案を作成します。search_tools を使うと、自分の言葉で適切なツールを検索し、正確な呼び出し行を取得できます。利用は無料です。詳しくは adako.ai/docs/routers をご覧ください。

LinkedIn Ads の読み取りは誰でも利用できます。広告アカウントを管理するメンバーを接続すれば、すべてのレポート、構成、予測ツールが動作します。変更するには、まずその広告アカウントを Adako の LinkedIn アプリケーションに追加する必要があります。9桁の ID を [email protected] にお送りください。TikTok Ads のツールは利用できますが、TikTok が Adako の開発者アプリを承認するまでは、TikTok アカウントを接続できません。

---

安全モデル

Adakoは、危険を伴わずにアシスタントを役立てられるように設計されています。

ルール	意味
読み取りはすぐに実行されます	パフォーマンス、構造、検索語、オーディエンスなどを確認します。承認は不要です。
書き込みはすべて提案になります	送信前に、オブジェクト、変更前後の値、1日あたりの費用を確認できます。
承認するかどうかはあなた次第です	チャットで承認するか、提案を受信箱に残して adako.ai/approvals で承認できます。提案の有効期限は48時間です。
作成されたオブジェクトは一時停止状態です	Adakoが作成するすべてのキャンペーン、広告セット、広告は一時停止状態で開始します。有効化は自分で行います。
ほとんど削除されません	8つのツールで何かを削除できますが、それぞれに明示的な確認フラグが必要です。一時停止が削除に回されることはありません。
実行は1回のみです	承認された提案にはそれぞれ冪等性キーが付与されます。2回承認しても、最初の結果が報告されるだけで、再実行はされません。
書き込みのたびに読み戻します	応答を信頼するのではなく、プラットフォームからオブジェクトを読み戻して変更を確認します。
トークンはサーバー側に保持されます	プラットフォームのトークンはAdakoが暗号化して保持し、AIクライアントに転送することはありません。

詳細：adako.ai/docs/safety。

---

インストール — 5分

認証方法は2つあります。

• OAuth — クライアントがブラウザーを開き、Adakoに一度サインインします。対応している場合は、どこでもこの方法を推奨します。
• APIキー — adako.ai/keys で作成し、Authorization: Bearer ak_live_your_key として送信します。ak_live_your_key は、コピーしたキー全体（プレフィックスを含み、ほかに何も付けないもの）に置き換えてください。静的な設定ファイルを読み込むクライアントで使用します。

クライアントを選択してください。

Claude.ai（カスタムコネクター）

ProおよびMaxの場合：Settings → Connectors → Add custom connector を選択します。URLを貼り付けて Add をクリックし、続けて Connect をクリックしてサインインします。

TeamおよびEnterpriseの場合：オーナーが最初に Organization settings → Connectors → Add で追加し、Custom にカーソルを合わせて Web を選び、URLを貼り付けます。その後、メンバーは各自の Settings → Connectors から接続できます。

https://adako.ai/mcp

追加できるカスタムコネクターの数は、Claudeのプランによって異なります。

Claude Desktop

Claude.aiと同じ Connectors 設定を使用します。上記のURLでカスタムコネクターを追加し、プロンプトが表示されたらサインインします。DesktopはClaudeアカウントを共有するため、ウェブで追加したコネクターはここでも利用できます。詳しいガイド：clients/claude-desktop.md。

Claude Code

claude mcp add --transport http adako https://adako.ai/mcp

次に、セッション内で /mcp を実行し、adako を選択してブラウザーからサインインします。

--scope user を指定して、プロジェクトごとに一度追加します。

claude mcp add --transport http adako https://adako.ai/mcp --scope user

APIキーを使用する場合（ブラウザーでの手順は不要）：

claude mcp add --transport http adako https://adako.ai/mcp \
  --header "Authorization: Bearer ak_live_your_key"

サーバー、スキル、セットアップコマンド、オペレーターエージェントを一度にインストールするプラグインもあります。

/plugin marketplace add ruslan2027/adako-mcp
/plugin install adako@adako
/adako-setup

clients/claude-code.md と plugin/ を参照してください。

ChatGPT（開発者モード）

1. Settings → Security & login で Developer mode を有効にしてから、 ChatGPT Plugins を開きます。
2. + をクリックします。接続名に Adako、MCP サーバーの URL に https://adako.ai/mcp を入力します。 短い説明を追加し、パブリックエンドポイントの接続オプションを選択して、Create をクリックします。
3. プロンプトが表示された場合は、認証を完了します。
4. 新しい会話を開始し、ツールメニューを開いて Adako を選択します。

詳しいガイド：clients/chatgpt.md。

Cursor

1 つのコマンドで設定でき、繰り返し実行しても安全です。他のサーバーには影響しません。

node install/cursor.mjs            # the home-folder .cursor/mcp.json
node install/cursor.mjs --project  # .cursor/mcp.json in this repository

または、ファイルを自分で作成します。

{
  "mcpServers": {
    "adako": {
      "url": "https://adako.ai/mcp"
    }
  }
}

完全なファイル：clients/cursor/mcp.json。ガイド： clients/cursor.md。

このリポジトリは Cursor Marketplace 向けの Cursor プラグインでもあります。 .cursor-plugin/plugin.json でサーバーと skills/ 内のスキルを追加します。

Codex CLI

codex mcp add adako --url https://adako.ai/mcp
codex mcp login adako

または、インストーラーを実行します。Codex の設定（Windows では C:\Users\<you>\.codex\config.toml、macOS では /Users/<you>/.codex/config.toml）内のテーブルを 1 つ書き換え、ファイルの残りの部分には手を加えません。

node install/codex.mjs            # API key from $ADAKO_API_KEY
node install/codex.mjs --oauth    # sign in with codex mcp login instead

完全なファイル：clients/codex/config.toml。ガイド： clients/codex.md。

Windsurf

node install/windsurf.mjs

または、Windows では C:\Users\<you>\.codeium\windsurf\mcp_config.json、macOS では /Users/<you>/.codeium/windsurf/mcp_config.json にブロックを手動で追加します。

{
  "mcpServers": {
    "adako": {
      "serverUrl": "https://adako.ai/mcp"
    }
  }
}

完全なファイル：clients/windsurf/mcp_config.json。ガイド： clients/windsurf.md。

Gemini（カスタムアプリ）

パソコンで gemini.google.com/apps を開くか、Settings → Connected apps を開きます。次に下部の Custom apps までスクロールし、Add a custom app を選択して、URL を貼り付けます。

https://adako.ai/mcp

Next をクリックしてサインインします。Advanced features の認証情報欄は空欄のままにします。Adako が自動的に登録します。チャットで @ を入力し、Adako を選択します。

ガイド：clients/gemini.md。カスタムアプリは現在も順次提供中です。Google が定める条件は、個人の Google アカウント、英語、米国、18 歳以上です。

Antigravity（アプリ、IDE、agy CLI）

3 つすべてが同じファイルを読み込むため、Adako の追加は 1 回だけです。デスクトップアプリでは、Settings → Customizations を開き、Open MCP Config を選択します。IDE では、エージェントのサイドパネルで … → MCP Servers を選択します。CLI では /mcp を実行するか、ファイル自体を編集します。ファイルは Windows では C:\Users\<you>\.gemini\config\mcp_config.json、macOS では /Users/<you>/.gemini/config/mcp_config.json（Linux では /home/<you>/.gemini/config/mcp_config.json）です。1 つのプロジェクトで使う場合は .agents/mcp_config.json を使用します。保存後、Installed MCP Servers の横にある refresh を押し、Adako をクリックしてサインインします。

{
  "mcpServers": {
    "adako": {
      "serverUrl": "https://adako.ai/mcp"
    }
  }
}

Antigravity は初回の呼び出し時にブラウザー経由でサインインします。ガイド： clients/antigravity.md。

Gemini CLI は 2026 年 6 月 18 日に無料アカウントと Pro アカウントへの提供を終了し、現在は有料の Gemini API キーと Gemini Enterprise API キーでのみ動作します。引き続き使用している場合は、従来の記述方法も利用できます。ホームフォルダーの .gemini/settings.json で httpUrl を使用し、拡張機能マニフェストには gemini-extension.json と clients/gemini-cli/gemini-extension.json を使用します。別途、agy plugin import gemini を実行すると、既存の設定を Antigravity に引き継げます。

VS Code（Copilot）

ワークスペース内の .vscode/mcp.json、またはユーザーの mcp.json を使用します。

{
  "servers": {
    "adako": {
      "type": "http",
      "url": "https://adako.ai/mcp"
    }
  }
}

VS Code が OAuth フローを処理します。API キーを使用する形式を含む完全なファイル： clients/vscode/mcp.json。ガイド：clients/vscode.md。

Perplexity

Adako をカスタムコネクターとして追加します。ウェブでは perplexity.ai/computer/connectorsから、デスクトップアプリでは Settings → Connectors を開き、上記の URL を OAuth で追加します。カスタムコネクターは Pro、Max、 Enterprise で利用できます。ガイド： clients/perplexity.md。

---

スキルを追加する

skills/ には 11 個の Agent Skills が含まれています。adako は運用手順で、安全性の取り決め、 ツール呼び出しの取り決め、ツールの一覧、ワークフローが記載されています。その他は用途を絞ったもので、 プラットフォームごと、または作業ごとに分かれています。

Skill	用途
adako	運用手順です。ここから始めてください。
google-ads、meta-ads、tiktok-ads、linkedin-ads、chatgpt-ads	プラットフォームごとに、作業別のツール、ルール、開始順を案内します。
launch	あらゆるプラットフォームで安全にキャンペーンを作成します。
performance-review	数値に基づいて「成果はどうですか」という質問に答えます。
optimize	レビュー後に何をどの順番で変更するかを案内します。
creative	プラットフォームごとのコピーの制限とアセットの仕様、疲労対策の手順です。
monitoring	モニター、アラート、ブリーフ、レポートを扱います。

• Claude Code — プラグインをインストールするか、skills/ をホームディレクトリの .claude/skills/ フォルダー（Windows では C:\Users\<you>\.claude\skills\、macOS では /Users/<you>/.claude/skills/）にコピーします。
• claude.ai — 設定で SKILL.md（skills/adako/SKILL.md と同じファイル）をスキルとしてアップロードします。
• その他 — 内容をシステムプロンプトまたはプロジェクトの指示に貼り付けます。

接続時にサーバーから短い指示も提供されるため、スキルは任意です。スキルを使うと、長いセッションの安定性が目に見えて向上します。

---

REST API とコマンドライン

同じツールを API キーで HTTP 経由で実行できます。

curl -X POST https://adako.ai/api/v1/tools/google_get_campaign_performance/execute \
  -H "Authorization: Bearer ak_live_your_key" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"date_range": "last_30_days"}}'

GET /api/v1/tools では、呼び出し可能なすべてのツールを一覧表示します。GET /api/v1/openapi.json は機械可読な 仕様で、n8n、Zapier、Make にインポートできます。詳細なリファレンス： adako.ai/docs/api。

adako コマンドラインは、スクリプトやコーディングエージェント向けに同じエンドポイントを利用します。

npx @adako/cli login
npx @adako/cli google list-campaigns --customer-id 1234567890
npx @adako/cli meta get-campaign-performance --date-range last_30_days --raw

ソースは cli/ にあります。依存関係のない ESM で、Node 22 以降が必要です。公開されている パッケージは npm の @adako/cli です。

---

アカウントを接続する

1. adako.ai にサインインします。
2. Accounts を開き、プラットフォームを接続します。Google Ads と LinkedIn Ads は 各プラットフォームを通じてサインインします。Meta Ads では、自分の Meta アプリのシステムユーザーから取得した アクセストークンを使用します。ChatGPT Ads では広告主の API キーを使用します。AI クライアントにパスワードや トークンを渡す必要はありません。
3. Adako が操作できるアカウントを有効にし、各プラットフォームのメインアカウントを選択します。
4. アシスタントに戻り、「start here」 と伝えます。

---

最初のプロンプト

読み取り専用なので、何も変更されません。

• 「ここから始めてください。」
• 「接続している広告アカウントを教えてください。」
• 「過去30日間のGoogleキャンペーンの成果を、その前の30日間と比較してください。」
• 「先月、費用が発生したもののコンバージョンがなかった検索語句を見つけてください。」
• 「今週、成果がないまま費用が発生しているMeta広告セットはどれですか？」
• 「成果が最も高かったMeta広告セットを、掲載先ごとに分析してください。」
• 「どのTikTok広告にクリエイティブの疲弊が見られますか？」
• 「先月のLinkedInのリード獲得単価はいくらで、どの役職にリーチしましたか？」
• 「この無駄な広告費のチェックを、すべてのアクティブなアカウントで実行してください。」

次に、変更を加える場合：

• 「このリストから除外キーワードを10個提案し、それぞれ何を除外するか教えてください。」
• 「コンバージョンがないまま最も費用が発生したキャンペーンを一時停止してください。」
• 「Brand Searchの1日の予算を40に引き上げてください。」
• 「{product}を対象に、{city}をターゲットとする1日25の一時停止中の検索キャンペーンを作成してください。」
• 「CPAが2日連続で80を超えたら通知し、毎週月曜日に簡単なレポートを送ってください。」

これらはすべて、承認または却下する提案として提示されます。

---

料金プラン

Freeでは、広告アカウント1件と月30タスクを利用できます。Pro（月額49ドル）では広告アカウント5件と月600タスク、Agency（月額149ドル）ではアカウント20件と5,000タスクを利用でき、Enterpriseの料金は契約ごとに設定されます。請求期間中に使用したアカウントは、期間がリセットされるまでその枠を占有します。 タスクとは、広告アカウントに対して請求対象となる変更1件のことです。読み取り、接続、使用状況、提案、検出、診断、解決ツールは無料です。モニター、スケジュール設定されたレポート、生成レポートにはPro以上が必要です。詳細はadako.ai/pricingをご覧ください。

ドキュメント

adako.ai/docs — クイックスタート、クライアントごとのページ、プラットフォームごとのページ、ツール一覧、ワークフロー、モニター、完全なツールリファレンス、REST APIを掲載しています。

サポート

[email protected] · セキュリティに関する報告： SECURITY.mdをご覧ください · 変更履歴： CHANGELOG.mdをご覧ください

ライセンス

このリポジトリのスキルとクライアント設定はMITライセンスです。LICENSEをご覧ください。ホステッドサービスのAdakoはプロプライエタリです。