MCP-Server: Rankion mit Claude und KI-Agenten verbinden

Rankion betreibt einen eigenen MCP-Server (Model Context Protocol). Jeder Tool-Aufruf läuft durch den passenden Endpoint der REST-API v1. Team-Zugriff, Validierung und Credits gelten deshalb genauso wie bei einem direkten API-Aufruf.

Den Token erstellst du in Rankion unter Einstellungen, Abschnitt API-Tokens (https://rankion.ai/settings). Mehr dazu unter Authentifizierung.

Einrichtung in Claude Code

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

<TOKEN> ersetzt du durch deinen Token. Danach zeigt claude mcp list den Server als verbunden an. Bei einem falschen oder widerrufenen Token antwortet der Server mit 401, und die Verbindung kommt nicht zustande.

Einrichtung für Managed Agents

Managed Agents ist die Agenten-Schnittstelle der Claude Developer Platform. Die Einrichtung hat zwei Teile: Der Agent nennt den Server, der Token liegt getrennt davon in einem Vault.

1. Server am Agenten eintragen. Zu jedem Eintrag in mcp_servers gehört ein mcp_toolset:

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

2. Token als Vault-Credential vom Typ static_bearer hinterlegen:

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

3. Beim Start der Session den Vault angeben: "vault_ids": ["<VAULT_ID>"].

Die Zuordnung läuft über die URL: mcp_server_url muss auf denselben Server zeigen wie url. Die vollständigen Aufrufe stehen in der Anthropic-Dokumentation zu MCP in Managed Agents und zu Vaults.

claude.ai und Claude Desktop

Der Ein-Klick-Connector in claude.ai (Web) und Claude Desktop verlangt eine Anmeldung per OAuth. Das kann der Rankion-Server heute nicht: Er nimmt nur Bearer-Tokens an, und laravel/passport, das Paket für die OAuth-Anmeldung, ist nicht installiert. Dieser Teil ist als Phase 2 vorgesehen, einen Termin gibt es nicht.

Für diese beiden Oberflächen gibt es also noch keine fertige Anbindung.

Der Katalog aktualisiert sich selbst

Die Tool-Liste entsteht bei jeder Verbindung neu aus den aktuellen v1-Routen. Eine neue Route ist damit ohne weitere Einrichtung auch ein Tool.

Das Feld version in serverInfo hat die Form 1.<tool-count>.<hash>, zum Beispiel 1.747.dd625a1e. Es ändert sich, sobald sich die API ändert. Ein Client darf den Katalog nicht über einen Versionswechsel hinweg zwischenspeichern. Ändert sich version oder fehlt ein erwartetes Tool, liest er die Tools neu ein oder baut die Verbindung neu auf.

Die Tool-Menge ist groß

Stand 04.11.2026 sind es 747 Tools. Von 754 Endpoints haben 744 ein Tool, und bei drei Endpoints gibt es zwei Tools mit eigener Beschreibung. Die aktuelle Zahl steht immer in version.

Das hat zwei Folgen:

• Ein Client mit Tool-Limit sieht möglicherweise nicht alle Tools. Wo es geht, schaltest du nur die Tools frei, die du brauchst. Bei Managed Agents geht das im mcp_toolset: "default_config": { "enabled": false } und dazu in configs die gewünschten Tools mit "enabled": true.
• tools/list liefert 15 Tools je Seite. Ein selbst gebauter Client muss nextCursor folgen, sonst kennt er nur die ersten 15.

Die Referenz aller Endpoints steht unter https://rankion.ai/api-reference.

Diese 10 Routen haben kein Tool

Dateien und eingehende Webhooks passen nicht in einen Tool-Aufruf. Diese Routen sind deshalb bewusst ausgenommen (Stand 04.11.2026) und bleiben über die REST-API erreichbar. Andere Export-Routen haben ein eigenes Tool.

Skill, REST-API und OpenAPI

Der MCP-Server ergänzt die anderen Wege, ein Token gilt für alle:

• Skill für Claude Code: eine Markdown-Datei, die Claude Code direkt liest.
• REST-API: alle Endpoints unter https://rankion.ai/api/v1/..., beschrieben in der API-Referenz.
• OpenAPI-Schema: maschinenlesbar unter https://rankion.ai/api/v1/openapi.yaml, zum Beispiel für n8n, Zapier oder eigene Clients.

Skill einrichten:

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

REST-API testen:

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

Worauf du achten solltest

• Token nicht committen. Halte ihn in einer .env oder einem Secret-Manager.
• Credits im Blick behalten. Ein Tool-Aufruf kostet so viel wie der Endpoint dahinter.
• Lang laufende Aufträge abfragen. Manche Endpoints antworten mit HTTP 202 und einer Job-ID. Den Status fragst du danach über das passende Tool oder den GET-Endpoint ab.

Verwandte Wiki-Artikel

• API-Referenz
• Authentifizierung
• Master-Agent / Agentic Chat: mehrstufige Aufträge per POST /v1/agentic/chat