Claude Code, Cursor und Co. mit XRIO verbinden

KI-Werkzeuge für Entwickler verbinden sich mit XRIO über einen API-Schlüssel, Claude Code auch über die Anmeldung im Browser. Hier stehen die Einträge für jeden Client.

Aktualisiert am 13. Oktober 2026 · Allgemeine Information, keine Steuerberatung

Vorbereitung: API-Schlüssel

Legen Sie im XRIO-Portal unter API-Schlüssel einen Schlüssel an und speichern Sie ihn als Umgebungsvariable XRIO_API_KEY. Die Einträge unten lesen ihn von dort; der Schlüssel steht nie in einer Datei, die Sie teilen.

Claude Code

Mit Anmeldung im Browser, ohne Schlüssel:

claude mcp add --transport http xrio --scope user https://api.xrio.de/mcp

Mit API-Schlüssel:

claude mcp add-json xrio '{"type":"http","url":"https://api.xrio.de/mcp","headers":{"Authorization":"Bearer ${XRIO_API_KEY}"}}' --scope user

Cursor

In ~/.cursor/mcp.json oder in der Projektdatei .cursor/mcp.json:

{
  "mcpServers": {
    "xrio": {
      "url": "https://api.xrio.de/mcp",
      "headers": { "Authorization": "Bearer ${env:XRIO_API_KEY}" }
    }
  }
}

VS Code

In .vscode/mcp.json; VS Code fragt den Schlüssel beim ersten Start ab und speichert ihn selbst:

{
  "inputs": [
    { "type": "promptString", "id": "xrio-api-key", "description": "xrio API-Schlüssel", "password": true }
  ],
  "servers": {
    "xrio": {
      "type": "http",
      "url": "https://api.xrio.de/mcp",
      "headers": { "Authorization": "Bearer ${input:xrio-api-key}" }
    }
  }
}

Gemini CLI

In ~/.gemini/settings.json; Gemini CLI liest Header wörtlich, tragen Sie den Schlüssel also direkt ein:

{
  "mcpServers": {
    "xrio": {
      "httpUrl": "https://api.xrio.de/mcp",
      "headers": { "Authorization": "Bearer xrio_live_…" }
    }
  }
}

Codex CLI

In ~/.codex/config.toml:

[mcp_servers.xrio]
url = "https://api.xrio.de/mcp"
bearer_token_env_var = "XRIO_API_KEY"

Der xrio-Skill

Der Skill bringt Ihrer KI die Abläufe bei: prüfen, erstellen, Fehler lesen. Er liegt unter https://api.xrio.de/v1/skills/xrio/SKILL.md; das XRIO-Portal zeigt unter MCP für jeden Client, wohin er gehört.

Die erste Rechnung

Erstelle mit xrio eine XRechnung an Büro Klein über 3 Stunden Wartung zu 80 € netto.

Die KI fragt nach, was fehlt, ruft XRIO auf und nennt den Download-Link. Zum Prüfen einer Datei holt sie sich einen Upload-Link und sendet die Datei mit curl selbst; die Datei läuft nie durch den Chat.

Häufige Fragen

Wo bekomme ich den API-Schlüssel?

Im XRIO-Portal unter „API-Schlüssel“. Er wird genau einmal angezeigt. Legen Sie ihn als Umgebungsvariable XRIO_API_KEY ab; die Einträge unten lesen ihn von dort.

Kann Claude Code auch ohne Schlüssel?

Ja. Mit dem Befehl ohne Header meldet sich Claude Code im Browser bei XRIO an, wie Claude im Chat.

Können diese Clients Dateien prüfen?

Ja. Sie haben eine Shell und senden eine Datei mit curl an den einmal gültigen Upload-Link, den XRIO ausgibt. Ergebnisse kommen als Download-Link.