はじめに約1分で読めます7 言語

Code mode: ツールを1ステップで実行し、AIエージェントのトークン使用量を削減する

Code mode を使うと、AIエージェントはツールごとに往復するのではなく、多数のMCPツールを1回の呼び出しでオーケストレーションする短いプログラムを実行できます。フィルタリングと結合は隔離されたサンドボックス内で行われ、最終的な答えだけが返ってくるため、データ量の多いワークフローではトークン使用量を最大90〜99%削減できます。

HC執筆: HelpCode チーム更新日 1分で読了 GitHub でオープンソース

クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり

  • 7日間の無料トライアル
    クレジットカード不要
  • GDPR・SOC 2 レディ
    EU データ保管、監査ログ
  • GitHub でオープンソース
    オープンソース · AGPL-3.0
  • ChatGPT、Claude、Gemini に対応
    MCP 対応クライアントすべて

概要

Code mode を使うと、AIエージェントはツールごとに往復するのではなく、多数のMCPツールを1回の呼び出しでオーケストレーションする短いプログラムを実行できます。フィルタリングと結合は隔離されたサンドボックス内で行われ、最終的な答えだけが返ってくるため、データ量の多いワークフローではトークン使用量を最大90〜99%削減できます。

マルチツール型エージェントが大量のトークンを消費する理由

AIエージェントがツールを呼び出すたびに、その結果はモデルを経由して戻ってきます。 「前四半期に注文したすべての顧客について、未払いの請求書を一覧にして」と頼むと、 1回に1ツールずつ進めるエージェントは数十回の呼び出しを行い、途中のリスト——顧客、 注文、請求書——をすべてコンテキストウィンドウに引き込みます。モデルはそのすべてを トークン単位で読み込みますが、最後に残したいのはほんの一握りのidだけです。データ量の 多いワークフローでは、答えではなく途中のデータこそがコストの正体です。

Code mode は、この往復をなくします。 ツールを1つずつ呼び出す代わりに、 エージェントはあなたのMCPツールをいくつも呼び出し、その結果をフィルタリング・結合し、 重要なものだけを返す短いJavaScriptプログラムを——1ステップで——書きます。数十回の 呼び出しと数メガバイトの途中データが、数行を返す1回の呼び出しになります。多段階で フィルタリングの多いタスクでは、これによりトークン使用量が最大90〜99%削減され、しかも 高速です。ループがモデルを経由せず、データのすぐそばで動くからです。

ビフォーとアフター

Code mode なし — モデルがすべてのステップを進め、すべての結果を読み込む:

search invoices → (model reads 400 rows)
list customers  → (model reads 1,200 rows)
for each open invoice, get the customer → (hundreds of calls, all read back)

Code mode あり — モデルは1つのプログラムを書き、結果だけが返ってくる:

// Discover, read and call your tools from inside the sandbox.
const invoices = await amcp.run('list_invoices', { status: 'open' });
const customers = await amcp.run('list_customers', { activeSince: '2026-01-01' });
const active = new Set(customers.map((c) => c.id));
return invoices
  .filter((i) => active.has(i.customerId))
  .map((i) => ({ id: i.id, amount: i.amount, customer: i.customerId }));

エージェントは、実際に求めていた短いリストを受け取ります。フィルタリングの対象となった 1,600行がコンテキストウィンドウに入ることは一切ありません。

設計として「信頼しない」——だから安全が保たれる

プログラムはモデルが書くものであり、プロンプトインジェクションを受けたツールの結果が それを誘導しようとするおそれがあります。だからこそ Code mode は AnythingMCP の バックエンドでは決して実行されません。実行は専用の code-runner で行われます。 実行ごとに1つの隔離されたサブプロセスが使われ、ネットワークもファイルシステムも環境変数も シークレットもありません。プログラムにできるのは、呼び出し元がすでに使用を許可されている MCPツールを amcp ブリッジ経由で呼び出すことだけで、バックエンドはその呼び出し元の ロールと権限のもとで応答します。到達範囲と読み取り/書き込みのルールはツールを直接 呼び出す場合とまったく同じで、すべての実行が監査され、各実行は制限時間・メモリ上限・ 実行できるツール呼び出し回数の上限によって制約されます。

