Configuração de ferramentas externas com servidores MCP

Adicionar, gerenciar e configurar servidores MCP para Delegate, incluindo servidores personalizados, settings.json, e Apps MCP.

MCP é um protocolo aberto para conectar assistentes de IA a fontes de dados e ferramentas externas. Ao contrário 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 em sua máquina).

A maioria dos servidores MCP não precisa de configuração manual — consulte a referência de servidores MCP para o catálogo baseado no Orchestrator e o marketplace de terceiros, ambos os quais adicionam um servidor com um clique.

Adicionando um servidor MCP personalizado

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

Servidores MCP remotos

Os servidores MCP remotos são hospedados em outro lugar e acessados por meio de 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: um nome amigável
   • Comando: o executável a ser executado (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 sistema de arquivos:

{
  "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 GitHub MCP:

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

Em Suplementos e Integrações → Servidores MCP, você pode alternar um servidor configurado, editar sua configuração ou removê-lo. Desabilitar um servidor impede que o agente use suas ferramentas, mas não interrompe um processo do servidor local que já está em execução — você pode precisar interromper esse processo por conta própria.

Como o agente encontra ferramentas do MCP

Quando um servidor MCP é habilitado, o agente conecta-se a ele, o servidor relata suas ferramentas disponíveis e essas ferramentas ficam disponíveis na conversa — sem necessidade de registro manual. Você pode fazer referência a eles em linguagem natural, por exemplo: "Usar a ferramenta do sistema de arquivos para listar minha pasta Documentos".

Apps MCP: interfaces interativas em linha

O MCP Apps é uma extensão para o 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 é compatível com ela, Delegate renderiza essa interface em linha na conversa, em um quadro restrito: a interface pode chamar as próprias ferramentas do 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 sensíveis, então você só altera o que importa, em vez de descrever todos os campos no chat.

Se um determinado servidor MCP oferece isso depende desse servidor — nem todos os servidores implementam 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.json

Os usuários avançados podem gerenciar conexões de servidor MCP diretamente em settings.json a mesma lista mcpServers que a interface gráfica lê e grava:

{
  "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.json apenas se você estiver confortável com JSON — a sintaxe inválida impede que o aplicativo seja carregado. Sempre faça backup antes de editar. Consulte Configurações locais de arquivos.

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
• Conexão 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
• Compartilhar habilidades com sua equipe — Encontre habilidades pré-criadas para seus serviços conectados