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

Configurar Servidores MCP no Vibe

Aula 8 de 16 Atualizada a 2 de novembro de 2026 Programador
Nesta página
  1. O Que É o MCP?
  2. Os Dois Tipos de Transporte
  3. Exemplo Prático: Adicionar Recuperação Web
  4. Filtragem de Ferramentas MCP
  5. Configuração Avançada com Autenticação
  6. Servidores MCP Populares
  7. Segurança do Servidor MCP
  8. Pontos-chave

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_env ou OAuth); a sintaxe ${VARIABLE} nos cabeçalhos, anteriormente apresentada, não está documentada para servidores MCP. Foram adicionados os subcomandos vibe mcp add e /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