RankMeFast MCP

Desarrolladores

RankMeFast MCP

Conecta RankMeFast con agentes de programación, IDE y CLI compatibles con MCP.

Conecta RankMeFast con tus herramientas de IA

RankMeFast ofrece un endpoint remoto de Model Context Protocol (MCP). Permite que un agente de programación, IDE o CLI compatible consulte tus datos SEO e inicie auditorías sin salir de tu flujo de trabajo.

Configúralo en cinco minutos

  1. Abre Ajustes → Claves de API, selecciona Crear clave y copia la clave cuando aparezca. RankMeFast solo muestra la clave completa una vez.

  2. Usa el endpoint MCP de RankMeFast:

    https://rankme.fast/api/mcp
    
  3. En los clientes que admitan variables de entorno, define la clave antes de iniciar el cliente:

    export RANKMEFAST_API_KEY='rmf_REPLACE_WITH_YOUR_KEY'
    

    En PowerShell:

    $env:RANKMEFAST_API_KEY = 'rmf_REPLACE_WITH_YOUR_KEY'
    
  4. Elige tu cliente a continuación, pega su configuración y reinícialo o vuelve a cargarlo.

  5. Comprueba la conexión con: «Usa RankMeFast para listar mis sitios».

Trata la clave como una contraseña. Las claves de API de RankMeFast abarcan toda la cuenta y no tienen ámbitos independientes. La herramienta start_audit puede consumir tu cuota mensual de auditorías. Da preferencia a una variable de entorno, una solicitud de contraseña o una configuración de usuario, y nunca incluyas una clave en los commits de tu repositorio.

El acceso MCP está incluido en Starter, Pro y Agency. Las claves de Agency también funcionan con la API REST pública de solo lectura.

Elige tu cliente

Cliente o entornoConfiguración directaConfiguración
Claude Code y su pestaña Code de escritorioServidor HTTP con cabecera bearer
Cursor IDE y Cursor Agent CLIJSON de MCP de usuario o proyecto
VS Code con GitHub Copilotmcp.json de usuario o espacio de trabajo
GitHub Copilot CLIComando de CLI o JSON de usuario
Windsurf / CascadeJSON de MCP de usuario
Codex CLI, extensión para IDE y Codex en ChatGPT de escritorioTOML compartido de Codex
Gemini CLIComando de CLI o JSON de usuario
OpenCodeJSON de MCP remoto
JetBrains AI Assistant y JunieAjustes de MCP del IDE
ZedServidor de contexto remoto
ClineServidor Streamable HTTP
Roo CodeServidor Streamable HTTP
Kiro IDE y CLIJSON de MCP de usuario o proyecto
Copilot en Visual Studio, JetBrains, Xcode y EclipseJSON de MCP de Copilot
Claude.ai / conector de chat de Claude DesktopNo directamenteEl conector necesita OAuth; RankMeFast usa actualmente claves bearer
ChatGPT webNo directamenteNo lee la configuración MCP local de Codex

Cualquier otro cliente puede conectarse si admite Streamable HTTP remoto y una cabecera Authorization personalizada. RankMeFast no ofrece un servidor stdio local ni un servidor SSE obsoleto.

Claude Code

Añade un servidor de usuario. Las comillas simples mantienen intacta la referencia a la variable de entorno:

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

Comprueba la conexión con:

claude mcp get rankmefast

También puedes ejecutar /mcp dentro de Claude Code. El entorno de Claude Code en la aplicación de escritorio usa la misma configuración. Consulta la guía oficial de MCP para Claude Code.

El conector de chat de Claude.ai y Claude Desktop es diferente: su flujo de conectores remotos documenta OAuth, no una cabecera bearer estática arbitraria. No puede conectarse directamente hasta que RankMeFast ofrezca OAuth; usa Claude Code mientras tanto. Consulta los conectores personalizados de Claude.

Cursor IDE y Cursor Agent CLI

Crea ~/.cursor/mcp.json para una configuración de usuario. Sustituye ambos marcadores y mantén el archivo privado:

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

Cursor IDE y Cursor Agent CLI leen la misma configuración. Compruébala con:

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

Para una configuración de equipo, usa .cursor/mcp.json, pero no incluyas una clave literal en ese archivo versionado. Consulta la guía oficial de MCP para Cursor.

VS Code y GitHub Copilot

Ejecuta MCP: Open User Configuration desde la paleta de comandos y usa una entrada de contraseña para que el secreto no se escriba en el archivo:

{
  "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}"
      }
    }
  }
}

Ejecuta MCP: List Servers para iniciar o inspeccionar el servidor. La configuración del espacio de trabajo puede guardarse en .vscode/mcp.json; la variante con entrada de contraseña se puede compartir de forma segura. Consulta la referencia oficial de configuración MCP de VS Code.

GitHub Copilot CLI

Con RANKMEFAST_API_KEY definida en tu shell:

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

La shell expande la clave antes de que Copilot guarde la configuración de usuario, así que protege ~/.copilot/mcp-config.json. Consulta Añadir servidores MCP a Copilot CLI.

Windsurf / Cascade

Añade lo siguiente a ~/.codeium/windsurf/mcp_config.json:

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

Vuelve a cargarlo desde Windsurf Settings → Cascade → MCP Servers. Consulta la guía oficial de MCP para Windsurf.

Codex CLI, extensión para IDE y ChatGPT de escritorio

Codex CLI, la extensión de Codex para IDE y el entorno de Codex en ChatGPT de escritorio comparten ~/.codex/config.toml en el mismo equipo:

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

