Conectando ao Performance Hub

O que diferencia o seu Agente de IA de um chatbot genérico é que ele está conectado ao seu negócio. Por meio da conexão MCP do Performance Hub, o agente pode consultar clientes e membros, verificar reservas e visitas, revisar a integridade de dispositivos, gerar relatórios — os mesmos dados operacionais que você vê no Performance Hub, disponíveis para o agente na conversa e em suas automações.

Você controla exatamente quanto do Performance Hub o agente pode alcançar: quais instalações, quais capacidades e até quais ferramentas individuais. Esta página explica as opções.

O acesso MCP é configurado em Gerenciamento de dispositivos em Configuração → Acesso MCP.

Figura 1: A seção de acesso MCP — escopo de acesso, capacidades e o botão liga/desliga

Referência rápida

Recomendação: Deixe o acesso MCP ligado (o padrão). A conexão é o que torna o agente genuinamente útil para o seu negócio e, por padrão, ela é restrita com segurança apenas à instalação onde o agente foi adicionado. Se posteriormente você precisar que o agente trabalhe com dados mais amplos — vários locais, uma região ou a organização inteira —, amplie o Escopo de acesso em vez de operar sem a conexão. "Se isso estiver desligado, o agente não poderá acessar nenhum recurso, ferramenta ou dado do Performance Hub."

O que a conexão fornece ao agente

MCP (Model Context Protocol) é o padrão aberto que o agente usa para chamar o Performance Hub: "Permitir que este agente chame ferramentas do Performance Hub por meio de uma conta de serviço. Nenhuma chave é armazenada no dispositivo — o acesso é verificado a cada solicitação e revogado no momento em que você desliga isso." Na prática, significa que você pode fazer perguntas como:

• "Quantos visitantes fizeram check-in na recepção esta semana em comparação com a semana passada?"
• "Quais controladores de porta estão off-line agora?"
• "Encontre o cliente cujo pagamento falhou ontem e faça um resumo da conta dele."

…e o agente responde com base nos dados ao vivo do Performance Hub, limitados ao que você concedeu. A mesma conexão alimenta automações — um resumo matinal das reservas de ontem, um resumo semanal da integridade de dispositivos — e o manual de procedimentos operacionais integrado descrito em Habilidades.

O agente atua com sua própria identidade no Performance Hub (uma conta de serviço vinculada ao dispositivo), e não como uma pessoa específica. Cada chamada feita por ele é verificada em relação ao acesso concedido aqui, no lado do Performance Hub — a concessão é aplicada de forma centralizada, e não com base na confiança.

Escopo de acesso — quais instalações o agente pode ver

• Esta instalação (padrão) — a instalação à qual o agente foi adicionado. Adequado para um agente de local único.
• Instalações selecionadas — apenas as instalações listadas por você. Útil para um agente que atende a alguns locais.
• Regiões — todas as instalações nas regiões selecionadas. Útil para o agente de um gerente regional.
• Organização inteira — tudo. Adequado para agentes da matriz que fazem relatórios entre locais.

"Você só pode conceder acesso dentro de suas próprias instalações, regiões e permissões."

Capacidades — o que o agente pode usar

As capacidades são grupos de ferramentas vinculadas aos módulos do Performance Hub.

• Todas as capacidades (padrão) — "O agente pode usar todas as capacidades disponíveis, incluindo novas capacidades à medida que forem adicionadas."
• Apenas capacidades selecionadas — "O agente só pode usar as capacidades que você selecionar abaixo." O agente recebe exatamente essas opções e mais nenhuma, mesmo que suas assinaturas mudem.
• Todas as capacidades, exceto as selecionadas — "O agente pode usar todas as capacidades, exceto aquelas que você selecionar abaixo. As novas capacidades são incluídas automaticamente." Um bom meio-termos: utilidade completa, com (por exemplo) o faturamento excluído.

A seção também possui um interruptor somente leitura: ative-o e o agente poderá consultar informações, mas não poderá alterar nada, pois as ferramentas que realizam alterações ficam ocultas e são recusadas. Essa é a maneira mais simples de executar um agente estritamente informativo.

Seleção de ferramentas (avançado)

Para um controle refinado, expanda Avançado e escolha uma Seleção de ferramentas — Apenas ferramentas selecionadas ou Todas, exceto as ferramentas selecionadas — para incluir ou excluir ferramentas individuais dentro das capacidades concedidas. Por exemplo, você pode permitir consultas de clientes, mas excluir atualizações de clientes. A maioria das instalações nunca precisa disso; o controle em nível de capacidade é a granularidade prática.

Última atualização por mostra quem alterou a concessão pela última vez.

Uma nota sobre ações de gravação

A menos que você ative a chave de somente leitura, a autorização cobre tudo o que as capacidades expõem — incluindo ações que alteram dados, e não apenas os leem, quando um módulo as oferece. Para manter o agente informativo, use a chave de somente leitura, restrinja-o a capacidades orientadas a relatórios ou exclua ferramentas específicas. O agente também confirma ações significativas na conversa antes de executá-las.

Desativação e revogação de acesso

• Desative o MCP access e o agente perderá imediatamente a conexão com o Performance Hub — ele continuará funcionando como um assistente geral com seus arquivos e Memory, mas não poderá mais ver os dados da sua empresa. As alterações (ativar, desativar ou editar o escopo) entram em vigor instantes após salvar; nada precisa ser reiniciado.
• Remover ou redefinir o agente revoga totalmente suas credenciais.

Quem pode conceder o quê

As concessões são limitadas a quem as concede: o escopo e as capacidades que você possui na Organização representam o limite máximo do que você pode delegar ao agente. Se uma opção estiver indisponível, é porque a sua própria função não a inclui — um administrador com o acesso necessário poderá configurá-la. Se você não conseguir alterar o MCP access de forma alguma, a seção exibirá "Você não tem permissão para configurar o acesso MCP para este dispositivo."

Páginas relacionadas

• Skills — o manual operacional que coloca esta conexão em funcionamento
• Agent capabilities — conectando o agente aos seus outros aplicativos
• Automations & scheduled tasks — tarefas não supervisionadas que usam dados do Performance Hub
• Access control — quem pode conversar com o agente (uma questão separada do que o agente pode acessar)
• Security & privacy