Um conector permite que ONE acesse uma ferramenta que está fora do Factorial IT. Adicione um quando quiser que o assistente procure informações em, ou execute ações em, outro sistema que sua equipe já utiliza.

Funcionalidade

Visão geral

Cada conector é um servidor de Protocolo de Contexto de Modelo (MCP) que você registra pelo seu URL. Quando está conectado, ONE pode chamar as ferramentas que o servidor oferece enquanto você conversa com ele. Por exemplo, pode encontrar uma página no Notion ou realizar uma tarefa em outro serviço.

Razões típicas para adicionar um:

• Buscar dados em outro lugar. Traga informações mantidas por uma ferramenta da qual sua equipe depende.
• Agir em outro lugar. Deixe o assistente concluir tarefas dentro de um serviço conectado.
• Ampliar o que o assistente pode fazer. Conecte qualquer ferramenta que suporte o Protocolo de Contexto de Modelo.

Você não precisa de um conector se o assistente só precisa trabalhar com dados do Factorial IT ou com as orientações da sua própria empresa. Para isso, use itens da base de conhecimento.

Antes de começar

• Para adicionar, editar, re-autenticar ou excluir conectores, ou para alterar as permissões das ferramentas, você precisa da permissão Gerenciar agentes de IA. Para vê-los, Ver agentes de IA é suficiente.
• Você precisa do URL de um servidor MCP que suporte autenticação OAuth.

Como usar

1. Vá para Agentes de IA > Configurações e selecione a aba Conectores.
2. Clique em Adicionar conector. Uma janela se abre.
3. Preencha os detalhes:
   • Nome: como o conector é rotulado, por exemplo Notion.
   • URL do servidor: o endpoint MCP, por exemplo https://example.com/mcp.
4. Abra Configurações avançadas apenas se seu servidor MCP não suportar Registro Dinâmico de Cliente. Nesse caso, registre Factorial IT no console OAuth do provedor e insira o ID do Cliente e o Segredo do Cliente. Clientes públicos que dependem de PKCE podem deixar o segredo em branco.
5. Clique em Conectar. Você será enviado ao servidor MCP para fazer login. Assim que conceder acesso, você retornará ao Factorial IT e o conector mostrará Conectado.

Status dos conectores

Ver um conector

A aba Conectores mostra os conectores integrados primeiro (Factorial IT e o conector do centro de ajuda), seguidos por quaisquer que você tenha adicionado. Conectores integrados estão sempre Conectados. Clique em qualquer conector para abrir sua página.

Na página de um conector que você adicionou, você encontrará:

• Configurações: o Nome, o URL do Servidor e, se você inseriu um, o ID do Cliente. O segredo do cliente nunca é exibido. Use Editar conexão para alterar esses valores. Alterar o URL do servidor ou as credenciais OAuth significa que você terá que autenticar novamente.
• Permissões de chat e Permissões de agente: cada ferramenta que o servidor MCP oferece, cada uma com sua política. Veja "Definir permissões de ferramentas" abaixo.

A lista de ferramentas é buscada do servidor MCP toda vez que você abre a página, portanto, sempre corresponde ao que o servidor oferece atualmente. As ferramentas só aparecem enquanto o conector está Conectado. Se o servidor não responder, você verá um aviso em vez das ferramentas, e Configurações permanecerá utilizável.

Conectores integrados não têm Configurações e nenhum menu de Ações. Você não pode editá-los ou excluí-los, mas pode alterar suas permissões de ferramenta.

Gerenciar um conector

Na página de um conector que você adicionou, use o menu Ações no canto superior direito:

• Re-autenticar: faça login novamente no servidor MCP. Esta opção só aparece quando o conector não está Conectado.
• Excluir: remova o conector junto com suas credenciais salvas, uma vez que você confirme. Se um agente estiver usando o conector, você não poderá excluí-lo até que o desative nesse agente.

Definir permissões de ferramentas

A página do conector controla como ONE pode usar cada ferramenta. Quando o conector está Conectado, suas ferramentas são listadas em duas seções:

• Permissões de chat cobrem suas próprias conversas com ONE.
• Permissões de agente cobrem ONE quando ele trabalha sem supervisão, por exemplo, em um ticket onde você o adicionou como agente. Quando você ativa o conector para um agente personalizado, esse agente mantém uma cópia dessas configurações e a conserva. Alterações feitas aqui depois não alcançam esse agente.

Ambas as seções agrupam ferramentas em Ferramentas somente leitura e Ferramentas leitura-escrita. Uma ferramenta conta como somente leitura apenas se o servidor MCP a marcar com a anotação readOnlyHint. Qualquer outra coisa é tratada como leitura-escrita.

Para definir uma política para um grupo inteiro, use o menu à direita desse grupo. A escolha também se aplica a ferramentas que o servidor adicionar no futuro, e substitui quaisquer configurações de ferramenta a ferramenta no grupo. Para definir uma ferramenta, expanda o grupo e escolha uma política com os ícones ao lado do nome da ferramenta. Quando ferramentas em um grupo têm políticas mistas, o grupo mostra Personalizado.

Políticas padrão, até que você as altere:

Isso significa que os agentes podem usar ferramentas leitura-escrita imediatamente. Para manter os agentes limitados à leitura em um conector, defina Ferramentas leitura-escrita para Sempre recusar sob Permissões de agente. Qualquer agente personalizado que já esteja usando o conector tem sua própria cópia, então atualize-a nesse agente também.

Como ONE usa conectores

Durante uma conversa, ONE tem acesso às ferramentas de cada conector conectado e escolhe a certa para cada solicitação. Para direcioná-lo a um conector específico, digite @ na caixa de mensagem e escolha o conector. ONE verifica as Permissões de chat do conector antes de executar qualquer ferramenta. Por padrão, ele pergunta a você antes de usar uma ferramenta que escreva ou altere dados.

Solução de Problemas e FAQ

Solução de Problemas

• O conector mostra Erro. A conexão falhou. Abra sua página e use Ações > Re-autenticar.
• O conector permanece Pendente de autenticação. A autenticação não foi concluída. Re-autentique e complete o login no servidor MCP.
• Nenhuma ferramenta aparece na página do conector. As ferramentas só aparecem enquanto o conector está Conectado, e o servidor deve responder. Se você ver um aviso, o servidor não respondeu.
• Você não pode excluir um conector. Um agente ainda está usando-o. Desative-o nesse agente primeiro.
• A conexão falha em um servidor sem Registro Dinâmico de Cliente. Registre Factorial IT no console OAuth do provedor e insira o ID do Cliente e o Segredo do Cliente em Configurações avançadas.
• Uma alteração de permissão não alcançou um agente. O agente mantém sua própria cópia. Altere a política dentro do agente.

FAQ

1. Qual permissão eu preciso para adicionar um conector?
   Gerenciar agentes de IA. Ver agentes de IA apenas permite que você veja conectores.
    
2. Posso editar ou excluir os conectores integrados?
   Não. Você só pode alterar suas permissões de ferramentas.
    
3. Como o Factorial IT decide se uma ferramenta é somente leitura?
   Apenas ferramentas que o servidor MCP marca com readOnlyHint são somente leitura. Qualquer outra ferramenta é leitura-escrita.
    
4. Por que não há Requerer aprovação para agentes?
   Um agente opera por conta própria, então ninguém está lá para aprovar a ferramenta.
    
5. Posso ver o segredo do cliente após salvá-lo?
   Não. Ele nunca é exibido novamente.