Apify MCP 中文教程：让 AI Agent 只调用你允许的采集工具

证据口径：本页在 2026-07-13 按 Apify MCP 官方文档 核对配置。本站没有为这篇教程使用自有 token 触发任何 Actor run，因此不写“本站已跑通”、不展示 Run Stamp；涉及 Actor 输出与价格时，只链接本站已有实测任务页。

Apify MCP Server 的作用很具体：把 Apify Store 里的 Actor、运行记录和 Dataset 变成 AI 客户端可调用的工具。它适合“让 Agent 在需要时取公开网页数据”，不等于给 Agent 一张无限额信用卡，也不应该默认暴露整个 Store。

先给结论：远程 OAuth + 最小 tools 是默认答案

支持远程 MCP 的客户端，优先使用官方托管地址和 OAuth：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=apify/google-search-scraper,apify/instagram-scraper"
    }
  }
}

第一次连接会跳到 Apify 完成授权；OAuth 的好处是不用把 API token 写进配置文件。上面的 tools 只暴露两个明确 Actor，适合先做最小可控版本。官方也建议生产配置显式指定工具，避免默认工具集以后变化。

如果你的客户端不支持这段通用配置，用 官方 MCP Configurator 选择客户端和 Actor，再复制它生成的当前配置。不要照搬旧教程里的 SSE 地址：官方文档把 2026-04-01 列为 SSE 移除日期，并要求改用 Streamable HTTP。

第一步：不登录，先做只读连通性检查

官方允许下面四个发现/文档工具匿名使用，不会启动 Actor：

https://mcp.apify.com?tools=search-actors,fetch-actor-details,search-apify-docs,fetch-apify-docs

连接后先让客户端执行两件事：

1. 搜索目标任务对应的 Actor；
2. 读取 Actor 的 input/output schema 与 pricing 信息。

这一步能验证“客户端看得见 MCP 工具”，又不会产生采集 run。只要工具列表里加入 Actor、运行记录或存储访问，官方就要求 OAuth 或 API token。

第二步：只开放任务真正需要的 Actor

不要从“把所有 Actor 都交给 Agent”开始。按任务拆最小工具集更容易审计：

Actor slug 不是随便猜的；先用 search-actors / fetch-actor-details 核对，再写进 tools。如果任务只需要一个 Actor，就只放一个。

第三步：把授权和凭证边界守住

推荐顺序：

1. 远程 OAuth：客户端只保存授权关系，不需要你手抄 token。
2. Bearer token：只有客户端确实不支持 OAuth 时才用；token 放客户端自己的秘密存储或环境变量，不进聊天、截图、仓库和共享配置。
3. 本地 stdio：只支持本地 MCP 的客户端可运行官方 @apify/actors-mcp-server，同样从环境变量读取 APIFY_TOKEN。

官方也区分两个容易混淆的概念：Apify MCP Server 是让外部 AI 客户端调用 Apify；MCP connectors 是让 Actor 反向调用 Notion、Slack 等第三方服务。你只是想让 Agent 抓公开网页时，用前者。

第四步：给自动运行加三道成本护栏

1. 工具护栏：用 tools 白名单限制 Agent 能调用什么。
2. 输入护栏：在提示和 Actor 输入里固定目标域名、结果上限、允许的字段与禁止范围；第一次先看 input schema，再提交。
3. 运行护栏：需要在后端/API 触发 run 时，Apify 官方提供 timeout 与 maxTotalChargeUsd 等运行上限；同时在 Console 查看用量。不要把“有免费额度”理解成 Agent 可以无限循环。

MCP 只是调用入口，Actor 仍按各自价目和运行方式计费。本站的任务页计算器用于运行前估算；真正扣费以 Apify Console 为准。

一个不会越权的起步提示

先不要运行 Actor。
请读取 apify/google-search-scraper 的 input schema 和 pricing，
列出准备提交的查询、结果上限与可能计费项，等我确认后再调用。
返回结果时保留来源 URL、查询词和 Dataset ID。

这段提示不能替代程序级限额，但能把“发现 → 预览输入 → 人确认 → 运行”变成默认顺序。生产系统仍应在工具层限制参数和预算。

常见故障，按这个顺序查

• 工具完全没出现：先确认客户端支持远程 MCP，配置地址是 https://mcp.apify.com，不是旧 SSE 地址；重启客户端后再看工具列表。
• 只能搜 Actor，不能运行：匿名模式本来就只能发现和读文档；运行 Actor、读取 Dataset 或 run 记录需要 OAuth/token。
• 指定 Actor 不在列表：核对 slug 与 tools 参数；先用只读工具查详情，不要手猜名称。
• 运行很久没有结果：到 Apify Console 查看对应 run 的状态与日志；Actor 是远端任务，不是每次都能瞬时返回。
• 出现 429：官方 MCP 服务有请求频率限制；降低并发并按客户端重试策略退避，别同时让多个 Agent 无限轮询。

准备实际采集前，先从 RAG / AI Agent 数据供给流水线 选数据源，或直接进入 Google Search 实测任务页 核对真实样本、最低扣费和输入方式。