O mundo externo,
como ferramenta.

O Model Context Protocol pluga bancos, APIs e serviços como ferramentas do agente. O MVCode fala MCP local (subprocesso) e remoto (HTTP) — com OAuth automático e gestão por diálogo, CLI e config.

01Local

{
  "mcp": {
    "meu-mcp": {
      "type": "local",
      "command": ["npx", "-y", "meu-mcp-command"],
      "enabled": true,
      "environment": { "MINHA_VAR": "valor" }
    }
  }
}

02Remoto

{
  "mcp": {
    "meu-remoto": {
      "type": "remote",
      "url": "https://meu-mcp.com/mcp",
      "headers": { "Authorization": "Bearer {env:MINHA_KEY}" }
    }
  }
}

Servidores padrão da organização podem chegar desabilitados via config remota (.well-known) — habilite o que precisa com enabled: true na sua config local.

03OAuth sem cerimônia

Servidor remoto respondeu 401? O MVCode inicia o fluxo OAuth sozinho — com Dynamic Client Registration (RFC 7591) quando o servidor suporta — e guarda os tokens com segurança. Credenciais pré-registradas entram no bloco oauth (clientId, clientSecret, scope); oauth: false desliga a detecção para servidores de API key.

mvcode mcp auth sentry
mvcode mcp auth list
mvcode mcp logout sentry
mvcode mcp debug sentry
# debug: status de auth, conectividade HTTP e discovery OAuth

04Ligando e desligando

Ferramentas MCP registram com o nome do servidor como prefixo — o padrão servidor_* controla todas de uma vez. O padrão profissional para muitos servidores: desligar global, ligar por agente:

{
  "mcp": { "meu-mcp": { "type": "local", "command": ["bun", "x", "meu-mcp"] } },
  "tools": { "meu-mcp*": false },
  "agent": {
    "meu-agente": { "tools": { "meu-mcp*": true } }
  }
}

Aprovação fina — "meumcp_*": "ask" — vive em permissões. O diálogo de MCP no app mostra cada servidor com dot de saúde e switch. Implementado

05Adicionando pela CLI

mvcode mcp add
→ guia local ou remoto, grava na config
mvcode mcp list
→ servidores configurados + status de conexão

06Exemplo: Sentry

{
  "mcp": {
    "sentry": { "type": "remote", "url": "https://mcp.sentry.dev/mcp", "oauth": {} }
  }
}

Na primeira chamada, o navegador abre para autorizar — e as issues do Sentry viram ferramentas da sessão.