Conectores MCP gerenciados
Os conectores MCP gerenciados permitem que administradores de agentes os conectem a um servidor MCP remoto. Crie um conector a partir de um modelo ou endpoint HTTPS personalizado, teste-o e selecione-o na etapa MCP do agente.
Caminho rápido
- Abra Agents e use a aba MCP.
- Escolha um modelo ou adicione um servidor MCP remoto personalizado.
- Insira o segredo quando necessário e use Test connection.
- Selecione o conector na etapa MCP do agente e salve o agente.
Modelos disponíveis
| Modelo | Finalidade | Autenticação |
|---|---|---|
| Context7 | Documentação e exemplos de bibliotecas conforme a versão | Chave de API opcional |
| GitHub | Ferramentas de repositórios, ocorrências, pull requests e Actions | Exige um token de acesso pessoal do GitHub |
| Scraper | Extração, mapeamento, rastreamento e renderização de sites públicos | Exige um token Bearer |
Por padrão, o GitHub usa acesso somente leitura e um conjunto limitado de ferramentas. Seu endpoint e seus campos de autenticação são fixos em conectores baseados em modelo.
Servidores remotos personalizados
Conectores personalizados aceitam URLs https:// ou http:// e um destes modos de autenticação: sem autenticação, token Bearer ou cabeçalho personalizado. As URLs não podem conter credenciais incorporadas.
O Almirant valida as URLs de saída dos conectores antes de salvá-las ou atualizá-las. Ele rejeita destinos privados ou não permitidos para reduzir o risco de SSRF. Sempre que possível, use um endpoint HTTPS acessível publicamente.
Segredos e acesso
- As credenciais do conector são criptografadas no servidor.
- A interface de Agents apenas indica que um conector possui um segredo; ela não retorna seu valor.
- Os segredos são descriptografados somente para preparar uma execução de agente à qual a pessoa proprietária tem acesso.
- A propriedade dos conectores é limitada ao usuário no espaço de trabalho ativo.
- Um teste de conexão retorna status e dados de diagnóstico seguros, e não o segredo nem o endpoint bruto na resposta de erro.
Solução de problemas
| Problema | Causa provável | Ação |
|---|---|---|
| O teste falha antes de conectar | URL inválida, protocolo incompatível ou destino bloqueado | Use um endpoint MCP HTTP(S) externo e válido. |
| Não é possível salvar um conector autenticado | Nenhum segredo foi fornecido | Forneça o token Bearer ou o valor necessário do cabeçalho personalizado. |
| Não é possível alterar um modelo | O endpoint e a autenticação do modelo são imutáveis | Crie um conector personalizado para outro servidor. |
| O agente não consegue usar um conector | Ele não foi selecionado na etapa MCP do agente | Selecione-o, salve o agente e inicie um novo trabalho. |