Connecter un assistant IA à Helpdash avec MCP

Helpdash expose un serveur Model Context Protocol (MCP), de sorte qu'un assistant IA peut travailler directement dans votre espace de travail au lieu que vous copiiez-colliez des tickets dans une fenêtre de chat. Demandez « quels tickets dépassent le SLA aujourd'hui ? » ou « résume ce fil pour la passation », et l'assistant interroge Helpdash lui-même.

Cet article couvre ce que le connecteur expose, comment en connecter un et — la partie qui mérite deux lectures — ce qu'il n'a pas le droit de faire.

Ce que le connecteur expose

Le serveur fournit 46 outils, quatre invites prêtes à l'emploi et une ressource listant toutes les valeurs d'énumération acceptées par les outils. Les outils couvrent les tickets, le chat en direct, la base de connaissances, les réponses enregistrées, les projets et les coéquipiers, le tableau de bord, le CSAT, les règles d'automatisation, les webhooks, les paramètres, le journal d'activité et la facturation.

Lecture et écriture sont toujours des outils distincts. Il n'existe pas d'outil fourre-tout api_request avec un paramètre method : rechercher des tickets et en modifier un sont des outils différents avec des droits différents, si bien qu'un assistant doté d'un accès en lecture ne peut rien modifier en changeant un argument.

Les quatre invites sont des enchaînements qu'il vaut la peine d'avoir déjà rédigés :

• Trier un ticket — recommande une priorité, une catégorie et un responsable. Ne change rien.
• Rédiger une réponse client — rédige le texte à partir de votre base de connaissances et de vos réponses enregistrées. Il ne peut pas envoyer ; la réponse revient pour relecture.
• Résumer un fil — condense un long ticket ou une transcription de chat pour la passation.
• Rapport support hebdomadaire — volume, SLA, CSAT et ce qui demande attention.

Connecter un client

Ouvrez Paramètres → Connecteurs IA (MCP) et émettez un jeton. Donnez-lui un libellé que vous reconnaîtrez plus tard, laissez tous les interrupteurs d'écriture désactivés pour le premier, et copiez la clé — elle n'est affichée qu'une seule fois.

Puis enregistrez-le. Pour Claude Code :

claude mcp add --transport http helpdash https://your-workspace.helpdash.io/mcp \
  --header "Authorization: Bearer hd_mcp_..."

Pour tout client qui lit un .mcp.json :

{
  "mcpServers": {
    "helpdash": {
      "type": "http",
      "url": "https://your-workspace.helpdash.io/mcp",
      "headers": { "Authorization": "Bearer hd_mcp_..." }
    }
  }
}

Les deux extraits sont générés pour vous, déjà remplis avec l'adresse de votre espace de travail, sur l'écran même où apparaît le jeton.

Les clients qui préfèrent une connexion dans le navigateur peuvent utiliser OAuth 2.1 plutôt qu'un jeton statique : le serveur publie les documents de découverte standards, prend en charge PKCE et l'enregistrement dynamique de clients, et affiche un écran de consentement qui liste exactement les portées demandées. Aucun jeton à copier, aucune clé à stocker sur disque.

Ce qu'il ne peut pas faire

Le connecteur n'est pas une seconde API plus permissive. Chaque appel franchit les mêmes quatre contrôles qu'une requête humaine.

Il agit en votre nom. Un jeton est lié à l'opérateur qui l'a émis. Il hérite exactement de ses rôles et de ses droits — si vous ne pouvez pas ouvrir un ticket dans l'application, un assistant porteur de votre jeton ne le peut pas non plus. Et il est lié à un espace de travail : aucun argument n'atteint les données d'un autre locataire.

Lecture seule sauf indication contraire. Un nouveau jeton avec tous les interrupteurs désactivés peut rechercher, lire et produire des rapports, rien de plus. L'accès en écriture s'accorde par domaine — modifier des tickets, répondre en chat en direct, éditer la base de connaissances, gérer des projets, inviter des coéquipiers, changer des paramètres, changer des règles d'automatisation — et uniquement pour ceux que vous cochez. La lecture est toujours incluse, car un assistant qui peut écrire mais pas lire est inutile.

Les outils d'écriture demandent d'abord. Chaque outil qui modifie des données est signalé comme destructeur, si bien qu'un client bien conçu vous sollicite avant chaque appel au lieu d'agir en silence. Les outils qui atteignent un client le disent dans leur propre description : un message de chat en direct est remis instantanément et ne peut pas être rappelé, et un commentaire de ticket est par défaut une note interne, pour que rien n'atteigne un client par accident.

Les secrets restent côté serveur. Lire vos paramètres via un connecteur renvoie les identifiants d'intégration masqués. Aucun argument ne les démasque.

Le texte client est mis entre barrières. Les descriptions de tickets, les commentaires et les transcriptions de chat sont écrits par d'autres personnes, et une boîte de support est précisément l'endroit où quelqu'un tenterait de glisser des instructions à destination d'une IA qui les lirait. Helpdash entoure ce texte d'un bloc explicite de contenu non fiable et indique au modèle, dans les instructions du serveur lui-même, que rien de ce qu'il contient n'est une commande.

Tout est journalisé. Chaque appel est consigné avec l'opérateur, l'outil et le résultat, dans le même journal d'audit que le reste de l'espace de travail. Si vous devez un jour répondre à « qu'a réellement fait l'assistant mardi ? », la trace est là.

La révocation est immédiate. Supprimer un jeton dans les Paramètres arrête la toute prochaine requête de l'assistant. Nous ne conservons qu'une empreinte SHA-256 de la clé, nous ne pouvons donc pas vous la restituer — si vous la perdez, vous en émettez une nouvelle.

Restreindre davantage un jeton

Deux contrôles facultatifs méritent d'être connus. Un jeton peut porter une date d'expiration, la façon la plus simple pour qu'une expérimentation courte se nettoie d'elle-même. Et il peut porter une liste d'IP autorisées, pour qu'un jeton destiné à un serveur ne puisse pas servir ailleurs. Les deux figurent dans le même formulaire de création.

Un premier jeton raisonnable

Émettez-en un sans portée d'écriture et accordez à l'assistant une semaine en lecture seule. Demandez-lui de repérer les risques de SLA, de résumer les fils touffus et de rédiger des réponses que vous enverrez vous-même. Cela couvre l'essentiel de la valeur sans aucune exposition. Quand vous saurez quelle portée d'écriture vous voulez vraiment, émettez un second jeton avec celle-ci uniquement — élargir un jeton existant est délibérément impossible.

Chaque affirmation ci-dessus décrit un comportement disponible aujourd'hui ; le connecteur est proposé sur chaque espace de travail Helpdash.