---
title: AI Actions Menu
description: A dropdown on every page that lets readers copy Markdown, open pages in ChatGPT/Claude/Perplexity, or install your MCP server in one click.
---
Every page on your Jamdesk site includes an AI Actions menu: a small dropdown above the title that gives readers quick access to AI tools. Copy the page as Markdown, open it in ChatGPT, install your MCP server in Cursor. No configuration needed.
## Built-in Options
The menu ships with eight options, all enabled by default:
| Option | Key | What it does |
|--------|-----|-------------|
| **Copy page** | `copy` | Fetches the raw Markdown and copies it to the clipboard |
| **View as Markdown** | `view` | Opens the `.md` file in a new tab |
| **Open in ChatGPT** | `chatgpt` | Opens ChatGPT with a prompt to read the current page |
| **Open in Claude** | `claude` | Opens Claude with the same prompt |
| **Open in Perplexity** | `perplexity` | Opens Perplexity with the same prompt |
| **Copy MCP config** | `mcp` | Copies the JSON config for your site's [MCP server](/ai/mcp-server) |
| **Add to Cursor** | `cursor` | Deep-links to install the MCP server in Cursor |
| **Add to VS Code** | `vscode` | Deep-links to install the MCP server in VS Code |
Gemini is also available as `gemini` but isn't included in the defaults because it doesn't support URL prompt pre-filling reliably. Add it explicitly if your readers use it.
When `copy` is in the options list, it becomes the primary button. The rest appear in a dropdown triggered by a chevron. Without `copy`, the whole thing collapses into a single "AI Actions" dropdown.
### Download API spec
On API reference pages, the menu gains one more item: **Download API spec**. It bundles every OpenAPI spec your site references — local files in your repo and remote spec URLs alike — into a single `api-specs.zip`, ready to hand to Postman, a client generator, or your own tooling. Multi-file specs keep their folder layout inside the zip, so `$ref` links between files still resolve.
The item appears on its own — there's nothing to configure. It shows only on pages backed by an OpenAPI spec, and only when your site actually has one, so regular guides are unaffected. The zip is assembled fresh on each download, so it always matches your current specs.
## Configuration
The menu works out of the box. You only need to touch `docs.json` if you want to customize which options appear or turn it off entirely.
### Show a subset of options
```json docs.json
{
"contextual": {
"options": ["copy", "claude", "mcp"]
}
}
```
### Disable the menu
```json docs.json
{
"contextual": {
"enabled": false
}
}
```
### Add custom options
You can mix built-in options with your own. Custom options open a URL in a new tab.
```json docs.json
{
"contextual": {
"options": [
"copy",
"claude",
{
"title": "Ask on Discord",
"description": "Get help from the community",
"icon": "discord",
"href": "https://discord.gg/your-server"
}
]
}
}
```
Custom options support an optional `icon` field. Any [Font Awesome icon name](/content/icons) works, including brand icons like `discord` or `slack`. Without an icon, a link icon is shown.
Custom options also support query parameters:
```json docs.json
{
"contextual": {
"options": [
"copy",
{
"title": "Search in Notion",
"description": "Find related internal docs",
"href": {
"base": "https://notion.so/search",
"query": [
{ "key": "q", "value": "docs" }
]
}
}
]
}
}
```
## How It Works
The menu runs entirely client-side. URLs update on every page navigation, so the "Open in Claude" link always points to whichever page you're looking at, even after navigating through the sidebar without a full page reload.
The AI service links include the page's `.md` URL in the prompt. ChatGPT, Claude, and Perplexity can all fetch URLs, so they'll read your documentation directly from the link.
MCP options use the `/_mcp` endpoint that every Jamdesk site exposes. "Copy MCP config" gives your readers the JSON they need for any MCP client. "Add to Cursor" and "Add to VS Code" are one-click deep links that open the editor's install flow directly. See [MCP Server](/ai/mcp-server) for details on what AI tools can do with it.
Your docs already have a built-in MCP server. The AI Actions menu just makes it easier to connect.
