Integrar um Servidor Personalizado no Vibe
Nesta página
Atualização de 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 acessível no modo Chat; no modo Work, os agentes tornaram-se competências (invocadas com
@), as memórias transformaram-se na base de conhecimento e a pesquisa profunda converteu-se na competência Deep Research. Os planos designam-se agora por Mistral Free, Pro, Team e Enterprise. Esta lição utiliza o nome Vibe; note que alguns menus aqui descritos podem ter alterado de nome ou de localização.
Ligar o Seu Servidor MCP ao Vibe
O seu servidor está implementado e a responder via HTTPS num endereço estável. Chega agora o passo que dá sentido a todo o seu trabalho anterior: torná-lo utilizável em conversação pelo seu público-alvo, incluindo aqueles que nunca abrirão um terminal. O Vibe aceita qualquer servidor MCP compatível como um conetor personalizado. Esta lição abrange a adição do conetor, a análise dos fluxos de chamada em conversação e o diagnóstico de falhas — pois a primeira tentativa falha frequentemente.
Adicionar o Conetor
Abra o Vibe em chat.mistral.ai e navegue até ao separador Connectors na barra lateral. Encontrará duas secções distintas: conetores em destaque, pré-configurados pela Mistral (GitHub, Notion e outros), e os seus próprios conetores personalizados, inicialmente vazios. Clique em Add Custom Connector e preencha os campos:
- Name: Um nome descritivo (ex.: “Task Manager”)
- Server URL: O URL completo do seu endpoint MCP (ex.:
https://my-server.com/tasks/mcp) - Description: O que o seu servidor faz (opcional, mas recomendado)
De seguida, escolha o seu método de autenticação: No authentication para um servidor público, Token se colar o seu token de API, ou OAuth 2.0 para um fluxo de consentimento completo. Clicar em Connect desencadeia a descoberta: se for bem-sucedido, o Vibe exibe a lista de ferramentas encontradas no seu servidor, mostrando o nome e a descrição de cada uma. Este é o seu primeiro feedback real sobre a qualidade das suas docstrings — lê-as aqui exatamente como o modelo as receberá.
O Que Acontece na Conversação
Uma vez ligado, o seu servidor aparece na secção Tools da barra lateral do chat, assinalado por um ícone que indica a disponibilidade de ferramentas externas. O utilizador expressa o seu pedido em linguagem natural e o modelo traduz:
User: Create a high-priority task to prepare the MCP demo
Vibe: [Calling create_task with the following arguments]
- title: "Prepare the MCP demo"
- priority: "high"
→ Do you want to authorize this tool call?
User: [Authorize]
Vibe: The task "Prepare the MCP demo" has been successfully created
with high priority. Its ID is abc123.
Este pedido de confirmação é o comportamento padrão. Pode aprová-lo ad hoc ou alterar uma ferramenta para autorização permanente. Resista à tentação de fazer isto para qualquer servidor que não lhe pertença. A confirmação protege não só contra erros; é a sua única defesa contra injeções de prompt, onde instruções ocultas nos dados devolvidos por uma ferramenta orientam o modelo para chamadas que ninguém solicitou. Ver os argumentos a passar antes da validação é o que lhe permite detetar a anomalia.
Quando Não Funciona
A mensagem “Unable to connect” resulta quase sempre de uma destas quatro causas: o URL está inacessível do exterior, o protocolo não é HTTPS (o que o Vibe exige), o servidor simplesmente não está em execução, ou o CORS não está configurado, embora o Vibe envie pedidos a partir de um navegador. O seguinte comando distingue entre as duas primeiras hipóteses em segundos:
# Test accessibility
curl -X POST https://your-url/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'
Se a ligação for bem-sucedida mas nenhuma ferramenta aparecer, rastreie a cadeia no lado do servidor: verifique se o decorador @app.tool() está presente em cada função, se não faltam docstrings e se o servidor MCP está montado na rota que pensa. Utilize o MCP Inspector antes de qualquer outra investigação.
O caso mais confuso ocorre quando tudo funciona, mas o modelo chama a ferramenta errada ou nenhuma. O problema não é então técnico: o modelo escolhe com base nas descrições e, se duas ferramentas se parecerem ou se uma permanecer vaga, escolherá mal. Utilize três alavancas, por esta ordem: torne a descrição mais específica clarificando o caso de uso, renomeie a ferramenta para remover ambiguidades e reduza o número de ferramentas ativas simultaneamente. Por fim, se uma ferramenta devolver um erro, verifique os registos do servidor, repita a chamada manualmente no inspector e confirme que as variáveis de ambiente estão definidas e que o token ou os scopes OAuth concedem as permissões esperadas.
O MCP Inspector: Utilize-o Antes do Vibe
O inspector testa as suas ferramentas sem envolver o modelo, isolando metade das variáveis do problema:
npx @modelcontextprotocol/inspector
Abre uma interface web onde se liga ao seu servidor remoto através do seu URL, lista todas as ferramentas com as suas descrições e parâmetros, executa uma ferramenta com argumentos à sua escolha e lê a resposta bruta do servidor. Torne hábito realizar esta verificação sistematicamente antes de adicionar um servidor ao Vibe, pois oferece-lhe um diagnóstico imediato: se uma ferramenta responder corretamente no inspector mas falhar no Vibe, o servidor não tem culpa e o problema reside na descrição ou no prompt.
Conviver com Múltiplos Servidores
Depois de instalar vários conetores, a disciplina torna-se o fator primordial de qualidade. O Vibe permite ativar ou desativar cada conetor: mantenha ativos apenas as ferramentas necessárias para a tarefa atual, pois um modelo inundado com cinquenta ferramentas escolhe com menos precisão e responde mais lentamente. Esta higiene baseia-se na separação de domínios abordada na Lição 10 — um servidor para gestão de projetos, um para monitorização, um para ferramentas internas —, uma vez que assim só precisa de ativar aquele que corresponde à conversação atual.
Por fim, adapte os seus prompts às capacidades realmente expostas:
# Good: reflects tool capabilities
"Create a high-priority task titled 'Prepare the demo'"
# Bad: too vague, the model doesn't know which tool to use
"Manage my project"
Um último ponto que vale a pena conhecer antes de conceber os seus servidores: os conetores MCP configurados no Vibe permanecem disponíveis na aplicação móvel. As suas ferramentas internas tornam-se assim acessíveis a partir de um telemóvel, abrindo cenários de utilização em campo que talvez não considere quando desenvolve num computador.
Pontos-chave
- Adicionar um conetor personalizado no Vibe requer 3 passos: nome, URL, autenticação
- Mantenha a confirmação manual das chamadas de ferramentas ativada por segurança
- Utilize o MCP Inspector para testar e depurar antes de integrar no Vibe
- Melhore as descrições das ferramentas se o modelo não as estiver a utilizar corretamente
- Mantenha ativas apenas as ferramentas necessárias para a tarefa atual
- Os seus servidores MCP também estão acessíveis em telemóvel