初めてのJinba Toolbox ToolSetを作成して実行する

組織を開き、ToolSetの構築、ツールの作成、Sandbox環境での実行を通じて、Jinba Toolbox を始めましょう。

作るもの

以下を行うツールを含むシンプルなToolSet：

テキスト入力を受け取る
隔離されたSandboxで処理する
構造化された出力を返す

前提条件

Jinba Toolbox アカウント（こちらからサインアップ）
ローカル環境のセットアップは不要 — すべてクラウドで動作します

手順

サインインしてOrganizationを開く

toolbox.jinba.io にアクセスし、アカウントにサインインします。サインイン後、ダッシュボードにYour Organizations（所属組織）の一覧が表示されます。Organization は、すべてのToolSetとチームメンバーの所有単位です。Organization とそのメンバーはToolboxコンソールではなくJinbaAuthで管理されており、招待された組織がここに表示されます。

作業したいOrganizationをクリック
そのOrganizationのTool Setsページが開きます

Organization のID（URLの /org/{orgId}/... に表示される値）をAPIのURLやMCPエンドポイントで使用します。

ToolSetを作成

ToolSetは、共有の実行環境を持つ関連ツールのコレクションです。npmパッケージやDockerイメージに似ています。

Organization のサイドバーでTool Setsに移動
**「New Tool Set」**をクリック
詳細を入力：
- Name：例 Text Utils（Slug（例：text-utils）は名前から自動生成され、編集できます）
- Description：例 “Text processing utilities”
- Visibility：Private（デフォルト）または Public
- Provider：E2B
- Language：Python または TypeScript を選択
- Timeout (seconds)：任意、デフォルト900（最大3600）
**「Create Tool Set」**をクリック

最初のToolを作成

Toolは、ToolSet内の個別の実行可能ユニットです。各ツールには入力スキーマ、出力スキーマ、コードがあります。スキーマを個別に入力する必要はなく、保存のたびにコード内の input と output の定義から抽出されます。

作成したToolSetを開く
**「Add Tool」**をクリック
ツールを設定：
- Name：Word Count（Slug word-count は名前から自動生成されます）
- Description：“Counts words in a given text”
**「Create Tool」**をクリックすると、ツールエディタが開きます
スターターテンプレートをツールのコード（TypeScript）に置き換えます：

import { z } from "zod";

export const input = z.object({
  text: z.string().describe("The text to count words in"),
});

export const output = z.object({
  wordCount: z.number().describe("Number of words in the text"),
});

export async function run(data: z.infer<typeof input>) {
  const words = data.text.trim().split(/\s+/).filter(Boolean);
  return { wordCount: words.length };
}

**「Save」**をクリック（または Cmd/Ctrl + S）。保存時にZodの定義から入力・出力のJSON Schemaが生成されます。

Toolをテスト

公開前に、ツールが正しく動作するかテストします。

エディタ下部のテストパネルでInputタブを開き、サンプル入力を入力：

{
  "text": "Hello world from Jinba Toolbox"
}

**「Run」**をクリック（または Cmd/Ctrl + Enter）
パネルがOutputタブに切り替わります。出力を確認：

{
  "wordCount": 5
}

ツールは隔離されたSandboxコンテナ内で実行されます。テスト実行は組織のRunsページにバージョン test として記録され、そこで stdout、stderr、実行時間を確認できます。

Versionを公開

テストが成功したら、ToolSetの不変Versionを公開します。

ToolSetのVersionsタブに移動
「New Version」（またはToolSetヘッダーの**「Publish」**）をクリック
semverのバージョン番号（例：1.0.0。コンソールが次のパッチバージョンを提案します）と任意のリリースノートを入力
**「Publish」**をクリック

公開されたVersionは不変のスナップショットで、選択した環境のアクティブVersionに即座になります。今後の変更には新しいVersionの公開が必要です。

APIまたはMCPで実行

これで、ツールをプログラムから呼び出す準備ができました。まず、組織のサイドバーのAPI KeysでAPIキーを作成します。REST APIを使用する場合（入力は input キーの下に指定します）：

curl -X POST https://toolbox-api.jinba.io/v1/orgs/{orgId}/toolsets/text-utils/tools/word-count/run \
  -H "Authorization: Bearer jtb_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"input": {"text": "Hello world from Jinba Toolbox"}}'

TypeScript SDKを使用する場合：

import { createClient } from "@jinba-toolbox/sdk";

const client = createClient({
  baseUrl: "https://toolbox-api.jinba.io",
  apiKey: process.env.JINBA_TB_API_KEY!,
  organizationId: "your-org-id",
});

const result = await client.run("text-utils", "word-count", {
  text: "Hello world from Jinba Toolbox",
});

console.log(result.output); // { wordCount: 5 }

MCPエンドポイントを使用する場合（AIエージェント向け）：ToolSetヘッダーのMCPスイッチをオンにします。ToolSetはMCPサーバーとして以下で利用可能になります：

POST /v1/orgs/{orgId}/toolsets/{toolsetSlug}/mcp

（公開ToolSetは POST /v1/public/{orgId}/{toolsetSlug}/mcp でもアクセスできます。）Model Context ProtocolをサポートするAIエージェントから、ツールを直接呼び出せます。

次のステップ

コアコンセプト

ドメインモデルと主要な用語を理解する

Webコンソール

ツール管理のためのWebコンソールを探索する

APIリファレンス

REST APIドキュメントの全体を確認する

SDKガイド

Jinba Toolbox をアプリケーションに統合する

​作るもの

​前提条件

​手順

​次のステップ