每个 AI Search 实例都可以公开内置的 Model Context Protocol (MCP) ↗ 端点。该端点在您已建立索引的内容上提供 search 工具，因此任何 MCP 客户端或代理（例如 AI 助手或 IDE）都可以在无需编写代码的情况下搜索您的知识库。
本指南将创建一个对文档站点建立索引的 AI Search 实例，然后将其公开为任何 MCP 客户端都可以调用的搜索工具。
- 注册 Cloudflare 账户 ↗。
- 安装
Node.js↗。
Node.js 版本管理器
使用 Volta ↗ 或 nvm ↗ 等 Node 版本管理器，以避免权限问题并切换 Node.js 版本。本指南后续将介绍的 Wrangler 需要 Node 版本 16.17.0 或更高。
要对网站建立索引，您还需要一个已加入 Cloudflare 账户的域名。否则，您可以将自己的文件上传到内置存储。
如果您已有包含已索引内容的实例，请跳至第 2 步。
使用 Wrangler CLI 创建实例。本示例对文档站点建立索引，使用位于 developers.cloudflare.com 的 Cloudflare 开发者文档，以便助手可以据此回答问题。将站点连接为网站数据源，以便 AI Search 自动爬取并建立索引：
npx wrangler ai-search create docs-search --type web-crawler --source developers.cloudflare.com将 developers.cloudflare.com 替换为您已加入 Cloudflare 账户的域名，因为您只能爬取您拥有的站点。若要在不爬取站点的情况下建立内容索引，请运行 npx wrangler ai-search create docs-search --type builtin，并将文件上传到内置存储。
检查索引进度：
npx wrangler ai-search stats docs-search索引完成后，您的实例将具有可通过 MCP 公开的内容。
实例的公共端点会提供 MCP 端点。
-
在 Cloudflare 仪表板中前往 AI Search。
Go to AI Search ↗ -
选择您的
docs-search实例。 -
前往 Settings（设置） > Public Endpoint（公共端点）。
-
打开 Enable Public Endpoint（启用公共端点），然后打开 MCP 端点。
-
复制端点主机。您的 MCP URL 是该主机加上
/mcp：https://<INSTANCE_ID>.search.ai.cloudflare.com/mcp
MCP 客户端会读取工具描述以决定何时调用它。在 Settings（设置） > Public Endpoint（公共端点） 下，将 Tool Description（工具描述） 设置为说明您的内容覆盖范围及其可回答的问题。例如：
Search the Cloudflare Developer Documentation for product concepts,
configuration, and API references. Use this when users ask how to build
or configure Cloudflare products.具体的描述有助于代理在正确的时机调用您的搜索工具。完整配置请参阅 Public endpoint 设置。
将 MCP URL 作为远程 MCP 服务器添加到客户端。许多客户端使用如下所示的 mcpServers 配置：
{
"mcpServers": {
"ai-search": {
"url": "https://<INSTANCE_ID>.search.ai.cloudflare.com/mcp"
}
}
}确切配置取决于您的客户端。某些客户端要求服务器条目上有传输字段，例如远程 HTTP 服务器的 "type": "http"，因此请参阅 MCP 客户端文档了解如何添加远程服务器。连接后，客户端可以调用 search 工具，从您的实例检索相关内容。
要直接测试端点或构建自己的客户端，请参阅 MCP 了解请求格式。
公共端点不需要身份验证，因此任何拥有该 URL 的人都可以查询您已建立索引的内容。要控制访问：
- 在 Settings（设置） > Public Endpoint（公共端点） 下启用速率限制。
- 使用 CORS 规则限制允许的来源。
- 仅对可安全公开的内容建立索引。
详情请参阅 Public endpoint 设置。