MCP Reference: sheetsmcp.googleapis.com

Este é um servidor MCP que fornece ferramentas para interagir com o Planilhas Google.

Um servidor do Protocolo de Contexto de Modelo (MCP) atua como um proxy entre um serviço externo que fornece contexto, dados ou recursos para um modelo de linguagem grande (LLM) ou um aplicativo de IA. Os servidores MCP conectam aplicativos de IA a sistemas externos, como bancos de dados e serviços da Web, traduzindo as respostas em um formato que o aplicativo de IA possa entender.

Ferramentas do MCP

Uma ferramenta do MCP é uma função ou capacidade executável que um servidor do MCP expõe a um LLM ou aplicativo de IA para realizar uma ação no mundo real.

Ferramentas

O servidor MCP sheetsmcp.googleapis.com tem as seguintes ferramentas:

Ferramentas do MCP
get_values Retorna um intervalo de valores de uma planilha. Corresponde a spreadsheets.values.get na API REST: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get
get_spreadsheet Retorna o conteúdo da planilha. Retorna títulos, nomes de planilhas, propriedades de grade e outros metadados para o ID da planilha. Também retorna dados completos da grade, se solicitado. Corresponde a spreadsheets.get na API REST: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get
update_spreadsheet

Aplica uma ou mais atualizações à planilha.

Corresponde a spreadsheets.batchUpdate na API REST: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate

A lista de atualizações possíveis é:

  • updateSpreadsheetProperties: atualiza as propriedades da planilha.
  • updateSheetProperties: atualiza as propriedades de uma planilha.
  • updateDimensionProperties: atualiza as propriedades das dimensões.
  • updateNamedRange: atualiza um intervalo nomeado.
  • repeatCell: repete uma única célula em um intervalo.
  • addNamedRange: adiciona um intervalo nomeado.
  • deleteNamedRange: exclui um intervalo nomeado.
  • addSheet: adiciona uma planilha.
  • deleteSheet: exclui uma planilha.
  • autoFill: preenche automaticamente mais dados com base nos dados atuais.
  • cutPaste: recorta dados de uma área e cola em outra.
  • copyPaste: copia dados de uma área e cola em outra.
  • mergeCells: mescla células.
  • unmergeCells: desmescla células mescladas.
  • updateBorders: atualiza as bordas em um intervalo de células.
  • updateCells: atualiza várias células de uma só vez.
  • addFilterView: adiciona uma visualização com filtro.
  • appendCells: anexa células após a última linha com dados em uma planilha.
  • clearBasicFilter: limpa o filtro básico em uma planilha.
  • deleteDimension: exclui linhas ou colunas em uma planilha.
  • deleteEmbeddedObject: exclui um objeto incorporado (por exemplo, gráfico, imagem) em uma planilha.
  • deleteFilterView: exclui uma visualização com filtro de uma planilha.
  • duplicateFilterView: duplica uma visualização com filtro.
  • duplicateSheet: duplica uma planilha.
  • findReplace: encontra e substitui ocorrências de um texto por outro.
  • insertDimension: insere novas linhas ou colunas em uma planilha.
  • insertRange: insere novas células em uma planilha, deslocando as células atuais.
  • moveDimension: move linhas ou colunas para outro local em uma planilha.
  • updateEmbeddedObjectPosition: atualiza a posição de um objeto incorporado (por exemplo, gráfico, imagem).
  • pasteData: cola dados (HTML ou delimitados) em uma planilha.
  • textToColumns: converte uma coluna de texto em várias colunas de texto.
  • updateFilterView: atualiza as propriedades de uma visualização com filtro.
  • deleteRange: exclui um intervalo de células de uma planilha, deslocando as células restantes.
  • appendDimension: anexa dimensões ao final de uma planilha.
  • addConditionalFormatRule: adiciona uma nova regra de formatação condicional.
  • updateConditionalFormatRule: atualiza uma regra de formatação condicional.
  • deleteConditionalFormatRule: exclui uma regra de formatação condicional.
  • sortRange: classifica dados em um intervalo.
  • setDataValidation: define a validação de dados para uma ou mais células.
  • setBasicFilter: define o filtro básico em uma planilha.
  • addProtectedRange: adiciona um intervalo protegido.
  • updateProtectedRange: atualiza um intervalo protegido.
  • deleteProtectedRange: exclui um intervalo protegido.
  • autoResizeDimensions: redimensiona automaticamente uma ou mais dimensões com base no conteúdo das células nessa dimensão.
  • addChart: adiciona um gráfico.
  • updateChartSpec: atualiza as especificações de um gráfico.
  • updateBanding: atualiza um intervalo com faixas
  • addBanding: adiciona um novo intervalo com faixas
  • deleteBanding: remove um intervalo com faixas
  • createDeveloperMetadata: cria novos metadados do desenvolvedor
  • updateDeveloperMetadata: atualiza uma entrada de metadados do desenvolvedor
  • deleteDeveloperMetadata: exclui metadados do desenvolvedor
  • randomizeRange: randomiza a ordem das linhas em um intervalo.
  • addDimensionGroup: cria um grupo no intervalo especificado.
  • deleteDimensionGroup: exclui um grupo no intervalo especificado.
  • updateDimensionGroup: atualiza o estado do grupo especificado.
  • trimWhitespace: remove espaços em branco das células (como espaços, tabulações ou novas linhas).
  • deleteDuplicates: remove linhas que contêm valores duplicados nas colunas especificadas de um intervalo de células.
  • updateEmbeddedObjectBorder: atualiza a borda de um objeto incorporado.
  • addSlicer: adiciona um segmentador.
  • updateSlicerSpec: atualiza as especificações de um segmentador.
  • addDataSource: adiciona uma fonte de dados.
  • updateDataSource: atualiza uma fonte de dados.
  • deleteDataSource: exclui uma fonte de dados.
  • refreshDataSource: atualiza uma ou várias fontes de dados e dbobjects associados.
  • cancelDataSourceRefresh: cancela as atualizações de uma ou várias fontes de dados e dbobjects associados.
  • addTable: adiciona uma tabela.
  • updateTable: atualiza uma tabela.
  • deleteTable: uma solicitação para excluir uma tabela.
update_values Define valores em um intervalo de uma planilha. Corresponde a spreadsheets.values.update na API REST: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
update_formulas Define fórmulas em um intervalo de uma planilha. Corresponde a spreadsheets.values.update na API REST: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
insert_dimension Insere linhas ou colunas em uma planilha em um índice específico. Corresponde a um InsertDimensionRequest na API REST spreadsheets.batchUpdate: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request

Receber especificações de ferramentas do MCP

Para receber as especificações de ferramentas do MCP para todas as ferramentas em um servidor do MCP, use o método tools/list. O exemplo a seguir demonstra como usar curl para listar todas as ferramentas e especificações disponíveis no servidor do MCP.

Solicitação curl 
curl --location 'https://sheetsmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'