Configurações
MCP
Credenciais que dão a um operador de IA o acesso — e agora a operação — de um agente do Hub.
Nesta página
- Onde fica
- Emitir uma credencial
- Escopos
- Conectar o operador de IA
- Tarefas do Kanban
- Projetos
- Servidores
- Alertas de infraestrutura
- Certificados SSL
- Organograma
- O que o operador de IA faz com o escopo de administração
- O que o operador de IA faz com o escopo de escrita
- Alterar uma credencial que já existe
- Acompanhar, revogar e excluir
A tela MCP emite as credenciais que permitem a um operador de IA — Grok, Claude, n8n ou qualquer outro — consultar e operar o Hub por conta própria — chamados e tarefas do Kanban — em vez de alguém copiar e colar informação para dentro de um chat. A credencial pertence a um agente: o robô enxerga exatamente os chamados que aquela pessoa enxerga e nada além disso.
Onde fica
Em Configurações, abra MCP. Exige a permissão Gerenciar as credenciais de MCP; administradores já a têm.
Emitir uma credencial
- Clique em Nova credencial.
- Em Nome da credencial, descreva onde ela vai ser usada (ex.: Grok Bot — Operação). É esse nome que aparece na lista e no histórico.
- Escolha o Agente. O operador de IA passa a agir como essa pessoa. Emitir no nome de outro agente é privilégio de administrador; quem tem só a permissão emite para si mesmo.
- Em Expira em (dias), defina um prazo ou deixe em branco para Sem expiração.
- Confira os Escopos e clique em Emitir credencial.
O token aparece uma única vez, no bloco Copie o token agora. O Hub guarda só um resumo criptografado dele — se perder, não há como recuperar: revogue e emita outra.
Escopos
- Leitura — chamados, tarefas, projetos e menções — disponível. Consulta, sem alterar nada. Inclui a leitura dos servidores, para quem tiver também a permissão de Infraestrutura.
- Escrita interna — opera chamados, tarefas e projetos — disponível, marcado com age como o agente.
- WhatsApp com o cliente — ler o inbox e responder conversa já aberta — disponível. Separado da escrita interna porque mensagem entregue ao cliente não se desfaz.
- Chat interno — ler e escrever nas conversas do agente dono da credencial — disponível. Separado dos demais, inclusive da leitura: o chat é a conversa privada do agente, e uma credencial só passa a alcançá-la quando alguém marca este escopo.
- Administração — agentes, webhooks de saída e credenciais de MCP — disponível. Separado de todos os outros: é o escopo que muda quem tem acesso ao Hub e por onde o dado sai dele. Veja O que o operador de IA faz com o escopo de administração, abaixo.
- Falar com o cliente — responder por e-mail e pedir aprovação — marcado como em breve.
Os escopos separam por consequência, não por módulo: consultar, agir dentro de casa, e escrever para o cliente. Não existe escopo por área — quem decide se esta credencial alcança projetos ou só chamados é a permissão do próprio agente dono dela. Aponte o token para quem já tem o acesso certo e o escopo faz o resto.
Marcar Escrita interna inclui a leitura automaticamente — a tela marca e trava a Leitura —, porque toda ação começa por encontrar o que vai alterar. O WhatsApp com o cliente não inclui: ele sozinho já deixa o operador de IA ler o inbox e responder, sem alcançar chamados, tarefas e projetos. O escopo de falar com o cliente aparece desabilitado de propósito — enquanto a operação não existir, uma credencial com esse poder seria poder no papel.
Dê Escrita interna só a credencial que precisa mesmo agir. Dentro desse escopo o operador de IA tem o mesmo poder do agente dono do token: encerrar chamado, trocar responsável, lançar horas, mover tarefa, mudar o status de um projeto e excluir qualquer um dos três.
Conectar o operador de IA
O bloco do topo traz as duas informações que qualquer cliente de MCP pede: o Endereço do servidor e a Autenticação (Authorization: Bearer <token>). Cole as duas na configuração do seu operador e ele descobre sozinho o que sabe fazer.
Perguntas que o robô já responde: o que há na fila da pessoa agora, onde ela foi mencionada (a mesma lista do sino, cobrindo chamado, tarefa e problema), quais chamados estão com SLA vencido ou em atenção, o resumo e a conversa de um chamado pelo número, o histórico de mudanças, as horas lançadas e quais chamados ficaram sem classificação — aqueles em que a cadeia Serviço → Categoria → Sub-Categoria não foi concluída, que é o que aparece como Não classificado nos relatórios e deixa o chamado de fora do agrupamento por Problema e do BI por serviço.
Tarefas do Kanban
O operador de IA também enxerga e opera o Kanban de desenvolvimento: listar tarefas por projeto, empresa, grupo, etapa ou responsável, abrir a ficha de uma tarefa com o briefing, as datas, as dependências e há quantos dias ela está parada na etapa atual, ler os comentários e responder "o que eu tenho para fazer" pela fila de prazos. Com o escopo de escrita, ele ainda cria tarefa avulsa, altera título, briefing, projeto, datas e horas, move de etapa, define responsáveis, comenta, vincula uma pull request, recusa com motivo e exclui.
A tarefa é identificada pelo id, não pelo número do chamado. Tarefa Concluída ou Rejeitada fica somente-leitura: para editar, mova antes para uma etapa ativa.
Mover para "Aguardando aprovação" não aciona o cliente. A solicitação é criada, mas o envio do e-mail continua sendo o seu clique em Enviar solicitação ao cliente, na tela da tarefa. Comentário de tarefa também é sempre interno — o cliente não o vê no portal.
Projetos
O operador de IA também acompanha a carteira de projetos: listar com filtros de status, empresa, gestor e prazo, abrir a ficha com a equipe, as datas e as horas, ver em quais projetos a pessoa está envolvida e — o mais útil — pedir o diagnóstico de um projeto, que traz o semáforo de saúde com os motivos e a previsão de término calculada pelo ritmo de entrega. É o mesmo cálculo que a tela do projeto mostra.
Com o escopo de escrita, ele ainda cria projeto, altera nome, descrição, empresa, gestor, datas e orçamento de horas, muda o status, define a equipe e exclui.
As tarefas de um projeto não saem na ficha dele: peça a lista de tarefas filtrando pelo projeto — e lá dá para pedir só as vencidas, as sem prazo, as sem responsável ou as que estão paradas há N dias na etapa atual. E definir a equipe substitui a equipe inteira — para acrescentar alguém, mande a lista completa com o novo integrante. O gestor nunca sai por aí; trocá-lo é alterar o projeto.
Excluir um projeto faz uma de duas coisas, conforme ele já ter começado. Projeto que nunca saiu do papel é apagado junto com as tarefas; projeto que já rodou não é destruído — volta para Rascunho e solta as tarefas e os chamados, que passam a existir sem projeto. Antes de executar, o robô informa qual dos dois vai acontecer.
A aprovação do cliente fica fora. O operador de IA não coloca projeto em Aguardando aprovação nem o marca como Aprovado: pedir o aceite e registrá-lo são ações suas, na tela do projeto. Marcar "Aprovado" por fora seria registrar no Hub uma decisão que o cliente não tomou.
Servidores
O operador de IA consulta e gerencia o parque de servidores: listar com filtros de empresa, ambiente, papel e estado do agente, abrir a ficha com sistema operacional, hardware, última medição de CPU, memória e disco, os monitores configurados, e pedir a série de métricas hora a hora — com média e pico de cada hora, que é o que revela saturação. O panorama responde "como está a infraestrutura agora" numa chamada só: quantos reportam, quantos pararam, quantos estão com o agente desatualizado, e quem são.
Ele também devolve a saúde de um servidor, ou do parque inteiro de uma vez: um semáforo com os motivos — agente sem reportar, monitor em estado ruim, CPU, memória ou disco acima do limite configurado. Disco acima do limite conta como crítico e CPU como atenção, porque CPU em 100% numa medição volta sozinha e disco cheio não volta.
Verde quer dizer "nada detectado", não "saudável". Servidor sem monitor e sem limite definido nunca vai acusar problema nenhum. Por isso toda resposta de saúde informa a cobertura: quantos monitores ativos existem e quais limites estão definidos.
Com o escopo de escrita, ele gerencia o monitoramento: edita o cadastro do servidor (nome, empresa, ambiente, papéis, tags, local, sistema operacional, hardware declarado e ativo/inativo), ajusta os limites de alerta de CPU, memória e disco, e cria, edita, pausa ou remove monitores. O hostname e o IP privado continuam fora: quem os define é o agente instalado.
Nada disso executa comando no servidor. O operador de IA não reinicia serviço, não reinicia a máquina e não roda script — o Hub não tem esse canal. Ele gerencia o cadastro e o que se observa. Pedir "reinicia o serviço" vai receber essa resposta, não uma tentativa.
Para calar um alerta durante uma manutenção, o caminho é pausar o monitor, não excluir: pausado, ele para de ser avaliado e a configuração fica inteira para quando voltar.
Alertas de infraestrutura
O operador de IA lista os alertas em aberto — monitor em estado ruim e certificado SSL, domínio, token de API ou licença vencendo — com o recurso, o prazo e, principalmente, se o alerta já virou chamado. Alerta sem chamado é alerta sem dono, e é o que ele consegue achar para você.
Ele também transforma um alerta em chamado, com assunto e descrição montados a partir dos fatos do alerta. O chamado fica vinculado ao alerta: o mesmo alerta não vira dois chamados, e uma segunda tentativa recebe de volta o número do chamado que já existe.
Abrir o chamado exige informar o contato solicitante, e a empresa vem do servidor do recurso. Isso não envia e-mail ao cliente: o chamado é aberto internamente.
Os demais blocos do módulo — domínios, licenças, bancos e ranges de IP — não têm consulta própria: eles aparecem para o operador de IA apenas como alerta.
Certificados SSL
O operador de IA consulta a carteira de certificados: domínio, emissor, provedor, data de vencimento, dias restantes, se a renovação é automática, quando o Hub verificou o domínio pela última vez e qual servidor está vinculado. Dá para pedir um recorte por janela — o que vence nos próximos 30 ou 60 dias — ou só o que está com problema.
Esta é a única forma de o operador de IA ver a carteira inteira. O alerta de infraestrutura só nasce quando o certificado já está crítico (7 dias ou menos), vencido ou com erro de verificação. A faixa de atenção — de 8 a 30 dias, que é justamente quando ainda dá para renovar com calma — não gera alerta nenhum e só aparece aqui e no panorama.
O panorama passou a trazer o resumo junto do parque: quantos estão vencidos, críticos e em atenção, quantos nunca foram verificados, quantos estão sem servidor vinculado e — o número que importa — quantos estão vencendo sem renovação automática, que são os que viram trabalho de alguém.
Três avisos que o robô devolve e que vale entender:
- Erro na verificação é falha da sondagem, não do certificado: o Hub não conseguiu falar com o domínio (firewall, DNS, site fora do ar). O certificado em si pode estar perfeito.
- Nunca verificado quer dizer que o Hub jamais sondou aquele domínio — a data de vencimento é a que alguém digitou no cadastro, e pode estar errada.
- Datas divergentes aparece quando a data cadastrada à mão não bate com a que o domínio respondeu, quase sempre porque o certificado foi renovado e ninguém atualizou o cadastro. A contagem de dias usa a data lida do domínio.
O operador de IA não renova certificado — renovar é ato no provedor, fora do Hub — e também não altera o cadastro deles. Aqui ele só consulta.
Certificado é permissão própria, separada da de servidores: para liberar, dê ao agente Gerenciar certificados SSL em Configurações → Agentes. Sem ela, o panorama avisa que os certificados ficaram de fora — em vez de dar a entender que não há nenhum vencendo.
O Cofre fica inteiramente fora. Senha, usuário de acesso e o token do agente nunca aparecem em nenhuma resposta. As Observações e Anotações do servidor, por serem texto livre onde alguém pode ter colado uma credencial, só chegam ao operador cujo agente já poderia abrir o Cofre na tela — os demais recebem apenas o aviso de que existe conteúdo ali.
O acesso a servidores é permissão própria: um agente pode operar chamados o dia inteiro sem enxergar o parque. Para liberar, dê a ele Ver os Servidores e métricas ou Ver apenas os Servidores do próprio grupo, em Configurações → Agentes.
Organograma
O operador de IA lê a hierarquia de gestão da empresa — a mesma de Empresa → Organograma. Ele responde "quem é o gestor de fulano", "quem está abaixo de beltrano" e "a quem escalar isto" sem ninguém precisar dizer, e consegue tanto a árvore inteira quanto a ficha de uma pessoa só: cargo, equipe, gestor, a cadeia inteira até o topo, os subordinados diretos e os pares — quem reporta ao mesmo gestor, que é a resposta para "quem cobre essa pessoa".
Três coisas que ele devolve de propósito, em vez de esconder:
- Não posicionados — quem está sem gestor e sem subordinado. Não é um nível da estrutura: é cadastro faltando.
- Sem cargo — quantas pessoas estão com o cargo em branco. Para essas, o organograma diz a quem reportam, mas não o que fazem.
- Ciclo — quando A está cadastrado como gestor de B e B como gestor de A. A pessoa marcada assim não é o topo da empresa: é onde o desenho precisou começar.
Nenhum dado de RH sai junto. CPF, matrícula, data de admissão, regime de contratação e valor/hora não são expostos a operador de IA nenhum, em nenhuma consulta. O que ele enxerga de uma pessoa é o mesmo que a tela do organograma mostra: nome, cargo, e-mail, equipe e se ela está ativa.
Não é preciso liberar permissão nenhuma — o organograma é leitura interna, aberta a qualquer agente, e o operador enxerga o que o agente dono da credencial enxergaria. Alterar o organograma continua sendo coisa de tela: religar alguém a outro gestor exige a permissão de gerenciar agentes e se faz arrastando a pessoa no desenho.
Com a credencial certa, o operador de IA lê a fila do inbox de WhatsApp e consegue responder o cliente e avisar um colega. São coisas diferentes e não se misturam.
- Responder o cliente exige o escopo WhatsApp com o cliente e a permissão Responder conversas do agente dono do token. Só vale para conversa já aberta: o robô não puxa assunto com ninguém, e conversa encerrada não aceita resposta. A mensagem sai assinada com o nome do agente dono da credencial e entra na thread, igual à que você digita na tela.
- Avisar um agente usa o escopo Escrita interna e manda um WhatsApp para o telefone cadastrado da pessoa — é o canal de alerta (SLA estourando, servidor fora do ar, aprovação parada). O aviso chega identificado como vindo de um operador de IA, com o nome de quem é dono da credencial, e não abre conversa no inbox. Avisar mais de uma pessoa de uma vez exige confirmação.
- Chat interno exige o escopo Chat interno: o robô lista e lê as conversas do agente dono do token (e só as dele), escreve para um colega ou numa conversa em que o agente já está, e marca conversa como lida. A mensagem sai em nome do agente e avisa o destinatário no sino e na tela do computador. Criar ou administrar grupo e apagar mensagem continuam só na tela.
Quem não tem telefone no cadastro não recebe aviso, e o operador de IA é informado de quem ficou de fora. Se nenhum número de WhatsApp estiver conectado em Configurações → Integrações, nada sai — nem alerta, nem resposta.
Não existe apagar nem editar mensagem de WhatsApp pelo operador de IA: o cliente já leu. Em caso de erro, a correção é mandar outra mensagem.
O que o operador de IA faz com o escopo de administração
Com Administração marcada, o operador de IA passa a cuidar de três telas de Configurações. O escopo abre a porta; o que ele alcança em cada uma continua sendo a permissão do agente dono da credencial — Gerenciar agentes, Gerenciar os webhooks de saída e Gerenciar as credenciais de MCP. Para dar a um robô só uma dessas rotinas, emita a credencial em nome de um agente que tenha só aquela permissão.
- Agentes — listar (inclusive os desativados), ver o cadastro, criar, alterar, ativar, desativar e excluir. Criar um agente a partir de outro copia cargo, equipe, gestor, permissões e configuração de fila. A senha nunca passa pelo robô: o Hub gera uma provisória e envia por e-mail ao próprio agente.
- Webhooks — listar, cadastrar, alterar, ligar, desligar, excluir, enviar teste, consultar o log de disparos e reenviar uma entrega.
- Credenciais de MCP — listar, emitir, alterar nome, escopos e validade, revogar, excluir, copiar o token, gerar token novo e consultar a trilha de chamadas.
O que continua só na tela
- Marcar o escopo Administração numa credencial. O operador de IA só concede escopo que a credencial dele já tem, e nunca este.
- Emitir credencial Sem expiração. A que o robô emite sempre tem prazo — 90 dias quando ele não informa.
- Dar o papel de administrador, trocar o e-mail de um administrador e mexer em senha.
- Conceder as permissões do Cofre de senhas, do Terminal, do acesso remoto, do MCP, dos webhooks e de gerenciar agentes, grupos e integrações. Retirar qualquer uma delas o robô pode.
- CPF, matrícula, admissão, regime de contratação, valor/hora e férias do agente.
- O conteúdo de uma entrega de webhook e o valor de um cabeçalho próprio do destino.
O webhook que o operador de IA cadastra nasce desativado: nada sai do Hub até alguém ligá-lo, pelo robô ou pela tela. Cada ação que cria acesso, liga um webhook ou entrega um token pede confirmação explícita e gera um aviso no sino de todos os administradores.
O operador de IA só copia ou troca o token de uma credencial quando a dele tem todos os escopos dela. Token e segredo de webhook aparecem uma única vez, na resposta de quem criou.
O que o operador de IA faz com o escopo de escrita
Com Escrita interna liberada, ele passa a operar o chamado como o agente faria na tela: abrir chamado novo, mudar status, prioridade, responsável, grupo, projeto, empresa, solicitante e campos personalizados, registrar anotação privada ou pública, corrigir e apagar anotação interna, promover chamado da triagem, reabrir chamado encerrado, enviar para desenvolvimento, assumir o próximo da fila, lançar e corrigir horas, agrupar chamados num problema, cadastrar contato e excluir chamado.
As mesmas regras da tela continuam valendo — ele não fecha chamado com campo obrigatório vazio, não mexe em chamado travado por tarefa do Kanban e não altera o que a permissão do agente não permitiria. Quando a regra impede, o robô recebe o motivo em português, igual ao aviso que aparece na tela.
Ações de maior consequência pedem uma confirmação explícita antes de executar: encerrar chamado, trocar a empresa, excluir, reabrir, agrupar em problema, enviar para desenvolvimento e qualquer ação em lote. Na primeira tentativa o robô recebe a descrição do que faria e nada é alterado; só depois de confirmar a ação acontece. Ação em lote vai até 50 chamados por vez.
Responder ao cliente por e-mail continua fora. Uma anotação pública fica visível no portal do cliente, mas não dispara e-mail; e mensagem já enviada ao cliente não pode ser editada nem apagada pelo operador de IA. Isso depende do escopo de e-mail, ainda indisponível.
Alterar uma credencial que já existe
Credencial Ativa tem o botão Alterar, que abre o mesmo formulário para mudar o Nome, os Escopos e a validade. É assim que se libera a escrita para um operador que já está rodando: o token continua o mesmo, então não é preciso reconfigurar nada do lado do robô nem conviver com duas credenciais para o mesmo operador.
O Agente dono não muda — para isso, emita outra credencial. Credencial Revogada ou Expirada também não se altera: o segredo dela já saiu de uso.
Nessa mesma tela, em Token de acesso, há duas ações:
- Copiar token — manda o token para a área de transferência sem exibi-lo na tela. Serve para quando você precisa configurar o operador de IA de novo e não tem mais o valor anotado. Não muda nada na credencial.
- Gerar novo token — troca o segredo mantendo a mesma credencial: nome, escopos e histórico continuam. O token anterior para de funcionar na hora, então o operador de IA fica fora do ar até você colar o novo na configuração dele. Use quando suspeitar que o token vazou.
Credencial emitida antes de 07/11/2026 não tem o botão de copiar: o Hub não guardava o token, e não há como recuperá-lo. Para essas, o caminho é Gerar novo token. Toda cópia e toda troca ficam registradas em Últimas chamadas, com quem fez e quando.
Toda mudança de escopo fica registrada em Últimas chamadas, com o antes, o depois e quem alterou. Assim dá para responder depois por que o operador de IA passou a mexer nos chamados a partir de certo dia.
Acompanhar, revogar e excluir
A lista mostra cada Credencial com o Agente dono, a Situação (Ativa, Expirada ou Revogada) e o Último uso. Em Revogar, a credencial para de funcionar na chamada seguinte.
Credencial que já não abre porta — Revogada ou Expirada — ganha no lugar o botão Excluir, que a tira da lista. Credencial Ativa não tem esse botão: para sumir com ela, revogue antes. É assim de propósito — esconder da tela uma credencial que ainda funciona deixaria o operador de IA acessando o Hub sem nada aqui denunciando que ela existe.
Abaixo, Últimas chamadas registra o que o operador de IA fez: Quando, qual Ferramenta usou, o Resultado e o Tempo de resposta. Quem opera do outro lado é um programa, então toda chamada fica registrada — inclusive as recusadas.
Excluir uma credencial não apaga o histórico dela: as chamadas que ela fez continuam em Últimas chamadas, com o nome da credencial. Desativar o agente no cadastro também derruba as credenciais dele: o Hub confere a pessoa a cada chamada, não só na emissão.