Reinicia el IDE o la aplicación de escritorio después de definir la variable de entorno. En la CLI, compruébalo con:

codex mcp list

También puedes ejecutar /mcp en una sesión de Codex. Consulta la guía oficial de MCP para Codex.

ChatGPT web no lee la configuración local de Codex, por lo que esta configuración solo se aplica a los entornos de Codex del equipo configurado.

Gemini CLI

Con RANKMEFAST_API_KEY definida en tu shell:

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

Compruébalo con gemini mcp list o /mcp dentro de Gemini CLI. El comando guarda la cabecera expandida en ~/.gemini/settings.json, así que mantén ese archivo privado. En JSON, usa httpUrl; Gemini reserva url para SSE obsoleto. Consulta la guía oficial de MCP para Gemini CLI.

OpenCode

Añade lo siguiente al archivo global ~/.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 evita la detección de OAuth porque RankMeFast usa una clave bearer. Comprueba la configuración con:

opencode mcp list
opencode mcp debug rankmefast

Consulta la guía oficial de MCP para OpenCode.

JetBrains AI Assistant y Junie

Abre Settings → Tools → AI Assistant → Model Context Protocol (MCP), añade un servidor HTTP y pega:

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

Guárdalo en los ajustes del IDE, no en un archivo de proyecto. Activa Pass custom MCP servers cuando quieras que Junie u otro agente integrado reciba las herramientas. Consulta la guía oficial de MCP para JetBrains.

Zed

Abre Settings → AI → MCP Servers → Add Remote Server o añade lo siguiente a tus ajustes de usuario:

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

Guarda la clave literal en los ajustes de usuario, no en los del proyecto. Un indicador verde junto al servidor confirma la conexión. Consulta la guía oficial de MCP para Zed.

Cline

Abre los ajustes de MCP de Cline y añade un servidor Streamable HTTP:

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

Deja autoApprove vacío para que iniciar una auditoría requiera tu aprobación. Consulta la guía oficial de MCP para Cline.

Roo Code

Usa los ajustes globales de MCP o .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": []
    }
  }
}

Deja alwaysAllow vacío para que las acciones con consumo requieran aprobación. Consulta la guía oficial de MCP para Roo Code.

Kiro IDE y CLI

Usa ~/.kiro/settings/mcp.json de forma global o .kiro/settings/mcp.json para un proyecto:

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

Kiro expande las variables de entorno en las cabeceras. Consulta la configuración oficial de MCP para Kiro.

Copilot en otros IDE

GitHub Copilot usa un formato diferente al de VS Code en Visual Studio, los IDE de JetBrains, Xcode y Eclipse:

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

Guarda esto como configuración de usuario y no confirmes la clave en el repositorio. Consulta la guía de configuración de MCP para las extensiones de Copilot en IDE de GitHub para encontrar el archivo de configuración de tu IDE.

Herramientas de RankMeFast disponibles

HerramientaQué hace¿Consume cuota del plan?
list_sitesLista los sitios que pertenecen a tu cuentaNo
get_latest_audit_reportDevuelve la última auditoría completada de un sitioNo
list_keywordsLista las palabras clave seguidas de un sitioNo
get_rank_historyDevuelve el historial de posiciones de una palabra clave de un sitioNo
list_content_analysesLista los análisis de Content IntelligenceNo
get_content_analysisDevuelve un análisis de Content IntelligenceNo
start_auditInicia una auditoría del sitio dentro del límite de páginas de tu planSí: una auditoría
get_audit_statusComprueba una ejecución de auditoríaNo

Las lecturas y acciones siempre se limitan a la cuenta propietaria de la clave. Un ID de sitio, análisis o ejecución de otra cuenta se devuelve como no encontrado.

Solución de problemas

  • El cliente no encuentra las herramientas: confirma que la URL termina en /api/mcp, elige Streamable HTTP en lugar de SSE o stdio y reinicia el cliente.
  • 401 Unauthorized: usa exactamente la cabecera Authorization: Bearer rmf_…. La clave puede estar mal escrita, revocada o vinculada a una cuenta inactiva.
  • 402 Upgrade required: MCP necesita Starter, Pro o Agency. Consulta Planes, límites y créditos.
  • 405 Method not allowed en el navegador: es lo esperado, porque el endpoint acepta solicitudes POST de MCP, no solicitudes GET normales del navegador.
  • 429 Too many requests: espera a que termine el intervalo del límite de frecuencia indicado en las cabeceras de respuesta y vuelve a intentarlo.
  • 503 Unavailable: MCP está desactivado o temporalmente no disponible en esa instalación de RankMeFast; consulta a su operador.
  • Funciona en local, pero no a través de un proxy: asegúrate de que el proxy reenvía las cabeceras Authorization, Content-Type y Accept a /api/mcp.

Para sustituir una clave, crea una nueva, actualiza y comprueba todos los clientes y, después, revoca la antigua desde Ajustes → Claves de API. La revocación es inmediata.

Compatibilidad

El registro de esta versión contiene exactamente las ocho herramientas indicadas arriba. Siete son de solo lectura; start_audit es la única que consume cuota del plan. Radar de marca, Inteligencia de reseñas, Inteligencia de enlaces, Información de tráfico, Tendencias de palabras clave y el Sensor SERP no tienen herramientas MCP. No ha cambiado ningún nombre de herramienta ni la forma de sus argumentos.

<!-- mcp-tools: list_sites; get_latest_audit_report; list_keywords; get_rank_history; list_content_analyses; get_content_analysis; start_audit; get_audit_status -->

Guías relacionadas