Configurar Servidores MCP no Vibe
Nesta página
Lição atualizada em 2 de novembro de 2026 com base na página MCP servers do Vibe Code: a autenticação utiliza agora a tabela
[mcp_servers.auth](api_key_envou OAuth); a sintaxe${VARIABLE}nos cabeçalhos, anteriormente apresentada, não está documentada para servidores MCP. Foram adicionados os subcomandosvibe mcp adde/mcp. Fonte: MCP servers.
O Que É o MCP?
O Model Context Protocol (MCP) é um padrão aberto que permite aos agentes de IA comunicarem com servidores de ferramentas externos. Em vez de codificar rigidamente cada integração, o MCP fornece um protocolo unificado: o servidor expõe as ferramentas e o agente descobre-as e utiliza-as automaticamente. Não precisa de escrever qualquer código de ligação. Basta declarar um endereço ou um comando, e as ferramentas aparecerão na sua próxima sessão.
O Vibe possui suporte nativo para MCP, o que significa que pode expandir as suas capacidades muito além das ferramentas integradas — ler uma página web, consultar uma base de dados ou chamar uma API interna da empresa.
Os Dois Tipos de Transporte
Antes de configurar qualquer coisa, precisa de decidir sobre o transporte — o canal que o Vibe utiliza para comunicar com o servidor.
Com o transporte HTTP, o servidor MCP funciona como um serviço web padrão e o Vibe envia pedidos para descobrir e invocar ferramentas:
[[mcp_servers]]
name = "my_http_server"
transport = "http"
url = "http://localhost:8000"
headers = { "Authorization" = "Bearer my_token_here" }
Utilize este modo quando o servidor MCP estiver em execução contínua — um serviço de base de dados, uma API interna ou uma ferramenta web partilhada por toda a sua equipa.
Com o transporte STDIO, o servidor é um programa local que o próprio Vibe inicia, comunicando via stdin/stdout:
[[mcp_servers]]
name = "fetch_server"
transport = "stdio"
command = "uvx"
args = ["mcp-server-fetch"]
Este é o modo mais simples de configurar, pois o Vibe gere o ciclo de vida do servidor: inicia o servidor no começo da sessão e encerra-o no final. Não é necessário arranque manual nem monitorização.
Existe também uma variante HTTP chamada streamable-http, concebida para ligações de longa duração com streaming:
[[mcp_servers]]
name = "my_stream_server"
transport = "streamable-http"
url = "http://localhost:9000/mcp"
Exemplo Prático: Adicionar Recuperação Web
Um dos servidores MCP mais úteis é o mcp-server-fetch, que permite ao Vibe ler o conteúdo de páginas web. Requer apenas três linhas de configuração:
# ~/.vibe/config.toml
[[mcp_servers]]
name = "fetch"
transport = "stdio"
command = "uvx"
args = ["mcp-server-fetch"]
O impacto no seu fluxo de trabalho diário é imediato. Pode agora fazer pedidos que pressupõem leitura externa:
Read the FastAPI documentation at fastapi.tiangolo.com and summarize the security endpoints for me
O agente chama automaticamente a ferramenta fetch do servidor MCP para obter a página e, em seguida, analisa o seu conteúdo. Não precisa de abrir um navegador nem colar excertos de documentação no terminal.
Filtragem de Ferramentas MCP
Esta conveniência tem uma contrapartida. Cada servidor que adiciona traz o seu próprio conjunto de ferramentas e, com três ou quatro servidores ativos, o catálogo fica sobrecarregado. A filtragem permite manter apenas o que é relevante:
# Ativar apenas ferramentas de um servidor específico
enabled_tools = ["fetch_*"]
# Desativar todas as ferramentas MCP exceto as explicitamente ativadas
disabled_tools = ["mcp_*"]
A filtragem por wildcards serve dois propósitos simultaneamente. Reforça a segurança ao limitar o que o agente tem permissão para fazer e evita sobrecarregar o contexto do modelo: uma lista de ferramentas demasiado longa consome contexto valioso e degrada a qualidade das decisões do agente.
Configuração Avançada com Autenticação
Os servidores MCP empresariais exigem quase sempre autenticação. Para um token, a tabela [mcp_servers.auth] no modo static lê a chave de uma variável de ambiente cujo nome você fornece, inserindo-a depois no cabeçalho da sua escolha:
[[mcp_servers]]
name = "internal_api"
transport = "http"
url = "https://mcp.your-company.com"
[mcp_servers.auth]
type = "static"
api_key_env = "MCP_API_TOKEN" # nome da variável, não o token em si
api_key_header = "Authorization" # valor padrão
api_key_format = "Bearer {token}" # valor padrão
Para um servidor que ofereça login OAuth, como o da Linear, defina type = "oauth" e inicie sessão durante a sua sessão com /mcp login <name>: o Vibe abre o seu navegador e armazena os tokens no chaveiro do sistema, nunca no config.toml. O comando vibe mcp add trata de tudo isto a partir do terminal: vibe mcp add linear --url https://mcp.linear.app/mcp adiciona o servidor e inicia o fluxo de login.
A vantagem é direta: pode versionar e partilhar o seu ficheiro config.toml com a sua equipa sem codificar rigidamente quaisquer segredos, uma vez que cada programador fornece o seu próprio token através do seu ambiente.
Servidores MCP Populares
Vários servidores prontos a usar cobrem as necessidades mais comuns e todos são declarados da mesma forma no config.toml. O mcp-server-fetch trata da recuperação de páginas web e APIs; o mcp-server-filesystem expande as operações de ficheiros para além das ferramentas integradas; o mcp-server-git traz integração avançada com Git, incluindo diff, blame e log; o mcp-server-sqlite e o mcp-server-postgres permitem consultar bases de dados SQLite e PostgreSQL. Um agente que consegue ler tanto um esquema de base de dados como o código que o utiliza deteta inconsistências que a simples leitura de ficheiros nunca revelaria.
Durante uma sessão, /mcp lista os servidores e /mcp <name> lista as suas ferramentas; /mcp status mostra o estado de cada um. O agente também indica quais as ferramentas que está a utilizar nas suas respostas, o que continua a ser a melhor forma de verificar se um servidor está realmente a funcionar.
Segurança do Servidor MCP
Um servidor MCP executa com as suas permissões e vê o que você lhe der: adicione apenas servidores fidedignos, pois um servidor malicioso poderia expor dados do seu código. Em seguida, limite as permissões com enabled_tools em vez de conceder acesso total por padrão.
Dois hábitos completam esta rotina de higiene. Verifique os seus cabeçalhos: nenhum token deve aparecer em texto simples no config.toml; é exatamente para isso que serve o api_key_env. E para ferramentas locais, prefira o transporte STDIO, que é mais seguro do que um servidor HTTP exposto na rede, se não fosse apenas porque não abre nenhuma porta.
Pontos-chave
- O MCP permite adicionar ferramentas externas ao Vibe através de um protocolo padronizado
- Dois transportes principais: HTTP (servidor persistente) e STDIO (processo local)
- A filtragem de ferramentas (
enabled_tools,disabled_tools) controla o que o agente pode utilizar - Variáveis de ambiente nos cabeçalhos protegem os segredos
- Adicione apenas servidores MCP fidedignos e limite as suas permissões