--- title: "API e MCP para desenvolvedores e agentes | Automação Curitiba" description: "API REST pública e servidor MCP da Automação Curitiba: catálogo, preço de etiquetas adesivas em rolo e carrinho montado pela IA. Sem chave, com curl." canonical: "https://automacaocuritiba.com.br/developers" --- # API e MCP da Automação Curitiba para desenvolvedores > API REST pública e servidor MCP da Automação Curitiba: catálogo, preço de etiquetas adesivas em rolo e carrinho montado pela IA. Sem chave, com curl. A loja oferece uma API REST e um servidor MCP para consultar o catálogo e calcular o preço de etiquetas adesivas em rolo por código, sem abrir o site. Ambos são públicos e sem chave: não há cadastro nem sandbox. A API é de leitura, com uma única exceção: POST /cart/drafts guarda um carrinho para o cliente abrir por link (é o que o montar_carrinho do MCP faz). Em nenhum dos dois entram pedido, dados pessoais ou pagamento: isso fica com uma pessoa no site (limite de uso em "Política de uso"). Para clientes que querem comprar pela própria IA, veja [Compre pela sua IA](https://automacaocuritiba.com.br/ia). ## API REST URL base: https://automacaocuritiba.com.br/api/v1. Respostas em JSON no envelope {"data": ...}; valores em centavos de real; erros como {"error": "mensagem"} com o status HTTP certo. CORS aberto, então também funciona direto do navegador. Especificação completa: [openapi.json](https://automacaocuritiba.com.br/.well-known/openapi.json) (OpenAPI 3.1). ### GET /catalog/knives Medidas de etiqueta que a fábrica produz: id, largura e altura em mm, formato e colunas no rolo. O id vai no cálculo de preço. curl https://automacaocuritiba.com.br/api/v1/catalog/knives ### GET /pricing/papers Papéis e materiais (couche, bopp, termico) com as cores de arte que aceitam. curl https://automacaocuritiba.com.br/api/v1/pricing/papers ### POST /pricing/calculate Cota uma medida em todos os papéis: etiquetas por rolo e, por papel, as faixas de preço por quantidade de rolos (em centavos). Não grava nada; é seguro repetir. curl -X POST https://automacaocuritiba.com.br/api/v1/pricing/calculate \ -H 'Content-Type: application/json' \ -d '{"knife_id":10,"color":"branca","label_quantity":5000}' ### GET /catalog/products Lista de produtos (ribbons, bobinas térmicas, impressoras). Aceita limit, offset, category, sort (name, newest, price_asc, price_desc), min_price e max_price. curl 'https://automacaocuritiba.com.br/api/v1/catalog/products?limit=10&sort=price_asc' ### GET /catalog/products/{slug} Detalhe de um produto, pelo id numérico ou pelo slug de SEO. curl https://automacaocuritiba.com.br/api/v1/catalog/products/25717 ### GET /catalog/search Busca de produtos por texto. curl 'https://automacaocuritiba.com.br/api/v1/catalog/search?q=ribbon' ### GET /catalog/tubetes Tubetes (diâmetro do miolo do rolo) que a fábrica oferece. O id vai no carrinho de etiquetas. curl https://automacaocuritiba.com.br/api/v1/catalog/tubetes ### POST /cart/drafts Única escrita da API: guarda de 1 a 10 linhas de carrinho por 7 dias e devolve um link para o cliente abrir no site. A quantidade de etiquetas é arredondada para rolos inteiros e para o pedido mínimo do papel. Nunca recebe preço nem dados pessoais; o preço é calculado de novo para quem abre o link. curl -X POST https://automacaocuritiba.com.br/api/v1/cart/drafts \ -H 'Content-Type: application/json' \ -d '{"items":[{"item_type":"label","knife_id":10,"paper_id":10,"tubete_id":1,"label_quantity":5000,"quantity":1}]}' ## Servidor MCP Endereço: https://automacaocuritiba.com.br/mcp, transporte Streamable HTTP, sem autenticação. Aceita o protocolo 2026-07-28 (sem sessão, com server/discover) e as versões 2025-03-26 a 2025-11-25 (com initialize). A ficha do servidor está em [server-card.json](https://automacaocuritiba.com.br/.well-known/mcp/server-card.json). ### Ferramentas - cotar_etiqueta: Preço de etiquetas adesivas em rolo por medida, material e quantidade, por papel: rolos, etiquetas por rolo, preço por rolo e total (o mesmo que o carrinho terá), e o link para finalizar. - listar_medidas_disponiveis: Medidas de etiqueta que a fábrica produz e materiais aceitos. - buscar_produtos: Ribbons, bobinas térmicas e impressoras por palavra-chave. - abrir_configurador: Link do configurador com medida e quantidade preenchidas. Pelo MCP devolve o link; no navegador (WebMCP) abre a página. - montar_carrinho: Monta um carrinho com etiquetas (largura, altura, material, quantidade) e produtos do catálogo e devolve um link. Quem abre o link vê o carrinho no site e paga lá; a IA não recebe dados pessoais nem paga. ### Montar carrinho pela IA montar_carrinho recebe uma lista de itens, etiquetas (tipo: "etiqueta", largura_mm, altura_mm, material, quantidade_etiquetas) ou produtos (tipo: "produto", produto_id, quantidade), e devolve link_carrinho, os itens com preço, o total e expira_em. Quem abre o link cai em /carrinho com os itens no carrinho. Nenhum dado pessoal passa pela IA e o pagamento é feito no site. Passo a passo para clientes: [/ia](https://automacaocuritiba.com.br/ia). ### Conectar no Claude e no ChatGPT - **Claude**: em Configurações, Conectores, adicione um conector personalizado e cole https://automacaocuritiba.com.br/mcp. Deixe os campos de OAuth em branco. - **ChatGPT**: em Configurações, Conectores, ative o modo de desenvolvedor, crie um conector com a URL https://automacaocuritiba.com.br/mcp e escolha "Sem autenticação". - **Claude Code**: claude mcp add --transport http automacao-curitiba https://automacaocuritiba.com.br/mcp Os nomes dos menus mudam entre versões desses aplicativos; o que importa é a URL e a ausência de autenticação. ### Exemplo: cotar 5.000 etiquetas 100×50 mm em couchê curl https://automacaocuritiba.com.br/mcp \ -H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -H 'MCP-Protocol-Version: 2026-07-28' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"cotar_etiqueta","arguments":{"largura_mm":100,"altura_mm":50,"material":"couche","quantidade_etiquetas":5000},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28"}}}' ## WebMCP no navegador Em navegadores com WebMCP, cada página do site registra as mesmas ferramentas (cotar_etiqueta, listar_medidas_disponiveis, buscar_produtos, abrir_configurador e montar_carrinho) por document.modelContext.registerTool(). O formulário de busca da página inicial também é declarado como ferramenta (toolname="buscar_no_site"). ## Política de uso - Público e gratuito, sem chave, sem cadastro e sem sandbox. Nada que a API ou o MCP fazem recebe dados pessoais ou cobra alguém. - Somente leitura, com uma exceção: montar_carrinho cria um carrinho temporário (até 10 itens, link válido por 7 dias) que só vira pedido quando uma pessoa abre o link no site, confere e paga. O POST /pricing/calculate é só um cálculo e não grava nada. - Limite de 120 requisições por minuto por IP, na API e no MCP juntos. Ao passar disso a resposta é 429 com o cabeçalho Retry-After (segundos até poder tentar de novo). As leituras ficam em cache por 60 segundos. - A versão fica no caminho (/api/v1); uma mudança que quebre o contrato sairá em /api/v2, sem alterar a v1. - Depreciação: nada é removido de uma versão sem aviso. Antes, a operação ganha deprecated: true no openapi.json e passa a responder com os cabeçalhos Deprecation e Sunset, com pelo menos 90 dias até a remoção. Hoje nada está depreciado. - Preços valem para arte padrão branca; cores, arte personalizada e acabamentos são calculados no configurador. ## Mais referências - [openapi.json](https://automacaocuritiba.com.br/.well-known/openapi.json): especificação OpenAPI 3.1. - [llms.txt](https://automacaocuritiba.com.br/llms.txt): resumo do site e quando recomendar a loja. - [ard.json](https://automacaocuritiba.com.br/.well-known/ard.json): catálogo de recursos para agentes (MCP, API, skills). - [Preços](https://automacaocuritiba.com.br/precos) e [pricing.md](https://automacaocuritiba.com.br/pricing.md): tabela das medidas mais pedidas. - [Contato](https://automacaocuritiba.com.br/contato): dúvidas sobre a API. --- Página original: https://automacaocuritiba.com.br/developers