Pular para o conteúdo
Agents

Como conectar o Google Drive ao Claude (MCP)

Os três caminhos para ligar o Google Drive ao Claude, o que cada um alcança e qual escolher, do conector do próprio Claude ao servidor MCP que só enxerga o que ele mesmo cria.

Ciro Cesar Maciel6 min de leituraFeito com ajuda de IA

Nesta página · 10 seções
  1. Os três caminhos
  2. Para o Claude ler o seu Drive: o conector do próprio Claude
  3. O servidor MCP oficial do Google
  4. Para um agente escrever no seu Drive: o conector do Agents
  5. Passo a passo no Claude Code e no Cursor
  6. O que fica guardado
  7. Perguntas frequentes
  8. Para continuar lendo
  9. Relatórios no seu Drive, escritos por um agente
  10. Fontes

Quem procura "conectar o Google Drive ao Claude" pode querer duas coisas diferentes. A primeira é o Claude ler os arquivos que já estão no seu Drive: o contrato, a planilha do orçamento, a apresentação do trimestre. A segunda é um agente escrever no seu Drive: montar a planilha da semana, o documento do relatório do mês, e deixar pronto para compartilhar. São caminhos diferentes, e escolher o certo poupa uma tarde.

Os três caminhos

CaminhoO que alcançaO que pede
Conector Google Drive do ClaudeBusca e lê os arquivos que a sua conta abre, e cria arquivosUma conta no Claude; você conecta em Personalizar > Conectores
Servidor MCP oficial do Google para o DriveBusca, lê e cria arquivos, com as permissões do usuárioEntrar no programa de Developer Preview do Google Workspace, um projeto no Google Cloud, as APIs ligadas e a tela de consentimento OAuth configurada
Conector Google Drive do AgentsSó as planilhas e os documentos que ele mesmo criouColar um endereço no cliente MCP e entrar com o Google

Para o Claude ler o seu Drive: o conector do próprio Claude

Segundo a documentação do Claude, o conector Google Drive é feito e operado pelo Google, e cada pessoa entra com a própria conta Google: o Claude só alcança os arquivos que essa conta abre. Ele lê Google Docs, Planilhas e Apresentações, PDF, arquivos do Word, do Excel e do PowerPoint e imagens PNG e JPEG. Não lê comentários nem sugestões, só o conteúdo, e um arquivo muito grande pode chegar incompleto.

Para ligar:

  1. No claude.ai, abra Personalizar, depois Conectores.

  2. Ache Google Drive na lista e clique em Conectar.

  3. Entre na sua conta Google e autorize. O botão passa a dizer Desconectar.

  4. Numa conversa, clique em +, depois em Conectores, ligue o Google Drive e pergunte, por exemplo: "leia a planilha do orçamento do terceiro trimestre e diga quais linhas passaram do previsto".

Nos planos Team e Enterprise, o conector só aparece depois que um dono da organização o libera. Se o que você quer é ler os seus arquivos na conversa, este é o caminho, e não precisa de mais nada.

O servidor MCP oficial do Google

O Google tem também um servidor MCP remoto para o Drive, para clientes como o Google Antigravity e o Claude. Segundo a documentação do Google, ele busca arquivos, lê o conteúdo e os detalhes deles e cria arquivos, sempre com as permissões do próprio usuário. Hoje ele está em Developer Preview: para usar, é preciso fazer parte do programa de Developer Preview do Google Workspace, ter um projeto no Google Cloud, ligar a API do Drive e a API do Drive MCP e configurar a tela de consentimento e um cliente OAuth. Faz sentido para quem já trabalha no Google Cloud.

Para um agente escrever no seu Drive: o conector do Agents

O conector Google Drive do Agents tem outro foco: ele cria planilhas e documentos do Google no seu Drive, escreve neles e lê o que escreveu. Ele usa o escopo drive.file do Google, que dá acesso só aos arquivos que o próprio conector criou. Os seus outros arquivos não aparecem para ele. É o que você quer quando um agente roda sozinho, numa rotina, e não deveria enxergar o resto do seu Drive.

Ele funciona em qualquer cliente MCP: o Claude, o Claude Code, o Cursor e o Assistant, o bot do Agents. Não pede projeto no Google Cloud.

