AI Drive MCP-Server

Durchsuchen und lesen Sie Keural-Drive-Dokumente aus externen MCP-Clients wie Claude Desktop.

Keural stellt Drive als MCP-Server bereit. Verbindet sich ein externer MCP-Client, kann er die Drive-Dokumente durchsuchen und seitenweise lesen, die der Benutzer des Schlüssels sehen darf. Plugins verbinden ein externes System mit Keural, dieser Server verbindet die Keural-Dokumente mit einer externen KI.

Für die Authentifizierung verwenden Sie einen Organisations-API-Schlüssel. Organisations-API-Schlüssel stellt Keural aus; fragen Sie deshalb Ihren Ansprechpartner bei der Einführung danach. Der Schlüssel arbeitet mit den Rechten des einen Benutzers, für den er ausgestellt wurde, und benötigt die Berechtigung drive:read. Wird der Schlüssel widerrufen, werden bestehende Verbindungen innerhalb von höchstens einer Minute gesperrt.

Verbindungsdaten

Element	Wert
Transport	MCP Streamable HTTP
Adresse	`https://<Agenten-Server-Domain der Umgebung>/core/v1/mcp-drive`
Authentifizierung	`Authorization: Bearer <Organisations-API-Schlüssel>` (bei jeder Anfrage)

Anfragemethode

Methode	Verwendung
`POST`	Eine JSON-RPC-Anfrage. Die Antwort ist immer ein einzelnes `application/json`. Benachrichtigungen (`notifications/*`) geben `202` ohne Body zurück.
`GET`	Ereignisstrom des Servers. Erfordert `Accept: text/event-stream` und `Mcp-Session-Id`. Sendet alle 15 Sekunden ein Keepalive und setzt mit `Last-Event-ID` fort.
`DELETE`	Beendet die Sitzung. Erfordert `Mcp-Session-Id` und gibt `204` zurück.

Bei erfolgreichem initialize wird die Sitzungs-ID im Antwort-Header Mcp-Session-Id zurückgegeben. Sitzungen sind optional: Sie können auch nur POST ohne Sitzung senden. Eine Sitzung bleibt 1 Stunde nach der letzten Anfrage aktiv und ist an den Schlüssel gebunden, mit dem sie erstellt wurde.
Wenn Sie den Header MCP-Protocol-Version senden, muss er 2025-06-18 lauten. Er ist nicht zwingend.
Der Servername lautet keural-ai-drive, und die einzige angebotene Funktion ist tools.

HTTP-Fehler

Fehler auf HTTP-Ebene haben kein JSON-RPC-Format; prüfen Sie daher zuerst den Statuscode.

Status	Ursache
`401`	Schlüssel fehlt oder ist falsch; Schlüssel widerrufen oder abgelaufen
`403`	Der Schlüssel hat nicht die Berechtigung `drive:read`
`400`	Nicht unterstützte `MCP-Protocol-Version`, JSON-Parsing fehlgeschlagen (`-32700`), oder `GET`·`DELETE` ohne Sitzungs-ID
`404`	Unbekannte oder abgelaufene Sitzungs-ID
`405`	`GET` ohne `Accept: text/event-stream`

Fehler auf JSON-RPC-Ebene werden mit 200 und einem Objekt error zurückgegeben. Unbekannte Methoden oder Werkzeuge ergeben -32601, fehlerhaft aufgebaute Anfragen -32600.

Werkzeuge

Werkzeug	Eingabe	Beschreibung
`list_files`	Keine	Liste der Dokumente, die Sie sehen dürfen (Name, ID, Hochladedatum, Änderungsdatum und, falls von einer anderen Person hochgeladen, der Uploader). Drive-Dokumente und im Chat angehängte Dateien erscheinen gemeinsam und werden über `origin` unterschieden. Maximal 500; bei mehr Treffern wird `truncated: true` ergänzt
`search_drive`	`query`	Semantische Suche im Dokumentinhalt; gibt relevante Textstellen und Zitatinformationen zurück
`read_document_page`	`file_id`, `page`	Liest den vollständigen Text einer bestimmten Seite eines Dokuments. Die `file_id` stammt aus den Ergebnissen der beiden oberen Werkzeuge; `page` zählt ab 1

Das Ergebnis eines Werkzeugs wird als JSON-Zeichenkette in content[0].text übergeben.

Werkzeug	JSON im Feld `text`
`list_files`	`{"files":[{"name","id","created_date","modified_date","owner_name","origin"}], "truncated": false}`. Datumsformat `yyyy-MM-dd HH:mm`
`search_drive`	`{"sources":[{"id","name","url","contents":[…]}]}`
`read_document_page`	`{"file_id","page","rows":[…]}`

Schlägt die Ausführung eines Werkzeugs fehl, wird kein JSON-RPC-Fehler zurückgegeben, sondern isError: true mit {"error": "…"}. Dokumente, die Sie nicht sehen dürfen oder die nicht existieren, erhalten dieselbe Antwort: file not found or not accessible.

Beispiel für die Client-Konfiguration

Tragen Sie Adresse und Header in einen Client ein, der entfernte MCP-Server unterstützt. Das folgende Beispiel zeigt nur das Format. Das Konfigurationsformat unterscheidet sich je nach Client; folgen Sie der Anleitung Ihres Clients zum Hinzufügen eines entfernten MCP-Servers.

{
  "mcpServers": {
    "keural-drive": {
      "type": "http",
      "url": "https://<Agenten-Server-Domain der Umgebung>/core/v1/mcp-drive",
      "headers": { "Authorization": "Bearer <Organisations-API-Schlüssel>" }
    }
  }
}

Unterstützt wird die MCP-Protokollversion 2025-06-18.

AI Drive MCP-Server

VerbindungsdatenAnkerlink kopieren

AnfragemethodeAnkerlink kopieren

HTTP-FehlerAnkerlink kopieren

WerkzeugeAnkerlink kopieren

Beispiel für die Client-KonfigurationAnkerlink kopieren

Auf dieser Seite

Verbindungsdaten

Anfragemethode

HTTP-Fehler

Werkzeuge

Beispiel für die Client-Konfiguration