Code mode は デフォルトではオフ です。ワークスペースはMCPサーバーごとにこれを 有効化し、インラインコードはさらに呼び出し元のロールによってゲートされます——つまり、 あなたが明示的に有効にするまで何も実行されません。

2つの使い方

  • 保存済みコードツール。 本体が保存されたプログラムになっている再利用可能なツールで、 他のツールと同じようにダッシュボードで作成します。ツール一覧に表示され、ロールごとの アクセス権に従い、監査されます。チームが繰り返し実行するワークフローに最適です。
  • インラインコード。 エージェントがその場で書いたプログラムで呼び出せる汎用の Run code ツールで、常に読み取り専用、呼び出し元自身の権限で動作します。エージェントは 保存済みコードツールを 提案 し、管理者に承認してもらうこともできます。

有効化する

  1. ダッシュボードでMCPサーバーを開き、Code mode を Saved code tools または Saved code tools + inline code に設定します。
  2. サーバーが公開するコネクターを選びます——プログラムが到達できるのはそれらだけです。
  3. サーバーを Claude、ChatGPT、あるいは任意のMCPクライアントに接続し、多段階のタスクを 実行するよう依頼します。AnythingMCP Cloud ではランナーはあなたの代わりに管理されます。 セルフホストの場合は、同梱の code-runner サービスを起動してください。

Code mode は AnythingMCP Cloud とセルフホストで利用できます。保存済みコードツールは Starter プラン以上に含まれます。インラインコードとエージェントによる提案は Team 以上で 利用でき、書き込み可能なコードツールは Enterprise の機能です。各プランに含まれる内容は 料金ページをご覧ください。無料トライアルから始めることもできます。

このガイドは役に立ちましたか?

60 秒で MCP をあなたのスタックに。

AnythingMCP をマネージドクラウドで起動するか、自社のインフラでセルフホスト。7 日間無料、クレジットカード不要。

関連ガイド

GS
はじめに

MCP コードモードのレシピ集:月次売上、請求書の照合、100件の価格照会を1回の呼び出しで

AnythingMCP のコードモードによる実用的なプログラムを3つ紹介します。オンラインショップ(Shopify)と会計(Lexware Office)をまたいだ月次売上、注文と請求書の照合、そして100件の顧客価格照会を100回ではなく1回のツール呼び出しで行う方法です。コード、押さえておきたい制限、プログラムをツールとして保存するタイミングも解説します。

GS
はじめに

最初の MCP コードツールを作成する:ERP の受注と CRM のアカウントを 1 回の呼び出しで取得

AnythingMCP のコードモードのステップバイステップ チュートリアル。コードランナーを起動し、コードモードを有効にして、ERP(weclapp)の直近の受注と CRM(HubSpot)のアカウントおよび進行中の案件を 1 回のツール呼び出しで読み取るコードツールを保存します。読み取り専用で、呼び出し元の権限で実行され、監査されます。

GS
はじめに

MCP コードモードとは?AIエージェントのトークン消費とラウンドトリップを削減する方法

コードモードでは、AIエージェントがツールを1つずつモデル経由で呼び出す代わりに、複数の MCP ツールを呼び出す短いプログラムを1つ実行します。トークンとラウンドトリップを節約できる理由、効果がある場合とない場合、そして AnythingMCP での動作方法(保存済みコードツール、インラインコード、エージェントによる提案を、分離されたランナーで実行)を解説します。

GS
はじめに

MCP ナレッジグラフ:システム同士のつながりを学習するコネクター

AnythingMCP は単なる MCP プロキシではありません。ツールのナレッジグラフを構築し、AI エージェントが CRM の顧客を ERP の注文へどうつなぐかを理解できるようにします。スマートコネクターの仕組みを紹介します。

GS
はじめに

モデルコンテキストプロトコル (MCP) とは?

モデルコンテキストプロトコルの理解を深めるための包括的なガイド — その仕組み、重要性、そして始め方。

GS
はじめに

AnythingMCPの始め方

数分でAnythingMCPをインストールして構成します。リポジトリをクローンし、インタラクティブなセットアップスクリプトを実行して、APIをAIエージェントに接続し始めましょう。