Criei um servidor MCP para Google Sheets para que Claude leia minhas planilhas

No meu trabalho diário, mantivemos nosso FAQ em uma Planilha Google para que colegas não técnicos pudessem editá-la sem tocar no código. Um serviço de terceiros transformou essa planilha em uma API que o site poderia ler. Funcionou até que a página do FAQ começou a aparecer em branco. Sem erro, sem aviso, apenas uma página vazia. O nível gratuito do serviço tinha um limite baixo de requisições mensais, e o tráfego comum o esgotou silenciosamente.

Minha solução não foi boa. Criei mais três contas no mesmo serviço e as alternei manualmente, para que nunca dependêssemos de uma única conta por tempo suficiente para atingir seu limite. Duas planilhas simples agora precisavam de quatro logins alternados apenas para permanecer online.

Esse é o problema que o PasteSheet existe para resolver. Você cola uma URL de Planilha Google e ele fornece uma API confiável e em cache para essa planilha. Este post é sobre uma parte mais nova dela: o servidor MCP, que permite que um agente de IA como Claude leia sua planilha diretamente. Se você já quis que Claude ou Cursor respondessem perguntas diretamente da sua própria planilha, é assim que você faz isso.

O que é realmente um servidor MCP

MCP, o Protocolo de Contexto do Modelo, é a maneira padrão como clientes de IA como Claude e Cursor se conectam a dados externos. Um servidor MCP fornece ao AI um conjunto de ferramentas que ele pode chamar. A IA decide quando usá-las e o que fazer com os resultados.

Um "servidor MCP de Planilhas Google" é simplesmente um servidor que fornece ao AI ferramentas para ler uma planilha. O PasteSheet constrói e hospeda esse servidor para você. Você cola uma URL de compartilhamento, e qualquer cliente compatível com MCP pode se conectar a ele. Não há projeto no Google Cloud, não há tela de consentimento OAuth e não há arquivo de conta de serviço para configurar.

Publique uma planilha, não conecte sua conta

A maioria das ferramentas resolve isso conectando sua conta inteira do Google ao agente, por trás do OAuth e de um projeto Cloud que você tem que configurar sozinho. Isso entrega ao agente muito mais do que a única planilha que você realmente se importa. As próprias ferramentas do Google funcionam assim, e o mesmo acontece com o Zapier.

O PasteSheet faz o oposto. Você publica uma única planilha como seu próprio endpoint, e o agente pode ler essa planilha e nada mais em seu Drive. Também não há caminho de escrita em nenhum lugar no produto, então a conexão é somente leitura por design. Isso é o que torna um endpoint seguro para entregar a um agente autônomo: não há ferramenta que ele poderia chamar para sobrescrever sua fonte de verdade.

As três ferramentas que seu agente recebe

Uma vez conectado, a IA tem três ferramentas somente de leitura:

• list_tabs mostra as abas na planilha e qual delas é a padrão.
• get_schema mostra o nome e o tipo de cada coluna, para que a IA saiba com o que está trabalhando antes de executar uma consulta.
• query_rows lê as linhas, com filtragem, pesquisa de texto completo, ordenação e paginação.

A segunda, get_schema, é o que torna isso confiável. Se a IA não souber os nomes das suas colunas, ela os adivinha, e metade de suas consultas falham. Quando ela pode ler o esquema primeiro, usa os nomes reais e as consultas funcionam. Essa única ferramenta foi a diferença entre "geralmente funciona" e "simplesmente funciona".

Conectando-o

Cada endpoint tem sua própria URL MCP. Em um cliente estilo Claude Desktop, você a adiciona à configuração:

{
  "mcpServers": {
    "pastesheet": {
      "url": "https://pastesheet.com/mcp/sheets/your-endpoint-id"
    }
  }
}

No Claude Code, é um único comando, sem arquivo de configuração para editar:

claude mcp add --transport http pastesheet https://pastesheet.com/mcp/sheets/your-endpoint-id

O guia de conexão do Claude orienta passo a passo através do Desktop, web, Code e Cursor. Endpoints públicos não precisam de chave. Para um privado, você passa ?api_key=... na URL, ou envia um cabeçalho Authorization: Bearer.

Depois disso, você apenas faz perguntas em inglês simples. Aqui está uma troca real contra uma planilha de produtos:

Eu:     Quais linhas do meu catálogo estão fora de estoque e abaixo de $50?
Claude: [chama get_schema, vê colunas: nome, preço, estoque, categoria]
        [chama query_rows filtra estoque=0, preço<50, ordena por preço]
        4 itens: Caneca de Cerâmica ($12), Pacote de Adesivos ($6), Caderno ($18), Cabo ($24).

Eu nunca disse a Claude os nomes das colunas. Ele leu o esquema, escreveu a consulta e respondeu.

Por que ele faz cache, e onde isso para

Agentes de IA fazem muitas perguntas pequenas. Para responder a um prompt, Claude pode listar as abas, ler o esquema e, em seguida, executar várias consultas filtradas em sequência. Se cada uma delas atingisse o Google diretamente, você rapidamente esbarraria nos limites do Google. A API de Planilhas permite 300 leituras por minuto por projeto e apenas 60 por minuto por usuário, e retorna um erro 429 uma vez que você ultrapassa essa linha. É o mesmo tipo de limite silencioso que quebrou minha página de FAQ no primeiro lugar.

Então, o PasteSheet lê sua planilha uma vez e armazena em cache as linhas. Cada chamada de ferramenta depois disso é servida do cache, o que significa que a décima consulta do agente não custa nada ao Google.

Esse cache vem com um custo que vale a pena ser honesto. Você escolhe quanto tempo ele dura, de 30 segundos a uma hora, e dentro dessa janela o agente vê a cópia em cache em vez de uma edição que você fez um momento atrás. E como tudo é somente leitura, o agente pode analisar sua planilha, mas nunca mudá-la. Se você precisar de um agente que escreva de volta para uma planilha, esta é a ferramenta errada. Se você quiser uma fonte de verdade que os agentes possam ler com segurança, esse limite de somente leitura é exatamente o recurso que você deseja.

Está no Registro MCP

Você não precisa acreditar apenas na minha palavra para a configuração. A documentação do servidor, a configuração do cliente e o manifesto do registro são públicos em GitHub, e está listado no Registro MCP oficial como com.pastesheet/google-sheets, então qualquer cliente que navegue pelo registro pode encontrá-lo e se conectar a ele.

Eu construo PasteSheet. Cole uma URL de Planilha Google e obtenha uma API JSON em cache, além de um servidor MCP somente leitura que seu agente de IA pode consultar. Nível gratuito, sem cartão de crédito, sem projeto Google Cloud.