← Přehled / ai-search / how-to

Připojte svou instanci AI Search ke klientovi MCP

Každá instance AI Search může zpřístupnit vestavěný Model Context Protocol (MCP) ↗ koncový bod. Tento koncový bod poskytuje search nad vaším indexovaným obsahem, takže jakýkoli MCP klient nebo agent, například AI asistent nebo IDE, může prohledávat vaši znalostní databázi bez jakéhokoli kódu.

Tento návod vytvoří instanci AI Search, která zaindexuje dokumentační web, a poté ji zpřístupní jako vyhledávací nástroj, který může zavolat libovolný MCP klient.

1. Zaregistrujte si účet Cloudflare ↗.
2. Nainstalujte Node.js ↗.

Chcete-li zaindexovat web, potřebujete také doménu onboardovaný do vašeho účtu Cloudflare. Jinak můžete nahrát vlastní soubory do vestavěné úložiště.

Pokud už máte instanci se zaindexovaným obsahem, přejděte rovnou na krok 2.

Vytvořte instanci pomocí Wrangler CLI. Tento příklad indexuje dokumentační web, konkrétně Cloudflare Developer Docs na adrese developers.cloudflare.com, aby z něj asistent mohl odpovídat na otázky. Připojte web jako zdroj dat webu tak, aby ho AI Search automaticky procházel a indexoval:

npx wrangler ai-search create docs-search --type web-crawler --source developers.cloudflare.com

Nahraďte developers.cloudflare.com s doménou, kterou máte onboardovaný do vašeho účtu Cloudflare, protože prohledávat můžete jen weby, které vlastníte. Chcete-li indexovat obsah bez procházení webu, spusťte npx wrangler ai-search create docs-search --type builtin a nahrajte soubory do vestavěné úložiště místo toho.

Kontrola průběhu indexování:

npx wrangler ai-search stats docs-search

Jakmile indexování dokončí, vaše instance má obsah, který lze zpřístupnit přes MCP.

Veřejný endpoint vaší instance zpřístupňuje MCP endpoint.

Klient MCP čte popis nástroje, aby se rozhodl, kdy jej zavolat. V rámci Nastavení > Veřejný koncový bod, nastavte Popis nástroje a popište v něm, co váš obsah pokrývá a na jaké otázky odpovídá. Například:

Search the Cloudflare Developer Documentation for product concepts,
configuration, and API references. Use this when users ask how to build
or configure Cloudflare products.

Konkrétní popis pomáhá agentům volat váš vyhledávací nástroj ve správný okamžik. Podívejte se na Nastavení veřejného koncového bodu pro úplnou konfiguraci.

Přidejte URL adresu MCP do klienta jako vzdálený server MCP. Mnoho klientů používá mcpServers konfiguraci, například:

{
	"mcpServers": {
		"ai-search": {
			"url": "https://<PUBLIC_ENDPOINT_ID>.search.ai.cloudflare.com/mcp"
		}
	}
}

Přesná konfigurace závisí na vašem klientovi. Někteří klienti vyžadují pole transport v položce serveru, například "type": "http" pro vzdálený server HTTP, proto si přidání vzdáleného serveru ověřte v dokumentaci vašeho klienta MCP. Po připojení může klient volat search nástroj pro načtení relevantního obsahu z vaší instance.

Chcete-li endpoint otestovat přímo nebo si vytvořit vlastního klienta, najdete více v MCP pro formát požadavku.

Veřejný endpoint nevyžaduje ověření, takže váš zaindexovaný obsah může dotazovat kdokoli, kdo zná URL adresu.

Chcete-li vyžadovat autentizaci, přidejte vlastní doména a zabezpečte ho pomocí Cloudflare Access. Klienti MCP se poté ověří pomocí Access token služby odesílané jako hlavičky požadavku.

Pokud necháte endpoint otevřený:

• Indexujte pouze obsah, který je bezpečné zveřejnit.
• Povolte omezování frekvence požadavků v Nastavení > Veřejný koncový bod.
• Omezte povolené originy v části Autorizovaní hostitelé. Týká se to pouze klientů v prohlížeči.

Viz Nastavení veřejného koncového bodu s podrobnostmi.