@@ -10,12 +10,18 @@ The contextual menu provides quick access to AI-optimized content and direct int
1010
1111## Menu options
1212
13- - ** Copy page** : Copies the current page as Markdown for pasting as context into AI tools.
14- - ** View as Markdown** : Opens the current page as Markdown.
15- - ** Open in ChatGPT** : Creates a ChatGPT conversation with the current page as context.
16- - ** Open in Claude** : Creates a Claude conversation with the current page as context.
17- - ** Open in Perplexity** : Creates a Perplexity conversation with the current page as context.
18- - ** [ Your custom options] ( #adding-custom-options ) ** : Add your own options to the menu.
13+ The contextual menu includes several pre-built options that you can enable by adding their identifier to your configuration.
14+
15+ | Option | Identifier | Description |
16+ | :--------| :------------| :-------------|
17+ | ** Copy page** | ` copy ` | Copies the current page as Markdown for pasting as context into AI tools |
18+ | ** View as Markdown** | ` view ` | Opens the current page as Markdown |
19+ | ** Open in ChatGPT** | ` chatgpt ` | Creates a ChatGPT conversation with the current page as context |
20+ | ** Open in Claude** | ` claude ` | Creates a Claude conversation with the current page as context |
21+ | ** Open in Perplexity** | ` perplexity ` | Creates a Perplexity conversation with the current page as context |
22+ | ** Copy MCP Server URL** | ` mcp ` | Copies the MCP server URL to the clipboard |
23+ | ** Open in Cursor** | ` cursor ` | Installs the hosted MCP server in Cursor |
24+ | ** Open in VSCode** | ` vscode ` | Installs the hosted MCP server in VSCode |
1925
2026<Frame >
2127 <img
@@ -36,7 +42,10 @@ Add the `contextual` field to your `docs.json` file and specify which options yo
3642 " view" ,
3743 " chatgpt" ,
3844 " claude" ,
39- " perplexity"
45+ " perplexity" ,
46+ " mcp" ,
47+ " cursor" ,
48+ " vscode"
4049 ]
4150 }
4251}
@@ -75,7 +84,10 @@ Create custom options in the contextual menu by adding an object to the `options
7584 </ResponseField >
7685
7786 <ResponseField name = " value" type = " string" required >
78- The query parameter value. Use ` $page ` to insert the current page content in Markdown or ` $path ` to insert the current page path.
87+ The query parameter value. We will replace the following placeholders with the corresponding values:
88+ - Use ` $page ` to insert the current page content in Markdown.
89+ - Use ` $path ` to insert the current page path.
90+ - Use ` $mcp ` to insert the hosted MCP server URL.
7991 </ResponseField >
8092 </Expandable >
8193 </ResponseField >
@@ -103,3 +115,35 @@ Example custom option:
103115 }
104116}
105117```
118+
119+ ### Custom option examples
120+
121+ <AccordionGroup >
122+ <Accordion title = " Simple link" >
123+ ``` json
124+ {
125+ "title" : " Request a feature" ,
126+ "description" : " Join the discussion on GitHub" ,
127+ "icon" : " plus" ,
128+ "href" : " https://github.com/orgs/mintlify/discussions/categories/feature-requests"
129+ }
130+ ```
131+ </Accordion >
132+
133+ <Accordion title = " Dynamic link with page content" >
134+ ``` json
135+ {
136+ "title" : " Share on X" ,
137+ "description" : " Share this page on X" ,
138+ "icon" : " x" ,
139+ "href" : {
140+ "base" : " https://x.com/intent/tweet" ,
141+ "query" : {
142+ "key" : " text" ,
143+ "value" : " Check out this documentation: $page"
144+ }
145+ }
146+ }
147+ ```
148+ </Accordion >
149+ </AccordionGroup >
0 commit comments