Servidor MCP de AI Drive

Busque y lea documentos de Keural Drive desde clientes MCP externos como Claude Desktop.

Keural también ofrece Drive como servidor MCP. Al conectar un cliente MCP externo, puede buscar y leer, página por página, los documentos de Keural Drive a los que tiene acceso el usuario que recibió la clave. Los complementos conectan un sistema externo con Keural, mientras que este servidor conecta los documentos de Keural con una IA externa.

Este servidor se autentica con una clave de API de la organización. Keural emite las claves de API de la organización, así que solicítela a la persona responsable de la implantación. La clave actúa con los permisos del único usuario al que se emitió y necesita el permiso drive:read. Si revoca la clave, las conexiones existentes se bloquean en un plazo máximo de 1 minuto.

Información de conexión

Elemento	Valor
Transporte	MCP Streamable HTTP
Dirección	`https://<dominio del servidor de agentes del entorno>/core/v1/mcp-drive`
Autenticación	`Authorization: Bearer <clave de API de la organización>` (en todas las solicitudes)

Método de solicitud

Método	Uso
`POST`	Una solicitud JSON-RPC. La respuesta siempre es un único `application/json`. Las notificaciones (`notifications/*`) devuelven `202` sin cuerpo.
`GET`	Flujo de eventos del servidor. Requiere `Accept: text/event-stream` y `Mcp-Session-Id`. Envía un keepalive cada 15 segundos y se reanuda con `Last-Event-ID`.
`DELETE`	Cierra la sesión. Requiere `Mcp-Session-Id` y devuelve `204`.

Si initialize se completa correctamente, el ID de sesión se devuelve en el encabezado de respuesta Mcp-Session-Id. Las sesiones son opcionales: también puede enviar solo POST sin sesión. Una sesión se mantiene durante 1 hora después de la última solicitud y queda vinculada a la clave con la que se creó.
Si envía el encabezado MCP-Protocol-Version, debe ser 2025-06-18. No es obligatorio enviarlo.
El nombre del servidor es keural-ai-drive y solo ofrece tools.

Errores HTTP

Los errores de la fase HTTP no usan el formato JSON-RPC, así que primero revise el código de estado.

Estado	Causa
`401`	Falta la clave o es incorrecta; la clave está revocada o caducada
`403`	La clave no tiene el permiso `drive:read`
`400`	`MCP-Protocol-Version` no admitido, error al analizar el JSON (`-32700`), o `GET`·`DELETE` sin ID de sesión
`404`	ID de sesión desconocido o caducado
`405`	`GET` sin `Accept: text/event-stream`

Los errores de la fase JSON-RPC llegan con 200 y un objeto error. El método o la herramienta desconocidos devuelven -32601, y una solicitud con formato incorrecto devuelve -32600.

Herramientas

Herramienta	Entrada	Descripción
`list_files`	Ninguna	Lista de documentos a los que puede acceder (nombre, id, fecha de subida, fecha de modificación y, si lo subió otra persona, quién lo subió). Los documentos de Drive y los archivos adjuntos en el chat aparecen juntos y se distinguen con `origin`. Muestra hasta 500; si hay más, se añade `truncated: true`
`search_drive`	`query`	Búsqueda semántica en el contenido de los documentos, que devuelve pasajes relevantes e información de citas
`read_document_page`	`file_id`, `page`	Lee el texto completo de una página de un documento. Obtenga `file_id` de los resultados de las dos herramientas anteriores; `page` empieza en 1

El resultado de cada herramienta se devuelve como una cadena JSON en content[0].text.

Herramienta	JSON dentro de `text`
`list_files`	`{"files":[{"name","id","created_date","modified_date","owner_name","origin"}], "truncated": false}`. Las fechas tienen el formato `yyyy-MM-dd HH:mm`
`search_drive`	`{"sources":[{"id","name","url","contents":[…]}]}`
`read_document_page`	`{"file_id","page","rows":[…]}`

Si falla la ejecución de una herramienta, se devuelve isError: true con {"error": "…"} (no un error JSON-RPC). Los documentos que no puede ver o que no existen reciben la misma respuesta: file not found or not accessible.

Ejemplo de configuración del cliente

Registre la dirección y los encabezados en un cliente que admita servidores MCP remotos. Lo siguiente es solo un ejemplo de formato. El formato de configuración varía según el cliente; siga el método del cliente para añadir un servidor MCP remoto.

{
  "mcpServers": {
    "keural-drive": {
      "type": "http",
      "url": "https://<dominio del servidor de agentes del entorno>/core/v1/mcp-drive",
      "headers": { "Authorization": "Bearer <clave de API de la organización>" }
    }
  }
}

La versión del protocolo MCP admitida es 2025-06-18.

Servidor MCP de AI Drive

Información de conexiónCopiar enlace de la sección

Método de solicitudCopiar enlace de la sección

Errores HTTPCopiar enlace de la sección

HerramientasCopiar enlace de la sección

Ejemplo de configuración del clienteCopiar enlace de la sección

En esta página

Información de conexión

Método de solicitud

Errores HTTP

Herramientas

Ejemplo de configuración del cliente