Menu contextuel

Le menu contextuel offre un accès rapide à un objet optimisé par l’IA et à des intégrations directes avec des outils d’IA populaires. Lorsque les utilisateurs ouvrent le menu contextuel sur n’importe quelle page, ils peuvent copier l’objet comme context pour des outils d’IA ou lancer des conversations dans ChatGPT, Claude, Perplexity, Google AI Studio, Grok, Devin, Devin Desktop, ou un outil personnalisé de votre choix, avec votre documentation déjà chargée comme context.

Associez le menu contextuel à votre fichier skill.md hébergé et à votre serveur MCP afin que vos utilisateurs puissent installer dans leurs outils d’IA toutes les capacités de votre produit, et pas seulement la page qu’ils consultent.

Le menu contextuel comprend plusieurs options prédéfinies que vous pouvez activer en ajoutant leur identifiant à votre configuration.

Option	Identifiant	Description
Copier la page	`copy`	Copie la page actuelle en Markdown pour la coller comme contexte dans des outils d’IA
Afficher en Markdown	`view`	Ouvre la page actuelle en Markdown
Demander à l’Assistant	`assistant`	Ouvre l’Assistant avec la page actuelle comme contexte
Télécharger le PDF	`download-pdf`	Télécharge la page actuelle au format PDF. Disponible avec les offres Enterprise.
Ouvrir dans ChatGPT	`chatgpt`	Crée une conversation ChatGPT avec la page actuelle comme contexte
Ouvrir dans Claude	`claude`	Crée une conversation Claude avec la page actuelle comme contexte
Ouvrir dans Perplexity	`perplexity`	Crée une conversation Perplexity avec la page actuelle comme contexte
Ouvrir dans Grok	`grok`	Crée une conversation Grok avec la page actuelle comme contexte
Ouvrir dans Google AI Studio	`aistudio`	Crée une conversation Google AI Studio avec la page actuelle comme contexte
Ouvrir dans Devin	`devin`	Crée une session Devin avec la page actuelle comme contexte
Ouvrir dans Devin Desktop	`devin-desktop`	Ouvre Devin Desktop avec la page actuelle comme contexte. Nécessite l’installation de Devin Desktop.
Copier l’URL du serveur MCP	`mcp`	Copie l’URL de votre serveur MCP dans le presse‑papiers
Copier la commande d’installation MCP	`add-mcp`	Copie la commande `npx add-mcp` pour installer le serveur MCP
Se connecter à Cursor	`cursor`	Installe votre serveur MCP hébergé dans Cursor
Se connecter à VS Code	`vscode`	Installe votre serveur MCP hébergé dans VS Code
Se connecter à Devin	`devin-mcp`	Installe votre serveur MCP hébergé dans Devin
Télécharger la spécification d’API	`downloadApiSpec`	Télécharge la spécification OpenAPI de votre déploiement. Si plusieurs spécifications sont configurées, les télécharge dans une archive zip. N’apparaît que sur les pages de référence d’API.
Options personnalisées	Objet	Ajoutez des options personnalisées au menu contextuel

Le menu contextuel développé affichant les éléments Copier la page, Afficher en Markdown, Ouvrir dans ChatGPT et Ouvrir dans Claude.

L’option downloadApiSpec n’apparaît que sur les pages de référence d’API (pages dont le frontmatter déclare api, openapi ou asyncapi). Sur les déploiements avec authentification ou authentification utilisateur activée, seuls les lecteurs authentifiés peuvent télécharger la spécification.

Ajoutez le champ contextual à votre fichier docs.json et indiquez les options que vous souhaitez inclure.

{
 "contextual": {
   "options": [
     "copy",
     "view",
     "assistant",
     "download-pdf",
     "chatgpt",
     "claude",
     "perplexity",
     "grok",
      "aistudio",
      "devin",
      "devin-desktop",
      "mcp",
      "cursor",
      "vscode",
      "devin-mcp",
      "downloadApiSpec"
    ]
 }
}

Emplacement d’affichage

Par défaut, le menu contextuel apparaît dans l’en-tête de la page. Vous pouvez le configurer pour qu’il s’affiche à la place dans la barre latérale de la table des matières à l’aide de l’option display.

{
  "contextual": {
    "options": ["copy", "view", "chatgpt", "claude"],
    "display": "toc"
  }
}

Valeur	Description
`header`	Affiche les options dans le menu contextuel en haut de la page (par défaut)
`toc`	Affiche les options dans la barre latérale de la table des matières

Ajout d’options personnalisées

Créez des options personnalisées dans le menu contextuel en ajoutant un objet au tableau options. Chaque option personnalisée requiert les propriétés suivantes :

title

string

requis

Le titre de l’option.

description

string

requis

La description de l’option. Affichée sous le titre lorsque le menu contextuel se déroule.

icon

string

requis

Icône à afficher.Options :

Nom d’icône Font Awesome si vous avez la propriété icons.library définie sur fontawesome dans votre docs.json
Nom d’icône Lucide si vous avez la propriété icons.library définie sur lucide dans votre docs.json
Nom d’icône Tabler si vous avez la propriété icons.library définie sur tabler dans votre docs.json
URL vers une icône hébergée en externe
Chemin vers un fichier d’icône dans votre projet

iconType

string

Style d’icône Font Awesome. Utilisé uniquement avec les icônes Font Awesome.Options : regular, solid, light, thin, sharp-solid, duotone, brands.

href

string | object

requis

Le href de l’option. Utilisez une chaîne pour des liens simples ou un objet pour des liens dynamiques avec des paramètres de requête.

Afficher href object

base

string

requis

L’URL de base de l’option.

query

object

requis

Les paramètres de requête de l’option.

Afficher query object

key

string

requis

La key du paramètre de requête.

value

string

requis

La valeur du paramètre de requête. Mintlify remplace les espaces réservés suivants par les valeurs correspondantes :

Utilisez $page pour insérer le contenu de la page actuelle en Markdown.
Utilisez $path pour insérer le chemin de la page actuelle.
Utilisez $mcp pour insérer l’URL du serveur MCP hébergé.

Exemple d’option personnalisée :

{
    "contextual": {
        "options": [
            "copy",
            "view",
            "chatgpt",
            "claude",
            "perplexity",
            {
                "title": "Demander une fonctionnalité",
                "description": "Rejoignez la discussion sur GitHub pour demander une nouvelle fonctionnalité",
                "icon": "plus",
                "href": "https://github.com/orgs/mintlify/discussions/categories/feature-requests"
            }
        ]
    }
}

Exemples d’options personnalisées

Lien simple

{
  "title": "Demander une fonctionnalité",
  "description": "Rejoindre la discussion sur GitHub",
  "icon": "plus",
  "href": "https://github.com/orgs/mintlify/discussions/categories/feature-requests"
}

Lien dynamique avec le contenu de la page

{
  "title": "Partager sur X",
  "description": "Partager cette page sur X",
  "icon": "x",
  "href": {
    "base": "https://x.com/intent/tweet",
    "query": [
      {
      "key": "text",
      "value": "Découvrez cette documentation : $page"
      }
    ]
  }
}

Prise en main

Organiser

Personnaliser

Créer du contenu

Documenter des API

Déployer

Optimisation

Options du menu

Activer le menu contextuel

Emplacement d’affichage

Ajout d’options personnalisées

Exemples d’options personnalisées

​Options du menu

​Activer le menu contextuel

​Emplacement d’affichage

​Ajout d’options personnalisées

​Exemples d’options personnalisées

Options du menu

Activer le menu contextuel

Emplacement d’affichage

Ajout d’options personnalisées

Exemples d’options personnalisées