跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

MCP

最后更新 查看 MarkdownAgent 设置

Model Context Protocol (MCP) 端点允许 AI Agent 发现并与你的 AI Search 内容交互。该端点遵循 MCP 规范 ↗,并提供用于查询已索引内容的工具。

前提条件

为你的 AI Search 实例启用公共端点:

  1. 在 Cloudflare 仪表板中前往 AI Search。 前往 AI Search ↗
  2. 选择你的 AI Search 实例。
  3. 前往 Settings(设置) > Public Endpoint(公共端点)。
  4. 打开 Enable Public Endpoint(启用公共端点)。
  5. 复制公共端点 URL。

Namespace MCP 端点

你可以在单个实例或整个 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 端点

向 /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。要附加自定义域名:

  1. 在 Cloudflare 仪表板中前往 AI Search。 前往 AI Search ↗
  2. 选择你的实例或 namespace。
  3. 前往 Public Endpoints(公共端点) 并启用公共端点。自定义域名需要已启用的公共端点。
  4. 前往 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 附加域名,请参阅 自定义域名。

这篇文档对您有帮助吗?