# Conectar um app de IA

> Conecte o Claude, ChatGPT, Cursor, VS Code ou qualquer cliente MCP ao TradeCatalog com seu próprio login.

O TradeCatalog executa um servidor remoto [Model Context Protocol](https://modelcontextprotocol.io) (MCP). Conecte-o ao seu app de IA e faça perguntas como:

- “Quanto paga a Oakfield Joinery por 20 caixas do HX-8510?”
- “Há novos pedidos hoje?”
- “Quem alterou o desconto da Brookside e quando?”
- “Me encontre um parafuso hexagonal de zinco, M10, e o meu preço para ele.” (como comprador)

## Como funciona

| Configuração    | Valor                                                                                                 |
| --------------- | ----------------------------------------------------------------------------------------------------- |
| URL do servidor | `https://tradecatalog.app/mcp`                                                                        |
| Transporte      | HTTP Streamable                                                                                       |
| Autenticação    | OAuth 2.1: você se autentica com seu login normal do TradeCatalog e escolhe **Permitir**              |
| Acesso          | Acesso de leitura, mais acesso de escrita opcional com revisão assinada para mudanças significativas. |
| Quem age        | Você. Ele vê exatamente o que você pode ver no TradeCatalog.                                          |

- **Funcionários** veem os dados permitidos por seu papel e escopo de cliente. Funcionários de vendas podem cobrir apenas clientes ou regiões atribuídos; alterações no catálogo, preços, pedidos e equipe exigem a permissão correspondente.
- **Compradores** veem os fornecedores de quem compra, com seus próprios preços e seus próprios pedidos apenas.

Convites de equipe, configurações de workspace e acesso à API seguem as permissões atuais de funcionários do fornecedor. A exclusão de workspace permanece apenas para o proprietário. Compradores selecionam sua própria conta de cliente para cada pedido. Conexões existentes permanecem somente leitura até serem reautorizadas.

Cada chamada de ferramenta é verificada com as mesmas regras do app. Veja [Ferramentas MCP](/docs/mcp/tools) para o que cada ferramenta faz.

## Habilidades de fluxo de trabalho

O plugin do TradeCatalog inclui dez habilidades focadas com sua conexão MCP. Cada descrição de habilidade diz ao app de IA quando o fluxo de trabalho se aplica; suas instruções explicam quais ferramentas usar, o que ler primeiro e como lidar com confirmações e resultados incompletos.

| Habilidade                | Quando usá-la                                                                                                             |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `tradecatalog`            | Conectar, criar um workspace de fornecedor ou selecionar um fornecedor e conta de cliente.                                |
| `tradecatalog-catalogue`  | Criar, editar, ocultar, mostrar e organizar produtos ou abrir uploads de mídia de produtos.                               |
| `tradecatalog-pricing`    | Explicar preços acordados e ajustar termos, ou redigir e publicar alterações de preços de lista.                          |
| `tradecatalog-imports`    | Verificar e importar linhas de produtos, contas de clientes ou preços acordados.                                          |
| `tradecatalog-customers`  | Onboarding de clientes, convidar compradores e gerenciar acesso ou listas de produtos aprovados.                          |
| `tradecatalog-orders`     | Consultar preços de comprador, preparar ou repetir um pedido, baixar uma lista de preços permitida ou rastrear um pedido. |
| `tradecatalog-fulfilment` | Revisar pedidos de fornecedor e reconhecer, despachar, completar ou cancelar.                                             |
| `tradecatalog-updates`    | Ler atualizações de comprador ou publicar anúncios de fornecedor com escolhas de horário e e-mail explícitos.             |
| `tradecatalog-workspace`  | Gerenciar configurações de negócio, convites de equipe e transferências autorizadas de exportação ou API.                 |
| `tradecatalog-support`    | Ler, preparar ou enviar um pedido de suporte de fornecedor ou follow-up para Happy Webs.                                  |

Outros agentes podem descobrir os mesmos guias a partir [do índice de habilidades público](https://tradecatalog.app/.well-known/agent-skills/index.json). As habilidades orientam o fluxo de trabalho; o servidor ainda verifica o acesso da conta e exige confirmação assinada para mudanças significativas.

## Inscreva-se e pague com um agente

Você pode se conectar antes de ter um workspace. A conexão abre a página de login do TradeCatalog, onde um novo endereço de e-mail cria seu login após você verificar. Conclua a verificação lá, depois retorne ao seu app de IA. Nunca compartilhe códigos de login ou detalhes de pagamento em chat.

Peça ao agente para criar seu workspace de fornecedor. Ele pede seu nome da empresa, moeda dos produtos, fuso horário e país, depois usa `create_workspace` para sua confirmação. Seu workspace inicia um teste Pro de 14 dias sem cartão. Não é uma assinatura paga. Quando o teste terminar, ele retorna para Grátis, até 100 produtos, a menos que você atualize.

Para agentes cujo host permite cobrança de assinatura de software, conecte-se a **`https://tradecatalog.app/mcp/account`**. Ele usa o mesmo login do TradeCatalog, escopos OAuth e membros da área de trabalho, com todas as ferramentas ordinárias mais `open_billing`. Quando você solicitar pagar ou gerenciar sua assinatura, esta ferramenta exclusiva do proprietário abre a página de cobrança segura da área de trabalho. Escolha cobrança mensal ou anual e confirme o pagamento no Stripe. Os assinantes existentes podem gerenciar sua assinatura lá. O agente pode verificar `get_settings` depois; abrir um link não é comprovação de que o pagamento foi concluído.

Os plugins do ChatGPT usam **`https://tradecatalog.app/mcp`**, que não expõe ferramentas de cobrança. As diretrizes dos plugins da OpenAI [plugin guidelines](https://developers.openai.com/plugins/plugin-guidelines) atualmente excluem a venda de assinaturas de software e a promoção de atualizações. O cadastro gratuito e a criação de espaços de trabalho estão disponíveis por meio dessa conexão. Os agentes podem preparar solicitações de ordem de comércio. Pagamentos opcionais do cliente exigem que o comprador abra a página de ordem autenticada, aprova a cobrança confirmada pelo fornecedor e conclua o Stripe Checkout. A aprovação de um pedido por um agente nunca é aprovação de pagamento.

## Claude (web, desktop e mobile)

1. Abra **Configurações**, depois **Conectores** e escolha **Adicionar conector personalizado**.
2. Dê-lhe o nome "TradeCatalog" e cole `https://tradecatalog.app/mcp`.
3. Escolha **Conectar**. Faça login no TradeCatalog com seu código de e-mail e escolha **Permitir**.

Os conectores que você adicionar no site também aparecem no Claude Desktop e nos aplicativos móveis. Em planos de Equipe e Empresa, um proprietário pode precisar adicionar o conector primeiro para a organização.

## Claude Code

```bash
claude mcp add --transport http tradecatalog https://tradecatalog.app/mcp
```

Em seguida, execute `/mcp` no Claude Code e escolha **tradecatalog** para fazer login.

## ChatGPT

1. Abra **Configurações**, depois **Apps & Conectores**. Se seu plano precisar, ative **Modo de desenvolvedor** sob **Avançado**.
2. Crie um conector com a URL `https://tradecatalog.app/mcp` e autenticação OAuth.
3. Faça login no TradeCatalog e escolha **Permitir**.

## Cursor

Adicione isso a `~/.cursor/mcp.json` (ou `.cursor/mcp.json` em um projeto):

```json
{
  "mcpServers": {
    "tradecatalog": { "url": "https://tradecatalog.app/mcp" }
  }
}
```

O Cursor abre a página de login do TradeCatalog na primeira vez que você o usar.

## VS Code

Adicione isso a `.vscode/mcp.json`:

```json
{
  "servers": {
    "tradecatalog": { "type": "http", "url": "https://tradecatalog.app/mcp" }
  }
}
```

## Outros clientes

Qualquer cliente que suporte MCP remoto por HTTP com Streamable e OAuth funciona. Para clientes que só executam servidores locais (stdio), use o puente `mcp-remote`:

```json
{
  "mcpServers": {
    "tradecatalog": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://tradecatalog.app/mcp"]
    }
  }
}
```

Quer construir seu próprio cliente? Veja [OAuth para clientes MCP](/docs/mcp/oauth).

## Desconectar um app

Veja todos os apps de IA que você aprovou e desconecte qualquer um deles em [tradecatalog.app/oauth/connections](/oauth/connections). Remover o conector em seu app de IA interrompe esse app de usá-lo. Desconectar aqui também revoga seu acesso do nosso lado, imediatamente.

## MCP ou a API REST?

|                          | MCP                                                | API REST                                     |
| ------------------------ | -------------------------------------------------- | -------------------------------------------- |
| Para                     | Pessoas que conversam em um app de IA              | Seus próprios sistemas e scripts             |
| Faz login como           | Cada pessoa, com seu próprio login                 | O workspace, com a chave API do proprietário |
| Compradores podem usá-lo | Sim, com seus próprios preços                      | Não                                          |
| Pode alterar dados       | Sim, com escopo de gravação e alterações revisadas | Sim, com uma chave de leitura e gravação     |
| Configurado por          | Cada pessoa, em seu app de IA                      | O proprietário, em Configurações             |
| Documentação             | [Ferramentas](/docs/mcp/tools)                     | [API REST](/docs/api)                        |