你将得到什么

• 客户端里名为 manifold（或你自定义名称）的远程 MCP 连接
• 一次成功的 OAuth 登录（或 API Key 备用路径）
• tools/list 的可读结果：按组理解 seo_* / aeo_* 等
• 用 dry_run: true 得到「估价但不扣费」的对照

课前准备

1. 已安装 Claude Code CLI，且本机能跑 claude 命令（没有的话，第 2 课改用 Cursor / Claude 网页版连接器）。
2. 浏览器可完成 Google/邮箱登录。
3. 本课不需要你事先买 Pro；官方说明：登录会创建账户与 workspace，并带上 250 免费 credits。

一、Manifold 是什么（30 秒）

Manifold 是一个托管的营销数据 MCP 服务器：SEO、自家 Search Console / GA（需连接后）、AI 回答（AEO）、公司与人、广告库、Reddit 与各主流社媒等。代理连上之后，在对话里用自然语言提问即可，由客户端挑选工具。

关键边界（官网 FAQ / docs）：

• 只查不写：没有发帖、回复、发送邮件或改配置的工具。
• 按次扣 credits：多数调用扣费；少数免费；缓存命中更便宜。
• 不是 Manifold Markets：预测市场那套与本产品无关。

服务器参数（setup.md）：

二、动手：用 Claude Code 添加服务器

在终端执行（官方原文命令，可直接抄）：

claude mcp add --transport http manifold https://mcp.manifoldmcp.com/mcp

然后在 Claude Code 会话里执行：

/mcp

按提示在浏览器登录并批准 Manifold。

对照结果（成功时你会看到）：

• claude mcp add ... 结束无报错，列表里出现名为 manifold 的 HTTP MCP
• /mcp 能打开连接状态；浏览器完成登录后状态变为已连接 / authenticated
• 登录后 workspace 带有起步免费 credits（官方：250）；可在 app.manifoldmcp.com 查看用量

若客户端无法走 OAuth：到 App 创建 API Key，在支持自定义 Header 的客户端里设置为：

Authorization: Bearer YOUR_MANIFOLD_API_KEY

（官方示意形态为 mk_live_...；此处用 YOUR_MANIFOLD_API_KEY 占位，不要把真实 Key 写进仓库或截图。）

三、tools/list：先看有什么，再决定问什么

连接成功后，让代理（或你在支持 MCP 调试的面板里）调用：

tools/list

阅读每个工具的 description：官网写明——描述里会说明何时用、返回什么、大概花费多少。

工具按组（首页 / docs 汇总，名称以 list 实时结果为准）：

对照结果：

• list 返回非空工具数组
• 你能指出至少两组：例如 seo_* 与 aeo_*
• 每个工具描述里能看到费用或「free」线索（具体数字以实时 description / 响应 meta 为准）

四、dry_run：先估价，再实扣

官方 setup / docs 要求：多数调用耗 credits；先传：

{
  "dry_run": true
}

对你打算调用的工具做一次「空跑」。同时可设：

{
  "max_credits": 10
}

避免一次调用超过预算。

练习 A：对一个轻量 SEO 工具 dry_run

向代理说（自然语言即可，代理会选工具）：

请对 Manifold 工具 seo_get_serp 做 dry_run：
关键词用 "crm for startups"，只要估价，不要真实扣费。
如果客户端支持，请显式传 dry_run=true。

或在能手写 MCP 参数的环境里，对 seo_get_serp 传入关键词并带 dry_run: true（参数名以 tools/list 里该工具的 input schema 为准）。

对照结果：

• 返回中带有估价 / 预计 credits，且不应从余额扣减（dry_run）
• 官网定价页举例：seo_get_serp（某关键词 Top 10）约 1 credit——若你的估价接近 1，说明路径正确；若 schema 或套餐变化，以返回 meta 为准
• 若报未连接 / 401：回到第二节重新 /mcp 登录

练习 B：确认免费起步额度

打开 https://app.manifoldmcp.com ，查看 credits / usage。

对照结果：

• 新 workspace 能看到起步额度（官方：250 free credits）
• 尚未实扣时，余额应仍接近起步值（允许 UI 刷新延迟）

五、本课检查清单

• MCP URL 已添加：https://mcp.manifoldmcp.com/mcp
• OAuth 或 API Key 任一路径可用
• tools/list 成功，能说出两个工具组
• 至少一次 dry_run: true 看到估价
• 知道 max_credits 可封顶

六、常见问题

Q：登录后没有工具？
A：确认 transport 为 HTTP/streamable，URL 无多余路径；在 Claude Code 用官方 claude mcp add --transport http ... 命令，不要误加成 stdio。

Q：我该不该一上来就跑 technical crawl？
A：官网建议站点审计（seo_run_technical_crawl + aeo_get_site_readiness）是很好的第一次有价值回答，但 crawl 定价页举例约 30 credits / 1000 页。本课先 dry_run；实跑放到第 2 课并设 max_credits。

Q：Key 写在哪？
A：只放在客户端密钥槽或本机环境变量，占位用 YOUR_MANIFOLD_API_KEY。不要提交到 git。

本课来源

• https://www.manifoldmcp.com/setup.md
• https://www.manifoldmcp.com/docs
• https://www.manifoldmcp.com/pricing
• https://www.manifoldmcp.com