跳至内容
文档

Grok:通过 MCP 连接 AutoPSEO

在 Grok 中使用 AutoPSEO 的 MCP server:在 grok.com 上将其添加为自定义连接器,在 Grok Build 中注册,或在 xAI API 中作为远程工具接入。

MCP & API阅读需 1 分钟

Grok 通过与其他 AI 助手相同的 MCP server 接入 AutoPSEO,地址为 https://app.autopseo.com/mcp。无需安装任何 Grok 专用组件:xAI 支持在三个位置接入远程 MCP server,即 grok.com、Grok Build 终端智能体和 xAI API。在这三处使用 AutoPSEO 时,可用的工具、权限和套餐都与你的账户一致。本页分别介绍每种方式的操作步骤,以及连接失败时的排查要点。

网页版 Grok

xAI 的连接器指南将自定义连接器的设置分为三步:

  1. 打开 grok.com/connectors。
  2. 选择 New Connector,然后选择 Custom。
  3. 将 https://app.autopseo.com/mcp 填入 MCP server URL 并完成登录。AutoPSEO 的登录与授权页面随即打开,请使用持有你网站资源的账户进行授权。

据 xAI 介绍,所有 Grok 用户均可使用连接器;在 Business 和 Enterprise 套餐中,需要由团队管理员先配置连接器,成员才能使用。连接完成后,可以让 Grok "列出我账户下的 Search Console 资源",以确认它连接到了正确的账户,并获取准确的资源名称。

Grok Build

Grok Build 是 xAI 的终端智能体,只需一条命令即可添加远程 server(xAI 的 MCP 指南):

grok mcp add --transport http autopseo https://app.autopseo.com/mcp

首次使用工具时,Grok Build 会在浏览器中打开登录页面,并自行保存令牌。如果机器上没有浏览器,可改用 API 密钥,并将其保存在环境变量中:

grok mcp add --transport http autopseo https://app.autopseo.com/mcp --header "Authorization: Bearer ${AUTOPSEO_API_KEY}"

Grok Build 还会加载为 Claude Code(~/.claude.json)、Cursor(.cursor/mcp.json)以及项目 .mcp.json 配置的 server,因此你已在这些位置添加过的 AutoPSEO server 会直接出现,无需再次配置。在其界面中,/mcps 会列出所有 server,并可对其中某个进行身份验证。

xAI API

基于 xAI API 构建的智能体可以把 AutoPSEO 作为远程 MCP 工具调用。xAI 在其原生 SDK 和兼容 OpenAI 的 Responses API 中均支持这种方式,传输协议为 Streamable HTTP,使用 server_url、server_label 以及用于传递令牌的可选 authorization 字段(远程 MCP 工具)。tools 数组中的条目如下所示:

{
  "type": "mcp",
  "server_label": "autopseo",
  "server_url": "https://app.autopseo.com/mcp",
  "authorization": "apk_live_..."
}

xAI 不支持 Responses API 的 require_approval 参数,因此工具运行前不会暂停等待批准。除非智能体必须修改数据,否则请只提供 Read only 密钥:对于所有会写入数据或消耗研究额度的工具,AutoPSEO 都会拒绝只读密钥的调用。

给 Grok 什么样的访问权限

用途连接方式
在 grok.com 对话中提问登录
在自己的电脑上使用 Grok Build登录;没有浏览器的机器则使用密钥
xAI API 上无人值守的智能体Read only 密钥;智能体需要执行操作时使用 Read & write

通过登录建立的连接会显示在 MCP & API 页面的 Signed-in tools 下,你可以在那里注销某个连接,密钥也在同一页面撤销。工具分组、访问级别和限额请参阅 MCP & ChatGPT,Grok 连接指南中提供了示例提示词。

故障排查

  • Grok 无法连接到 server。 xAI 要求 server 可通过公网访问,AutoPSEO 的 server 满足这一条件,因此请检查地址:务必完整输入 https://app.autopseo.com/mcp,包括 /mcp。
  • 没有显示任何资源。 调用 whoami 工具,查看该连接使用的是哪个 AutoPSEO 账户。如果账户正确,请先在该账户下连接 Search Console。
  • 工具调用被拒绝。 只读密钥无法写入数据或消耗额度,拥有 Read 权限的团队成员也只能读取。
  • HTTP 429。 限额为每个密钥每分钟 60 次调用,每个账户每小时 1,000 次。
  • 需要订阅。 账户的试用期已结束,请在订阅与账单中选择套餐。

Grok 带到你网站的访问会计入 GA4 的 LLM 流量报告。

让你的 SEO 内容自动运行

连接 Search Console 和你的网站,AutoPSEO 会立即扫描并规划首批主题。无需信用卡。