# Toolcape + Cloud Services

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
Cloud Services: Controla quais APIs do Google estão ativadas em um projeto de nuvem.
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: Listar APIs ativadas
- Alterar: Ativar ou desativar uma API
Desativar uma API pode interromper aplicativos. Reserve alterações à equipe de TI responsável.

## 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.
- serviceusageServicesEnable — Services Enable
  POST https://serviceusage.googleapis.com/v1/{+name}:enable
  https://cloud.google.com/service-usage/
- serviceusageServicesDisable — Services Disable
  POST https://serviceusage.googleapis.com/v1/{+name}:disable
  https://cloud.google.com/service-usage/
- serviceusageServicesBatchGet — Batch Services Get
  GET https://serviceusage.googleapis.com/v1/{+parent}/services:batchGet
  https://cloud.google.com/service-usage/
- serviceusageServicesGet — Get Services
  GET https://serviceusage.googleapis.com/v1/{+name}
  https://cloud.google.com/service-usage/
- serviceusageServicesBatchEnable — Batch Services Enable
  POST https://serviceusage.googleapis.com/v1/{+parent}/services:batchEnable
  https://cloud.google.com/service-usage/
- serviceusageServicesList — List Services
  GET https://serviceusage.googleapis.com/v1/{+parent}/services
  https://cloud.google.com/service-usage/
- serviceusageOperationsCancel — Operations Cancel
  POST https://serviceusage.googleapis.com/v1/{+name}:cancel
  https://cloud.google.com/service-usage/
- serviceusageOperationsGet — Get Operations
  GET https://serviceusage.googleapis.com/v1/{+name}
  https://cloud.google.com/service-usage/
- serviceusageOperationsDelete — Delete Operations
  DELETE https://serviceusage.googleapis.com/v1/{+name}
  https://cloud.google.com/service-usage/
- serviceusageOperationsList — List Operations
  GET https://serviceusage.googleapis.com/v1/operations
  https://cloud.google.com/service-usage/

## Uma boa primeira pergunta
Quais APIs estão ativadas neste projeto?

## 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.