FerramentaO que fazPede aprovação?
Listar arquivosAs planilhas e documentos que o conector criou, com linkNão
Nova planilhaCria uma planilha, já com as linhas que você derSim
Acrescentar linhasPõe linhas no fim de uma aba, sem mexer no restoSim
Escrever célulasEscreve valores ou fórmulas num intervaloSim
Ler planilhaLê uma aba ou um intervalo de uma planilha criada aquiNão
Novo documentoCria um documento com títulos, parágrafos e listasSim
Acrescentar ao documentoPõe conteúdo no fim de um documento criado aquiSim
Ler documentoO texto de um documento criado aquiNão
CompartilharDá acesso a alguém por e-mailSim
Mandar para a lixeiraManda um arquivo criado aqui para a lixeira do DriveSim

Pedidos que ele resolve:

  • "Crie a planilha do relatório semanal com sessões, leads e vendas e compartilhe com o time."

  • "Acrescente as linhas de hoje na planilha de vendas que você criou ontem."

  • "Escreva o relatório do mês num documento do Google, com um título por canal."

Ele não lê os arquivos que você já tem. Para isso, use o conector do Claude, acima.

Passo a passo no Claude Code e no Cursor

No Claude Code, adicione o servidor pelo terminal e depois rode /mcp dentro do Claude Code para entrar:

claude mcp add --transport http google-drive https://google-drive.mcp.myagents.click/mcp

No Cursor, acrescente o servidor ao arquivo .cursor/mcp.json, no projeto ou na sua pasta pessoal. O Cursor abre o login na primeira vez:

{
  "mcpServers": {
    "google-drive": { "url": "https://google-drive.mcp.myagents.click/mcp" }
  }
}

No Claude, o caminho é o mesmo dos outros conectores personalizados: Personalizar, Conectores, Adicionar conector personalizado, e o endereço https://google-drive.mcp.myagents.click/mcp. O login pede primeiro a conta Agents, uma vez só, e depois a conta Google, onde você autoriza o acesso aos arquivos que o conector criar.

O que fica guardado

O conteúdo das planilhas e dos documentos fica no seu Drive, na sua conta. O conector guarda os tokens de acesso do Google, criptografados, enquanto a conexão existir, o identificador da sua conta Agents e contadores de uso para os limites, apagados em até dois dias (os do mês, em até 40 dias). Nada é vendido nem usado para treinar modelos. Para cortar o acesso, remova o Agents em myaccount.google.com/permissions.

Perguntas frequentes

O conector do Agents consegue ler o meu Drive inteiro?

Não. O escopo drive.file só alcança os arquivos que o próprio conector criou. Para o Claude ler os seus arquivos, use o conector Google Drive do Claude.

Preciso de projeto no Google Cloud?

Não para o conector do Claude nem para o do Agents. Só o servidor MCP oficial do Google pede projeto no Google Cloud, além da entrada no Developer Preview.

Quanto custa o conector do Agents?

O Connectors conta chamadas por mês, somando todos os conectores feitos no Agents. O plano grátis tem 100 chamadas por mês. Nos outros conectores o grátis é só de leitura, mas o Google Drive é a exceção: criar planilhas e documentos, escrever neles e compartilhar valem em todos os planos, inclusive no grátis. Os planos pagos aumentam as chamadas; os valores estão na página de preços do Connectors.

Funciona no ChatGPT?

O ChatGPT aceita servidores MCP remotos como conector personalizado, no modo de desenvolvedor, e o conector usa o protocolo que ele pede. Mas o uso no ChatGPT ainda não foi conferido aqui. Onde os conectores já são usados: o Assistant, o Claude e o Claude Code.

Para continuar lendo

Relatórios no seu Drive, escritos por um agente

O conector Google Drive está em google-drive.mcp.myagents.click, com o endereço pronto para copiar e um exemplo de planilha. Ele faz parte do Connectors, o diretório de servidores MCP remotos com login OAuth do Agents, em mcp.myagents.click. Conhecer o Connectors

Fontes

XLinkedInWhatsAppE-mail

Quem escreveu

Ciro Cesar Maciel

Sou marido, pai e trabalho com tecnologia há mais de duas décadas, construindo sistemas para grandes empresas e liderando times técnicos. Desde 2024 desenvolvo ferramentas digitais e aplico Inteligência Artificial para viver e trabalhar com mais clareza, e escrevo aqui sobre isso.

Todos os textos

Continue lendo

Comentários

Seu e-mail fica com Agents para moderar e responder. O comentário aparece depois de aprovado.