Présentation de MCP

Shayan TaslimMis à jour

Le serveur MCP de UserJot permet aux outils d’IA de se connecter directement à votre espace de travail UserJot via HTTP distant, sans avoir à installer de package local ni de processus intermédiaire.

URL du serveur

UserJot met à disposition un point de terminaison MCP distant :

text
https://api.userjot.com/v1/mcp

Authentification

La plupart des clients MCP modernes prennent directement en charge la connexion via OAuth. Collez l’URL du serveur (ou utilisez le bouton d’installation en un clic ou la commande dans Paramètres → MCP & API ; VS Code et Gemini CLI se trouvent dans le menu Plus), connectez-vous à UserJot, choisissez votre espace de travail, puis cliquez sur Autoriser.

Client

Méthode d’authentification recommandée

Guide de configuration

Claude (web, ordinateur et mobile)

OAuth (en un clic depuis Paramètres → MCP & API)

Configuration générale

Claude Code

OAuth (ou jeton d’API)

Claude Code

Cursor

OAuth (en un clic depuis Paramètres → MCP & API) ou jeton d’API

Cursor

Codex

OAuth (ou jeton d’API)

Codex

ChatGPT

OAuth (ou jeton d’API sur ordinateur)

ChatGPT

VS Code (Copilot)

OAuth (dans Plus, sous Paramètres → MCP & API)

Configuration générale

Gemini CLI

OAuth (dans Plus, sous Paramètres → MCP & API)

Configuration générale

Windsurf et outils sans interface/CI

En-tête de jeton d’API

Windsurf / Configuration générale

Les applications connectées via OAuth apparaissent sous Applications connectées, dans Paramètres → MCP & API, avec le nom de la personne qui a connecté chacune d’elles. Utilisez Maintenir pour révoquer pour couper l’accès d’une application dès sa prochaine requête.

Note

Seuls les propriétaires et les administrateurs d’un espace de travail peuvent connecter une application OAuth. Une application connectée ne fonctionne que tant que la personne qui l’a connectée reste propriétaire ou administratrice.

Pour les clients qui exigent un en-tête statique ou pour les scripts automatisés, créez un jeton d’API dans Paramètres → MCP & API et transmettez :

text
Authorization: Bearer YOUR_USERJOT_API_TOKEN

Fonctions du serveur MCP

Le serveur MCP distant expose 98 outils couvrant les données et les flux de travail de votre espace de travail (deux opérations REST, le téléversement multipartie createAsset et l’effacement des données conformément au RGPD deleteMember, sont uniquement disponibles via REST) :

  • Espace de travail et tableaux : consulter les métadonnées de l’espace de travail et créer, répertorier, mettre à jour ou supprimer des tableaux.

  • Demandes, commentaires, votes et étiquettes : répertorier, créer, mettre à jour, déplacer et fusionner des demandes, annuler leur fusion, trouver des demandes similaires, gérer les abonnements, publier ou épingler des commentaires, ajouter ou retirer des votes, gérer les étiquettes et joindre des images.

  • Journal des modifications : répertorier, créer, mettre à jour et supprimer des entrées, et gérer les demandes associées, les auteurs et les étiquettes.

  • Conversations : Lister, consulter et démarrer des conversations sortantes (createConversation nécessite une formule payante : 5 par jour avec Starter, 15 avec Professional), consulter les historiques, publier des réponses et des notes internes, et mettre à jour le statut ou la personne assignée.

  • Membres et entreprises : rechercher, répertorier, synchroniser et mettre à jour des membres et des entreprises, et gérer les appartenances aux entreprises.

  • Centre d’aide : créer, mettre à jour, supprimer, publier, dépublier et rechercher des collections et des articles.

  • Ressources : Importer des images distantes ou créer des téléversements pré-signés à utiliser dans les journaux des modifications et les articles d’aide.

Tous les outils de modification et de suppression disposent de toutes les autorisations de l’espace de travail et sont signalés comme destructifs, afin que les clients demandent une confirmation avant de modifier les données.

Limites de débit et accès selon le forfait

MCP est disponible avec tous les forfaits, y compris Free. Les appels d’outils partagent les limites de débit de l’API REST de votre espace de travail : 10 requêtes/min (150/h) avec Free, 60 requêtes/min (1 500/h) avec Starter et 120 requêtes/min (5 000/h) avec Professional. Les sessions d’agents intensives peuvent rapidement atteindre la limite de Free.

MCP ou API REST

Utilisez MCP pour connecter un assistant d’IA ou un outil de programmation compatible avec le protocole Model Context Protocol. Utilisez l’API REST pour créer votre propre intégration de backend, script ou code d’application.

Gestion des jetons

Si vous utilisez un jeton d’API plutôt qu’OAuth, traitez-le comme n’importe quel autre secret :

  • Ne l’inscrivez pas en dur dans des fichiers de configuration commités.

  • Privilégiez les variables d’environnement ou un gestionnaire de secrets local.

  • Utilisez des jetons distincts pour les différents environnements ou membres de l’équipe.

  • Révoquez les jetons inutilisés dans Paramètres → MCP & API en utilisant Maintenir pour révoquer.

Étapes suivantes

Cet article a-t-il répondu à votre question ?