Servidor MCP do AI Drive

Pesquise e leia documentos do Drive do Keural a partir de clientes MCP externos, como o Claude Desktop.

O Drive do Keural é disponibilizado como servidor MCP. Ao conectar um cliente MCP externo, você pesquisa e lê, página por página, os documentos do Drive que o usuário da chave pode ver. Os plugins conectam um sistema externo ao Keural, enquanto este servidor conecta os documentos do Keural a uma IA externa.

A autenticação usa uma chave de API da organização. Essa chave é emitida pelo Keural, então solicite à pessoa responsável pela implantação. A chave age com as permissões de um único usuário, para quem foi emitida, e exige a permissão drive:read. Se a chave for revogada, as conexões existentes são bloqueadas em 1 minuto.

Informações de conexão

Item	Valor
Transporte	MCP Streamable HTTP
Endereço	`https://<domínio do servidor de agentes do ambiente>/core/v1/mcp-drive`
Autenticação	`Authorization: Bearer <chave de API da organização>` (em todas as requisições)

Método da requisição

Método	Uso
`POST`	Uma requisição JSON-RPC. A resposta é sempre um único `application/json`. As notificações (`notifications/*`) retornam `202` sem corpo.
`GET`	Fluxo de eventos do servidor. Exige `Accept: text/event-stream` e `Mcp-Session-Id`. Envia um keepalive a cada 15 segundos e retoma com `Last-Event-ID`.
`DELETE`	Encerra a sessão. Exige `Mcp-Session-Id` e retorna `204`.

Quando initialize é bem-sucedido, o ID da sessão é retornado no cabeçalho de resposta Mcp-Session-Id. A sessão é opcional: você também pode enviar apenas POST, sem sessão. A sessão permanece ativa por 1 hora após a última requisição e fica vinculada à chave com que foi criada.
O cabeçalho MCP-Protocol-Version é opcional. Se for enviado, deve ser 2025-06-18.
O nome do servidor é keural-ai-drive, e o único recurso oferecido é tools.

Erros HTTP

Erros da etapa HTTP não usam o formato JSON-RPC, então verifique pelo código de status.

Status	Causa
`401`	Chave ausente ou incorreta; chave revogada ou expirada
`403`	A chave não tem a permissão `drive:read`
`400`	`MCP-Protocol-Version` não suportada, falha ao analisar o JSON (`-32700`), ou `GET`·`DELETE` sem ID de sessão
`404`	ID de sessão desconhecido ou expirado
`405`	`GET` sem `Accept: text/event-stream`

Erros da etapa JSON-RPC são retornados com 200 e um objeto error. Método ou ferramenta desconhecidos retornam -32601, e requisição mal formada retorna -32600.

Ferramentas

Ferramenta	Entrada	Descrição
`list_files`	Nenhuma	Lista de documentos que você pode ver (nome, id, data de envio, data de modificação e, se outra pessoa tiver enviado, quem enviou). Os documentos do Drive e os arquivos anexados no chat são retornados juntos e diferenciados por `origin`. Retorna até 500; se houver mais, é adicionado `truncated: true`
`search_drive`	`query`	Pesquisa semântica no conteúdo dos documentos e retorna trechos relevantes e informações de citação
`read_document_page`	`file_id`, `page`	Lê o texto completo de uma página de um documento. Obtenha o `file_id` nos resultados das duas ferramentas acima; `page` começa em 1

O resultado de cada ferramenta vem como string JSON em content[0].text.

Ferramenta	JSON dentro de `text`
`list_files`	`{"files":[{"name","id","created_date","modified_date","owner_name","origin"}], "truncated": false}`. As datas usam o formato `yyyy-MM-dd HH:mm`
`search_drive`	`{"sources":[{"id","name","url","contents":[…]}]}`
`read_document_page`	`{"file_id","page","rows":[…]}`

Se a execução de uma ferramenta falhar, a resposta é isError: true com {"error": "…"} (não é um erro JSON-RPC). Documentos sem permissão de acesso ou inexistentes retornam sempre file not found or not accessible.

Exemplo de configuração do cliente

Cadastre o endereço e os cabeçalhos em um cliente que ofereça suporte a servidores MCP remotos. O formato de configuração varia de cliente para cliente, então siga o método do seu cliente para adicionar um servidor MCP remoto.

{
  "mcpServers": {
    "keural-drive": {
      "type": "http",
      "url": "https://<domínio do servidor de agentes do ambiente>/core/v1/mcp-drive",
      "headers": { "Authorization": "Bearer <chave de API da organização>" }
    }
  }
}

A versão do protocolo MCP suportada é 2025-06-18.

Servidor MCP do AI Drive

Informações de conexãoCopiar link da âncora

Método da requisiçãoCopiar link da âncora

Erros HTTPCopiar link da âncora

FerramentasCopiar link da âncora

Exemplo de configuração do clienteCopiar link da âncora

Nesta página

Informações de conexão

Método da requisição

Erros HTTP

Ferramentas

Exemplo de configuração do cliente