Privacidade e alcance

Uma resposta, uma empresa

Ao autorizar você escolhe quais empresas a conexão pode consultar. Se você administra uma só, é essa. Se administra várias, marca as que quiser e depois se move entre elas na mesma conversa, sem entrar de novo.

Esse conjunto fica fixado na credencial e não dá para ampliá-lo pelo assistente: pedir uma empresa que você não marcou é recusado, exista ela ou não. Cada chamada responde sobre uma só delas; o servidor nunca mistura duas empresas numa mesma resposta.

Se a conexão cobre várias e a pergunta não deixa claro qual, o servidor não escolhe por você: responde com a lista para que o assistente pergunte. Uma resposta sobre a empresa errada se lê perfeita e não avisa de nada, e isso é pior do que não responder. get_context é a maneira de confirmar, antes de responder qualquer coisa, quais empresas esta conexão alcança.

O vínculo é revalidado a cada chamada contra as empresas que essa pessoa ainda tem atribuídas como staff — não só ao autorizar. Tirar de alguém o papel de staff em uma empresa corta o acesso MCP dela àquela empresa no mesmo instante, sem precisar revogar nada à parte. Perder uma de cinco deixa as outras quatro funcionando; perder todas fecha a conexão.

Somente leitura, exceto por um pedido de relatório

Das 22 ferramentas, 21 são leituras. A única exceção é request_report, que enfileira um trabalho para gerar um Excel ou CSV. Nenhuma ferramenta apaga nem modifica dados da empresa.

Os dados pessoais estão atrás de duas chaves independentes

Nomes, e-mails, telefones e números de documento não aparecem por padrão. Para que apareçam, as duas chaves precisam estar abertas ao mesmo tempo:

1. A do deployment — a variável MCP_EXPOSE_PII na hackÜ que responde. Ela vem desligada. Ligá-la manda dados pessoais de colaboradores de clientes corporativos para o modelo que o staff estiver usando, então exige que esse fornecedor seja um subprocessador declarado com DPA assinado antes de ativá-la.
2. A do scope da credencial — users:pii, concedido por pessoa.

As duas existem para que uma credencial possa servir a perguntas agregadas ou painéis sem nunca expor o telefone de alguém, e para que revogar esse alcance não implique revogar a integração inteira.

Toda resposta que pode incluir esses campos traz pii_included: true|false explícito. Quando é false, as pessoas vêm identificadas apenas por user_id.

A segmentação recorta antes de responder

Se o staff que autorizou a credencial está restrito a um segmento da empresa (segment_restriction), as ferramentas de pessoas devolvem apenas essa parcela — não a empresa inteira. get_context expõe esse limite explicitamente, e várias respostas (list_users, get_company_overview) incluem uma nota esclarecendo que as contagens são do segmento, não da companhia completa. Apresentar esse número como se fosse o total da empresa é um erro de leitura, não um limite dos dados.

Os relatórios vão para o e-mail da pessoa, nunca para a conversa

request_report não devolve o conteúdo do arquivo. Ele enfileira um trabalho, manda o link de download para o e-mail do staff que pediu, e esse link exige o login próprio dela na hackÜ para abrir — o modelo não consegue lê-lo nem se quisesse. É deliberado: os dados pessoais de um relatório passam pelo e-mail e pelo login da pessoa, nunca pelo chat.

Dica

Se um pedido usa um report_type fora da lista válida (users, users_csv, evaluations, evaluations_detail, surveys, ssaa, point_logs, pensum_users, finished_courses), ou se já existe um idêntico em andamento, a hackÜ recusa — veja Problemas comuns.