# Documentação do desenvolvedor do TradeCatalog

> Conecte seus sistemas e apps de IA ao TradeCatalog com a API REST, o servidor MCP e documentos prontos para LLMs.

TradeCatalog mantém o catálogo de um fornecedor de comércio, preços dos clientes, pedidos e mudanças de preço em um só lugar. Esses documentos cobrem as formas como o software pode trabalhar com esses dados.

Para famílias de catálogos, produtos medidos, tabelas de tamanhos e importações revisadas, consulte [Configure seu catálogo comercial](/docs/guides/trade-catalogues).

## Três maneiras de entrar

### API REST

Para seus próprios sistemas: ERP, controle de estoque, contas, um script noturno. Os proprietários criam uma chave de API em **Configurações → API**. A chave funciona em um workspace com direitos de equipe.

- Leia produtos com os preços de qualquer cliente, clientes, pedidos, mudanças de preço e o log de atividades.
- Crie e atualize produtos e clientes em lotes de 100.
- Mova pedidos (confirmados, despachados, concluídos, cancelados).

Comece com o [guia rápido](/docs/quickstart), depois leia a [visão geral da API REST](/docs/api).

### Servidor MCP para apps de IA

Para pessoas usando Claude, ChatGPT, Cursor ou qualquer cliente MCP. Cada pessoa entra com seu próprio login TradeCatalog e aprova o acesso de leitura, opcionalmente com acesso de gravação e alterações revisadas. O app de IA então vê exatamente o que essa pessoa vê no app: os funcionários veem seus workspaces, os compradores veem seus próprios preços.

Veja [Conectar um aplicativo de IA](/docs/mcp) e as [ferramentas MCP](/docs/mcp/tools).

### Documentos para LLMs

Toda página aqui também é markdown simples. Adicione `.md` a qualquer URL de documento, ou baixe [/llms-full.txt](/llms-full.txt) para todos eles em um único arquivo. Cada página tem os botões **Copiar página** e **Abrir no Claude**. Veja [Recursos de IA e LLMs](/docs/guides/llms).

## Qual devo usar?

| Você quer…                                                                         | Usar                              |
| ---------------------------------------------------------------------------------- | --------------------------------- |
| Sincronizar produtos e clientes do seu ERP todas as noites                         | [REST API](/docs/guides/erp-sync) |
| Buscar novos pedidos para suas contas ou sistema de expedição                      | [REST API](/docs/api/orders)      |
| Perguntar "O que a Oakfield Joinery paga pelo HX-8510?" no chat                    | [MCP](/docs/mcp)                  |
| Permitir que um comprador verifique seus próprios preços a partir de seu app de IA | [MCP](/docs/mcp)                  |
| Gerar um cliente tipado para o seu código                                          | [OpenAPI](/docs/api/openapi)      |

## O que ainda não está aqui

- **Webhooks.** Consulte [`GET /orders?status=new`](/docs/api/orders) a cada alguns minutos.
- **Publicação de alterações de preços por API.** Os preços de lista alterados entram em um rascunho que você revisa e publica no aplicativo. Veja [Alterações de preços](/docs/api/price-changes).
- **Exclusão de produtos ou clientes por API.** Tornar um produto inativo ou removê-lo no aplicativo.
- **Chaves para compradores.** Os compradores usam [MCP](/docs/mcp) ou baixam sua lista de preços como CSV de seu portal comercial.

Precisa de ajuda com uma conexão? Consulte [Contato com o suporte](/docs/support).

Algo faltando que você precisa? Envie um e-mail para o suporte a partir do seu workspace (Suporte no menu) e nos diga o que você está construindo.