Kilo aus deinem KI-Assistenten (MCP)

MCP ist für KI-Assistenten, was eine REST-API für Programme ist: ein standardisierter Zugang. Kilos MCP-Server lebt am selben Origin wie die API - ein einziger gehosteter Server, betrieben von Kilo, nichts zu installieren - und stellt einen kleinen Satz Werkzeuge bereit, die ein Assistent in deinem Namen aufrufen kann, sobald du ihm einen API-Schlüssel gibst.

Der praktische Effekt: „Mach einen QR-Code für die Speisekarte und sag mir nächste Woche, wie er lief“ wird zu einem vollständigen Ablauf, den du aus einem Chat-Fenster heraus führst. Der Assistent erstellt den Link, speichert das QR-Design und liest dir die Zahlen vor; die fertige Grafik liegt einen Klick entfernt im Dashboard.

• Erstellen - Kurzlinks und die QR-Codes darauf („kürze das“, „mach einen QR für den Frühjahrsflyer“).
• Gestalten - speichere das QR-Design eines Links: Farben, Modulformen, Verläufe, ein Logo; animierte Designs in Tarifen mit animiertem Export.
• Messen - Summen, Zeitreihen, Länder, Geräte, Referrer und Klickqualität (wahrscheinlich menschlich vs. Rechenzentrum vs. VPN).
• Stöbern - liste Links und Kampagnen auf, prüfe einen Link, prüfe Konto und Tarif mit whoami.

Der Server spricht JSON-RPC 2.0 über Streamable HTTP an einem einzigen Endpoint am Kilo-QR-Origin, unter /api/mcp. Die meisten Clients nehmen einen kleinen JSON-Block - das ist die Form (der Schlüssel kommt im nächsten Abschnitt):

{
  "mcpServers": {
    "kilo-routes": {
      "type": "http",
      "url": "https://qr2r.com/api/mcp",
      "headers": { "Authorization": "Bearer $KILO_API_KEY" }
    }
  }
}

In Claude Desktop und Cursor gehört dieser Block in die MCP-Einstellungsdatei; andere Clients benennen die Felder etwas anders, aber es läuft immer auf die URL plus den Authorization-Header hinaus. Claude Code verdrahtet es in einer Zeile:

claude mcp add --transport http kilo-routes https://qr2r.com/api/mcp \
  --header "Authorization: Bearer $KILO_API_KEY"

Die Authentifizierung ist derselbe Bearer-API-Schlüssel wie bei der REST-API: Präge einen im Dashboard unter API-Schlüssel. Gib dem Assistenten einen Lese-Schlüssel, wenn er nur Zahlen berichtet, oder einen Lese-und-Schreib-Schlüssel, wenn er Links und Designs erstellen soll. Die Schlüsselverwaltung selbst bleibt rein interaktiv - kein Schlüssel und kein MCP-Werkzeug kann andere Schlüssel prägen oder widerrufen.

MCP-Zugang ist ab dem Pro-Tarif enthalten. Fragst du darunter an, antwortet der Server mit einem strukturierten Fehler, der die exakten Upgrade- und Preis-URLs trägt - sodass ein Assistent, der den Fehler weiterreicht, dir einen funktionierenden nächsten Schritt gibt statt einer Sackgasse:

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32003,
    "message": "MCP access is included from the Pro plan up (current plan: Free). …",
    "data": {
      "feature": "mcp_access",
      "upgrade_url": "…/billing",
      "pricing_url": "…/#pricing"
    }
  }
}

Die Werkzeuge sind bewusst um die Sätze herum formuliert, die Menschen wirklich sagen. Ein paar, die unverändert funktionieren:

• „Kürze https://example.com/spring-catalog und nenne ihn Frühjahrskatalog.“
• „Mach einen QR-Code für unsere Café-Speisekarte und gestalte ihn dunkelgrün mit abgerundeten Punkten.“
• „Wie viele Scans hatte der Flyer in den letzten 30 Tagen, und aus welchen Ländern?“
• „Welcher unserer aktiven Links bekam diese Woche die meisten wahrscheinlich menschlichen Klicks?“

Darunter übersetzt sich das in eine Handvoll Werkzeuge - create_link, save_link_qr_design, get_link_analytics, list_links - plus ein whoami, das der Assistent aufruft, wenn er deinen Tarif prüfen oder einen Berechtigungsfehler diagnostizieren muss. Der Server veröffentlicht außerdem eine Erste-Schritte-Ressource, die dir jeder Client vorlesen kann.

Der Werkzeugsatz ist absichtlich nur Lesen + Erstellen. Ein Assistent mit deinem Schlüssel kann Dinge hinzufügen und Dinge lesen; er kann nichts zerstören oder umleiten, was bereits existiert.

• Kein Löschen, kein Deaktivieren, kein Pausieren - kein Werkzeug entfernt einen Link.
• Keine Zieländerungen - ein gedruckter QR kann nicht still aus einem Chat heraus umgelenkt werden.
• Jede Erstellung durchläuft dieselbe Validierung, dieselben Tarifgrenzen und dieselbe Ziel-Sicherheitsprüfung wie das Dashboard - MCP ist keine Seitentür.
• Ein Nur-Lese-Schlüssel kann kein Erstellungswerkzeug aufrufen, und nichts über MCP berührt Mitglieder, Abrechnung oder andere Schlüssel.

Alles, was ein Assistent über MCP kann, kannst du auch über einfaches HTTP - die API-Anleitungen decken dasselbe Terrain Endpoint für Endpoint ab.