Einrichtung und Konfiguration - MCP

Was diese Integration macht

Der entfernte MCP-Server (Model Context Protocol) lässt KI-Assistenten und andere Werkzeuge, die diesen Standard sprechen, direkt mit den Monitoring-Daten von DockRay kommunizieren - Projekte und Fehler durchsuchen, ihre diagnostischen Details lesen und bei entsprechenden Berechtigungen den Status eines Fehlers ändern oder ein Projekt verwalten. Es gibt einen Endpunkt: POST https://dockray.io/api/mcp, JSON-RPC 2.0, Protokollversion 2025-06-18. Das ist eine kostenpflichtige Plankomponente, getrennt vom Fehler-Ingest - ein Konto ohne sie kann keinen funktionierenden Schlüssel ausstellen.

Einen Zugangsschlüssel erstellen

Gehe im Panel zu Einstellungen → MCP-Integration und erstelle einen neuen Schlüssel. Benenne ihn nach dem Client oder der Automatisierung, die ihn nutzen wird, und aktiviere nur die Berechtigungen, die dieses Werkzeug wirklich braucht. Das erzeugte Token wird nur einmal angezeigt, beim Erstellen - DockRay speichert nur seinen Hash, ein verlorenes Token lässt sich also nicht wiederherstellen, sondern nur durch einen neuen Schlüssel ersetzen.

Einen MCP-Client verbinden

Trage in einem Client, der MCP spricht, als Endpunkt https://dockray.io/api/mcp ein und füge einen Autorisierungs-Header mit dem Token hinzu:

Authorization: Bearer dockray_mcp_…

Nach dem Verbinden sollte der Client die Standardanfrage tools/list aufrufen - die Antwort listet nur die Werkzeuge, für die der Schlüssel berechtigt ist. Ein Werkzeug, für das der Schlüssel keine Berechtigung hat, existiert aus seiner Sicht schlicht nicht: Es fehlt in der Liste, und der Aufruf schlägt fehl, als wäre es nie definiert worden.

Der erste Test

Rufe vom Client aus projects.list auf - es sollte die Projekte des Kontos zurückgeben, zu dem der Schlüssel gehört, samt ihrem aktuellen Monitoring-Zustand. Hast du die Berechtigung zum Lesen von Fehlern aktiviert, probiere auch issues.list für eines der Projekte. Eine leere Antwort trotz vorhandener Daten bedeutet meist, dass dem Schlüssel die passende Berechtigung fehlt - nicht, dass das Konto nichts zu zeigen hat.

Wie ein einzelner Aufruf aussieht

Der Server spricht reines JSON-RPC 2.0, ein Werkzeugaufruf ist also eine gewöhnliche POST-Anfrage mit der Methode tools/call:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "projects.list",
    "arguments": {"limit": 10}
  }
}

Ein unbekanntes oder nicht erlaubtes Werkzeug erhält genau dieselbe Antwortform wie der Aufruf einer Methode, die es nie gab - aus Sicht des Protokolls gibt es keinen Unterschied zwischen „keine Berechtigung" und „dieses Werkzeug ist nicht definiert".

Getrennte Schlüssel für getrennte Clients

Es lohnt sich, für jeden Client oder jede Automatisierung einen eigenen Schlüssel auszustellen, selbst wenn sie dieselben Berechtigungen benötigen. Schlüssel werden unabhängig voneinander widerrufen: Der Verlust eines Werkzeugs oder das Ende der Zusammenarbeit mit einem Anbieter erfordert dann nicht, die übrigen Integrationen zu unterbrechen.