Ezoic Setup MCP Server

什么是 Ezoic Setup MCP Server？

Ezoic Setup MCP Server 是 Ezoic AI Setup Assistant（AI 设置助手）的公开 MCP 端点，帮助发布者和开发者在 Claude、ChatGPT、Cursor、VS Code 或 Codex 中为网站或应用接入 Ezoic 广告，无需登录 Ezoic。

Ezoic 是面向网站发布者的广告与变现平台（其广告产品为 EzoicAds）。接入 Ezoic 涉及多个环节：ads.txt 文件、页头脚本和同意（consent）脚本、广告位代码片段，以及各类框架或平台的 SDK。AI Setup Assistant 依据 Ezoic 公开的集成文档作答，并返回完整、可复制的代码片段，因此编码助手可以直接在你的项目中完成修改。你也可以在网页 setup-agent.ezoic.com 上直接与它对话。

它不是 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 中，只有 Owner 可以在 Organization settings 中添加连接器。

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，客户端可以轮询，而不必在一次调用中等待。

Ezoic Setup MCP Server 工具

服务器围绕一个对话式代理提供四个工具：

• 提问：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 完全为 https://setup-agent.ezoic.com/mcp（包括 /mcp），然后重新加载 MCP 服务器或重启助手。
• 出现登录提示：Setup Assistant 没有 OAuth。你很可能误添加了 Analytics MCP，请删除任何 analytics-mcp.ezoic.com 条目。
• 在 Claude Team 或 Enterprise 中无法添加连接器：只有 Owner 可以在 Organization settings 的 Connectors 中添加。