# Promax Studio

> Software de projeto de móveis planejados no navegador (cozinha, dormitório, closet, banheiro, comercial), para fábricas, marcenarias, lojas e escritórios de arquitetura. Tudo é parametrizado: o sistema calcula sozinho as peças, a furação, as fitas, as ferragens e a saída de produção. Uma API para IA deixa o ChatGPT e o Claude lerem e desenharem nos projetos de uma empresa (ambientes, paredes, móveis, eletros, tampos e peças avulsas), com as mesmas regras da tela.

A documentação é pública; toda chamada à API precisa da chave da empresa. Medidas sempre em mm. Os endereços abaixo são os do ar; se você leu este arquivo de outro endereço (um ambiente de teste), troque o começo pelo de onde ele veio.

## Como a IA se conecta

- Chave: o dono ou o administrador cria em Empresa > Integrações, escolhe o escopo (ler e mudar projetos, ou só ler) e a validade, e copia uma vez. Ela vai no cabeçalho `Authorization: Bearer pmxs_...` de todo pedido. Sem chave, a resposta é 401.
- ChatGPT: num GPT personalizado, em Ações, importe o documento OpenAPI por endereço e escolha autenticação "Chave de API", tipo Bearer, com a chave.
- Claude Code e Claude Desktop: servidor MCP por HTTP em `/api/v1/mcp`, com o cabeçalho Authorization. Exemplo: `claude mcp add --transport http promax-studio https://promaxstudio.com.br/api/v1/mcp --header "Authorization: Bearer pmxs_..."`.
- Conector do claude.ai (pelo navegador): ainda não funciona, porque ele pede OAuth, que o Promax Studio ainda não tem. Está na lista do que vem depois.

## Documentação

- [Guia completo da API para IA](https://promaxstudio.com.br/llms-full.txt): o roteiro "desenhe estes móveis neste ambiente", como medir o lugar de cada item na parede, todas as operações e ferramentas com exemplos em JSON, os comandos, os erros, os limites e como desfazer.
- [Documento OpenAPI 3.1](https://promaxstudio.com.br/api/v1/openapi.json): as operações REST, pro ChatGPT importar.
- [Servidor MCP](https://promaxstudio.com.br/api/v1/mcp): pro Claude (só POST, com a chave).

## Opcional

- [Site do Promax Studio](https://promaxstudio.com.br/): o produto, em beta por convite.