Pular para o conteúdo
Menu de documentos

MCP

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 (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 funcionaLink para esta seção#

ConfiguraçãoValor
URL do servidorhttps://tradecatalog.app/mcp
TransporteHTTP Streamable
AutenticaçãoOAuth 2.1: você se autentica com seu login normal do TradeCatalog e escolhe Permitir
AcessoAcesso de leitura, mais acesso de escrita opcional com revisão assinada para mudanças significativas.
Quem ageVocê. 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 para o que cada ferramenta faz.

Habilidades de fluxo de trabalhoLink para esta seção#

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.

HabilidadeQuando usá-la
tradecatalogConectar, criar um workspace de fornecedor ou selecionar um fornecedor e conta de cliente.
tradecatalog-catalogueCriar, editar, ocultar, mostrar e organizar produtos ou abrir uploads de mídia de produtos.
tradecatalog-pricingExplicar preços acordados e ajustar termos, ou redigir e publicar alterações de preços de lista.
tradecatalog-importsVerificar e importar linhas de produtos, contas de clientes ou preços acordados.
tradecatalog-customersOnboarding de clientes, convidar compradores e gerenciar acesso ou listas de produtos aprovados.
tradecatalog-ordersConsultar preços de comprador, preparar ou repetir um pedido, baixar uma lista de preços permitida ou rastrear um pedido.
tradecatalog-fulfilmentRevisar pedidos de fornecedor e reconhecer, despachar, completar ou cancelar.
tradecatalog-updatesLer atualizações de comprador ou publicar anúncios de fornecedor com escolhas de horário e e-mail explícitos.
tradecatalog-workspaceGerenciar configurações de negócio, convites de equipe e transferências autorizadas de exportação ou API.
tradecatalog-supportLer, 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. 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 agenteLink para esta seção#

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 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)Link para esta seção#

  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 CodeLink para esta seção#

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

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

ChatGPTLink para esta seção#

  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.

CursorLink para esta seção#

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 CodeLink para esta seção#

Adicione isso a .vscode/mcp.json:

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

Outros clientesLink para esta seção#

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.

Desconectar um appLink para esta seção#

Veja todos os apps de IA que você aprovou e desconecte qualquer um deles em tradecatalog.app/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?Link para esta seção#

MCPAPI REST
ParaPessoas que conversam em um app de IASeus próprios sistemas e scripts
Faz login comoCada pessoa, com seu próprio loginO workspace, com a chave API do proprietário
Compradores podem usá-loSim, com seus próprios preçosNão
Pode alterar dadosSim, com escopo de gravação e alterações revisadasSim, com uma chave de leitura e gravação
Configurado porCada pessoa, em seu app de IAO proprietário, em Configurações
DocumentaçãoFerramentasAPI REST