Model Context Protocol (MCP) 端点允许 AI Agent 发现并与你的 AI Search 内容交互。该端点遵循 MCP 规范 ↗,并提供用于查询已索引内容的工具。
为你的 AI Search 实例启用公共端点:
- 在 Cloudflare 仪表板中前往 AI Search。 前往 AI Search ↗
- 选择你的 AI Search 实例。
- 前往 Settings(设置) > Public Endpoint(公共端点)。
- 打开 Enable Public Endpoint(启用公共端点)。
- 复制公共端点 URL。
你可以在单个实例或整个 namespace 上启用公共端点。namespace 端点同样提供 /mcp,并会在该 namespace 中你允许的实例之间搜索。其主机名带有 ns- 前缀:
https://ns-<NAMESPACE_ENDPOINT_ID>.search.ai.cloudflare.com/mcp两种端点的工具与请求格式相同。本页示例使用实例主机名。
AI Search MCP 端点暴露一个 search 工具,用于查询你的已索引内容。
| Tool | Description |
|---|---|
search |
精确查找你要搜索的内容 |
你可以在 AI Search 实例设置中自定义此内容。更多详情请参阅 公共端点配置。
向 /mcp 端点发送请求,并带上 Accept: application/json, text/event-stream 标头:
curl https://<PUBLIC_ENDPOINT_ID>.search.ai.cloudflare.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search",
"arguments": {
"query": "How do I configure AI Search?"
}
}
}'你可以用自己拥有的主机名提供 MCP 端点,例如 https://search.example.com/mcp,而不使用生成的主机名。该主机名必须属于同一 Cloudflare 账户中的 zone。要附加自定义域名:
- 在 Cloudflare 仪表板中前往 AI Search。 前往 AI Search ↗
- 选择你的实例或 namespace。
- 前往 Public Endpoints(公共端点) 并启用公共端点。自定义域名需要已启用的公共端点。
- 前往 Custom Domains(自定义域名) 并附加你的主机名。
自定义域名会通过你自己的 zone 路由请求,因此你可以在端点前放置 Cloudflare Access。MCP 客户端使用 Access 服务令牌 进行身份验证,作为 CF-Access-Client-Id 和 CF-Access-Client-Secret 标头发送,因此只有你签发令牌的智能体才能访问该端点。Access 只保护自定义主机名,因此请同时将 default_domain_enabled 设为 false。否则默认的 <PUBLIC_ENDPOINT_ID>.search.ai.cloudflare.com 主机名会继续响应未经身份验证的请求。
要通过 API 附加域名,请参阅 自定义域名。