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

Integrar um Servidor Personalizado no Vibe

Aula 13 de 14 Atualizada a 2 de novembro de 2026 Programador
Nesta página
  1. Ligar o Seu Servidor MCP ao Vibe
  2. Adicionar o Conetor
  3. O Que Acontece na Conversação
  4. Quando Não Funciona
  5. O MCP Inspector: Utilize-o Antes do Vibe
  6. Conviver com Múltiplos Servidores
  7. Pontos-chave

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:

  1. Name: Um nome descritivo (ex.: “Task Manager”)
  2. Server URL: O URL completo do seu endpoint MCP (ex.: https://my-server.com/tasks/mcp)
  3. 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