Ezoic Setup MCP Server

Ezoic Setup MCP Server とは？

Ezoic Setup MCP Server は、Ezoic の AI Setup Assistant を公開する MCP エンドポイントです。パブリッシャーや開発者は、Claude、ChatGPT、Cursor、VS Code、Codex の中から、Ezoic へのログインなしでサイトやアプリに Ezoic 広告を導入できます。

Ezoic はウェブサイトのパブリッシャー向けの広告・収益化プラットフォームです（広告製品は EzoicAds）。導入には、ads.txt ファイル、ヘッダーと同意（consent）スクリプト、広告枠のスニペット、フレームワークやプラットフォーム向け SDK など、いくつかの要素があります。AI Setup Assistant は Ezoic の公開インテグレーションドキュメントに基づいて回答し、コピーしてそのまま使える完全なスニペットを返すため、コーディングエージェントがプロジェクトに直接変更を加えられます。setup-agent.ezoic.com の Web 版でチャットすることもできます。

これは Ezoic Analytics MCP ではありません。Setup Assistant はアカウントを読み取らず、ダッシュボード設定も変更せず、分析データも返しません。

Ezoic Setup MCP Server の使い方

インストールは不要で、アカウントや API キーの設定もありません。エンドポイントは次のとおりです。

https://setup-agent.ezoic.com/mcp

Streamable HTTP を使用し、認証はありません。Ezoic のドキュメントでは、アシスタントが自分で MCP サーバーを追加できる場合、次の文を貼り付ける方法が紹介されています："Add the Ezoic Setup MCP server: https://setup-agent.ezoic.com/mcp (streamable HTTP, no auth). Then use it to help me set up Ezoic ads."

Claude Code

claude mcp add --transport http ezoic-setup https://setup-agent.ezoic.com/mcp

Claude Desktop と claude.ai

Ezoic Setup は Claude のコネクタディレクトリに掲載されています。メッセージ欄の横の + をクリックし、Add connector、Browse connectors の順に選び、Ezoic Setup を検索して Connect をクリックします。ディレクトリのコネクタが使えない場合は、Settings、Connectors、Add custom connector の順に開き、名前を Ezoic Setup にして URL を貼り付けます。Claude Team と Enterprise では、Organization settings からコネクタを追加できるのは Owner のみです。

Cursor

~/.cursor/mcp.json（またはプロジェクトの .cursor/mcp.json）に追加します。

{"mcpServers": {"ezoic-setup": {"url": "https://setup-agent.ezoic.com/mcp"}}}

VS Code

コマンドラインから追加します。

code --add-mcp '{"name":"ezoic-setup","type":"http","url":"https://setup-agent.ezoic.com/mcp"}'

または .vscode/mcp.json に追加します。

{"servers": {"ezoic-setup": {"type": "http", "url": "https://setup-agent.ezoic.com/mcp"}}}

Codex と ChatGPT

Codex CLI では、~/.codex/config.toml に次を追加して Codex を再起動します。

[mcp_servers.ezoic-setup]
url = "https://setup-agent.ezoic.com/mcp"

ChatGPT では、Ezoic Setup はアプリディレクトリの公式アプリです。開いて Connect をクリックします。

Ezoic Setup MCP Server の主な機能

• Ezoic 公式のサーバー。ChatGPT、Claude、Claude Code、Cursor、VS Code、Codex 向けの手順が用意されています。
• OAuth も API キーも Ezoic へのログインも不要な公開エンドポイント。
• 回答は Ezoic の公開インテグレーションドキュメントに基づき、コピー可能な完全なコードスニペットが付きます。
• Ezoic の質問例から判断すると、ads.txt、ヘッダーと同意スクリプト、広告枠、React SDK、ゲームの広告ブレイクをカバーしています。
• 設計上は読み取り専用で、Ezoic アカウント、ダッシュボード設定、分析データにはアクセスしません。
• 時間のかかる質問はジョブ ID を返すため、クライアントは 1 回の呼び出しで待たずにポーリングできます。

Ezoic Setup MCP Server のツール

サーバーは 1 つの対話型エージェントを中心に 4 つのツールを提供します。

• 質問：ask はセットアップエージェントに質問を送り、エージェントは一連の処理を実行して回答を返します。指定した期限内に回答が用意できない場合は、pending ステータスとジョブ ID を返します。会話の文脈を保つため、毎回同じスレッド ID（UUID）を渡すよう求められます。
• 保留中のジョブの追跡：request_status は保留中ジョブの状態を確認し、read_response はその出力を少しずつ読み出します。
• 案内：help は呼び出し側向けの短い説明を返します。

Ezoic Setup MCP Server のユースケース

• 初めての導入："Add Ezoic ads to this site. Put the header and consent scripts in head."
• 広告枠のスニペット："Show me the id-less showAds snippet and where to paste it."
• ads.txt："Set up ads.txt for Ezoic on this project."
• フレームワーク："Add the Ezoic React SDK to this Next.js app."
• ゲーム："How do I show a rewarded ad break in this HTML5 game?"

Ezoic Setup MCP Server のトラブルシューティング

• アシスタントがサーバーに接続できない：URL が /mcp を含めて正確に https://setup-agent.ezoic.com/mcp であることを確認し、MCP サーバーを再読み込みするかアシスタントを再起動してください。
• サインインを求められる：Setup Assistant には OAuth がありません。誤って Analytics MCP を追加している可能性があるため、analytics-mcp.ezoic.com のエントリを削除してください。
• Claude Team や Enterprise でコネクタを追加できない：Organization settings の Connectors からコネクタを追加できるのは Owner のみです。