> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jinba.io/llms.txt
> Use this file to discover all available pages before exploring further.

# クイックスタート

> 数分でToolSetを作成してツールを実行する

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

## 作るもの

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

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

## 前提条件

* Jinba Toolbox アカウント（[こちらからサインアップ](https://toolbox.jinba.io/)）
* ローカル環境のセットアップは不要 -- すべてクラウドで動作します

## 手順

<Steps>
  <Step title="サインアップしてOrganizationを作成">
    [toolbox.jinba.io](https://toolbox.jinba.io/) にアクセスし、アカウントにサインインします。

    サインイン後、新しい**Organization**を作成します。Organization は、すべてのToolSetとチームメンバーの所有単位です。

    1. ダッシュボードで\*\*「Create Organization」\*\*をクリック
    2. 名前とスラッグを入力（例：`my-team`）
    3. \*\*「Create」\*\*をクリック

    Organization のスラッグはAPIのURLやMCPエンドポイントで使用されます。
  </Step>

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

    1. Organization のダッシュボードに移動
    2. \*\*「New ToolSet」\*\*をクリック
    3. 詳細を入力：
       * **Name**：例 `text-utils`
       * **Description**：例 "Text processing utilities"
       * **Language**：TypeScript または Python を選択
       * **Sandbox Provider**：E2B または Daytona を選択
       * **Visibility**：Private（デフォルト）または Public
    4. \*\*「Create ToolSet」\*\*をクリック
  </Step>

  <Step title="最初のToolを作成">
    **Tool**は、ToolSet内の個別の実行可能ユニットです。各ツールには入力スキーマ、出力スキーマ、コードがあります。

    1. 作成したToolSetを開く
    2. \*\*「Add Tool」\*\*をクリック
    3. ツールを設定：
       * **Name**：`word-count`
       * **Description**："Counts words in a given text"
    4. **入力スキーマ**を定義：

    ```json theme={null}
    {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "The text to count words in"
        }
      },
      "required": ["text"]
    }
    ```

    5. **出力スキーマ**を定義：

    ```json theme={null}
    {
      "type": "object",
      "properties": {
        "wordCount": {
          "type": "number",
          "description": "Number of words in the text"
        }
      },
      "required": ["wordCount"]
    }
    ```

    6. **ツールのコード**を記述（TypeScript）：

    ```typescript theme={null}
    export default async function run(input: { text: string }) {
      const words = input.text.trim().split(/\s+/).filter(Boolean);
      return { wordCount: words.length };
    }
    ```

    7. \*\*「Save」\*\*をクリック
  </Step>

  <Step title="Toolをテスト">
    公開前に、ツールが正しく動作するかテストします。

    1. ツール詳細ページで\*\*「Test」\*\*ボタンをクリック
    2. サンプル入力を入力：

    ```json theme={null}
    {
      "text": "Hello world from Jinba Toolbox"
    }
    ```

    3. \*\*「Run Test」\*\*をクリック
    4. 出力を確認：

    ```json theme={null}
    {
      "wordCount": 5
    }
    ```

    ツールは隔離されたSandboxコンテナ内で実行されます。Run の詳細で stdout、stderr、実行時間を確認できます。
  </Step>

  <Step title="Versionを公開">
    テストが成功したら、ToolSetの不変Versionを公開します。

    1. ToolSetの**Versions**タブに移動
    2. \*\*「Publish Version」\*\*をクリック
    3. semverのバージョン番号を入力（例：`1.0.0`）
    4. \*\*「Publish」\*\*をクリック

    公開されたVersionは不変のスナップショットです。今後の変更には新しいVersionの公開が必要です。
  </Step>

  <Step title="APIまたはMCPで実行">
    これで、ツールをプログラムから呼び出す準備ができました。

    **REST APIを使用する場合：**

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

    **TypeScript SDKを使用する場合：**

    ```typescript theme={null}
    import { createClient } from "@jinba-toolbox/sdk";

    const client = createClient({
      apiKey: process.env.JINBA_TR_API_KEY,
    });

    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サーバーとしても利用可能です：

    ```
    POST /v1/public/{orgSlug}/{toolsetSlug}/mcp
    ```

    Model Context ProtocolをサポートするAIエージェントから、ツールを直接呼び出せます。
  </Step>
</Steps>

## 次のステップ

<CardGroup cols={2}>
  <Card title="コアコンセプト" icon="book" href="./core-concepts">
    ドメインモデルと主要な用語を理解する
  </Card>

  <Card title="Webコンソール" icon="desktop" href="./console/overview">
    ツール管理のためのWebコンソールを探索する
  </Card>

  <Card title="APIリファレンス" icon="server" href="./developer/api-reference">
    REST APIドキュメントの全体を確認する
  </Card>

  <Card title="SDKガイド" icon="cube" href="./developer/sdk">
    Jinba Toolbox をアプリケーションに統合する
  </Card>
</CardGroup>