Skill para Claude Code (en lugar de un servidor MCP)

Importante — aclaración 2026-05-16: Rankion no opera un servidor MCP. Versiones anteriores de este wiki anunciaban un endpoint MCP previsto en /mcp — ese plan fue descartado. En su lugar entregamos un Skill (un único archivo Markdown para Claude Code), nuestra API REST con más de 130 endpoints y una spec OpenAPI para cualquier otro agente.

Lo que obtienes en su lugar

1. Skill para Claude Code — un archivo Markdown en https://rankion.ai/claude-skill que Claude Code lee directamente. Sin paquete npm, sin servidor MCP, sin infraestructura adicional.
2. API REST — más de 130 endpoints en https://rankion.ai/api/v1/..., documentados en la referencia API. Auth via tokens Sanctum.
3. Spec OpenAPI — legible por máquina en https://rankion.ai/api/openapi.json. Úsala para auto-generar clientes tipados para cualquier framework de agente (n8n, Zapier, conector de ChatGPT, herramientas custom).

Un único token Sanctum sirve para los tres caminos.

Setup para Claude Code en 2 minutos

# 1. Crear el directorio del skill
mkdir -p ~/.claude/skills/rankion-api

# 2. Descargar el Markdown del skill
curl -o ~/.claude/skills/rankion-api/SKILL.md https://rankion.ai/claude-skill

# 3. Establecer tu token Sanctum (copiado de Configuración → API)
export RANKION_API_TOKEN="rk_live_..."

# 4. Lanzar Claude Code — el skill está disponible inmediatamente
claude "Investiga palabras clave para 'AI Content Marketing' y redacta un artículo"

Crea el token en la UI bajo Configuración → API.

Para otros agentes (conector de ChatGPT, Cursor, n8n, Zapier, custom)

Todos los agentes no-Claude llaman a la API REST directamente. Ejemplo:

curl -X POST https://rankion.ai/api/v1/generate/article \
  -H "Authorization: Bearer $RANKION_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"project_id": 1, "keyword": "AI Content Marketing", "article_type": "blog-post"}'

Para frameworks que entienden OpenAPI: carga https://rankion.ai/api/openapi.json y auto-genera clientes tipados.

Si tu agente realmente requiere MCP

A 2026-05-16 no hemos encontrado tal caso. Los clientes MCP actuales (Claude Desktop, Cursor, Windsurf) pueden en casi todas las configuraciones llamar a APIs REST directamente — o, en el caso de Claude Code, cargar un skill. Si tu caso concreto requiere estrictamente un servidor MCP, escribe a info@provimedia.de — evaluamos caso por caso; no hay compromiso de roadmap.

Buenas prácticas

• Nunca comprometas el token Sanctum en código. Mantenlo en .env o inyéctalo via un gestor de secretos.
• Un token, un equipo. Los tokens Sanctum están scopeados por equipo — solo ven el equipo que los posee.
• Respeta los rate limits. El Skill y la doc OpenAPI listan rate limits por endpoint (típicamente 60/min).
• Sondea endpoints async correctamente. Las operaciones largas (generación de artículo 30-90 s, audits) devuelven HTTP 202 con un job ID — sondea el endpoint GET de estado hasta status: "completed".

Artículos wiki relacionados

• Índice de API REST
• Autenticación via tokens Sanctum
• Master Agent / Agentic Chat — razonamiento multi-paso via POST /v1/agentic/chat