Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Adicionar um Conetor MCP Personalizado

Aula 11 de 14 Atualizada a 2 de novembro de 2026 Intermediario
Nesta página
  1. Para Além do Diretório Oficial
  2. O Processo de Adição
  3. Métodos de Autenticação
  4. Pré-requisitos para o Seu Servidor MCP
  5. Testes com o MCP Inspector
  6. Gestão Organizacional
  7. Segurança dos Conetores Personalizados
  8. Pontos-chave

Atualizado a 2 de novembro de 2026 — O Le Chat é agora o Vibe. Desde 28 de maio de 2026, o Le Chat foi renomeado para Vibe (ainda em chat.mistral.ai): um único agente para trabalho e código, que mantém as suas conversas, definições e subscrições. A experiência legada do Le Chat permanece disponível no modo Chat; no modo Work, os agentes são agora competências (invocadas com @), as memórias funcionam como base de conhecimento e a pesquisa profunda é a competência Deep Research. Os planos passaram a designar-se Mistral Free, Pro, Team e Enterprise. Esta lição utiliza o nome Vibe; alguns menus aqui descritos podem ter alterado o nome ou a localização.

Para Além do Diretório Oficial

Os conetores integrados cobrem muitos casos de uso, mas a sua organização provavelmente depende de ferramentas internas, APIs proprietárias ou serviços de nicho ausentes do diretório do Vibe. É aqui que entram os conetores personalizados: pode adicionar qualquer servidor MCP remoto ao Vibe simplesmente fornecendo o seu URL. Esse CRM interno desenvolvido há seis anos torna-se utilizável numa conversa, tal como o GitHub ou o Notion.

O Processo de Adição

Adicionar um conetor requer apenas alguns cliques na interface. Abra o separador Connectors, clique em Add a custom connector na parte inferior da lista e preencha os detalhes necessários:

  • Name: Um nome descritivo para identificar o conetor (por exemplo, “CRM Interno” ou “API Meteorológica”)
  • Server URL: O endereço público do seu servidor MCP, incluindo o endpoint /mcp (por exemplo, https://mon-serveur.example.com/mcp)
  • Description: Uma breve explicação sobre o que o conetor faz (opcional, mas recomendado)
  • Authentication method: None, Token ou OAuth 2.0

Por fim, clique em Create para guardar o conetor. O Vibe consulta automaticamente o servidor para descobrir as ferramentas disponíveis: a lista de funções expostas aparece e pode começar a utilizá-las nas suas conversas.

Este pedido de descoberta devolve o name, a description em texto, os parameters esperados (com o seu nome, tipo e descrição) e o return type para cada ferramenta. Estes são os únicos detalhes que o modelo Mistral utiliza para decidir quando e como invocar cada ferramenta — razão pela qual a próxima lição se foca intensamente na qualidade da descrição. Uma ferramenta bem escrita com uma descrição pobre permanece invisível para o modelo.

Métodos de Autenticação

O caso mais simples é a ausência de autenticação: o seu servidor MCP está acessível a qualquer pessoa que conheça o seu URL. Isto funciona para ferramentas públicas que não lidam com dados sensíveis, protótipos, demonstrações e servidores MCP que envolvem APIs públicas. A autenticação por token envolve fornecer uma chave enviada com cada pedido ao servidor; o Vibe armazena o token de forma segura. Escolha esta opção para APIs internas protegidas por uma chave de API, servidores que precisam de identificar o chamador e qualquer cenário onde pretenda restringir o acesso. Finalmente, existe o OAuth 2.0, o fluxo completo com redirecionamento para a página de autorização do serviço: é o mecanismo mais seguro, mas também o mais complexo de implementar no lado do servidor, sendo abordado em profundidade em futuros guias da Mistral AI.

Pré-requisitos para o Seu Servidor MCP

O Que o Vibe Exige de um Servidor MCP
  • Acessível através de um URL público (sem localhost)
  • Expõe um endpoint no formato Streamable HTTP (/mcp)
  • Responde a pedidos de descoberta de ferramentas no formato JSON MCP padrão
  • Gere corretamente as chamadas de ferramentas e devolve resultados no formato esperado

O requisito do URL público pode parecer bloquear o desenvolvimento local, mas existe uma solução durante a fase de depuração. Se estiver a desenvolver na sua máquina e quiser testar com o Vibe antes da implementação, abra um túnel para o seu servidor local utilizando o ngrok:

ngrok http 8000

O ngrok fornece-lhe um URL público temporário que pode utilizar como URL do conetor no Vibe. Esta abordagem é ideal para desenvolvimento e testes: modifica o seu código, reinicia e o Vibe vê imediatamente a nova versão sem qualquer implementação.

Testes com o MCP Inspector

Antes de adicionar o seu servidor ao Vibe, teste-o com o MCP Inspector, uma ferramenta de código aberto que verifica se o seu servidor responde corretamente aos pedidos de descoberta, lista as ferramentas disponíveis com as suas descrições e parâmetros, executa chamadas de ferramentas manualmente para verificar os resultados e ajuda a depurar problemas de formatação ou de tipagem. Inicie-o com um comando npx simples:

npx @modelcontextprotocol/inspector

O Inspector abre uma interface web local onde liga o seu servidor MCP e testa cada ferramenta individualmente. Este passo não é apenas uma formalidade: poupa-lhe o gasto de mensagens de conversa em depuração e isola claramente os erros do servidor dos erros de interpretação do modelo.

Gestão Organizacional

Se fizer parte de uma organização no Vibe, note que os conetores personalizados que adicionar são visíveis para outros membros. Um administrador pode desativar qualquer conetor para toda a organização se o considerar inadequado ou inseguro. No entanto, cada utilizador deve fornecer as suas próprias credenciais — token ou OAuth — para conetores que exigem autenticação: partilhar um conetor nunca significa partilhar credenciais de acesso.

Segurança dos Conetores Personalizados

Ao contrário dos conetores oficiais validados pela Mistral AI, um conetor personalizado pode executar código arbitrário no lado do servidor, e a descrição em texto que vê não garante nada sobre o que o servidor realmente faz. Limite-se a servidores que desenvolveu pessoalmente, aos de colegas ou parceiros de confiança e a servidores de código aberto cujo código verificou. Mesmo com os seus próprios conetores, mantenha a validação humana ativada durante toda a fase de depuração; assim que tiver a certeza de que tudo funciona, pode considerar definir as ferramentas de apenas leitura como “Always Allow”.

Pontos-chave

  • Pode adicionar qualquer servidor MCP remoto como um conetor personalizado no Vibe
  • O servidor deve ser acessível através de um URL público com um endpoint /mcp
  • São suportados três métodos de autenticação: none, token e OAuth 2.0
  • Utilize o ngrok para testar o seu servidor local com o Vibe antes da implementação
  • O MCP Inspector é essencial para depurar o seu servidor antes da integração
  • Adicione apenas conetores de fontes fidedignas e mantenha a validação humana ativada