Model Context Protocol（模型上下文协议）

使用托管的 MCP 服务器，将文档和 API 端点连接到 AI 工具。

​

关于 MCP 服务器

Model Context Protocol（MCP，模型上下文协议）是一个开放协议，用于在 AI 应用与外部服务（例如文档）之间建立标准化连接。Mintlify 会基于你的文档生成一个 MCP 服务器，为更广泛的 AI 生态系统做好准备，让任何 MCP 客户端（例如 Claude、Cursor、Goose 等）都可以连接到你的文档。

你的 MCP 服务器会向 AI 应用提供一个搜索工具，以便在你的文档中发起搜索请求。

​

MCP 服务器的工作方式

当 Claude、Cursor 或 ChatGPT 等 AI 工具接入你的文档 MCP 服务器后，LLM 可以在生成回复时直接搜索你的文档，而无需执行通用的网页搜索。

• LLM 可以在生成回复时主动搜索你的文档，而不仅仅是在被显式请求时才进行搜索。
• LLM 会根据对话的 context 以及你的文档与当前话题的相关性来决定何时使用搜索工具。
• 每次调用工具都发生在生成过程中，使 LLM 能够将你的文档中的实时信息融入到回复中。

例如，如果用户提出了一个编码问题，而 LLM 判断你的文档是相关的，它就可以搜索你的文档，并在回复中包含这些信息，而无需用户显式地询问与你的文档有关的内容。

​

访问你的 MCP 服务器

仅能为公开文档生成 MCP 服务器。需要终端用户认证的文档无法用于生成服务器。

Mintlify 会为你的文档自动生成一个 MCP 服务器，并将其托管在你的文档 URL 的 /mcp 路径下。例如，Mintlify 的 MCP 服务器位于 https://mintlify.com/docs/mcp。

你可以在控制台中的 MCP 服务器页面 查看并复制你的 MCP 服务器 URL。

托管的 MCP 服务器会在其 URL 中使用 /mcp 路径。其他导航元素不能使用 /mcp 路径。

​

使用你的 MCP 服务器

你的用户需要将你的 MCP 服务器连接到他们常用的 AI 工具。

1. 将你的 MCP 服务器 URL 公开可访问。
2. 让用户复制你的 MCP 服务器 URL 并添加到他们的工具中。
3. 用户即可通过其工具访问你的文档。

以下是一些你可以帮助用户连接到你的 MCP 服务器的方法：

Contextual menu

在上下文菜单中为用户添加选项，使其可从文档任意页面连接到你的 MCP 服务器。

选项	标识符	说明
复制 MCP 服务器 URL	mcp	将你的 MCP 服务器 URL 复制到用户的剪贴板。
连接到 Cursor	cursor	在 Cursor 中安装你的 MCP 服务器。
连接到 VS Code	vscode	在 VS Code 中安装你的 MCP 服务器。

Claude

1. 获取你的 MCP 服务器 URL。

   前往控制台，找到你的 MCP 服务器 URL。

2. 为用户发布 MCP 服务器 URL。

   为用户创建一份指南，包含你的 MCP 服务器 URL 以及将其连接到 Claude 的步骤。

   1. 在 Claude 设置中，前往 Connectors 页面。
   2. 选择 Add custom connector。
   3. 添加你的 MCP 服务器名称和 URL。
   4. 选择 Add。
   5. 使用 Claude 时，选择附件按钮（加号图标）。
   6. 选择你的 MCP 服务器。

详见 Model Context Protocol 文档。

Claude Code

1. 获取你的 MCP 服务器 URL。

   前往控制台，找到你的 MCP 服务器 URL。

2. 为用户发布 MCP 服务器 URL。

   为用户创建一份指南，包含你的 MCP 服务器 URL 以及将其连接到 Claude Code 的命令。

   claude mcp add --transport http <name> <url>
   

详见 Claude Code 文档。

Cursor

1. 获取你的 MCP 服务器 URL。

   前往控制台，找到你的 MCP 服务器 URL。

