← Обзор / ai-search / api / search

MCP

Конечная точка Model Context Protocol (MCP) позволяет ИИ-агентам обнаруживать содержимое AI Search и взаимодействовать с ним. Эта конечная точка соответствует Спецификация MCP ↗ и предоставляет инструменты для выполнения запросов к вашему индексированному контенту.

Включите публичные конечные точки для своего экземпляра AI Search:

1. Перейдите в AI Search в панели управления Cloudflare. Перейдите в AI Search ↗
2. Выберите свой экземпляр AI Search.
3. Перейдите в Настройки > Публичная конечная точка.
4. Включите Включить публичную конечную точку.
5. Скопируйте URL-адрес публичной конечной точки.

Вы можете включить публичную конечную точку для отдельного экземпляра или для всего пространство имён. Конечная точка пространства имён обслуживает /mcp тоже, и выполняет поиск по экземплярам, которые вы разрешили в этом пространстве имён. Его имя хоста начинается с ns-:

https://ns-<NAMESPACE_ENDPOINT_ID>.search.ai.cloudflare.com/mcp

Инструменты и формат запроса одинаковы для обоих вариантов. В примерах на этой странице используется имя хоста экземпляра.

Конечная точка MCP AI Search предоставляет 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. Чтобы подключить пользовательский домен:

1. Перейдите в AI Search в панели управления Cloudflare. Перейдите в AI Search ↗
2. Выберите свой экземпляр или пространство имён.
3. Перейдите в Публичные конечные точки и включите публичную конечную точку. Для пользовательского домена нужна активная публичная конечная точка.
4. Перейдите в Custom Domains и подключите своё имя хоста.

Пользовательский домен маршрутизирует запросы через вашу собственную зону, поэтому затем вы можете разместить перед ним 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, см. Пользовательские домены.