Aller au contenu
Menu documentation

MCP

Connectez une application AI

Connectez Claude, ChatGPT, Cursor, VS Code ou tout client MCP à TradeCatalog avec votre propre connexion.

TradeCatalog exécute un serveur Protocole de contexte de modèle (MCP) à distance. Connectez-le à votre application d'IA et posez des questions comme :

  • « Combien paie Oakfield Joinery pour 20 boîtes de HX-8510 ? »
  • « Y a-t-il de nouvelles commandes aujourd'hui ? »
  • « Qui a modifié la remise de Brookside, et quand ? »
  • « Trouvez-moi un boulon hexagonal en zinc, M10, et mon prix pour celui-ci. » (en tant qu'acheteur)

Comment ça marcheLien vers cette section#

ParamètreValeur
URL du serveurhttps://tradecatalog.app/mcp
TransportHTTP diffusable
ConnexionOAuth 2.1 : vous vous connectez avec votre connexion habituelle à TradeCatalog et choisissez Autoriser
AccèsAccès en lecture, plus un accès en écriture optionnel avec une revue signée pour les changements conséquents.
Qui agit commeVous. Il voit exactement ce que vous pouvez voir dans TradeCatalog.
  • Personnel voient les données autorisées par leur rôle et leur portée client. Le personnel commercial peut couvrir uniquement les clients ou régions assignés ; les changements de catalogue, prix, commande et équipe nécessitent chacun la permission correspondante.
  • Acheteurs voient les fournisseurs auprès desquels ils achètent, avec leurs propres prix et leurs propres commandes uniquement.

Les invitations d'équipe, les paramètres d'espace de travail et l'accès API suivent les permissions actuelles du personnel du fournisseur. La suppression d'un espace de travail reste réservée à l'administrateur. Les acheteurs sélectionnent leur propre compte client pour chaque commande. Les connexions existantes restent en lecture seule jusqu'à leur réautorisation.

Chaque appel d'outil est vérifié avec les mêmes règles que l'application. Voir Outils MCP pour ce que chaque outil fait.

Compétences de workflowLien vers cette section#

Le plugin TradeCatalog intègre dix compétences ciblées avec sa connexion MCP. Chaque description de compétence indique à l'application d'IA quand le workflow s'applique ; ses instructions expliquent quels outils utiliser, quels éléments lire en premier et comment gérer les confirmations et les résultats incomplets.

CompétenceQuand l'utiliser
tradecatalogConnectez-vous, créez un espace de travail fournisseur ou sélectionnez un fournisseur et un compte client.
tradecatalog-catalogueCréez, modifiez, masquez, affichez et organisez les produits ou ouvrez les téléchargements de médias de produits.
tradecatalog-pricingExpliquez les prix convenus et ajustez les termes, ou rédigez et publiez des changements de prix de liste.
tradecatalog-importsVérifiez et importez les lignes de produits, comptes clients ou prix convenus.
tradecatalog-customersInscrire les clients, inviter les acheteurs et gérer l'accès ou les listes de produits approuvés.
tradecatalog-ordersRechercher les prix d'acheteur, préparer ou répéter une commande, télécharger une liste de prix autorisée ou suivre une commande.
tradecatalog-fulfilmentExaminer les commandes fournisseurs et les valider, expédier, terminer ou annuler.
tradecatalog-updatesLire les mises à jour des acheteurs ou publier des annonces fournisseurs avec un choix explicite de date et d'envoi par courriel.
tradecatalog-workspaceGérer les paramètres d'entreprise, les invitations de personnel et les transferts d'exportation ou d'API autorisés.
tradecatalog-supportLire, préparer ou envoyer une demande d'assistance fournisseur ou un suivi à Happy Webs.

D'autres agents peuvent découvrir les mêmes guides à partir de l'index de compétences public. Les compétences guident le workflow ; le serveur vérifie toujours l'accès au compte et nécessite une confirmation connectée pour les changements conséquents.

S'inscrire et payer avec un agentLien vers cette section#

Vous pouvez vous connecter avant d'avoir un espace de travail. La connexion ouvre la page de connexion de TradeCatalog, où une nouvelle adresse e-mail crée votre connexion après vérification. Terminez la vérification là-bas, puis retournez à votre application d'IA. Ne partagez jamais les codes de connexion ou les détails de paiement en chat.

Demandez à l'agent de créer votre espace de travail fournisseur. Il demande votre nom d'entreprise, votre devise de produit, votre fuseau horaire et votre pays, puis utilise create_workspace pour votre confirmation. Votre espace de travail démarre un essai Pro de 14 jours sans carte. Ce n'est pas un abonnement payant. Lorsque l'essai se termine, il revient à l'offre gratuite, jusqu'à 100 produits, sauf si vous mettez à niveau.

Pour les agents dont le hébergeur autorise la facturation par abonnement logiciel, connectez-vous à https://tradecatalog.app/mcp/account. Il utilise la même connexion TradeCatalog, les mêmes portées OAuth et les mêmes membres d'espace de travail, avec tous les outils ordinaires plus open_billing. Lorsque vous demandez à payer ou gérer votre abonnement, cet outil réservé aux propriétaires ouvre la page de facturation sécurisée de l'espace de travail. Choisissez la facturation mensuelle ou annuelle et confirmez le paiement via Stripe. Les abonnés existants peuvent gérer leur abonnement là-bas. L'agent peut vérifier get_settings après ; ouvrir un lien n'est pas une preuve que le paiement a été effectué.

Les plugins ChatGPT utilisent https://tradecatalog.app/mcp, qui ne met pas à disposition d'outils de facturation. Les lignes directrices des plugins d'OpenAI excluent actuellement la vente d'abonnements logiciels et la promotion des mises à niveau. L'inscription gratuite et la création d'un espace de travail sont disponibles via cette connexion. Les agents peuvent préparer les demandes de commande commerciale. Les paiements clients optionnels exigent que l'acheteur ouvre la page de commande connectée, approuve la charge confirmée par le fournisseur et termine Stripe Checkout. L'approbation par un agent n'est jamais une approbation de paiement.

Claude (web, bureau et mobile)Lien vers cette section#

  1. Ouvrez Paramètres, puis Connecteurs, et choisissez Ajouter un connecteur personnalisé.
  2. Donnez-lui le nom « TradeCatalog » et collez https://tradecatalog.app/mcp.
  3. Choisissez Connecter. Connectez-vous à TradeCatalog avec votre code par courriel et choisissez Autoriser.

Les connecteurs que vous ajoutez sur le web apparaissent également dans Claude Desktop et les applications mobiles. Sur les plans d'Équipe et d'Entreprise, un propriétaire peut avoir besoin d'ajouter le connecteur pour l'organisation en premier.

Claude CodeLien vers cette section#

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

Exécutez ensuite /mcp dans Claude Code et choisissez tradecatalog pour vous connecter.

ChatGPTLien vers cette section#

  1. Ouvrez Paramètres, puis Apps & Connecteurs. Si votre plan le nécessite, activez Mode développeur sous Avancé.
  2. Créez un connecteur avec l'URL https://tradecatalog.app/mcp et l'authentification OAuth.
  3. Connectez-vous à TradeCatalog et choisissez Autoriser.

CursorLien vers cette section#

Ajoutez ceci à ~/.cursor/mcp.json (ou .cursor/mcp.json dans un projet) :

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

Cursor ouvre la page de connexion TradeCatalog la première fois que vous l'utilisez.

VS CodeLien vers cette section#

Ajoutez ceci à .vscode/mcp.json :

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

Autres clientsLien vers cette section#

Tout client qui prend en charge l'MCP distant via HTTP Streamable avec OAuth fonctionne. Pour les clients qui ne fonctionnent qu'avec des serveurs locaux (stdio), utilisez le pont mcp-remote :

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

Vous construisez votre propre client ? Consultez OAuth pour les clients MCP.

Désactiver une applicationLien vers cette section#

Voyez toutes les applications AI que vous avez approuvées, et désactivez-en n'importe laquelle, à tradecatalog.app/oauth/connections. La suppression du connecteur dans votre application AI arrête cette application d'en faire usage. Désactiver ici révoque également son accès de notre côté, immédiatement.

MCP ou l'API REST ?Lien vers cette section#

MCPAPI REST
PourLes personnes qui discutent dans une application AIVos propres systèmes et scripts
Se connecte en tant queChaque personne, avec leur propre connexionL'espace de travail, avec une clé API du propriétaire
Les acheteurs peuvent l'utiliserOui, avec leurs propres prixNon
Peut modifier les donnéesOui, avec une portée d'écriture et des modifications réviséesOui, avec une clé en lecture et écriture
Configuration parChaque personne, dans leur application AILe propriétaire, dans Paramètres
DocsOutilsAPI REST