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

Recurso/Função

Visão Geral

Cada conector é um servidor do 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, ele 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.
• Atuar em outro lugar. Permita que o assistente complete tarefas dentro de um serviço conectado.
• Expandir 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 da Factorial TI ou com a orientação da sua própria empresa. Para isso, use itens da base de conhecimento.

Antes de começar

• Para adicionar, editar, reautenticar ou excluir conectores, ou para alterar as permissões das ferramentas, você precisa da permissão Gerenciar agentes de IA. Para vê-los, Visualizar 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 Clientes. Nesse caso, registre a Factorial TI 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 você conceder acesso, retornará à Factorial TI e o conector mostrará Conectado.

Statuses do conector

Visualizar um conector

A aba Conectores mostra primeiro os conectores integrados (Factorial TI 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ê precisará 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 ferramenta" abaixo.

A lista de ferramentas é buscada do servidor MCP toda vez que você abre a página, então sempre corresponde ao que o servidor atualmente oferece. 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 continua utilizável.

Conectores integrados não têm Configurações e nem 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:

• Reautenticar: faça login no servidor MCP novamente. 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é desligá-lo nesse agente.

Definir permissões de ferramenta

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

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

Ambas as seções agrupam ferramentas em Ferramentas somente leitura e Ferramentas de leitura e 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 e 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 adiciona no futuro e substitui quaisquer configurações individuais de 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é você alterá-las:

Isso significa que os agentes podem usar ferramentas de leitura e escrita imediatamente. Para manter os agentes limitados à leitura em um conector, defina Ferramentas de leitura e 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 escreve ou altera 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 > Reautenticar.
• O conector permanece em Pendente de autenticação. A autenticação não foi concluída. Reautentique e finalize 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. Desligue-o nesse agente primeiro.
• A conexão falha em um servidor sem Registro Dinâmico de Clientes. Registre a Factorial TI 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. Visualizar 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 ferramenta.
    
3. Como a Factorial TI decide se uma ferramenta é somente leitura?
   Apenas ferramentas que o servidor MCP marca com readOnlyHint são somente leitura. Qualquer outra ferramenta é de leitura e escrita.
    
4. Por que não há Exigir 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 é mostrado novamente.