メインコンテンツへスキップ
ToolSetは、共有の実行環境にバンドルされた関連ツールのコレクションです。npmパッケージやDockerイメージのように、ツールをグループ化し、ランタイム依存関係を定義し、semverベースのバージョニングをサポートします。

ToolSetの作成

1

Tool Setsに移動

組織内でサイドバーのTool Setsをクリックします。組織に入ったときのデフォルトページです。
2

New Tool Setをクリック

New Tool Setボタンをクリックします。以下のフィールドを持つ作成フォームが表示されます。
3

詳細を入力

4

作成

Create Tool Setをクリックします。Tool Sets一覧に戻るので、新しいToolSetを開いてツールの追加を開始します。

ToolSet詳細ページ

詳細ページは、ToolSetを管理するための中央ハブです。4つのタブで構成されています:

Tools

ToolSet内のすべてのドラフトツールを一覧表示します。新しいツールの追加、ツールをクリックしてコードエディタを開く、未公開の変更があるかどうかを一目で確認できます。MCPが有効でバージョンが公開済みの場合、エンドポイントとClaude Desktop設定を含むMCP Connectionカードがここに表示されます。

Versions

公開済みバージョンの履歴を表示し、新しいバージョンを公開し、環境ごとのアクティブバージョンを切り替え、バージョンをZIPとしてエクスポートします。

Packages

Sandbox依存関係を管理します。ツールがランタイムで必要とするnpmパッケージ(TypeScript)またはpipパッケージ(Python)の追加・削除を行います。

Environment

環境プロファイル(例:default、staging)と、それぞれの環境でツールが利用できる環境変数を管理します。シークレット値は暗号化されて保存され、必要に応じて表示できます。

Sandbox設定

すべてのToolSetは、ツールが実行されるSandbox環境を定義します。Sandbox設定は作成時に行います:
  • Language — PythonまたはTypeScript。使用するランタイムと新しいツールに生成されるコードテンプレートを制御します。
  • Provider — E2B(APIではdaytonaも受け付けますが、コンソールで選択できるのはE2Bのみです)。Sandboxプロバイダーがコンテナの作成、コードの実行、ライフサイクル管理を担当します。
  • Timeout — 1回の実行に許容される時間。デフォルト900秒、最大3600秒。

パッケージの管理

Packagesタブに移動して、ランタイム依存関係を管理します。
1

パッケージの追加

Add(一覧が空の場合はAdd Package)をクリックし、Package Nameを入力します(例:TypeScriptの場合はaxios、Pythonの場合はrequests)。オプションでVersionを指定できます。空のままにすると最新版になります。
2

パッケージの削除

一覧のパッケージの横にある削除アイコンをクリックし、Removeで確定してSandbox設定から削除します。
パッケージの変更はドラフト状態に反映されます。更新されたパッケージを本番APIコールに反映するには、新しいバージョンを公開する必要があります。TypeScriptのToolSetでは、指定したパッケージに加えてzodとtsxが常にインストールされます。

環境変数の管理

Environmentタブに移動して、シークレットと設定値を管理します。 すべてのToolSetにはdefault環境プロファイルがあります。+ Environment(NameとSlug)でプロファイル(例:staging)を追加でき、各プロファイルは独自の変数セットと独自のアクティブ公開バージョンを持ちます。実行時にどのプロファイルが使われるかは、APIキーの環境(キー作成時に選択)または実行リクエストのenvironmentSlugフィールドで決まります。defaultプロファイルは名前変更や削除ができません。
1

環境を選択

タブ上部のセレクターで環境プロファイルを選びます。
2

変数の追加

+ Variable(一覧が空の場合はAdd Variable)をクリックします。Key(大文字、数字、アンダースコアのみ。例:SLACK_TOKEN)、Valueを入力し、必要に応じてSecretをオンにします。シークレット値は暗号化され、UIでマスクされます。
3

編集または削除

変数にカーソルを合わせてEditをクリックするとキー、値、シークレットフラグを更新できます(値を空のままにすると既存の値を維持)。削除アイコンをクリックすると削除されます。
4

