Skill für Claude Code (statt MCP-Server)

Wichtig — Klarstellung 2026-05-16: Rankion betreibt keinen eigenen MCP-Server. Frühere Wiki-Versionen haben einen geplanten MCP-Endpoint unter /mcp angekündigt — dieser Plan ist verworfen. Stattdessen bieten wir einen Skill (eine einzelne Markdown-Datei für Claude Code) sowie unsere REST-API mit 130+ Endpoints und ein OpenAPI-Schema für jeden anderen Agent.

rankion.aiWas du stattdessen bekommst

1. Skill für Claude Code — eine Markdown-Datei unter https://rankion.ai/claude-skill, die Claude Code direkt liest. Kein npm-Paket, kein MCP-Server, keine zusätzliche Infrastruktur.
2. REST-API — 130+ Endpoints unter https://rankion.ai/api/v1/..., dokumentiert in der API-Referenz. Auth via Sanctum-Bearer-Token.
3. OpenAPI-Schema — maschinenlesbar unter https://rankion.ai/api/openapi.json. Damit kannst du in jedem Agent-Framework (n8n, Zapier, ChatGPT-Konnektor, eigene Tools) automatisch typsichere Clients generieren.

Ein einziger Sanctum-Token funktioniert für alle drei Wege.

rankion.aiSetup für Claude Code in 2 Minuten

# 1. Skill-Verzeichnis anlegen
mkdir -p ~/.claude/skills/rankion-api

# 2. Skill-Markdown von rankion.ai laden
curl -o ~/.claude/skills/rankion-api/SKILL.md https://rankion.ai/claude-skill

# 3. Sanctum-Token setzen (aus Settings → API kopiert)
export RANKION_API_TOKEN="rk_live_..."

# 4. Claude Code starten — der Skill ist sofort verfügbar
claude "Research keywords for 'AI Content Marketing' and draft an article"

Token erstellst du im UI unter Settings → API.

rankion.aiFür andere Agents (ChatGPT-Konnektor, Cursor, n8n, Zapier, custom)

Alle nicht-Claude-Agents nutzen die REST-API direkt. Beispiel-Call:

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

Für Frameworks, die OpenAPI verstehen: lade https://rankion.ai/api/openapi.json und generiere typsichere Clients automatisch.

rankion.aiWenn dein Agent zwingend MCP verlangt

Stand 2026-05-16 ist das nicht der Fall. Aktuelle MCP-Clients (Claude Desktop, Cursor, Windsurf) können in den allermeisten Setups REST-APIs direkt aufrufen — oder, im Fall von Claude Code, einen Skill laden. Sollte dein konkreter Use-Case zwingend einen MCP-Server brauchen: melde dich bei info@provimedia.de — wir prüfen das pro Fall, eine Roadmap-Entscheidung gibt es nicht.

rankion.aiBest Practices

• Sanctum-Token niemals im Code committen. In .env halten oder per Secret-Manager injecten.
• Ein Token, ein Team. Sanctum-Token sind team-scoped — sie sehen nur das Team, dem sie gehören.
• Rate-Limits beachten. Der Skill und die OpenAPI-Doku listen pro Endpoint die Rate-Limits (typisch 60/min).
• Async-Endpoints korrekt pollen. Lang laufende Operationen (Artikel-Generierung 30-90 s, Audits) liefern HTTP 202 mit Job-ID — den GET-Status-Endpoint pollen, bis status: "completed".

rankion.aiVerwandte Wiki-Artikel

• REST-API Index
• Authentifizierung via Sanctum-Token
• Master-Agent / Agentic Chat — Multi-Step-Reasoning per POST /v1/agentic/chat