Ferramentas de conexão

Conecte Delegate a aplicativos de negócios usando conectores do Integration Service para integrações de SaaS gerenciadas ou servidores MCP para conexões de ferramentas personalizadas e locais.

Este guia aborda como conectar o Delegate aos seus aplicativos e serviços de negócios. Delegate é compatível com dois métodos de conexão: conectores do Integration Service para integrações de SaaS gerenciadas e servidores MCP (Protocolo de contexto do modelo) para conexões de ferramentas personalizadas ou locais.

Conexões do Integration Service

O Integration Service fornece conexões seguras e autenticadas para aplicativos de negócios populares. Quando você conecta um conector do Integration Service, Delegate pode:

• Leia e grave dados no aplicativo conectado
• Aja em seu nome usando suas permissões
• Acessar dados sem exigir que você compartilhe senhas
• Funciona em segundo plano sem automação do navegador

Integrações disponíveis

Delegate é compatível com todos os conectores no catálogo do Integration Service, não apenas com um subconjunto fixo. Alguns exemplos comuns:

Serviço	O que o Delegate pode fazer
Microsoft Outlook	Ler e-mails, enviar mensagens, gerenciar calendário, criar tarefas
Gmail	Leia e-mails, envie mensagens, pesquise conversas
calendário do Google	Ler eventos, criar reuniões, verificar disponibilidade
Google Drive	Listar, ler e gerenciar arquivos
Documentos Google	Criar e editar documentos
Slack	Ler canais, publicar mensagens, gerenciar threads
Microsoft Teams	Ler canais, publicar mensagens, verificar menções
Jira	Ler problemas, criar tíquetes, atualizar status, adicionar comentários
Confluence	Ler páginas, pesquisar conteúdo, criar documentação
GitHub	Ler repositórios, problemas, solicitações pull; criar problemas
Salesforce	Leia e atualize registros, crie tarefas, verifique oportunidades

Pré-requisitos

• O Integration Service deve estar disponível em seu tenant da UiPath.

Criando uma conexão

Para criar uma conexão do Integration Service, siga as seguintes etapas:

1. Abra Configurações → Conexões (ou Integration Service).
2. Selecione Adicionar conexão ou Conectar.
3. Selecione o serviço que você deseja conectar.
4. Você será redirecionado para a página de autorização do OAuth do serviço.
5. Faça login com sua conta existente para esse serviço.
6. Conceda as permissões solicitadas.
7. Você retornará a Delegate com a conexão confirmada.

Resultado: a conexão aparece na lista com um indicador de status verde. Agora, você pode fazer referência a esse serviço em Delegate por nome.

Modo de filtro da conexão

Controle quais conexões o Delegate pode acessar:

Mode	Description	Use quando
Pessoal	Apenas as conexões que você criou	Trabalhando sozinho, testando
Todos	Todas as conexões em seu tenant/organização	Ambientes de equipe, recursos compartilhados

Para alterar: Configurações → Conexões → Lista suspensa de filtros

Observação: no modo "Todas", você pode usar as conexões criadas por colegas de equipe, mas só pode ver os dados para os quais você tem permissão no aplicativo conectado.

Teste de uma conexão

Após criar uma conexão:

1. A conexão aparece na lista com um indicador de status.
2. Verde = Conectado e funcionando.
3. Amarelo = conectado, mas pode ter permissões limitadas.
4. Vermelho = A conexão falhou ou expirou.

Para testar: peça ao Delegate para realizar uma ação simples: "Listar meus emails não lidos do Outlook" ou "Mostrar meu calendário de hoje".

Revogação de uma conexão

Para revogar uma conexão e remover o acesso do Delegate a um serviço, siga as seguintes etapas:

1. Abra Configurações → Conexões.
2. Encontre a conexão que você deseja remover.
3. Selecione Desconectar ou o ícone da lixeira.
4. Confirme a desconexão.

Resultado: a conexão é removida da lista. Delegate não poderá mais acessar esse serviço até que você se reconecte.

Observação: isso remove o acesso de Delegate, mas não exclui sua conta com o serviço. Para revogar totalmente, remova também a autorização nas configurações do próprio serviço (por exemplo, Conta Google → Segurança → Aplicativos de terceiros).

Atualização de conexões obsoletas

As conexões podem expirar ou se tornar inválidas se:

• Sua senha foi alterada
• O serviço revogou acesso de terceiros
• Sua organização alterou as políticas de segurança

Problemas: Delegate relata "Falha na conexão" ou "Erro de autenticação"

Para corrigir

1. Vá para Configurações → Conexões.
2. Encontre a conexão com falha.
3. Selecione Reconectar ou Atualizar.
4. Conclua o fluxo do OAuth novamente.

Servidores MCP (Protocolo de contexto do modelo)

MCP é um protocolo aberto para conectar assistentes de IA a fontes de dados e ferramentas externas. Ao contrário dos conectores do Integration Service (gerenciados pela UiPath), os servidores MCP podem ser:

