← Přehled / ai-search / api / search

MCP

Endpoint Model Context Protocol (MCP) umožňuje AI agentům objevovat váš obsah AI Search a pracovat s ním. Tento endpoint se řídí Specifikace MCP ↗ a poskytuje nástroje pro dotazování na váš indexovaný obsah.

Povolte veřejné endpointy pro svou instanci AI Search:

1. Přejděte na AI Search v dashboardu Cloudflare. Přejděte na AI Search ↗
2. Vyberte svou instanci AI Search.
3. Přejděte na Nastavení > Veřejný koncový bod.
4. Zapněte Povolte veřejný endpoint.
5. Zkopírujte adresu URL veřejného endpointu.

Veřejný endpoint můžete povolit pro jednu instanci nebo pro celý namespace. Endpoint jmenného prostoru obsluhuje /mcp také a prohledává instance, které v daném jmenném prostoru povolíte. Jeho hostitelský název má předponu ns-:

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

Nástroje a formát požadavku jsou pro obě stejné. Příklady na této stránce používají hostitelský název instance.

Endpoint MCP AI Search zpřístupňuje search nástroj, který dotazuje váš indexovaný obsah.

Toto můžete upravit v nastavení své instance AI Search. Další podrobnosti najdete v Konfigurace veřejného koncového bodu.

Odešlete požadavek na /mcp koncový bod s Accept: application/json, text/event-stream hlavičku:

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 endpoint můžete zpřístupnit z hostitelského názvu, který vlastníte, například https://search.example.com/mcp, místo vygenerovaného. Hostitelský název musí patřit do zóny na stejném účtu Cloudflare. Chcete-li připojit vlastní doménu:

1. Přejděte na AI Search v dashboardu Cloudflare. Přejděte na AI Search ↗
2. Vyberte svou instanci nebo jmenný prostor.
3. Přejděte na Veřejné koncové body a povolte veřejný koncový bod. Vlastní doména vyžaduje aktivní veřejný koncový bod.
4. Přejděte na Custom Domains a připojte svůj hostitelský název.

Vlastní doména směruje požadavky přes vaši vlastní zónu, takže před ni pak můžete umístit Cloudflare Access před endpoint. Klienti MCP se autentizují pomocí Access token služby, odesláno jako CF-Access-Client-Id a CF-Access-Client-Secret hlavičky, takže k endpointu se dostanou pouze agenti, kterým jste vydali tokeny. Access chrání pouze vlastní hostitelský název, proto nastavte default_domain_enabled na false také. V opačném případě výchozí <PUBLIC_ENDPOINT_ID>.search.ai.cloudflare.com hostitelský název i nadále odpovídá na neautentizované požadavky.

Chcete-li místo toho připojit doménu přes API, najdete postup v Vlastní domény.