将 RankMeFast 连接到你的 AI 工具

如需简短说明，请查看连接 RankMeFast MCP 指南。

RankMeFast 提供远程 Model Context Protocol (MCP) 端点。兼容的编程智能体、IDE 或 CLI 可以通过它读取你的 SEO 数据并启动审计，无需离开当前工作流程。

五分钟完成设置

1. 打开设置 → API 密钥，选择创建密钥，并在密钥出现后立即复制。RankMeFast 只会完整显示一次密钥。

2. 使用 RankMeFast MCP 端点：

   https://rankme.fast/api/mcp
   

3. 如果客户端支持环境变量，请在启动客户端前设置密钥：

   export RANKMEFAST_API_KEY='rmf_REPLACE_WITH_YOUR_KEY'
   

   在 PowerShell 中：

   $env:RANKMEFAST_API_KEY = 'rmf_REPLACE_WITH_YOUR_KEY'
   

4. 在下方选择你的客户端，粘贴相应配置，然后重启或重新加载客户端。

5. 使用这条指令验证连接：“使用 RankMeFast 列出我的站点。”

请像保管密码一样保管密钥。每个 RankMeFast API 密钥都可以设置自己的限制范围。start_audit 工具会消耗你的每月审计额度。请优先使用环境变量、密码输入框或用户级配置，并且绝不要将密钥提交到代码仓库。

Starter、Pro 和 Agency 套餐均包含 MCP 访问权限。Agency 密钥还可用于只读公共 REST API。

控制权限与密钥范围

打开设置 → MCP，可管理 MCP 与登录状态下的 AI 助手共同使用的账户默认权限：

1. 开启或关闭每个 RankMeFast 工具。
2. 将允许的站点保留为全部站点，或选择工具可以使用的站点。
3. 如果绝不允许运行 start_audit，请关闭允许产生支出的操作。
4. 保存设置。同一标签页的快速开始卡片会显示端点、API 密钥入口和可复制的客户端配置。

在你主动修改之前，账户默认权限全部开放，因此现有密钥会继续工作。助手通过你的登录会话直接使用这些默认权限。

你可以在设置 → API 密钥中创建密钥时添加更严格的范围，也可以之后编辑。密钥范围只能收紧访问权限。MCP 的最终访问权限始终是两者的交集：

• 只有账户和密钥都允许时，工具才可用。
• 如果账户和密钥都选择了站点，则只有同时出现在两个列表中的站点可用。
• start_audit 要求两个层级都允许该工具和产生支出的操作。

范围不受限表示“采用账户默认权限”，绝不会绕过账户限制。被禁止的工具不会出现在发现列表中；被阻止或不属于该账户的站点都会返回相同的“未找到”结果。

语言和 JSON-RPC 契约

对于 tools/list 和没有工具覆盖值的请求，MCP 依次通过 x-lang、Accept-Language 和 en 选择人类可读文本。fr-CA 等区域请求头标签会安全归一化为 fr。Bearer 端点不会读取浏览器 Cookie、账户语言或工作区偏好。

每个工具都接受可选的 locale 参数。en、ar、fr、de、es、ru 或 zh 中的精确值会覆盖请求头，并用于该工具的执行、安全错误、成功文本、结构化结果中的 locale 和 HTTP Content-Language。不支持的参数仍会在 bearer 请求语言下返回无效参数错误（-32602），不会按区域标签归一化。响应会在不删除现有值的前提下向 Vary 添加 x-lang, Accept-Language。

只有工具说明、人类可读的结果摘要和安全错误消息会本地化。工具名称和架构、JSON-RPC 的 jsonrpc、数字 code 和 id、属性名、枚举和状态值、布尔值、计数、ID、域名、URL、关键词、时间戳、游标、证据以及已存储的用户或供应商文本均保持不变。结构化工具结果会添加 locale，但不会删除任何现有字段。

