# Protocolo de Serviço de Modelos Locais (LMSP)

> O LMSP é um protocolo aberto para descobrir e chamar os modelos de linguagem do seu dispositivo. Define descoberta de serviços, catálogo de modelos, streaming, tarefas persistentes e compatibilidade com a OpenAI.

Source: https://madeforagent.com/pt-br/lmsp/
Language: pt-BR
Updated: 2026-11-08

## O que o LMSP faz {#what}

O LMSP (Local Model Service Protocol) é um protocolo aberto para softwares que executam modelos de linguagem no próprio dispositivo ou na rede local do usuário, e para os clientes que usam esse software.

Um serviço local residente se descreve em um endereço well-known e lista seus modelos. Ele responde às requisições de geração com JSON ou com eventos enviados pelo servidor, e executa as gerações longas como tarefas persistidas, que podem ser canceladas e acompanhadas de novo após uma desconexão. O mesmo serviço também fala a API da OpenAI, de modo que os clientes que existem hoje continuam funcionando.

O LMSP não substitui a API da OpenAI, o Ollama nem o MCP. Ele combina os pontos fortes de cada um em uma camada de protocolo pensada para serviços locais residentes.

## Visão rápida {#glance}

| Tópico | Resumo |
| --- | --- |
| Endereço padrão | `http://127.0.0.1:17832` |
| Descrição do serviço | `GET /.well-known/lmsp.json` |
| Interface principal | `/lmsp/v1`, JSON sobre HTTP, streaming com eventos enviados pelo servidor |
| Interfaces de compatibilidade | `/v1` para clientes OpenAI, `/api` opcional para clientes Ollama |
| Descoberta | Endereço manual, sondagem de endereços locais, mDNS e DNS-SD opcionais (`_lmsp._tcp.local.`) |
| Autenticação | Tokens de portador obtidos por pareamento local |
| Persistência | SQLite embutido, com tarefas que sobrevivem a uma reinicialização |
| Contrato | OpenAPI 3.2 |

## Experimente {#try}

Se um serviço LMSP estiver em execução na sua máquina, este é o fluxo completo. Faça primeiro o pareamento para obter um token, como descrito na [seção 10.2](https://madeforagent.com/pt-br/lmsp/1.0/security.md#pairing), e guarde-o em `LMSP_TOKEN`.

```sh
# 1. Descobrir o serviço
curl http://127.0.0.1:17832/.well-known/lmsp.json

# 2. Listar os modelos locais
curl http://127.0.0.1:17832/lmsp/v1/models \
  -H "Authorization: Bearer $LMSP_TOKEN"

# 3. Gerar uma resposta
curl http://127.0.0.1:17832/lmsp/v1/responses \
  -H "Authorization: Bearer $LMSP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen3:14b-q4_k_m","input":[{"type":"message","role":"user","content":[{"type":"input_text","text":"Hello"}]}]}'
```

## Como o LMSP se relaciona com outros protocolos {#related}

| Protocolo | O que cobre | Relação com o LMSP |
| --- | --- | --- |
| API da OpenAI | Modelos hospedados. A Responses API é a sua interface mais recente. | O LMSP segue a estrutura do Responses em sua interface principal, e um serviço oferece, ao lado dela, uma interface compatível com a OpenAI. |
| Ollama | Um ambiente de execução local que já serve endpoints compatíveis com a OpenAI. | Pode ficar por trás de um serviço LMSP como adaptador, e o LMSP define endpoints opcionais compatíveis com o Ollama. |
| MCP | Conecta agentes a ferramentas e contexto. | O LMSP conecta agentes a modelos. Ambos preferem a descoberta sem estado a sessões obrigatórias. |
| A2A | Colaboração entre agentes. | O LMSP toma emprestados os cartões de serviço e os estados explícitos de tarefa para a descrição do serviço e para as suas tarefas. |

## Recursos {#resources}

- A [especificação, versão 1.0 (rascunho)](https://madeforagent.com/pt-br/lmsp/1.0.md).
- O contrato OpenAPI, em [JSON](https://madeforagent.com/lmsp/1.0/openapi.json) ou [YAML](https://madeforagent.com/lmsp/1.0/openapi.yaml).
- [llms.txt](https://madeforagent.com/pt-br/llms.txt) e [llms-full.txt](https://madeforagent.com/pt-br/llms-full.txt), para modelos de linguagem.
- Cada página está disponível em Markdown. Substitua a barra final do endereço por `.md`, por exemplo [`/pt-br/lmsp/1.0/tasks.md`](https://madeforagent.com/pt-br/lmsp/1.0/tasks.md).

## Perguntas frequentes

### O que é o LMSP?

O LMSP, o Local Model Service Protocol (Protocolo de Serviço de Modelos Locais), é um protocolo aberto para serviços de modelos de linguagem executados no próprio dispositivo do usuário ou na rede local. Ele define como os clientes descobrem um serviço, listam seus modelos, solicitam respostas, recebem a saída em streaming e executam tarefas longas.

### O LMSP substitui a API da OpenAI, o Ollama ou o MCP?

Não. O LMSP se apoia neles. Sua interface principal segue a estrutura do OpenAI Responses, um serviço pode oferecer endpoints compatíveis com a OpenAI e com o Ollama, e o protocolo toma emprestados do MCP a descoberta sem estado e do A2A os estados das tarefas.

### Os clientes OpenAI existentes podem usar um serviço LMSP?

Normalmente sim. Eles precisam de outra URL base e do token do LMSP como chave de API. Não encontram o serviço automaticamente, porque a descoberta exige um cliente compatível com o LMSP.

### Como um cliente encontra um serviço LMSP local?

Ele tenta três coisas, nesta ordem. Primeiro um endereço digitado manualmente; depois o endereço local convencional, onde requisita /.well-known/lmsp.json; e por fim, opcionalmente, a busca por mDNS e DNS-SD de _lmsp._tcp.local. na rede local.

### Um serviço de modelos no localhost é seguro?

Não automaticamente, porque páginas da web podem tentar acessar portas locais. Os serviços LMSP se vinculam ao loopback por padrão, exigem tokens de portador obtidos por pareamento local, verificam os cabeçalhos Origin e Host e exigem autenticação no modo LAN.

### Qual é o status da especificação?

A versão 1.0 é um primeiro rascunho público e ainda pode mudar de forma incompatível. O texto em inglês é o normativo, e as traduções são oferecidas por conveniência.