Para que serve
Ligar uma ferramenta dá à IA do Saga uma nova capacidade que utiliza em seu nome durante as conversas. O fornecedor da ferramenta dá-lhe um endereço web (e por vezes uma credencial), e o Saga trata do resto. Os exemplos incluem bases de dados de investigação, sistemas internos do escritório ou qualquer serviço que suporte o Model Context Protocol.Configurar uma ferramenta (administradores)
Abra o Painel de administração e vá à secção MCP Servers.- Adicione a ferramenta. Clique em Add Server, dê-lhe um nome e cole o endereço web da ferramenta (o seu URL de endpoint). O fornecedor da ferramenta fornece-lhe este endereço.
- Defina como o Saga inicia sessão. Escolha a autenticação que a ferramenta requer:
- None — a ferramenta não necessita de credenciais.
- API Key ou Bearer Token — cole a chave ou o token partilhado que o fornecedor lhe deu. É armazenado de forma segura e nunca mais é mostrado.
- Basic Auth — uma combinação partilhada de nome de utilizador e palavra-passe, introduzida na forma codificada que o fornecedor especificar.
- OAuth 2.1 — introduza os detalhes de cliente OAuth que o fornecedor lhe der, se forem necessários. O servidor é configurado para a organização, mas o início de sessão é pessoal. Cada pessoa deve clicar em Connect para essa ferramenta para ligar a sua própria conta.
- Per-User API Token — cada pessoa introduz o seu próprio token pessoal em vez de uma credencial partilhada do escritório (ver abaixo).
- Teste e ative-a. Use Test Connection para confirmar que o Saga consegue aceder à ferramenta — um teste bem-sucedido lista as capacidades encontradas. Ative Available in Chat para que as pessoas da sua organização possam usá-la.
As credenciais que introduz aqui são armazenadas de forma segura e nunca mais são apresentadas. Se precisar de alterar uma, introduza um novo valor.
Ligar a sua própria conta ou token
Algumas ferramentas estão configuradas para que cada pessoa ligue a sua própria conta ou token em vez de usar uma credencial partilhada do escritório. Isto aplica-se a ferramentas que usam OAuth 2.1 e a ferramentas que usam Per-User API Token.- Vá a Definições > MCPs.
- Encontre a ferramenta na lista.
- Clique em Connect para iniciar sessão com OAuth, ou cole o seu token pessoal se a ferramenta o pedir.
- Guarde quando o Saga pedir para guardar um token. A ferramenta está agora disponível para si no chat.
Usar ferramentas MCP num chat
Abra Adicionar fontes na caixa de mensagem. Em MCPs, escolha os servidores ligados que o Saga pode usar para esta mensagem. Pode incluir até ao limite indicado na lista. Use Manage MCP Connections para abrir as suas ligações. Os servidores que a sua organização configurou, mas que ainda não ligou, aparecem em Não conectado, cada um com um botão Conectar. Num servidor que usa início de sessão OAuth, Conectar abre o início de sessão. Nos outros servidores, abre Definições > MCPs, onde adiciona o seu token. Se o Saga precisar de um servidor que não ligou, o cartão que lhe pede para o ligar mostra Ligar e Ignorar. Escolha Ignorar para continuar sem esse servidor. Se um servidor precisar que inicie sessão, o chat mostra Connect to com o nome do servidor e um botão Connect. Se a permissão Usar MCPs estiver em Perguntar, o chat mostra Allow Saga to use com o nome do servidor. Escolha Permitir, Permitir sempre ou Ignorar. Enquanto o Saga trabalha, a resposta mostra que servidor ou ferramenta está a usar. Se um servidor não responder, a resposta indica que o Saga não o usou. Se Usar MCPs estiver em Desligado em Permissões, abaixo da caixa de mensagem, a lista de MCPs indica-o.Prefere que o Saga seja a ferramenta à qual outros assistentes se ligam? Essa é a outra direção — consulte Ligar o seu assistente ao Saga.