シークレットの表示

シークレット値の横の目のアイコンをクリックして、一時的に値を表示します。
環境変数は実行時にSandboxに注入され、process.env(TypeScript)またはos.environ(Python)経由でアクセスできます。

バージョニングと公開

ToolSetはセマンティックバージョニング(例:1.0.0、1.1.0、2.0.0)を使用します。各バージョンは、公開時点のすべてのツールとそのコードの不変スナップショットです。
1

変更を行う

ドラフト状態でツールの編集、新しいツールの追加、またはパッケージの更新を行います。
2

バージョンを公開

VersionsタブでNew Version(またはToolSetヘッダーのPublish)をクリックします。バージョン番号(コンソールが次のパッチバージョンを提案します)を入力し、Active Environmentを選択し、オプションのリリースノートを入力してPublishをクリックします。
3

アクティブバージョンの設定

新しく公開されたバージョンは、選択した環境のアクティブバージョンに自動的になり、その環境を対象とするAPIおよびMCPコールで使用されます。Versionsタブには環境セレクターがあり、バージョン一覧の任意のバージョンにカーソルを合わせてSet Activeをクリックすると、選択中の環境のアクティブバージョンを切り替えられます。各バージョン行には直近30日間の実行回数と、そのバージョンをZIPでダウンロードするExportアクションも表示されます。
公開済みバージョンは不変です。変更を行うには、ドラフトツールを編集して新しいバージョンを公開してください。

可視性設定

ToolSetの可視性は、誰がツールを発見・実行できるかを制御します: 可視性を変更するには、ToolSetヘッダーのPublicスイッチ(または設定ページのVisibilityフィールド)を使用します。Publicへの変更は、ツールスキーマがExploreページで表示されるようになるため、Make Tool Set Publicの確認ダイアログが表示されます(ソースコードは共有されません)。

MCP Server

ToolSetヘッダーのMCPスイッチがオンで、かつ1つ以上のバージョンが公開されていると、ToolsタブにMCP Connectionカードが表示されます。このカードには、エンドポイントURL、コピー可能なClaude Desktop設定(HTTPエンドポイントをsupergatewayでブリッジするもの)、Connect with JinbaAppボタンが含まれます。Model Context Protocolをサポートするエージェントやクライアントは、このエンドポイントに接続して、ToolSet内のツールを発見・呼び出すことができます。 MCPのオン・オフはToolSetヘッダーからいつでも切り替え可能です。

インポートとエクスポート

ToolSet詳細ページでは、zipベースのインポートとエクスポートをサポートしています。アーカイブの構成、toolset.yml / tool.ymlのフィールド、エラーメッセージはインポートとエクスポートで説明しています:
  • エクスポート — toolset.yml(名前、説明、言語、パッケージ、環境変数。シークレットの値は平文ではなく暗号化された形のまま含まれ、インポート時もそのまま取り込まれます)と、ツールごとのフォルダ(tool.ymlとmain.py / main.ts)を含む{slug}.zipをダウンロードします。バックアップや移行に便利です。公開済みの各バージョンはVersionsタブから個別にエクスポートできます。
  • インポート — 同じ構成のフォルダまたは.zipアーカイブを選択して、ToolSetにツールを一括インポートします。入出力スキーマはインポート時にコードから抽出されます。Overwrite existing tools with same slugをオンにすると、スラッグが一致する既存のツールを更新します。

ToolSet設定の編集

ToolSetヘッダーの設定アイコンをクリックして、設定ページに移動します。以下の操作が可能です:
  • NameとDescriptionの変更。
  • ToolSetのIconのアップロードまたは削除。
  • Visibility設定の変更。
Language、Provider、Slugは作成後に変更できません。MCPスイッチは設定ページではなくToolSetヘッダーにあります。

ToolSetの削除

ToolSetヘッダーの削除アイコンをクリックします。すべてのツールとバージョンが完全に削除されることを警告するDelete Tool Set確認ダイアログが表示されます。この操作は元に戻すことができません。