协议失败会保留数字条件：-32700 表示解析错误，-32600 表示无效请求，-32601 表示未知方法，-32602 表示无效参数或工具，-32603 表示内部错误。安全消息仅按数字代码本地化；绝不会返回原始 SDK、验证或供应商诊断。MCP 不输出 CSV。公共 API 指南说明了逐字节稳定的 CSV 契约。

选择你的客户端

其他客户端只要支持远程 Streamable HTTP 和自定义 Authorization 请求头，也可以连接。RankMeFast 不提供本地 stdio 服务器或旧版 SSE 服务器。

Claude Code

添加用户级服务器。单引号可以原样保留环境变量引用：

claude mcp add-json --scope user rankmefast \
  '{"type":"http","url":"https://rankme.fast/api/mcp","headers":{"Authorization":"Bearer ${RANKMEFAST_API_KEY}"}}'

使用以下命令检查连接：

claude mcp get rankmefast

你也可以在 Claude Code 中运行 /mcp。桌面应用中的 Claude Code 使用同一份配置。请参阅官方 Claude Code MCP 指南。

Claude.ai 和 Claude Desktop 的聊天连接器有所不同：它的远程连接流程使用 OAuth，不支持任意静态 Bearer 请求头。在 RankMeFast 提供 OAuth 之前，它无法直接连接；请改用 Claude Code。请参阅 Claude 自定义连接器。

Cursor IDE 和 Cursor Agent CLI

创建 ~/.cursor/mcp.json 进行用户级设置。替换两个占位符，并确保该文件不被公开：

{
  "mcpServers": {
    "rankmefast": {
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

Cursor IDE 和 Cursor Agent CLI 读取同一份配置。使用以下命令验证：

cursor-agent mcp list
cursor-agent mcp list-tools rankmefast

团队配置可使用 .cursor/mcp.json，但不要把明文密钥放入将要提交的文件。请参阅官方 Cursor MCP 指南。

VS Code 和 GitHub Copilot

从命令面板运行 MCP: Open User Configuration，然后使用密码输入项，以免将密钥写入文件：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "rankmefast-key",
      "description": "RankMeFast API key",
      "password": true
    }
  ],
  "servers": {
    "rankmefast": {
      "type": "http",
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:rankmefast-key}"
      }
    }
  }
}

运行 MCP: List Servers 以启动或检查服务器。工作区配置可以放在 .vscode/mcp.json；使用密码输入项的版本可以安全共享。请参阅官方 VS Code MCP 配置参考。

GitHub Copilot CLI

在 shell 中设置 RANKMEFAST_API_KEY 后运行：

copilot mcp add \
  rankmefast \
  --type http \
  --url https://rankme.fast/api/mcp \
  --header "Authorization=Bearer $RANKMEFAST_API_KEY" \
  --tools "*"

shell 会在 Copilot 保存用户配置前展开密钥，因此请保护好 ~/.copilot/mcp-config.json。请参阅向 Copilot CLI 添加 MCP 服务器。

Windsurf / Cascade

将以下内容添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "rankmefast": {
      "serverUrl": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:RANKMEFAST_API_KEY}"
      }
    }
  }
}

从 Windsurf Settings → Cascade → MCP Servers 重新加载配置。请参阅官方 Windsurf MCP 指南。

Codex CLI、IDE 扩展和 ChatGPT 桌面版

Codex CLI、Codex IDE 扩展和 ChatGPT 桌面版中的 Codex 在同一台设备上共享 ~/.codex/config.toml：

[mcp_servers.rankmefast]
url = "https://rankme.fast/api/mcp"
bearer_token_env_var = "RANKMEFAST_API_KEY"

设置环境变量后，重启 IDE 或桌面应用。在 CLI 中使用以下命令检查：

codex mcp list

你也可以在 Codex 会话中运行 /mcp。请参阅官方 Codex MCP 指南。

ChatGPT 网页版不会读取本地 Codex 配置，因此此设置仅适用于已配置设备上的 Codex 使用端。

Gemini CLI

在 shell 中设置 RANKMEFAST_API_KEY 后运行：

