Serveur MCP AI Drive

Recherchez et lisez les documents Keural Drive depuis des clients MCP externes comme Claude Desktop.

Keural expose Drive comme serveur MCP. Lorsqu'un client MCP externe se connecte à ce serveur, il peut rechercher et lire, page par page, les documents Keural Drive auxquels l'utilisateur titulaire de la clé a accès. Les plugins connectent un système externe à Keural, alors que ce serveur connecte les documents Keural à une IA externe.

Ce serveur s'authentifie avec une clé d'API de l'organisation. Les clés d'API de l'organisation sont délivrées par l'équipe Keural : demandez-en une à votre contact lors de la mise en place. La clé agit avec les droits de l'unique utilisateur pour lequel elle a été délivrée, et doit disposer de l'autorisation drive:read. Si vous révoquez la clé, les connexions existantes sont bloquées dans un délai d'une minute.

Informations de connexion

Élément	Valeur
Transport	MCP Streamable HTTP
Adresse	`https://<domaine du serveur d'agents de l'environnement>/core/v1/mcp-drive`
Authentification	`Authorization: Bearer <clé d'API de l'organisation>` (sur chaque requête)

Méthode de requête

Méthode	Usage
`POST`	Une requête JSON-RPC. La réponse est toujours un seul `application/json`. Les notifications (`notifications/*`) renvoient `202` sans corps.
`GET`	Flux d'événements du serveur. Nécessite `Accept: text/event-stream` et `Mcp-Session-Id`. Envoie un keepalive toutes les 15 secondes et reprend avec `Last-Event-ID`.
`DELETE`	Ferme la session. Nécessite `Mcp-Session-Id` et renvoie `204`.

Lorsque initialize réussit, l'identifiant de session est renvoyé dans l'en-tête de réponse Mcp-Session-Id. La session est facultative : vous pouvez aussi n'envoyer que des POST, sans session. Une session reste active 1 heure après la dernière requête et est liée à la clé avec laquelle elle a été créée.
L'en-tête MCP-Protocol-Version est facultatif. S'il est envoyé, sa valeur doit être 2025-06-18.
Le nom du serveur est keural-ai-drive, et la seule fonctionnalité proposée est tools.

Erreurs HTTP

Les erreurs de l'étape HTTP ne suivent pas le format JSON-RPC ; vérifiez donc le code d'état.

Statut	Cause
`401`	Clé absente ou incorrecte ; clé révoquée ou expirée
`403`	La clé n'a pas l'autorisation `drive:read`
`400`	`MCP-Protocol-Version` non prise en charge, échec d'analyse du JSON (`-32700`), ou `GET`·`DELETE` sans identifiant de session
`404`	Identifiant de session inconnu ou expiré
`405`	`GET` sans `Accept: text/event-stream`

Les erreurs de l'étape JSON-RPC sont renvoyées avec 200 et un objet error. Une méthode ou un outil inconnu renvoie -32601, et une requête mal formée renvoie -32600.

Outils

Outil	Entrée	Description
`list_files`	Aucune	Liste des documents que vous pouvez voir (nom, id, date d'envoi, date de modification et, si quelqu'un d'autre l'a envoyé, son auteur). Les documents Drive et les fichiers joints au chat sont renvoyés ensemble et se distinguent par `origin`. Renvoie jusqu'à 500 éléments ; au-delà, `truncated: true` est ajouté
`search_drive`	`query`	Recherche sémantique dans le contenu des documents, qui renvoie les passages pertinents et les informations de citation
`read_document_page`	`file_id`, `page`	Lit le texte intégral d'une page d'un document. Récupérez `file_id` dans les résultats des deux outils ci-dessus ; `page` commence à 1

Le résultat de chaque outil est une chaîne JSON placée dans content[0].text.

Outil	JSON contenu dans `text`
`list_files`	`{"files":[{"name","id","created_date","modified_date","owner_name","origin"}], "truncated": false}`. Les dates au format `yyyy-MM-dd HH:mm`
`search_drive`	`{"sources":[{"id","name","url","contents":[…]}]}`
`read_document_page`	`{"file_id","page","rows":[…]}`

Si l'exécution d'un outil échoue, la réponse contient isError: true avec {"error": "…"} (ce n'est pas une erreur JSON-RPC). Les documents que vous ne pouvez pas voir ou qui n'existent pas renvoient tous file not found or not accessible.

Exemple de configuration du client

Enregistrez l'adresse et les en-têtes dans un client qui prend en charge les serveurs MCP distants. Le format de configuration varie d'un client à l'autre : suivez la procédure d'ajout d'un serveur MCP distant de votre client.

{
  "mcpServers": {
    "keural-drive": {
      "type": "http",
      "url": "https://<domaine du serveur d'agents de l'environnement>/core/v1/mcp-drive",
      "headers": { "Authorization": "Bearer <clé d'API de l'organisation>" }
    }
  }
}

La version du protocole MCP prise en charge est 2025-06-18.

Serveur MCP AI Drive

Informations de connexionCopier le lien vers la section

Méthode de requêteCopier le lien vers la section

Erreurs HTTPCopier le lien vers la section

OutilsCopier le lien vers la section

Exemple de configuration du clientCopier le lien vers la section

Sur cette page

Informations de connexion

Méthode de requête

Erreurs HTTP

Outils

Exemple de configuration du client