AI Actions Menu

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:

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

{
  "contextual": {
    "options": ["copy", "claude", "mcp"]
  }
}

Disable the menu

{
  "contextual": {
    "enabled": false
  }
}

Add custom options

You can mix built-in options with your own. Custom options open a URL in a new tab.

{
  "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 works, including brand icons like discord or slack. Without an icon, a link icon is shown.

Custom options also support query parameters:

{
  "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 for details on what AI tools can do with it.