MCP-Server / Einrichtung

MCP-Server einrichten

Über den MCP-Server starten KI-Werkzeuge Scans und lesen Berichte, ohne dass jemand HTTP-Aufrufe von Hand schreibt. Die drei Werkzeuge rufen intern die REST-API auf. Über MCP geht nichts, was über REST nicht auch ginge.

Adresse

https://api.red-check.de/mcp

Der Server spricht MCP über Streamable HTTP: JSON-RPC 2.0 per POST, ohne Sitzung. Der Bearer-Schlüssel steht in jeder Anfrage. GET und DELETE beantwortet er mit 405. Unterstützt sind die Protokollfassungen 2025-06-18, 2025-03-26 und 2024-11-05.

Konfiguration

Die meisten Werkzeuge erwarten einen Eintrag dieser Form:

{
"mcpServers": {
  "redcheck": {
    "url": "https://api.red-check.de/mcp",
    "headers": {
      "Authorization": "Bearer rc_live_••••••••"
    }
  }
}
}

Rechte

Der MCP-Server erbt Recht und Domain-Einschränkung des Schlüssels:

Ohne passendes Recht endet start_scan mit api_key_scope_insufficient. Eine Domain außerhalb der Einschränkung findet das Werkzeug nicht und meldet not_found.

Ein Fehler kommt als Werkzeugergebnis mit isError: true und dem Inhalt {"error": {"code": "…", "message": "…"}}. Die Codes sind dieselben wie in der REST-API, siehe Konventionen. Die HTTP-Antwort auf /mcp hat dabei den Status 200, auch bei plan_upgrade_required oder einem ungültigen Schlüssel. Werten Sie deshalb isError und error.code aus. Ein Werkzeugaufruf ganz ohne Schlüssel endet dagegen mit 401.

Werkzeuge