Chaque connexion correspond à un seul espace de travail, et aucun outil ne permet de passer de l’un à l’autre. Reconnectez-vous et choisissez l’autre espace de travail sur l’écran de consentement.
MCP
Le serveur MCP de Ferndesk permet aux outils d’IA comme Claude, ChatGPT, Cursor et Codex d’intervenir dans votre espace de travail en votre nom. Ils peuvent rechercher et modifier des articles, soumettre des modifications pour révision, gérer les conversations d’assistance et consulter des rapports. Son adresse est https://mcp.ferndesk.com. Vous vous connectez avec OAuth : aucune clé API n’est nécessaire.
Les propriétaires et les administrateurs trouvent les instructions propres à chaque client dans Intégrations > Clients d’IA. Un contributeur peut également se connecter à l’aide de la même URL. Votre centre d’aide dispose aussi d’un serveur MCP distinct, en lecture seule, destiné aux lecteurs. Consultez Recherche, SEO et outils d’IA.
Connecter un client
Ajoutez l’URL à votre client, puis connectez-vous à Ferndesk dans la fenêtre de navigateur qui s’ouvre. Sur l’écran de consentement, choisissez l’espace de travail et autorisez l’accès.
claude mcp add --transport http ferndesk https://mcp.ferndesk.comClaude (claude.ai et l’application de bureau) : ajoutez un connecteur personnalisé à l’aide de l’URL. Avec les offres Team et Enterprise, le propriétaire de l’organisation doit d’abord l’ajouter. Le guide des connecteurs personnalisés d’Anthropic présente les étapes à suivre.
Claude Code : exécutez la commande, démarrez une session, exécutez
/mcp, sélectionnezferndesket choisissez S’authentifier.ChatGPT : activez le mode Développeur dans Paramètres > Applications > Paramètres avancés, puis créez une application à l’aide de l’URL. Le mode Développeur dépend de votre forfait ChatGPT.
Cursor : utilisez Ajouter à Cursor sur la page des clients d’IA, ou ajoutez le JSON ci-dessus à
~/.cursor/mcp.jsonou au fichier.cursor/mcp.jsond’un projet.Codex CLI : les serveurs distants doivent être configurés dans
config.toml, carcodex mcp addn’ajoute que des serveurs locaux. Exécutez ensuitecodex mcp login ferndesk.Autres clients : tout client compatible avec Streamable HTTP et OAuth 2.1, avec enregistrement dynamique du client et PKCE (S256). Il doit s’agir d’un client public : un client nécessitant un secret client fixe ne fonctionnera pas.
Ce que permet une connexion
Une connexion représente un membre dans un espace de travail. Elle peut effectuer les actions autorisées par votre rôle et les permissions que vous avez approuvées. Votre rôle est vérifié à chaque requête : toute modification de rôle s’applique immédiatement.
Permission | Actions autorisées |
|---|---|
| Lire et rechercher des articles, des brouillons, des révisions, des demandes de révision et les tâches de Fern. |
| Créer et modifier des brouillons, déplacer et supprimer des articles, gérer les collections et leur ordre, soumettre des modifications dans une demande de révision et gérer les utilisateurs du centre d’aide. |
| Publier des brouillons et des demandes de révision, dépublier des articles et restaurer des révisions. Réservé aux propriétaires et aux administrateurs. |
| Lire les conversations de l’assistant IA de votre centre d’aide. |
| Lire les conversations d’assistance, les clients, les collègues, les étiquettes et les réponses enregistrées. |
| Ajouter des notes internes. Les propriétaires et les administrateurs peuvent également attribuer, étiqueter, fermer, rouvrir, mettre en attente et définir la priorité. |
| Répondre aux clients en votre nom. Désactivé par défaut : activez cette option lors du consentement. |
| Consulter les rapports sur l’assistance et le centre d’aide. |
| Consulter les paramètres du centre d’aide, du widget, de l’agent IA, du guide, de la boîte de réception, des étiquettes, des réponses enregistrées et de l’équipe. Les secrets ne sont jamais renvoyés. |
| Modifier ces paramètres, ajouter des boîtes de réception e-mail et activer Support. Réservé aux propriétaires et aux administrateurs. |
| Inviter des collègues. Désactivé par défaut et réservé aux propriétaires et aux administrateurs. |
Les clients qui ne demandent pas de permissions spécifiques obtiennent toutes les permissions, sauf les deux désactivées par défaut. Pour ajouter une permission ultérieurement, reconnectez-vous et approuvez-la.
Les modifications sont soumises à révision
Dans un centre d’aide qui contient déjà des articles publiés, les modifications sont soumises dans une demande de révision. Rien n’est publié tant qu’une personne ne l’a pas publié, dans Ferndesk ou depuis le client après votre confirmation. L’envoi d’une demande prévient vos propriétaires et administrateurs par e-mail. Une demande de révision comprenant des modifications de référence API ne peut être publiée que dans Ferndesk.
Conserver l’URL d’un article
L’URL d’un article comprend son slug et son identifiant court, par exemple /connect-intercom-a1b2c. Sans slug personnalisé, le slug suit le titre à chaque publication de l’article et l’ancienne URL redirige vers la nouvelle avec une redirection 301.
Pour choisir le slug, transmettez slug à save_article lorsque vous soumettez la modification dans une demande de révision. En mode direct, enregistrez le brouillon sans ce paramètre, puis transmettez slug à publish_article. Le slug devient le slug personnalisé de l’article et reste donc inchangé si son titre est modifié. Pour conserver l’URL actuelle après un changement de titre, transmettez le slug actuel. get_article renvoie customSlug, qui vaut true dès qu’un slug personnalisé est défini.
Un slug doit comporter au moins 2 caractères : des lettres minuscules, des chiffres et des traits d’union simples, sans trait d’union au début ni à la fin. Si un slug n’est pas valide, il est refusé et une correction est suggérée.
Le MCP n’exige pas que les slugs soient uniques, car chaque URL se termine par l’identifiant court.
Vous ne pouvez pas transmettre de slug pour une traduction (modifiez-le dans Ferndesk), pour une suppression ni pour un centre d’aide publié sur une plateforme externe.
Le MCP ne peut pas désactiver un slug personnalisé. Pour que l’URL suive à nouveau le titre, désactivez Slug personnalisé dans Paramètres de l’article > SEO.
L’API publique utilise le même champ slug dans POST /v1/review_requests/:id/changes, POST /v1/articles et PATCH /v1/articles/:id, au même format.
Créer des liens vers des collections et modifier leurs URL
Les liens textuels peuvent également pointer vers une collection, une section ou une référence API publiée dans le même centre d’aide. Utilisez internal://coll_..., internal://sect_... ou internal://apiref_... avec les identifiants obtenus via get_helpdesk_overview (les identifiants des références API proviennent de get_order sur la section).
Pour modifier l’URL d’une collection, transmettez slug à save_collection avec son collection_id. L’identifiant court reste le même : l’ancienne URL redirige vers la nouvelle avec une redirection 301.
Limites
Il ne peut pas démarrer de tâche Fern. Il peut lister et supprimer les tâches de Fern.
Aucun outil de téléversement d’images n’est disponible. Insérez les images dans le HTML ou le markdown de l’article : les images
data:intégrées sont téléversées lors de l’enregistrement de l’article, et les images hébergées ailleurs sont copiées dans votre centre d’aide lors de sa publication.Il ne peut pas créer ni supprimer des sections, gérer la facturation, les clés API ou les webhooks.
Le corps d’un article peut contenir jusqu’à 500 000 caractères.
Les écritures partagent le quota de l’API : 1 000 par minute et par connexion, et 3 000 par minute et par espace de travail. Les lectures ne sont pas comptabilisées.
Sans abonnement actif, les modifications sont désactivées.
Gérer les connexions
Les propriétaires et les administrateurs voient toutes les connexions sur la page des clients d’IA, à raison d’une ligne par espace de travail, et peuvent révoquer chacune d’elles. Un contributeur qui souhaite supprimer une connexion doit le demander à un propriétaire ou à un administrateur. Les jetons d’accès sont valides pendant une heure et sont renouvelés pendant 7 jours : si vous n’utilisez pas un client pendant une semaine, il vous demandera de vous reconnecter.
Un client peut-il utiliser plusieurs espaces de travail ?
Pourquoi l’enregistrement a-t-il été refusé ?
La plupart des refus indiquent ce qu’il faut modifier : une permission manquante (reconnectez-vous et approuvez-la), un rôle qui ne permet d’enregistrer que des brouillons, un article dont le brouillon d’un autre rédacteur est toujours ouvert, ou une modification qui supprimerait accidentellement le titre, les images ou les blocs.
Un contributeur peut-il publier ?
Non. Le client d’un contributeur enregistre les brouillons et soumet les demandes de révision ; un propriétaire ou un administrateur les publie.