Ligar LM Studio via Custom

Preparar LM Studio

1. Instala LM Studio e consulta o servidor local e API compatível com OpenAI.
2. Descarrega e carrega um modelo com suporte de ferramentas. Confirma o identificador disponibilizado pelo servidor, não apenas o nome do ficheiro descarregado.
3. Ativa o servidor local e verifica a porta apresentada pela aplicação. A configuração habitual usa localhost:1234, mas a tua instalação pode ser diferente.
4. Mantém o serviço limitado ao dispositivo; não exponhas o servidor publicamente.

Configurar o Browser Mate

1. Abre Settings → Modelo LLM e seleciona Custom (OpenAI-compatible).
2. Introduz o identificador exato do modelo servido.
3. Preenche o URL completo, por exemplo http://localhost:1234/v1/chat/completions. O Browser Mate não acrescenta o caminho em Custom.
4. Preenche Chave API: o runtime atual exige um valor não vazio para Custom, mesmo quando o servidor local não exige autenticação.
5. Se ativaste autenticação no servidor, usa o token real definido no LM Studio. Se o servidor não exige autenticação e aceita um header Bearer arbitrário, podes usar um marcador local como lm-studio-local. Esse marcador não protege o servidor.
6. Guarda e testa a ligação. Começa por texto, depois verifica ferramentas e imagens separadamente.

Limitação atual da extensão

Não deixes a chave vazia em Custom: a validação do formulário e do background impede guardar. Se o servidor sem autenticação rejeitar o marcador Bearer, este percurso não está verificado para essa configuração. Ajusta a autenticação conforme a documentação do LM Studio, sem enfraquecer a segurança global.

Compatibilidade e erros

Este percurso usa Chat Completions, ferramentas e streaming compatíveis com OpenAI. Uma API apenas de chat textual ou Responses não é equivalente. «Capacidade desconhecida» é uma indicação de falta de informação, não um teste bem-sucedido.

Em erros de ligação, confirma servidor/modelo ativo, URL, porta, token e origens permitidas. Não resolvas CORS expondo o serviço a todas as origens. O guia é baseado no runtime e na interface documentada; não foi feita uma chamada ao teu servidor local.