Utilizar servidores MCP no Vibe
Nesta página
Da Configuração à Utilização Prática
A Lição 8 mostrou-lhe como declarar servidores MCP no ficheiro config.toml. O ficheiro está escrito, os servidores respondem, mas a questão que realmente importa no dia a dia permanece: como é que isto altera efetivamente o seu fluxo de trabalho? É exatamente isso que esta lição aborda.
Conceder Acesso à Web
O servidor mais valioso para instalar primeiro é o mcp-server-fetch, pois remove a limitação mais irritante de um agente local: a ignorância sobre tudo o que não esteja no seu disco. Uma vez configurado, o Vibe consegue ler qualquer página web.
Leia a documentação da API da Stripe sobre webhooks e resuma os passos de implementação para mim
Obtenha o conteúdo desta issue do GitHub: https://github.com/org/repo/issues/42
Verifique a versão mais recente disponível da biblioteca fastapi em pypi.org
Repare que, em nenhum momento, especificou qual a ferramenta a utilizar. O agente invoca a ferramenta fetch autonomamente assim que deteta que é necessário um URL ou uma referência web; o contexto do seu pedido orienta a decisão, e não uma instrução explícita da sua parte.
Consultar os Seus Dados
O mesmo princípio aplica-se a uma base de dados através de um servidor MCP SQLite ou PostgreSQL. A declaração mantém-se concisa:
# Configuração em config.toml
[[mcp_servers]]
name = "db_locale"
transport = "stdio"
command = "uvx"
args = ["mcp-server-sqlite", "--db-path", "./data/app.db"]
Numa sessão, coloca então questões de negócio, e não SQL: “Mostre-me os 10 utilizadores registados mais recentemente com as respetivas datas de criação” ou “Quantos pedidos foram feitos este mês? Agrupe-os por estado.” O agente escreve a consulta, executa-a e devolve um resultado legível. O SQL torna-se um detalhe de implementação.
Combinar Múltiplos Servidores
O verdadeiro poder do MCP surge quando dois servidores trabalham na mesma troca. Com o fetch e o SQLite ativos simultaneamente, um pedido como este envolve ambos:
Compare os dados da nossa base de dados com a documentação oficial da API.
Existem campos em falta no nosso esquema?
O Vibe lê a documentação através do servidor fetch, inspeciona o seu esquema através do servidor SQLite e, em seguida, cruza as duas fontes de informação. Dois fluxos de trabalho comuns baseiam-se nesta composição. Primeiro, a monitorização tecnológica:
1. Obtenha os últimos lançamentos do React no GitHub
2. Compare com a versão no nosso package.json
3. Se houver uma atualização importante, resuma as alterações disruptivas
O agente encadeia a chamada ao servidor fetch para o GitHub, lê o ficheiro package.json local e realiza a análise, sem que tenha de decompor o pedido. A auditoria de dependências segue a mesma lógica, com uma iteração extra:
Para cada dependência em @package.json, verifique no npm vulnerabilidades conhecidas
e gere um relatório
O Vibe percorre as dependências uma a uma, chama o servidor fetch para cada uma e compila os resultados num único relatório.
Saber o Que Está Disponível e Diagnosticar Falhas
Durante uma sessão, não precisa de adivinhar quais as ferramentas MCP ativas. Sempre que o Vibe utiliza uma, indica claramente o servidor e a ferramenta invocados na sua saída, que pode visualizar com Ctrl+O. Também pode perguntar diretamente: “Que ferramentas fornece o servidor MCP ‘fetch’?”
Quando um servidor deixa de responder ou devolve um erro, o Vibe informa-o explicitamente. Quatro causas cobrem a maioria dos casos.
| Causa | O que verificar |
|---|---|
| Servidor não iniciado | Para transportes HTTP, garanta que o serviço está em execução |
| Tempo limite excedido | O servidor está a demorar demasiado tempo a responder: aumente o tempo limite na configuração, se necessário |
| Autenticação | Garanta que os cabeçalhos e tokens estão corretos |
| Ferramenta não encontrada | Garanta que o nome da ferramenta no filtro corresponde ao exposto pelo servidor |
Para transportes STDIO, a questão do arranque não se coloca: o Vibe gere o próprio ciclo de vida do servidor e, se o processo falhar, tenta reiniciá-lo.
Manter as Sessões Rápidas
Cada servidor MCP ativo adiciona as suas ferramentas ao contexto do agente, e não notará o impacto até ter oito deles. Os efeitos são mecânicos: o tempo de resposta aumenta porque o modelo tem de arbitrar entre mais opções, e o custo por pedido sobe porque todas estas definições de ferramentas consomem tokens no contexto faturável. A regra é simples: ative apenas os servidores úteis para a sessão atual.
Quando estiver interessado apenas numa parte do que um servidor expõe, a filtragem é preferível à desativação completa:
# Utilizar apenas a ferramenta fetch do servidor, não as outras
enabled_tools = ["fetch_fetch"]
Por fim, prefira o STDIO para tudo o que corre localmente. O Vibe inicia e para estes servidores automaticamente: não precisa de manter serviços em segundo plano nem de os reiniciar após um reinício do sistema.
Pontos-chave
- Os servidores MCP estendem o Vibe com capacidades web, de base de dados e outras
- O agente escolhe automaticamente qual a ferramenta MCP a utilizar com base no contexto
- Vários servidores MCP podem ser combinados num único fluxo de trabalho
- Limite o número de servidores ativos para manter o desempenho
- A filtragem de ferramentas permite um controlo detalhado sobre as capacidades disponíveis