gemini mcp add \
  --scope user \
  --transport http \
  --header "Authorization: Bearer $RANKMEFAST_API_KEY" \
  rankmefast https://rankme.fast/api/mcp

使用 gemini mcp list 或 Gemini CLI 中的 /mcp 验证。该命令会将展开后的请求头存入 ~/.gemini/settings.json，因此请确保此文件不被公开。在 JSON 中请使用 httpUrl；Gemini 将 url 保留给旧版 SSE。请参阅官方 Gemini CLI MCP 指南。

OpenCode

将以下内容添加到全局文件 ~/.config/opencode/opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "rankmefast": {
      "type": "remote",
      "url": "https://rankme.fast/api/mcp",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:RANKMEFAST_API_KEY}"
      }
    }
  }
}

oauth: false 会阻止 OAuth 发现，因为 RankMeFast 使用 Bearer 密钥。使用以下命令检查设置：

opencode mcp list
opencode mcp debug rankmefast

请参阅官方 OpenCode MCP 指南。

JetBrains AI Assistant 和 Junie

打开 Settings → Tools → AI Assistant → Model Context Protocol (MCP)，添加一个 HTTP 服务器，然后粘贴：

{
  "mcpServers": {
    "rankmefast": {
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

请将配置保存在 IDE 级设置中，而不是项目文件中。需要让 Junie 或其他集成智能体使用这些工具时，请启用 Pass custom MCP servers。请参阅官方 JetBrains MCP 指南。

Zed

打开 Settings → AI → MCP Servers → Add Remote Server，或将以下内容添加到用户设置：

{
  "context_servers": {
    "rankmefast": {
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
      }
    }
  }
}

请将明文密钥保存在用户设置中，而不是项目设置中。服务器旁的绿色指示灯表示连接成功。请参阅官方 Zed MCP 指南。

Cline

打开 Cline 的 MCP 设置，添加一个 Streamable HTTP 服务器：

{
  "mcpServers": {
    "rankmefast": {
      "type": "streamableHttp",
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

保持 autoApprove 为空，以便启动审计时需要你的批准。请参阅官方 Cline MCP 指南。

Roo Code

使用全局 MCP 设置或 .roo/mcp.json：

{
  "mcpServers": {
    "rankmefast": {
      "type": "streamable-http",
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

保持 alwaysAllow 为空，使消耗额度的操作需要批准。请参阅官方 Roo Code MCP 指南。

Kiro IDE 和 CLI

使用 ~/.kiro/settings/mcp.json 进行全局配置，或使用 .kiro/settings/mcp.json 进行项目配置：

{
  "mcpServers": {
    "rankmefast": {
      "url": "https://rankme.fast/api/mcp",
      "headers": {
        "Authorization": "Bearer ${RANKMEFAST_API_KEY}"
      }
    }
  }
}

Kiro 会展开请求头中的环境变量。请参阅官方 Kiro MCP 配置。

其他 IDE 中的 Copilot

Visual Studio、JetBrains IDE、Xcode 和 Eclipse 中的 GitHub Copilot 使用与 VS Code 不同的格式：

{
  "servers": {
    "rankmefast": {
      "url": "https://rankme.fast/api/mcp",
      "requestInit": {
        "headers": {
          "Authorization": "Bearer rmf_REPLACE_WITH_YOUR_KEY"
        }
      }
    }
  }
}

请将其保存为用户级配置，且不要提交密钥。请按照 GitHub 的 Copilot IDE 扩展 MCP 设置指南，查找你的 IDE 所使用的配置文件位置。

可用的 RankMeFast 工具

所有读取和操作始终限定于密钥所属的账户。来自其他账户的站点、分析或任务 ID 会返回“未找到”。

客户端只会发现账户与密钥最终权限允许的工具。受限工具未出现是正常现象，并不表示连接失败。

读取已存储的数据

在前十个工具之后新增的工具只读取 RankMeFast 已经存储的数据。它们不会调用 Google 或任何其他供应商，不会刷新任何内容，不会启动任务，也绝不消耗你的套餐额度。积分包和每月上限都不受影响。

• 范围会写明。 Search Console 和 Google Analytics 的结果包含 range（7d、28d 或 90d）、起止日期、asOf 日期和来源，因此“最近 28 天的点击量”这类回答可以准确引用其覆盖范围。站点总数与搜索词、页面、国家和设备表格可能不同，结果会说明原因。
• 缺失的数据会明确说明。 如果未连接 Google、未关联资源或还没有快照，结果会带有 status: "unavailable" 或 "empty" 以及清晰的原因。它不会用零来代替缺失的数据。
• 套餐限制依然有效。 属于更高套餐的功能所对应的工具会返回 status: "locked"，并且不会读取任何内容。
• 权限在每次调用时生效。 每次调用都会检查 设置 → MCP 中的账户开关、密钥自身的范围以及允许的站点列表。你无法访问或属于其他账户的站点会按未找到返回。
• 新工具默认允许。 它们与其他只读工具使用相同的默认值，在它们出现之前保存的权限设置会继续照常工作。
• 结果有大小限制。 列表最多返回 100 行，结果也保持较小；行被截断时，结果会标明 truncated: true。

AI 助手使用相同的工具和相同的权限。在关联了站点的对话中，它会直接使用该站点，不需要先列出你的站点。

故障排除

• **客户端无法发现工具：**确认 URL 以 /api/mcp 结尾，选择 Streamable HTTP 而不是 SSE 或 stdio，然后重启客户端。
• 缺少预期工具：检查设置 → MCP中的账户开关，以及设置 → API 密钥中该密钥的范围。
• **站点显示未找到：**确认账户与密钥范围都允许该站点。被阻止的站点和不属于账户的站点会有意返回相同结果。
• **不允许产生支出的操作：**在两个层级都允许 start_audit 和产生支出的操作，或为只读客户端保持关闭。
• **401 Unauthorized：**使用完全一致的 Authorization: Bearer rmf_… 请求头。密钥可能输入有误、已被吊销，或属于非活跃账户。
• **402 Upgrade required：**MCP 要求 Starter、Pro 或 Agency 套餐。请参阅套餐、限额与额度。
• **浏览器中出现 405 Method not allowed：**这是正常现象，因为该端点接收 MCP POST 请求，而不是普通浏览器 GET 请求。
• **429 Too many requests：**等待响应头所示的限流窗口结束，然后重试。
• **503 Unavailable：**该 RankMeFast 安装的 MCP 已禁用或暂时不可用；请联系其运维人员。
• **本地可用，但通过代理后不可用：**确保代理将 Authorization、Content-Type 和 Accept 请求头转发到 /api/mcp。

如需更换密钥，请先创建新密钥，更新并验证每个客户端，然后从设置 → API 密钥吊销旧密钥。吊销会立即生效。

兼容性

此版本的注册表仅包含上文列出的二十五个工具。其中二十三个只读，set_action_state 会写入但不消耗额度，start_audit 是唯一会消耗套餐额度的工具。品牌雷达、评论智能、链接智能、流量洞察、关键词趋势和 SERP 传感器均没有 MCP 工具。现有工具的名称和参数结构均未更改。

<!-- mcp-tools: list_sites; get_latest_audit_report; list_keywords; get_rank_history; list_content_analyses; get_content_analysis; start_audit; get_audit_status; list_actions; set_action_state; get_gsc_search_summary; list_gsc_top_queries; list_gsc_top_pages; get_ga4_summary; list_pages; get_page_detail; get_backlinks_summary; list_backlinks; list_competitors; list_keyword_research_history; get_keyword_research_result; get_ai_visibility_summary; get_local_seo_summary; get_reviews_summary; list_client_reports -->

相关指南

• AI 助手, 在 RankMeFast 聊天中使用相同的已获准工具。
• 公共 API, 仅限 Agency 套餐的只读 API。
• Content Intelligence, 了解 MCP 返回的分析数据。
• 账户安全, 保护你的账户和密钥。