OpenAICloudflare Developer Platform2026/07/22 0:00

Agents, Workers - Agents SDK reduces MCP schema conversion, adds exposure controls for MCP in Think and Code Mode SDK adds direct host APIs

要点だけを先に読めるように短く再構成したセクションです。

元記事

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

openaijamodel: gpt-5-mini-2025-08-07

Agents SDK:MCPスキーマ変換削減、Thinkの公開制御追加、Code Modeの直接ホストAPI

Key Points

  • MCPのスキーマ再変換を削減
  • Thinkで自動公開を無効化可能
  • Code Modeを直接ホストで呼び出し可能

Summary

このリリースでは以下を実装しています:

  • MCPクライアントがライブ接続中に変換済みの入力/出力スキーマとツールカタログを再利用し、各モデルターンでのJSON Schema→Zod変換を繰り返さないように最適化。
  • @cloudflare/think に includeMcpTools = false を追加し、Thinkによる自動MCPツール公開をオプトアウト可能に(外部でツールを公開する場合に使用)。
  • @cloudflare/codemode の耐久ランタイムに search(), describe(), execute() を追加し、AI SDKを介さずにMCPサーバーや他ホストからCode Modeランタイムを直接操作可能に。

Key Points

  • パフォーマンス改善:MCPのスキーマ変換が再利用されるため、同一接続下での余分なZod変換を削減。
  • Thinkの公開制御:
    • includeMcpTools = false を設定するとThinkの自動 getAITools() 呼び出しをスキップ。
    • MCPの登録/復元/発見、生カタログ取得、直接呼び出し、Code Modeコネクタは引き続き動作。
    • 生カタログだけ必要な場合は listTools() を使用。
  • Code Modeの直接呼び出し:
    • runtime.search() / runtime.describe() / runtime.execute() で非AI-SDKホストがコネクタ検索・説明・実行を行える。
    • 保護されたメソッドは requiresApproval: true を返し、保留中の実行は既存の approve() / reject() で解決。

Examples

import { Think } from '@cloudflare/think' export class MyAgent extends Think { includeMcpTools = false waitForMcpConnections = true }

// Code Mode 実行例(耐久ランタイムハンドル上で直接呼び出す) const matches = await runtime.search('create issue') const docs = await runtime.describe(matches.results[0].path) const outcome = await runtime.execute({ code: 'async () => github.create_issue()' })

Upgrade

npm i agents@latest @cloudflare/think@latest @cloudflare/codemode@latest yarn add agents@latest @cloudflare/think@latest @cloudflare/codemode@latest pnpm add agents@latest @cloudflare/think@latest @cloudflare/codemode@latest bun add agents@latest @cloudflare/think@latest @cloudflare/codemode@latest

短く:Thinkで自動公開をオフにして外部でツールを管理する場合や、MCPのスキーマ変換コストを下げたいケース、非SDKホストからCode Modeを直接呼び出したいケースに有効です。

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

openaijamodel: gpt-5-mini-2025-08-07

Agents、Workers - Agents SDK が MCP スキーマ変換を削減、Think の MCP 暴露制御を追加、Code Mode SDK がホスト向け直接 API を追加

概要

2026-07-22 のリリースノートです。今回のリリースでは、Agents SDK が同じ MCP スキーマの繰り返し変換を削減し、Think による自動 MCP ツール暴露をオプトアウトする設定を追加しました。さらに、非 AI-SDK ホストが耐久的な Code Mode ランタイムを直接呼び出せるようになりました。

Think における MCP ツールの直接暴露を制御

  • Agents SDK の MCP クライアントは、ライブ接続中に同じツールカタログが維持されている限り、変換済みの入力/出力スキーマを再利用します。これにより、各モデルのターンごとに MCP の JSON Schema を Zod に再変換する必要がなくなります。

  • @cloudflare/think に includeMcpTools が追加されました。Think の自動ツールセットの外(Code Mode や別の仕組み)で MCP ツールを公開している場合は、これを false に設定してください。

    import { Think } from "@cloudflare/think" ; export class MyAgent extends Think { includeMcpTools = false ; waitForMcpConnections = true ; }

    import { Think } from "@cloudflare/think" ; export class MyAgent extends Think<Env> { includeMcpTools = false ; waitForMcpConnections = true ; }

  • この設定は Think の自動 getAITools() 呼び出しをスキップします。

  • MCP の登録、復元、ディスカバリ、未加工カタログへのアクセス、直接呼び出し、Code Mode コネクタは引き続き機能します。

  • 生の MCP カタログだけが必要な場合は listTools() を使用してください。

  • コネクタのセットアップについては「Use MCP tools with Code Mode」を参照してください。

AI SDK を使わずに Code Mode ランタイムを呼び出す

  • @cloudflare/codemode@latestexecute()search()describe() が耐久ランタイムハンドルに追加されました。これにより、MCP サーバーやその他のホストがランタイムを AI SDK のツールに適合させることなく、コードを実行したりコネクタメソッドを発見したりできます。

    const matches = await runtime.search("create issue"); const docs = await runtime.describe(matches.results[0].path); const outcome = await runtime.execute({ code: async () => github.create_issue({ title: "Bug" }) , });

  • searchdescribe の結果には、保護されたコネクタメソッドの場合 requiresApproval: true が含まれます。

  • 一時停止した実行は既存の approve()reject() で解決できます。

  • セットアップと正確なメソッド型については「Create a durable Code Mode runtime」および「Code Mode API reference」を参照してください。

アップグレード

以下のコマンドでパッケージを最新にアップグレードしてください。

  • npm: npm i agents@latest @cloudflare/think@latest @cloudflare/codemode@latest
  • yarn: yarn add agents@latest @cloudflare/think@latest @cloudflare/codemode@latest
  • pnpm: pnpm add agents@latest @cloudflare/think@latest @cloudflare/codemode@latest
  • bun: bun add agents@latest @cloudflare/think@latest @cloudflare/codemode@latest

ご不明点があれば、どの部分について詳しく知りたいか教えてください。