将 Mintlify Index 连接到你的编码代理

通过 CLI 或手动配置，在 Claude Code、Cursor、VS Code、Codex、OpenCode、Windsurf 或 Zed 中设置 Mintlify Index MCP 服务器。

将你的编码代理连接到 Mintlify Index，使其可以在规划和编写代码时检索最新的技术文档和 Web 上下文。Index 支持 Claude Code、Cursor、VS Code、Codex、OpenCode、Windsurf 和 Zed。

连接公开的 Index MCP 服务器不需要 Mintlify 账户或 API key。

使用 CLI 设置

运行 Index 设置命令，即可在一个步骤中配置一个或多个编码代理：

npx mint index

该命令会检测已安装的受支持编码代理，并提示你选择要配置的代理。对于每个选中的代理，它会将 Index MCP 服务器添加到该代理的配置中，并安装一条规则，告诉代理何时使用 context 工具。

要跳过选择器，请改为传入一个或多个代理标志：

npx mint index --claude --cursor

添加 --yes 可在不提示的情况下配置检测到的所有代理，或添加 --project 将配置写入当前项目，而不是全局代理设置。并非所有代理都支持项目级配置；这些代理始终会接收全局配置。

再次运行该命令即可更新现有设置或添加其他代理。

要手动配置某个代理，或确认 CLI 所做的更改，请按照对应代理的步骤操作。

添加服务器

运行以下命令：

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

验证连接

列出已配置的 MCP 服务器：

claude mcp list

输出应包含状态为已连接的 mintlify-index。

选择在 Cursor 中安装，检查 MCP 配置，然后批准安装。

也可以手动配置 Cursor：

打开 MCP 设置

添加 Mintlify Index

添加以下服务器：

{
  "mcpServers": {
    "mintlify-index": {
      "url": "https://index.mintlify.com/mcp"
    }
  }
}

验证连接

重新加载 Cursor，然后打开 Settings → Tools & MCP（设置 → 工具和 MCP）。mintlify-index 服务器应显示为已连接，并且可以使用 context 工具。

将以下服务器添加到 VS Code 用户配置文件夹中的 mcp.json，或添加到项目中的 .vscode/mcp.json：

{
  "servers": {
    "mintlify-index": {
      "type": "http",
      "url": "https://index.mintlify.com/mcp"
    }
  }
}

将以下服务器添加到 ~/.codex/config.toml，或添加到项目中的 .codex/config.toml：

[mcp_servers.mintlify-index]
type = "http"
url = "https://index.mintlify.com/mcp"

将以下服务器添加到 ~/.config/opencode/opencode.json，或添加到项目中的 opencode.json：

{
  "mcp": {
    "mintlify-index": {
      "type": "remote",
      "url": "https://index.mintlify.com/mcp",
      "enabled": true
    }
  }
}

将以下服务器添加到 ~/.codeium/windsurf/mcp_config.json。Windsurf 不支持项目级 MCP 配置。

{
  "mcpServers": {
    "mintlify-index": {
      "serverUrl": "https://index.mintlify.com/mcp"
    }
  }
}

将以下服务器添加到你的 Zed settings.json，或添加到项目中的 .zed/settings.json：

{
  "context_servers": {
    "mintlify-index": {
      "url": "https://index.mintlify.com/mcp"
    }
  }
}

提出实现问题，并告诉代理在你希望确保它检索最新来源时使用 Index。例如：

Use Mintlify Index to find the current recommended way to configure caching in Next.js 16. Cite the sources you use.

代理在需要技术上下文时会调用 Index 的 context 工具，并在工作中包含返回的来源链接。

运行以下命令：

claude mcp remove mintlify-index

打开 Settings → Tools & MCP（设置 → 工具和 MCP），然后从 mcp.json 中删除 mintlify-index 条目。

对于 VS Code、Codex、OpenCode、Windsurf 或 Zed，请从该代理的 MCP 服务器配置中删除 mintlify-index 条目。

有关工具输入和速率限制，请参阅 Index MCP 参考。