RankMeFast MCP

Разработчикам

RankMeFast MCP

Подключите RankMeFast к агентам для программирования, IDE и CLI с поддержкой MCP.

Подключите RankMeFast к своим ИИ-инструментам

RankMeFast предоставляет удалённую конечную точку Model Context Protocol (MCP). Она позволяет совместимому агенту для программирования, IDE или CLI читать ваши SEO-данные и запускать аудиты, не покидая текущий рабочий процесс.

Настройка за пять минут

  1. Откройте Настройки → API-ключи, нажмите Создать ключ и скопируйте появившийся ключ. RankMeFast показывает ключ целиком только один раз.

  2. Используйте конечную точку MCP RankMeFast:

    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, чтобы показать список моих сайтов».

Обращайтесь с ключом как с паролем. API-ключи RankMeFast действуют для всего аккаунта и не имеют отдельных областей доступа. Инструмент start_audit может расходовать месячный лимит аудитов. По возможности используйте переменную окружения, запрос пароля или пользовательскую конфигурацию и никогда не сохраняйте ключ в репозитории.

Доступ к MCP включён в тарифы Starter, Pro и Agency. Ключи Agency также работают с публичным REST API только для чтения.

Выберите клиент

Клиент или интерфейсПрямое подключениеКонфигурация
Claude Code и вкладка Code в приложении для компьютераДаHTTP-сервер с Bearer-заголовком
Cursor IDE и Cursor Agent CLIДаПользовательская или проектная конфигурация MCP JSON
VS Code с GitHub CopilotДаПользовательский или рабочий mcp.json
GitHub Copilot CLIДаКоманда CLI или пользовательский JSON
Windsurf / CascadeДаПользовательская конфигурация MCP JSON
Codex CLI, расширение для IDE и Codex в приложении ChatGPT для компьютераДаОбщая конфигурация Codex TOML
Gemini CLIДаКоманда CLI или пользовательский JSON
OpenCodeДаКонфигурация удалённого MCP в JSON
JetBrains AI Assistant и JunieДаНастройки MCP в IDE
ZedДаУдалённый контекстный сервер
ClineДаСервер Streamable HTTP
Roo CodeДаСервер Streamable HTTP
Kiro IDE и CLIДаПользовательская или проектная конфигурация MCP JSON
Copilot в Visual Studio, JetBrains, Xcode и EclipseДаКонфигурация Copilot MCP в JSON
Чат-коннектор Claude.ai / Claude DesktopНе напрямуюКоннектор требует OAuth, а RankMeFast сейчас использует Bearer-ключи
ChatGPT в браузереНе напрямуюОн не читает локальную конфигурацию Codex MCP

Любой другой клиент сможет подключиться, если он поддерживает удалённый 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; вариант с запросом пароля безопасно передавать другим. См. официальную справку по конфигурации MCP в VS Code.

GitHub Copilot CLI

Задайте RANKMEFAST_API_KEY в командной оболочке и выполните:

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

Оболочка подставит ключ до того, как Copilot сохранит пользовательскую конфигурацию, поэтому защитите ~/.copilot/mcp-config.json. См. руководство по добавлению MCP-серверов в Copilot CLI.

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 и интерфейс Codex в приложении ChatGPT для компьютера используют общий файл ~/.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

Задайте 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 или /mcp внутри Gemini CLI. Команда сохраняет подставленный заголовок в ~/.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, а не в файле проекта. Включите Pass custom MCP servers, когда нужно передать инструменты Junie или другому встроенному агенту. См. официальное руководство 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

Откройте настройки MCP в Cline и добавьте сервер 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 подставляет переменные окружения в заголовках. См. официальную документацию по конфигурации MCP в Kiro.

Copilot в других IDE

GitHub Copilot в Visual Studio, IDE JetBrains, Xcode и Eclipse использует формат, отличный от VS Code:

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

Храните эту конфигурацию на уровне пользователя и не добавляйте ключ в репозиторий. Расположение файла конфигурации для своей IDE найдите в руководстве GitHub по настройке MCP для расширений Copilot в IDE.

Доступные инструменты RankMeFast

ИнструментНазначениеРасходует лимит тарифа?
list_sitesПоказывает сайты, принадлежащие вашему аккаунтуНет
get_latest_audit_reportВозвращает последний завершённый аудит сайтаНет
list_keywordsПоказывает отслеживаемые ключевые слова сайтаНет
get_rank_historyВозвращает историю позиций ключевого словаНет
list_content_analysesПоказывает анализы Content IntelligenceНет
get_content_analysisВозвращает один анализ Content IntelligenceНет
start_auditЗапускает аудит сайта в пределах лимита страниц тарифаДа — один аудит
get_audit_statusПроверяет выполнение аудитаНет

Чтение и действия всегда ограничены аккаунтом, которому принадлежит ключ. Идентификатор сайта, анализа или запуска из другого аккаунта возвращается как не найденный.

Устранение неполадок

  • Клиент не обнаруживает инструменты: убедитесь, что 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: MCP отключён или временно недоступен в этой установке RankMeFast; обратитесь к её оператору.
  • Локально работает, а через прокси — нет: убедитесь, что прокси передаёт заголовки 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 -->

Связанные руководства