• Remoto: serviços hospedados aos quais você se conecta por meio da URL
• Local: programas em execução na sua máquina

Quando usar MCP versus Integration Service

A tabela a seguir descreve quando usar cada método de conexão.

Caso de uso	Abordagem recomendada
SaaS populares (Outlook, Slack, Salesforce)	Integration Service
APIs internas personalizadas	Servidor remoto MCP
Bancos de dados ou arquivos locais	Servidor local MCP
Ferramentas proprietárias sem um conector do Integration Service	MCP (qualquer tipo)
Integrações experimentais ou beta	MCP

Adicionando um servidor MCP remoto

Os servidores MCP remotos são hospedados em outro lugar e acessados via HTTP:

1. Abra Configurações → Servidores MCP.
2. Selecione Adicionar servidor.
3. Selecione Remoto.
4. Insira os detalhes do servidor:
   • URL: o endereço do ponto de extremidade (por exemplo, https://api.example.com/mcp)
   • Título: um nome amigável (por exemplo, "API da empresa")
   • Cabeçalhos (opcional): cabeçalhos de autenticação, se necessário
5. Selecione Salvar.
6. Alterne Habilitado para ativar.

Exemplo de configuração

{
  "type": "remote",
  "url": "https://internal-api.company.com/mcp",
  "enabled": true,
  "title": "Company Data API",
  "headers": {
    "Authorization": "Bearer YOUR_TOKEN"
  }
}

Adicionando um servidor MCP local

Os servidores MCP locais são executados como processos em sua máquina:

1. Abra Configurações → Servidores MCP.
2. Selecione Adicionar servidor.
3. Selecione Local.
4. Insira os detalhes do servidor:
   • Título: um nome amigável
   • Comando: o executável para executar (por exemplo, node, python, /path/to/server)
   • Argumentos: argumentos de linha de comando
   • Diretório de trabalho: onde o comando é executado
   • Variáveis de ambiente: pares de chave-valor para o processo
5. Selecione Salvar.
6. Alterne Habilitado para ativar.

Exemplos de configurações

Exemplo: Servidor MCP do Filesystem

{
  "type": "local",
  "enabled": true,
  "serverId": "filesystem-mcp",
  "title": "Local Filesystem Access",
  "config": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"],
    "env": {},
    "cwd": "/Users/username"
  }
}

Exemplo: servidor MCP do GitHub

{
  "type": "local",
  "enabled": true,
  "serverId": "github-mcp",
  "title": "GitHub Integration",
  "config": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
    },
    "cwd": "/Users/username"
  }
}

Gerenciamento de servidores MCP

Em Configurações → Servidores MCP, você pode:

• Habilitar/Desabilitar: alternar entre servidores individuais
• Editar: modificar a configuração (URL, comando, argumentos)
• Excluir: remover uma configuração do servidor
• Teste: verifique se o servidor responde corretamente

Observação: as alterações entram em vigor imediatamente. Desabilitar um servidor impede que o Delegate use suas ferramentas, mas não interrompe a execução de um processo local. Você pode precisar encerrar o processo manualmente.

Como o Delegate encontra ferramentas do MCP

Quando um servidor MCP está habilitado:

1. Delegate conecta-se ao servidor (HTTP para remota, estdio para local).
2. O servidor relata suas ferramentas e recursos disponíveis.
3. As ferramentas aparecem nos recursos disponíveis do Delegate.
4. Você pode fazer referência a eles em linguagem natural: "Usar a ferramenta do sistema de arquivos para listar minha pasta Documentos".

Sem necessidade de registro manual— as ferramentas MCP são descobertas automaticamente.

Os administradores podem controlar servidores MCP no nível da política — consulte Servidores MCP em Governança com Automation Ops.

Avançado: gerenciamento da conexão por meio de Configurações

Os usuários avançados podem gerenciar conexões MCP diretamente settings.json em:

{
  "mcpServers": [
    {
      "type": "remote",
      "url": "https://api.example.com/mcp",
      "enabled": true,
      "title": "Example API",
      "headers": {
        "Authorization": "Bearer token123"
      }
    },
    {
      "type": "local",
      "enabled": true,
      "serverId": "my-local-server",
      "title": "Local Tools",
      "config": {
        "command": "python",
        "args": ["/path/to/server.py"],
        "env": {"API_KEY": "secret"},
        "cwd": "/path/to/working/dir"
      }
    }
  ]
}

Observação: edite settings.json apenas se você estiver confortável com JSON. Uma sintaxe inválida impedirá que o Delegate seja carregado. Sempre faça backup antes de editar.

Para considerações de segurança e informações de fluxo de dados para conexões, consulte Configuração de segurança local.

Próximas Etapas

Saiba como:

• Repetir trabalho com Rotinas — Salve fluxos de trabalho que usam suas ferramentas conectadas
• Compartilhe trabalho com o Delegate Armazenamento — Encontre habilidades pré-criadas para seus serviços conectados
• Revise a referência de Configurações — Opções de configuração completas