Conecta RankMeFast con tus herramientas de IA

Para ver el flujo breve, consulta la guía para conectar RankMeFast MCP.

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. Cada clave de API de RankMeFast puede tener sus propios ámbitos restrictivos. 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.

Controlar permisos y ámbitos de clave

Abre Ajustes → MCP para administrar los valores predeterminados de la cuenta que comparten MCP y el Asistente de IA con sesión iniciada:

1. Activa o desactiva cada herramienta de RankMeFast.
2. Deja Sitios permitidos en todos los sitios o selecciona los que pueden usar las herramientas.
3. Desactiva Permitir acciones con gasto si start_audit no debe ejecutarse nunca.
4. Guarda los ajustes. La tarjeta de inicio rápido de la misma pestaña muestra el endpoint, un acceso a las claves de API y una configuración de cliente que puedes copiar.

Los valores de la cuenta son totalmente permisivos hasta que los cambias, por lo que las claves existentes siguen funcionando. El Asistente los usa directamente mediante tu sesión iniciada.

Puedes añadir ámbitos más estrictos al crear una clave en Ajustes → Claves de API y editarlos más adelante. Los ámbitos solo pueden restringir el acceso. El acceso efectivo de MCP siempre es la intersección:

• Una herramienta solo está disponible si la cuenta y la clave la permiten.
• Si la cuenta y la clave seleccionan sitios, solo están disponibles los incluidos en ambas listas.
• start_audit exige que la herramienta y las acciones con gasto estén permitidas en ambos niveles.

Dejar un ámbito sin restricciones significa «aplicar el valor de la cuenta»; nunca evita una restricción de la cuenta. Una herramienta no permitida desaparece del descubrimiento, y un sitio bloqueado o ajeno devuelve el mismo resultado de no encontrado.

Idioma y contrato JSON-RPC

Para tools/list y las solicitudes sin anulación de herramienta, MCP elige el texto humano mediante x-lang, después Accept-Language y finalmente en. Las etiquetas regionales de cabecera, como fr-CA, se normalizan de forma segura a fr. El endpoint bearer nunca lee las cookies del navegador, el idioma de la cuenta ni las preferencias del espacio de trabajo.

Todas las herramientas aceptan un argumento locale opcional. Un valor exacto entre en, ar, fr, de, es, ru y zh anula las cabeceras para la ejecución, los errores seguros, el texto de éxito, el locale del resultado estructurado y el Content-Language HTTP de esa herramienta. Un valor no admitido sigue siendo un error de parámetros no válidos (-32602) en el idioma de la solicitud bearer; no se normaliza como una etiqueta regional. Las respuestas añaden x-lang, Accept-Language a Vary sin eliminar valores existentes.

Solo se localizan las descripciones de herramientas, los resúmenes para personas y los mensajes de error seguros. Permanecen iguales los nombres y esquemas de herramientas, jsonrpc, el code numérico y el id de JSON-RPC, los nombres de propiedades, valores de enumeración y estado, booleanos, recuentos, ID, dominios, URL, palabras clave, marcas de tiempo, cursores, pruebas y textos guardados del usuario o proveedor. Los resultados estructurados añaden locale sin retirar ningún campo.

Los fallos de protocolo conservan su condición numérica: -32700 error de análisis, -32600 solicitud no válida, -32601 método desconocido, -32602 parámetros o herramienta no válidos y -32603 error interno. El mensaje seguro se localiza a partir del código numérico; nunca se devuelven diagnósticos sin filtrar del SDK, la validación o el proveedor. MCP no genera CSV. La guía de la API pública explica su contrato CSV idéntico byte a byte.

Elige tu cliente

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

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.

Tu cliente solo descubre las herramientas permitidas por los permisos efectivos de la cuenta y la clave. Es normal que no aparezca una herramienta restringida; no significa que la conexión haya fallado.

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.
• Falta una herramienta esperada: revisa el interruptor de la cuenta en Ajustes → MCP y los ámbitos de esa clave en Ajustes → Claves de API.
• Un sitio aparece como no encontrado: confirma que la cuenta y los ámbitos de clave lo permiten. Los sitios bloqueados y ajenos usan la misma respuesta a propósito.
• No se permiten acciones con gasto: permite start_audit y las acciones con gasto en ambos niveles, o déjalas desactivadas para un cliente de solo lectura.
• 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 diez herramientas indicadas arriba. Ocho son de solo lectura, set_action_state escribe sin coste y 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; list_actions; set_action_state -->

Guías relacionadas

• Asistente de IA, usa las mismas herramientas autorizadas en el chat de RankMeFast.
• API pública, la API de solo lectura exclusiva del plan Agency.
• Content Intelligence, entiende los datos de análisis que devuelve MCP.
• Seguridad de la cuenta, protege tu cuenta y tus claves.