ToolSet管理

Jinba ToolboxコンソールでToolSetの作成、Sandbox環境の設定、パッケージの管理、可視性の制御を行う

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

​

ToolSetの作成

1. ToolSetsに移動

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

2. New ToolSetをクリック

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

3. 詳細を入力

   フィールド	説明
   Slug	URL用の識別子（例：slack-tools）。作成後は変更できません。
   Name	人間が読みやすい表示名（例：「Slack Tools」）。
   Description	このToolSetの機能の簡単な概要。
   Language	TypeScriptまたはPython。コードテンプレートとランタイムを決定します。作成後は変更できません。
   Provider	Sandboxプロバイダー：E2BまたはDaytona。作成後は変更できません。
   Visibility	PublicまたはPrivate。後から変更可能です。
   MCP Server	有効にすると、このToolSetをMCPエンドポイントとして公開します。後から切り替え可能です。

4. 作成

   Createをクリックします。ToolSet詳細ページにリダイレクトされ、ツールの追加を開始できます。

​

ToolSet詳細ページ

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

Tools

ToolSet内のすべてのドラフトツールを一覧表示します。新しいツールの追加、ツールをクリックしてコードエディタを開く、未公開の変更があるかどうかを一目で確認できます。

Versions

公開済みバージョンの履歴を表示し、新しいバージョンを公開し、アクティブ（デプロイ済み）バージョンを切り替えます。

Packages

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

Environments

実行時にツールが利用できる環境変数を管理します。値は暗号化されて保存され、必要に応じて表示できます。

​

Sandbox設定

すべてのToolSetは、ツールが実行されるSandbox環境を定義します。Sandbox設定は作成時に行います：

• Language — TypeScriptまたはPython。使用するランタイムと新しいツールに生成されるコードテンプレートを制御します。
• Provider — E2BまたはDaytona。Sandboxプロバイダーがコンテナの作成、コードの実行、ライフサイクル管理を担当します。

​

パッケージの管理

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

1. パッケージの追加

   Add Packageをクリックし、パッケージ名を入力します（例：TypeScriptの場合はaxios、Pythonの場合はrequests）。オプションでバージョン制約を指定できます。

2. パッケージの削除

   一覧のパッケージの横にある削除アイコンをクリックして、Sandbox設定から削除します。

パッケージの変更はドラフト状態に反映されます。更新されたパッケージを本番APIコールに反映するには、新しいバージョンを公開する必要があります。

​

環境変数の管理

Environmentsタブに移動して、シークレットと設定値を管理します。

1. 変数の追加

   Add Variableをクリックします。キー（例：SLACK_TOKEN）、値を入力し、オプションでシークレットとしてマークします。シークレット値はUIでマスクされます。

2. 編集または削除

   編集アイコンをクリックして変数の値を更新するか、削除アイコンをクリックして削除します。

3. シークレットの表示

   表示トグルを使用して、マスクされたシークレット値を一時的に表示します。表示は変数ごとに行われ、適切な権限が必要です。

環境変数は実行時にSandboxに注入され、process.env（TypeScript）またはos.environ（Python）経由でアクセスできます。

​

バージョニングと公開

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

1. 変更を行う

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

2. バージョンを公開

   VersionsタブでNew Versionをクリックします。バージョン番号（コンソールが次のパッチバージョンを提案します）とオプションのリリースノートを入力し、Publishをクリックします。

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

   最新の公開バージョンが自動的にAPIおよびMCPコールで使用されるアクティブバージョンになります。バージョン一覧の任意のバージョンにカーソルを合わせ、Set as Activeをクリックしてアクティブバージョンを切り替えることができます。

公開済みバージョンは不変です。変更を行うには、ドラフトツールを編集して新しいバージョンを公開してください。

​

可視性設定

ToolSetの可視性は、誰がツールを発見・実行できるかを制御します：

可視性	発見	実行
Private	組織メンバーのみ	組織メンバーのみ（セッションまたはAPIキー経由）
Public	Exploreページで誰でも	有効なAPIキーを持つすべての組織
Restricted	一般には非公開	明示的に許可された組織のみ

可視性を変更するには、ToolSetヘッダーの可視性トグルを使用します。Publicへの変更は、ツールスキーマがExploreページで表示されるようになるため確認が必要です（ソースコードは共有されません）。

​

MCP Server

ToolSetでMCP Serverを有効にすると、コンソールにコピー可能なMCP接続エンドポイントURLが表示されます。Model Context Protocolをサポートするエージェントやクライアントは、このエンドポイントに直接接続して、ToolSet内のツールを発見・呼び出すことができます。

MCPのオン・オフはToolSetヘッダーからいつでも切り替え可能です。

​

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

ToolSet詳細ページでは、zipベースのインポートとエクスポートをサポートしています：

• エクスポート — すべてのツール定義、コード、メタデータを含む.zipアーカイブをダウンロードします。バックアップや移行に便利です。
• インポート — .zipアーカイブをアップロードして、ToolSetにツールを一括インポートします。スラッグが一致する既存のツールは更新されます。

​

ToolSet設定の編集

ToolSetヘッダーの設定/編集リンクをクリックして、編集ページに移動します。以下の操作が可能です：

• NameとDescriptionの変更。
• Visibility設定の変更。
• MCP Serverのオン・オフの切り替え。

Language、Provider、Slugは作成後に変更できません。

​

ToolSetの削除

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