Suas chaves,
suas regras.

O MVCode fala com 75+ provedores de modelo e com modelos locais. BYOK é o caminho padrão: a credencial fica na sua máquina, o contrato é entre você e o provedor.

01Conectando um provedor

1. Rode /connect

   Selecione o provedor na lista — os populares vêm pré-carregados.

2. Cole a chave de API

   Ela é gravada no auth store local (auth.json no diretório de dados), nunca na config em texto plano.

3. Escolha o modelo

   /models lista tudo que os provedores conectados oferecem. Modelos →

Chaves definidas em variáveis de ambiente ou em um .env do projeto também são carregadas na inicialização.

02Configurando provedores

A seção provider da config customiza qualquer provedor — o caso mais comum é trocar o endpoint:

{
  "provider": {
    "anthropic": {
      "options": { "baseURL": "https://api.anthropic.com/v1" }
    }
  }
}

Útil para proxies corporativos, gateways de billing e endpoints privados. Em ambientes restritos, combine com a política de rede.

03Diretório

Uma amostra do que o /connect oferece — a lista completa vive no seletor, alimentada pelo catálogo de modelos:

04Modelos locais

Ollama e LM Studio entram como provedores OpenAI-compatible apontando para o servidor local:

{
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": { "baseURL": "http://localhost:11434/v1" },
      "models": { "qwen3-coder": { "name": "Qwen3 Coder" } }
    }
  }
}

05Provedor customizado

Qualquer API OpenAI-compatible entra sem esperar por suporte oficial. No /connect, escolha Other, dê um id e cole a chave; depois declare o provedor na config:

{
  "provider": {
    "meuprovedor": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Meu Provedor",
      "options": {
        "baseURL": "https://api.meuprovedor.com/v1",
        "apiKey": "{env:MEUPROVEDOR_API_KEY}",
        "headers": { "X-Team": "maxvision" }
      },
      "models": {
        "meu-modelo": {
          "name": "Meu Modelo",
          "limit": { "context": 200000, "output": 65536 }
        }
      }
    }
  }
}

• npm — @ai-sdk/openai-compatible para /v1/chat/completions; use @ai-sdk/openai se o endpoint for /v1/responses.
• {env:VAR} — interpola variáveis de ambiente; a chave nunca precisa aparecer literal no arquivo.
• limit — declara janelas de contexto e saída para o orçamento de contexto da sessão.

Runtimes externos com saúde, agentes e sessões próprias merecem mais que um provedor genérico — veja connectors.