Configuração de ferramentas externas com servidores MCP

Adicione, gerencie e configure servidores MCP para Delegate, incluindo servidores personalizados, configurações_v2.json, e Apps MCP.

MCP é um protocolo aberto para conectar assistentes de IA a fontes de dados e ferramentas externas. Diferentemente dos conectores do Integration Service, os servidores MCP podem ser remotos (hospedados em outro lugar, acessados por HTTP) ou locais (um programa em execução na sua máquina).

A maioria dos servidores MCP não precisa de configuração manual — consulte a referência de servidores MCP para obter o catálogo apoiado pelo Orchestrator e o Marketplace de terceiros, ambos adicionam um servidor com um clique.

Adicionar um servidor MCP personalizado

Para um servidor que não esteja no catálogo ou Marketplace, adicione-o manualmente em Complementos e integrações → Servidores MCP.

Servidores MCP remotos

Hospede servidores MCP remotos externamente e acesse-os via HTTP:

1. Selecione Adicionar Servidor MCP → Remoto.
2. 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
3. Selecione Salvar.
4. 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": "<your-access-token>"
  }
}

Servidores MCP locais

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

1. Selecione Adicionar Servidor MCP → Local.
2. Insira os detalhes do servidor:
   • Título: 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
3. Selecione Salvar.
4. Alterne Habilitado para ativar.

Exemplos de configurações

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"
  }
}

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": "<your-github-token>"
    },
    "cwd": "/Users/username"
  }
}

Gerenciamento de servidores MCP

De Complementos e integrações → Servidores MCP, você pode alternar um servidor configurado entre ativado ou desativado, editar sua configuração ou removê-lo. Desabilitar um servidor impede que o agente use suas ferramentas, mas não interrompe um processo de servidor local que já esteja em execução — você pode precisar parar esse processo por conta própria.

Como o agente descobre ferramentas de MCP

Ao habilitar um servidor MCP, o agente se conecta a ele, o servidor informa suas ferramentas disponíveis e elas ficam prontas para uso na conversa — sem necessidade de registro manual. Você pode fazer referência a eles em linguagem natural, por exemplo: "Use a ferramenta de filesystem para listar minha pasta de Documentos".

Apps MCP: interfaces interativas em linha

Apps MCP é uma extensão do Protocolo de Contexto do Modelo que permite que uma ferramenta retorne uma interface interativa — um formulário, um painel, um gráfico, uma tabela de dados — em vez de apenas texto. Quando a ferramenta de um servidor MCP conectado oferece suporte, o Delegate renderiza essa interface em linha na conversa, em um quadro restrito: a interface pode chamar as ferramentas do próprio servidor e receber atualizações, mas não pode acessar nada fora de seu próprio quadro. Os formulários chegam pré-preenchidos com valores razoáveis, para que você altere apenas o que é importante em vez de descrever cada campo no chat.

Se um determinado servidor MCP oferece isso ou não, depende desse servidor — nem todo servidor implementa a extensão.

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 do settings_v2.json

Usuários avançados podem gerenciar conexões de servidor MCP diretamente em settings_v2.json — a mesma lista mcpServers que a interface gráfica lê e escreve:

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

Edite settings_v2.json apenas se você estiver confortável com o JSON — a sintaxe inválida impede o carregamento do aplicativo. Sempre faça backup antes de editar. Consulte Locais do arquivo de configurações.

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

• Referência de servidores MCP — O catálogo do Orchestrator e o Marketplace de terceiros
• Conecte-se a aplicativos de negócios populares — para integrações de SaaS gerenciadas
• Repetição de trabalho com rotinas — Salve fluxos de trabalho que usam suas ferramentas conectadas
• Compartilhamento de habilidades com sua equipe — Localize habilidades pré-criadas para seus serviços conectados