Aller au contenu principal

JTLGO Commerce MCP

Un connecteur pour les recherches publiques et les tâches de votre compte.

JTLGO Commerce MCP relie un client d’IA aux outils de commerce et de logistique de JTLGO. Le mode public sert à la recherche, aux estimations depuis la Chine et au suivi ; le mode compte ajoute les outils autorisés après connexion.

Point d’accès public https://jtlgo.com/api/mcp

Vérification de la connexion MCP…

Protocole
—
Outils
—
Temps de réponse
—

Comparer les accès

Choisir d’abord le niveau d’accès

Le choix dépend des tâches : recherches publiques uniquement, ou accès au compte avec OAuth. Une URL et un fichier de configuration sont deux façons de renseigner le même point d’accès.

Connecteur de compte

Cette URL réunit outils publics et outils de compte. Le client MCP ouvre OAuth lorsque les données du compte sont nécessaires ; cette page web ne manipule pas le jeton.

10 outils · OAuth pour les données du compte

https://jtlgo.com/api/mcp/account

Les deux URL donnent accès aux mêmes 6 outils publics. Pour accéder au compte, configurez une seule connexion avec l’URL de compte : il n’est pas nécessaire de conserver deux connecteurs.

Choisir votre client

Utilisez l’URL publique pour les recherches anonymes, ou l’URL de compte comme connexion unique pour les outils publics et ceux du compte.

URL à renseigner dans le client

Sans connexion pour découvrir les outils publics et effectuer des recherches générales.

https://jtlgo.com/api/mcp

Configuration JSON

Copiez cette URL dans le champ du connecteur ou dans sa configuration.

{
  "mcpServers": {
    "jtlgo-commerce": {
      "url": "https://jtlgo.com/api/mcp"
    }
  }
}

Configuration TOML

[mcp_servers.jtlgo-commerce]
url = "https://jtlgo.com/api/mcp"

URL à renseigner dans le client

Cette URL réunit outils publics et outils de compte. Le client MCP ouvre OAuth lorsque les données du compte sont nécessaires ; cette page web ne manipule pas le jeton.

https://jtlgo.com/api/mcp/account

Configuration JSON

Copiez cette URL dans le champ du connecteur ou dans sa configuration.

{
  "mcpServers": {
    "jtlgo-commerce": {
      "url": "https://jtlgo.com/api/mcp/account"
    }
  }
}

Configuration TOML

[mcp_servers.jtlgo-commerce]
url = "https://jtlgo.com/api/mcp/account"

Configurer l’accès au compte

Cette URL réunit outils publics et outils de compte. Le client MCP ouvre OAuth lorsque les données du compte sont nécessaires ; cette page web ne manipule pas le jeton.

https://jtlgo.com/api/mcp/account

Outils du compte après autorisation

Ces 4 outils sont accessibles une fois OAuth terminé dans le client.

get_account_summary

Lire le résumé et les informations du compte que le connecteur est autorisé à exposer.

list_customer_work_items

Lister les tâches du client nécessitant encore une action.

get_customer_work_item

Consulter le détail d’une tâche pour poursuivre le traitement.

create_support_ticket

Créer un ticket d’assistance dans le périmètre autorisé.

Les six outils publics

Voici les outils proposés par le connecteur public JTLGO.

OutilUtilisationDonnées usuellesRésultat
search_products Rechercher des produits keyword, site, limit Liste de produits avec les champs autorisés
quote_shipping_rates Estimer une expédition depuis la Chine countryCode, weight, dimensions Solutions de transport et poids facturable
track_shipment Suivre une expédition Numéro de suivi ou liste de numéros Derniers événements et signalement d’incident
get_product_detail Consulter un article id ou URL du produit Détails du produit autorisés
human_handoff Contacter l’équipe language, reason Coordonnées e-mail et WhatsApp
get_mcp_config Vérifier la configuration Aucun paramètre Métadonnées et liste des outils

Outils du compte après autorisation

Pour comprendre le fonctionnement

Ces trois articles en anglais expliquent les achats assistés par agents, leurs limites et le rôle des outils logistiques.

Questions avant de connecter un assistant

Pourquoi utiliser POST pour un outil public ?

Le point d’accès MCP de JTLGO reçoit les messages JSON-RPC par POST ; un GET sur cette même URL renvoie 405. La séquence initialize, notifications/initialized puis tools/list vérifie la connexion, sans créer d’achat ni de paiement.

Séquence de vérification POST initialize → notifications/initialized → tools/list

Quand choisir le connecteur de compte ?

Choisissez l’URL de compte si votre assistant doit consulter vos données ou créer un ticket autorisé. Le client gère OAuth avec les portées account:read, work_items:read et support:write ; cette page ne reçoit pas le jeton.

Faut-il configurer les deux URL ?

Non. Pour les seules recherches publiques, utilisez le connecteur public. Pour les outils du compte, utilisez l’URL de compte comme unique connecteur : elle comprend aussi les 6 outils publics.