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

关于 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 工具。

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

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

Contextual menu
Claude
Claude Code
Cursor
VS Code

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

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

获取你的 MCP 服务器 URL。

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

为用户发布 MCP 服务器 URL。

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

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

详见 Claude Code 文档。

获取你的 MCP 服务器 URL。

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

为用户发布 MCP 服务器 URL。

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

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

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

详见 Cursor 文档。

获取你的 MCP 服务器 URL。

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

为用户发布 MCP 服务器 URL。

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

创建 .vscode/mcp.json 文件。
在 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
Claude
Claude Code
Cursor
VS Code

在 Claude 中使用 Mintlify MCP 服务器：

将 Mintlify MCP 服务器添加到 Claude

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

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

选择 Add。

在聊天中访问 MCP 服务器

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

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

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

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

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

claude mcp list

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

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

打开 MCP 设置

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

配置 Mintlify MCP 服务器

在 mcp.json 中添加：

{
  "mcpServers": {
    "Mintlify": {
      "url": "https://mintlify.com/docs/mcp"
    }
  }
}

测试连接

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

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

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

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

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

快速开始

整理

自定义

创建内容

API 文档

部署

优化

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

关于 MCP 服务器

MCP 服务器的工作方式

访问你的 MCP 服务器

使用你的 MCP 服务器

示例：连接 Mintlify MCP 服务器

快速开始

整理

自定义

创建内容

API 文档

部署

优化

Documentation Index

​关于 MCP 服务器

​MCP 服务器的工作方式

​访问你的 MCP 服务器

​使用你的 MCP 服务器

​示例：连接 Mintlify MCP 服务器

关于 MCP 服务器

MCP 服务器的工作方式

访问你的 MCP 服务器

使用你的 MCP 服务器

示例：连接 Mintlify MCP 服务器