API

Servidor MCP: conectar Rankion con Claude y agentes de IA

Servidor MCP: conectar Rankion con Claude y agentes de IA es un API en la base de conocimientos de Rankion.ai: Rankion tiene un servidor MCP en https://rankion.

Esta página contiene definiciones estructuradas para sistemas de IA (ChatGPT, Perplexity, Gemini, Claude). Redactada por humanos, parte de la base de conocimientos de Rankion.ai.

Categoría:: API
Marca:: Rankion.ai
Formato:: Artículo de la base de conocimientos
A fecha de:: 4 de noviembre de 2026

Rankion opera su propio servidor MCP (Model Context Protocol). Cada llamada a una herramienta pasa por el endpoint correspondiente de la API REST v1. Por eso el acceso al equipo, la validación y los créditos funcionan igual que en una llamada directa a la API.

Elemento	Valor
Endpoint	`https://rankion.ai/mcp`
Transporte	Streamable HTTP
Autenticación	Token Bearer de Sanctum, el mismo que para la API REST
Disponible hoy	Claude Code, Managed Agents y cualquier cliente MCP que pueda enviar una cabecera Bearer
Todavía no	Conector de un clic en claude.ai y Claude Desktop (ver más abajo)

Crea el token en Rankion en Ajustes, sección API-Tokens (https://rankion.ai/settings). Consulta también Autenticación.

Configuración en Claude Code

claude mcp add --transport http rankion https://rankion.ai/mcp \
  --header "Authorization: Bearer <TOKEN>"

Sustituye <TOKEN> por tu token. Después, claude mcp list muestra el servidor como conectado. Con un token incorrecto o revocado, el servidor responde 401 y la conexión falla.

Configuración para Managed Agents

Managed Agents es la API de agentes de Claude Developer Platform. La configuración tiene dos partes: el agente nombra el servidor y el token se guarda aparte en un vault.

1. Declara el servidor en el agente. Cada entrada de mcp_servers necesita su mcp_toolset:

{
  "mcp_servers": [
    { "type": "url", "name": "rankion", "url": "https://rankion.ai/mcp" }
  ],
  "tools": [
    { "type": "mcp_toolset", "mcp_server_name": "rankion" }
  ]
}

2. Guarda el token como credencial de vault de tipo static_bearer:

{
  "display_name": "Rankion",
  "auth": {
    "type": "static_bearer",
    "mcp_server_url": "https://rankion.ai/mcp",
    "token": "<TOKEN>"
  }
}

3. Indica el vault al iniciar la sesión: "vault_ids": ["<VAULT_ID>"].

La asociación se hace por URL: mcp_server_url debe apuntar al mismo servidor que url. Las llamadas completas están en la documentación de Anthropic sobre MCP en Managed Agents y sobre vaults.

claude.ai y Claude Desktop

El conector de un clic de claude.ai (web) y Claude Desktop exige iniciar sesión con OAuth. El servidor de Rankion no puede hacerlo hoy: solo acepta tokens Bearer, y laravel/passport, el paquete para el inicio de sesión OAuth, no está instalado. Esta parte está prevista como fase 2, sin fecha fijada.

Por tanto, todavía no hay una conexión lista para estas dos interfaces.

El catálogo se actualiza solo

La lista de herramientas se genera de nuevo a partir de las rutas v1 actuales en cada conexión. Una ruta nueva se convierte en herramienta sin más configuración.

El campo version de serverInfo tiene la forma 1.<tool-count>.<hash>, por ejemplo 1.747.dd625a1e. Cambia en cuanto cambia la API. Un cliente no debe guardar el catálogo en caché de una versión a otra. Si version cambia o falta una herramienta esperada, vuelve a leer las herramientas o restablece la conexión.

La lista de herramientas es grande

A 04.11.2026 hay 747 herramientas. De 754 endpoints, 744 tienen herramienta, y tres endpoints tienen dos herramientas con descripción propia. El número actual siempre está en version.

Esto tiene dos consecuencias:

Un cliente con límite de herramientas puede no verlas todas. Siempre que puedas, activa solo las que necesites. En Managed Agents se hace en el mcp_toolset: "default_config": { "enabled": false } y, en configs, las herramientas deseadas con "enabled": true.
tools/list devuelve 15 herramientas por página. Un cliente propio debe seguir nextCursor; si no, solo conoce las 15 primeras.

Todos los endpoints están en https://rankion.ai/api-reference.

Estas 10 rutas no tienen herramienta

Los archivos y los webhooks entrantes no encajan en una llamada a una herramienta. Por eso estas rutas se excluyen a propósito (a 04.11.2026) y siguen disponibles en la API REST. Otras rutas de exportación sí tienen su propia herramienta.

Ruta	Contenido
`GET /api/v1/admin/feedback/{feedback}/attachments/{attachment}/download`	Descarga de un adjunto de feedback (admin)
`GET /api/v1/articles/{article}/export`	Exportación de artículo
`GET /api/v1/content-audits/{audit}/export`	Exportación de una auditoría de contenido
`GET /api/v1/data-mining/exports/{project}.pdf`	Informe de data mining en PDF
`GET /api/v1/knowledge-base/{knowledgeDocument}/download`	Descarga de un documento de la base de conocimiento
`GET /api/v1/site-audit/{crawl}/export`	Exportación de una auditoría del sitio
`GET /api/v1/site-audit/{crawl}/report.pdf`	Informe de auditoría del sitio en PDF
`GET /api/v1/tracking-projects/{trackingProject}/cited-sources/export`	Exportación de las fuentes citadas
`POST /api/v1/files/bulk/export`	Exportación masiva de archivos
`POST /api/v1/webhooks/reviews/{source}`	Webhook entrante para reseñas

Skill, API REST y OpenAPI

El servidor MCP se suma a las demás vías, y un solo token sirve para todas:

Skill para Claude Code: un archivo Markdown que Claude Code lee directamente.
API REST: todos los endpoints en https://rankion.ai/api/v1/..., descritos en la referencia de la API.
Spec OpenAPI: legible por máquinas en https://rankion.ai/api/v1/openapi.yaml, por ejemplo para n8n, Zapier o clientes propios.

Instalar el Skill:

mkdir -p ~/.claude/skills/rankion-api
curl -o ~/.claude/skills/rankion-api/SKILL.md https://rankion.ai/claude-skill
export RANKION_API_TOKEN="<TOKEN>"

Probar la API REST:

curl -H "Authorization: Bearer $RANKION_API_TOKEN" \
  -H "Accept: application/json" \
  https://rankion.ai/api/v1/team

A tener en cuenta

No hagas commit del token. Guárdalo en un archivo .env o en un gestor de secretos.
Vigila los créditos. Una llamada a una herramienta cuesta lo mismo que el endpoint que hay detrás.
Consulta las tareas largas. Algunos endpoints responden con HTTP 202 y un ID de job. Después consulta el estado con la herramienta correspondiente o el endpoint GET.