# Toolcape + Google Sheets

O Toolcape conecta a IA existente da empresa aos seus sistemas por um único ponto de entrada MCP, com conexões de contas, permissões de grupos e pessoas e registros de auditoria. Esta documentação descreve um protótipo; não comprova a conexão de um servidor ou conta real.

## A conexão
Google Sheets: As planilhas do Google para orçamentos, listas e tabelas compartilhadas.
Conexão por API · a IA usa o Toolcape via MCP
Login no provedor (OAuth). Confirme se a conexão configurada age em nome do usuário ou usa permissões de aplicativo.

## Ações típicas
- Ler: Ler células, intervalos e a estrutura da planilha
- Criar: Criar uma planilha ou adicionar linhas
- Alterar: Atualizar valores e formatação
Uma célula alterada pode afetar fórmulas e relatórios. Limite a edição aos fluxos que precisam dela.

## Configuração
1. A equipe de TI configura o aplicativo no provedor, a API e os escopos solicitados.
2. Login no provedor (OAuth). Confirme se a conexão configurada age em nome do usuário ou usa permissões de aplicativo.
3. Disponibilize o serviço no Toolcape. Defina regras para Todos, grupos e pessoas conforme as ações necessárias. Adicionar um serviço não concede acesso.
4. Conecte o aplicativo de IA aprovado ao endereço MCP real do Toolcape e faça login. Comece com uma consulta sem risco e confira o registro de auditoria.

## Permissões
No acesso pessoal delegado, a conta do provedor, os escopos aprovados e as regras do Toolcape precisam permitir a ação. Contas compartilhadas e permissões de aplicativo podem ter outros limites. O Toolcape combina permissões de Todos e dos grupos; uma exceção pessoal substitui o acesso herdado naquele serviço. A leitura pode expor informações confidenciais. Compartilhamento, envio e exclusão exigem avaliação separada.

## Executar uma operação
Primeiro, descubra quais ferramentas o servidor Toolcape conectado realmente oferece. Se houver pesquisar → descrever → executar, encontre a operação, confira o esquema de entrada e as permissões e execute com dados validados. Os nomes variam por servidor; não invente nomes, argumentos, URLs ou resultados bem-sucedidos. Sem ferramentas conectadas, oriente a configuração em vez de afirmar que executou ações.

## Referência de operações
Catálogo de 16 de setembro de 2026. Verifique o esquema atual antes de executar.
- sheetsSpreadsheetsGet — Consultar planilha
  GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}
  https://developers.google.com/workspace/sheets/
- sheetsSpreadsheetsCreate — Criar planilha
  POST https://sheets.googleapis.com/v4/spreadsheets
  https://developers.google.com/workspace/sheets/
- sheetsSpreadsheetsGetByDataFilter — Consultar planilha
  POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:getByDataFilter
  https://developers.google.com/workspace/sheets/
- sheetsSpreadsheetsBatchUpdate — Batch Spreadsheets Update
  POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
  https://developers.google.com/workspace/sheets/
- sheetsSpreadsheetsValuesGet — Consultar planilha
  GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}
  https://developers.google.com/workspace/sheets/
- sheetsSpreadsheetsValuesUpdate — Atualizar planilha
  PUT https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}
  https://developers.google.com/workspace/sheets/
- sheetsSpreadsheetsValuesBatchClearByDataFilter — Batch Spreadsheets Values Clear By Data Filter
  POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter
  https://developers.google.com/workspace/sheets/
- sheetsSpreadsheetsValuesBatchGet — Batch Spreadsheets Values Get
  GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet
  https://developers.google.com/workspace/sheets/
- sheetsSpreadsheetsValuesBatchClear — Batch Spreadsheets Values Clear
  POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClear
  https://developers.google.com/workspace/sheets/
- sheetsSpreadsheetsValuesBatchUpdate — Batch Spreadsheets Values Update
  POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdate
  https://developers.google.com/workspace/sheets/
- sheetsSpreadsheetsValuesBatchGetByDataFilter — Batch Spreadsheets Values Get By Data Filter
  POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter
  https://developers.google.com/workspace/sheets/
- sheetsSpreadsheetsValuesClear — Spreadsheets Values Clear
  POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear
  https://developers.google.com/workspace/sheets/
- sheetsSpreadsheetsValuesBatchUpdateByDataFilter — Batch Spreadsheets Values Update By Data Filter
  POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter
  https://developers.google.com/workspace/sheets/
- sheetsSpreadsheetsValuesAppend — Spreadsheets Values Append
  POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append
  https://developers.google.com/workspace/sheets/
- sheetsSpreadsheetsDeveloperMetadataGet — Consultar planilha
  GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/developerMetadata/{metadataId}
  https://developers.google.com/workspace/sheets/
- sheetsSpreadsheetsDeveloperMetadataSearch — Pesquisar planilhas
  POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/developerMetadata:search
  https://developers.google.com/workspace/sheets/
- sheetsSpreadsheetsSheetsCopyTo — Copiar planilha
  POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/sheets/{sheetId}:copyTo
  https://developers.google.com/workspace/sheets/

## Uma boa primeira pergunta
Resuma os números da planilha de vendas.

## Se falhar
Verifique a conta, autorizações expiradas, aprovação do aplicativo, escopos do provedor e permissões do Toolcape. Envie ao suporte apenas erros sem dados sensíveis. Nunca cole senhas, tokens ou chaves secretas em uma conversa com IA.