INTEGRITY Dokumentace

← Vytvářejte agenty na Cloudflare / agents / tools

MCP

Agents mohou používat Model Context Protocol (MCP) jako klienty. Připojte agenta k externím serverům MCP, zjistěte nástroje, které tyto servery poskytují, a předejte tyto nástroje do volání modelu.

Používejte MCP, pokud chcete, aby agent:

Pokud chcete místo toho vytvořit MCP server, přejděte na Model Context Protocol (MCP).

Základní vzor

Zavolejte addMcpServer() pro připojení ke vzdálenému MCP serveru a poté předejte this.mcp.getAITools() do AI SDK.

import { Agent } from "agents";
import { generateText } from "ai";
import { createWorkersAI } from "workers-ai-provider";

export class ToolAgent extends Agent {
	async onStart() {
		await this.addMcpServer("github", "https://mcp.github.com/mcp");
	}

	async onRequest(request) {
		const workersai = createWorkersAI({ binding: this.env.AI });

		const response = await generateText({
			model: workersai("@cf/zai-org/glm-4.7-flash"),
			prompt: "Use available tools to summarize the latest issue activity.",
			tools: this.mcp.getAITools(),
		});

		return new Response(response.text);
	}
}
import { Agent } from "agents";
import { generateText } from "ai";
import { createWorkersAI } from "workers-ai-provider";

export class ToolAgent extends Agent<Env> {
	async onStart() {
		await this.addMcpServer("github", "https://mcp.github.com/mcp");
	}

	async onRequest(request: Request) {
		const workersai = createWorkersAI({ binding: this.env.AI });

		const response = await generateText({
			model: workersai("@cf/zai-org/glm-4.7-flash"),
			prompt: "Use available tools to summarize the latest issue activity.",
			tools: this.mcp.getAITools(),
		});

		return new Response(response.text);
	}
}

Pokud server vyžaduje OAuth, addMcpServer() vrátí stav autentizace a autorizační URL. Připojení se uloží do Úložiště SQL.

Konfigurace

U veřejných serverů MCP není potřeba žádná konfigurace vazby. URL adresy serverů, tokeny API nebo nastavení OAuth ukládejte jako proměnné prostředí nebo tajné klíče.

U serverů MCP, které vyžadují bearer tokeny nebo hlavičky Cloudflare Access, předejte při připojování vlastní přenosové hlavičky.

await this.addMcpServer("internal", this.env.MCP_SERVER_URL, {
	transport: {
		headers: {
			Authorization: `Bearer ${this.env.MCP_TOKEN}`,
			"CF-Access-Client-Id": this.env.CF_ACCESS_CLIENT_ID,
			"CF-Access-Client-Secret": this.env.CF_ACCESS_CLIENT_SECRET,
		},
	},
});
await this.addMcpServer("internal", this.env.MCP_SERVER_URL, {
	transport: {
		headers: {
			Authorization: `Bearer ${this.env.MCP_TOKEN}`,
			"CF-Access-Client-Id": this.env.CF_ACCESS_CLIENT_ID,
			"CF-Access-Client-Secret": this.env.CF_ACCESS_CLIENT_SECRET,
		},
	},
});

McpClient API

Připojte Agents k externím serverům MCP a využijte jejich nástroje, zdroje a prompty.

Připojení k serveru MCP

Vytvořte Agenta, který se připojí k externímu serveru MCP a použije jeho nástroje.

Použití nástrojů MCP s Code Mode

S nástroji MCP použijte postupné zjišťování, skládání založené na kódu a trvalá schválení.

Specifikace Model Context Protocol

Seznamte se s otevřeným protokolem pro propojení AI aplikací s externími nástroji a daty.