# Toolcape + Analytics Admin

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
Analytics Admin: Administração de contas, propriedades e fluxos de dados do Analytics.
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: Consultar configurações de contas e propriedades
- Criar: Criar propriedades ou fluxos compatíveis
- Alterar: Alterar a configuração do Analytics
Este serviço é de administração, não de relatórios de tráfego. Um analista pode precisar apenas dos relatórios do Analytics.

## 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.
- analyticsadminAccountsGetDataSharingSettings — Consultar configuração
  GET https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminAccountsGet — Get Accounts
  GET https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminAccountsDelete — Delete Accounts
  DELETE https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminAccountsPatch — Patch Accounts
  PATCH https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminAccountsSearchChangeHistoryEvents — Pesquisar eventos
  POST https://analyticsadmin.googleapis.com/v1alpha/{+account}:searchChangeHistoryEvents
  
- analyticsadminAccountsList — List Accounts
  GET https://analyticsadmin.googleapis.com/v1alpha/accounts
  
- analyticsadminAccountsProvisionAccountTicket — Accounts Provision Account Ticket
  POST https://analyticsadmin.googleapis.com/v1alpha/accounts:provisionAccountTicket
  
- analyticsadminAccountsRunAccessReport — Accounts Run Access Report
  POST https://analyticsadmin.googleapis.com/v1alpha/{+entity}:runAccessReport
  
- analyticsadminAccountSummariesList — List Account Summaries
  GET https://analyticsadmin.googleapis.com/v1alpha/accountSummaries
  
- analyticsadminPropertiesGet — Get Properties
  GET https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesDelete — Delete Properties
  DELETE https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesPatch — Patch Properties
  PATCH https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesList — List Properties
  GET https://analyticsadmin.googleapis.com/v1alpha/properties
  
- analyticsadminPropertiesCreate — Create Properties
  POST https://analyticsadmin.googleapis.com/v1alpha/properties
  
- analyticsadminPropertiesAcknowledgeUserDataCollection — Properties Acknowledge User Data Collection
  POST https://analyticsadmin.googleapis.com/v1alpha/{+property}:acknowledgeUserDataCollection
  
- analyticsadminPropertiesGetDataRetentionSettings — Consultar prazo de retenção
  GET https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesUpdateDataRetentionSettings — Atualizar prazo de retenção
  PATCH https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesRunAccessReport — Properties Run Access Report
  POST https://analyticsadmin.googleapis.com/v1alpha/{+entity}:runAccessReport
  
- analyticsadminPropertiesConversionEventsGet — Consultar evento
  GET https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesConversionEventsDelete — Excluir evento
  DELETE https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesConversionEventsPatch — Atualizar evento
  PATCH https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesConversionEventsList — Listar eventos
  GET https://analyticsadmin.googleapis.com/v1alpha/{+parent}/conversionEvents
  
- analyticsadminPropertiesConversionEventsCreate — Criar evento
  POST https://analyticsadmin.googleapis.com/v1alpha/{+parent}/conversionEvents
  
- analyticsadminPropertiesGoogleAdsLinksDelete — Delete Properties Google Ads Links
  DELETE https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesGoogleAdsLinksPatch — Patch Properties Google Ads Links
  PATCH https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesGoogleAdsLinksList — List Properties Google Ads Links
  GET https://analyticsadmin.googleapis.com/v1alpha/{+parent}/googleAdsLinks
  
- analyticsadminPropertiesGoogleAdsLinksCreate — Create Properties Google Ads Links
  POST https://analyticsadmin.googleapis.com/v1alpha/{+parent}/googleAdsLinks
  
- analyticsadminPropertiesFirebaseLinksList — List Properties Firebase Links
  GET https://analyticsadmin.googleapis.com/v1alpha/{+parent}/firebaseLinks
  
- analyticsadminPropertiesFirebaseLinksCreate — Create Properties Firebase Links
  POST https://analyticsadmin.googleapis.com/v1alpha/{+parent}/firebaseLinks
  
- analyticsadminPropertiesFirebaseLinksDelete — Delete Properties Firebase Links
  DELETE https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesCustomDimensionsArchive — Properties Custom Dimensions Archive
  POST https://analyticsadmin.googleapis.com/v1alpha/{+name}:archive
  
- analyticsadminPropertiesCustomDimensionsGet — Get Properties Custom Dimensions
  GET https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesCustomDimensionsPatch — Patch Properties Custom Dimensions
  PATCH https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesCustomDimensionsList — List Properties Custom Dimensions
  GET https://analyticsadmin.googleapis.com/v1alpha/{+parent}/customDimensions
  
- analyticsadminPropertiesCustomDimensionsCreate — Create Properties Custom Dimensions
  POST https://analyticsadmin.googleapis.com/v1alpha/{+parent}/customDimensions
  
- analyticsadminPropertiesCustomMetricsGet — Consultar estatística
  GET https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesCustomMetricsPatch — Atualizar estatística
  PATCH https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesCustomMetricsList — Listar estatísticas
  GET https://analyticsadmin.googleapis.com/v1alpha/{+parent}/customMetrics
  
- analyticsadminPropertiesCustomMetricsCreate — Criar estatística
  POST https://analyticsadmin.googleapis.com/v1alpha/{+parent}/customMetrics
  
- analyticsadminPropertiesCustomMetricsArchive — Properties Custom Metrics Archive
  POST https://analyticsadmin.googleapis.com/v1alpha/{+name}:archive
  
- analyticsadminPropertiesDataStreamsList — List Properties Data Streams
  GET https://analyticsadmin.googleapis.com/v1alpha/{+parent}/dataStreams
  
- analyticsadminPropertiesDataStreamsCreate — Create Properties Data Streams
  POST https://analyticsadmin.googleapis.com/v1alpha/{+parent}/dataStreams
  
- analyticsadminPropertiesDataStreamsGet — Get Properties Data Streams
  GET https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesDataStreamsDelete — Delete Properties Data Streams
  DELETE https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesDataStreamsPatch — Patch Properties Data Streams
  PATCH https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesDataStreamsMeasurementProtocolSecretsGet — Consultar segredo
  GET https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesDataStreamsMeasurementProtocolSecretsDelete — Excluir segredo
  DELETE https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesDataStreamsMeasurementProtocolSecretsPatch — Atualizar segredo
  PATCH https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesDataStreamsMeasurementProtocolSecretsList — Listar segredos
  GET https://analyticsadmin.googleapis.com/v1alpha/{+parent}/measurementProtocolSecrets
  
- analyticsadminPropertiesDataStreamsMeasurementProtocolSecretsCreate — Criar segredo
  POST https://analyticsadmin.googleapis.com/v1alpha/{+parent}/measurementProtocolSecrets
  
- analyticsadminPropertiesKeyEventsList — Listar eventos
  GET https://analyticsadmin.googleapis.com/v1alpha/{+parent}/keyEvents
  
- analyticsadminPropertiesKeyEventsCreate — Criar evento
  POST https://analyticsadmin.googleapis.com/v1alpha/{+parent}/keyEvents
  
- analyticsadminPropertiesKeyEventsGet — Consultar evento
  GET https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesKeyEventsDelete — Excluir evento
  DELETE https://analyticsadmin.googleapis.com/v1alpha/{+name}
  
- analyticsadminPropertiesKeyEventsPatch — Atualizar evento
  PATCH https://analyticsadmin.googleapis.com/v1alpha/{+name}
  

## Uma boa primeira pergunta
Quais sites estão configurados na nossa conta do Analytics?

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