跳转到主要内容
上下文菜单可快速访问经 AI 优化的对象，并可直接对接主流 AI 工具。用户在任意页面打开上下文菜单时，可以将对象复制并作为 AI 工具的 context，或在 ChatGPT、Claude、Perplexity，或你自定义的工具中开启对话，并将你的文档预先加载为 context。 上下文菜单包含多项内置选项，你可以通过将其标识符添加到配置中来启用。
选项标识符说明
复制页面copy将当前页面复制为 Markdown，便于作为上下文粘贴到 AI 工具中
以 Markdown 查看view以 Markdown 打开当前页面
在 ChatGPT 中打开chatgpt以当前页面为上下文创建 ChatGPT 对话
在 Claude 中打开claude以当前页面为上下文创建 Claude 对话
在 Perplexity 中打开perplexity以当前页面为上下文创建 Perplexity 对话
复制 MCP 服务器 URLmcp将你的 MCP 服务器 URL 复制到剪贴板
连接到 Cursorcursor在 Cursor 中安装你托管的 MCP 服务器
连接到 VS Codevscode在 VS Code 中安装你托管的 MCP 服务器
展开的上下文菜单，显示“复制页面”“以 Markdown 查看”“在 ChatGPT 中打开”和“在 Claude 中打开”等菜单项。

​
启用情境菜单

在你的 docs.json 文件中添加 contextual 字段，并指定要包含的选项。 
{
 "contextual": {
   "options": [
     "copy",
     "view",
     "chatgpt",
     "claude",
     "perplexity",
     "mcp",
     "cursor",
     "vscode"
   ]
 }
}

​
添加自定义选项

通过向 options 数组添加一个对象，在上下文菜单中创建自定义选项。每个自定义选项需要包含以下属性：
​
title
string
required
选项的标题。
​
description
string
required
选项的说明。在展开上下文菜单时显示于标题下方。
​
icon
string
required
要显示的 icon。选项：
  • Font Awesome icon 名称
  • Lucide icon 名称
  • 用花括号包裹的、与 JSX 兼容的 SVG 代码
  • 指向外部托管 icon 的 URL
  • 项目中 icon 文件的路径
针对自定义 SVG 图标：
  1. 使用 SVGR converter 将你的 SVG 进行转换。
  2. 将 SVG 代码粘贴到 SVG 输入框。
  3. 从 JSX 输出框复制完整的 <svg>...</svg> 元素。
  4. 用花括号包裹与 JSX 兼容的 SVG 代码：icon={<svg ...> ... </svg>}。
  5. 按需调整 height 和 width。
​
iconType
string
Font Awesome 的 icon 样式。仅在使用 Font Awesome 图标时使用。选项：regular、solid、light、thin、sharp-solid、duotone、brands。
​
href
string | object
required
选项的 href。简单链接使用字符串，带有 query 参数的动态链接使用对象。
自定义选项示例： 
{
    "contextual": {
        "options": [
            "copy",
            "view",
            "chatgpt",
            "claude",
            "perplexity",
            {
                "title": "功能请求",
                "description": "在 GitHub 上参与讨论，请求新功能",
                "icon": "plus",
                "href": "https://github.com/orgs/mintlify/discussions/categories/feature-requests"
            }
        ]
    }
}

​
自定义选项示例

{
  "title": "请求新功能",
  "description": "在 GitHub 上参与讨论",
  "icon": "plus",
  "href": "https://github.com/orgs/mintlify/discussions/categories/feature-requests"
}

{
  "title": "在 X 上分享",
  "description": "将此页面分享至 X",
  "icon": "x",
  "href": {
    "base": "https://x.com/intent/tweet",
    "query": [
      {
      "key": "text",
      "value": "查看这份文档：$page"
      }
    ]
  }
}
⌘I