2. 为用户发布 MCP 服务器 URL。

   为用户创建一份指南，包含你的 MCP 服务器 URL 以及将其连接到 Cursor 的步骤。

   1. 使用 Command + Shift + P（Windows 上为 Ctrl + Shift + P）打开命令面板。
   2. 搜索 “Open MCP settings”。
   3. 选择 Add custom MCP。这会打开 mcp.json 文件。
   4. 在 mcp.json 中配置服务器：

   {
     "mcpServers": {
       "<your-mcp-server-name>": {
         "url": "<your-mcp-server-url>"
       }
     }
   }
   

详见 Cursor 文档。

VS Code

1. 获取你的 MCP 服务器 URL。

   前往控制台，找到你的 MCP 服务器 URL。

2. 为用户发布 MCP 服务器 URL。

   为用户创建一份指南，包含你的 MCP 服务器 URL 以及将其连接到 VS Code 的步骤。

   1. 创建 .vscode/mcp.json 文件。
   2. 在 mcp.json 中配置服务器：

   {
     "servers": {
       "<your-mcp-server-name>": {
         "type": "http",
         "url": "<your-mcp-server-url>"
       }
     }
   }
   

详见 VS Code 文档。

​

示例：连接 Mintlify MCP 服务器

连接 Mintlify MCP 服务器，以便在你常用的 AI 工具中搜索此文档站点。这样你就能在本地环境中更精准地了解如何使用 Mintlify，同时也演示了如何帮助你的用户连接到你的 MCP 服务器。

Contextual menu

在本页顶部打开上下文菜单，选择 Connect to Cursor 或 Connect to VS Code，即可将 Mintlify MCP 服务器连接到你选择的 IDE。

Claude

在 Claude 中使用 Mintlify MCP 服务器：

1. 将 Mintlify MCP 服务器添加到 Claude

   1. 进入 Claude 设置中的 Connectors 页面。
   2. 选择 Add custom connector。
   3. 添加 Mintlify MCP 服务器：

   • Name: Mintlify
   • URL: https://mintlify.com/docs/mcp

   4. 选择 Add。
2. 在聊天中访问 MCP 服务器

   1. 使用 Claude 时，点击附件按钮（加号图标）。
   2. 选择 Mintlify MCP 服务器。
   3. 向 Claude 提问有关 Mintlify 的问题。

查看 Model Context Protocol 文档了解更多详情。

Claude Code

在 Claude Code 中使用 Mintlify MCP 服务器，运行以下命令：

claude mcp add --transport http Mintlify https://mintlify.com/docs/mcp

通过运行以下命令测试连接：

claude mcp list

查看 Claude Code 文档了解更多详情。

Cursor在 Cursor 中安装

要将 Mintlify MCP 服务器连接到 Cursor，点击 在 Cursor 中安装 按钮。若需手动连接 MCP 服务器，请按以下步骤操作：

1. 打开 MCP 设置

   1. 使用 Command + Shift + P（Windows 上为 Ctrl + Shift + P）打开命令面板。
   2. 搜索 “Open MCP settings”。
   3. 选择 Add custom MCP。这会打开 mcp.json 文件。
2. 配置 Mintlify MCP 服务器

   在 mcp.json 中添加：

   {
     "mcpServers": {
       "Mintlify": {
         "url": "https://mintlify.com/docs/mcp"
       }
     }
   }
   
3. 测试连接

   在 Cursor 的聊天中，输入 “What tools do you have available?”。Cursor 应显示 Mintlify MCP 服务器为可用工具。

查看 Cursor 文档中的 Installing MCP servers 了解更多详情。

VS Code在 VS Code 中安装

要将 Mintlify MCP 服务器连接到 VS Code，点击 在 VS Code 中安装 按钮。若需手动连接 MCP 服务器，创建 .vscode/mcp.json 文件并添加：

{
  "servers": {
    "Mintlify": {
      "type": "http",
      "url": "https://mintlify.com/docs/mcp"
    }
  }
}

查看 VS Code 文档了解更多详情。