将 RankMeFast 连接到你的 AI 工具

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。

选择你的客户端

其他客户端只要支持远程 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 会返回“未找到”。

故障排除

• **客户端无法发现工具：**确认 URL 以 /api/mcp 结尾，选择 Streamable HTTP 而不是 SSE 或 stdio，然后重启客户端。
• **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 密钥吊销旧密钥。吊销会立即生效。

兼容性

此版本的注册表仅包含上文列出的八个工具。其中七个只读；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 -->

相关指南

• 公共 API — 仅限 Agency 套餐的只读 API。
• Content Intelligence — 了解 MCP 返回的分析数据。
• 账户安全 — 保护你的账户和密钥。