クイックスタート

1. アカウント作成

Jinba Tool Registryにアクセスし、アカウントを作成します。

GoogleアカウントまたはEmailで登録できます。

2. Organizationを作成

ログイン後、Organizationを作成します。

Organizationはチームやプロジェクト単位でリソースを管理するためのコンテナです。

3. ToolSetを作成

サイドバーから「Tool Sets」を選択し、「New ToolSet」をクリックします。

ToolSetは関連するToolをグループ化するコンテナです。作成時に公開設定を選択できます:

Private: 組織メンバーのみアクセス可能
Public: 誰でもアクセス可能（認証は必須）

4. Toolを作成

ToolSet内で「New Tool」をクリックし、ツールを作成します。詳しくはツール開発ガイドを参照してください。

Pythonの場合

Pydanticを使ってInput/Outputを定義します。

from pydantic import BaseModel

class Input(BaseModel):
    name: str

class Output(BaseModel):
    message: str

def run(input: Input) -> Output:
    return Output(message=f"Hello, {input.name}!")

TypeScriptの場合

Zodを使ってInput/Outputを定義します。

import { z } from "zod";

export const input = z.object({
  name: z.string(),
});

export const output = z.object({
  message: z.string(),
});

export async function run(data: z.infer<typeof input>) {
  return { message: `Hello, ${data.name}!` };
}

5. Publishする

ToolSetの「Versions」タブから新しいバージョンをPublishします。

6. API Keyを発行

サイドバーから「API Keys」を選択し、新しいAPIキーを発行します。詳しくはAPIキー管理を参照してください。

7. ツールを呼び出す

REST API

ToolSetの公開設定に応じて、適切なエンドポイントを使用します。

組織エンドポイント（Private/Public共通）

自組織のツールを実行する場合:

curl -X POST https://tool-registry-api.jinba.io/v1/orgs/{orgId}/toolsets/{toolsetSlug}/tools/{toolSlug}/run \
  -H "Authorization: Bearer $JINBA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": {"name": "World"}}'

公開エンドポイント（Public ToolSet向け）

他組織のPublicツールを実行する場合、または外部に共有する場合:

curl -X POST https://tool-registry-api.jinba.io/v1/public/{orgSlug}/{toolsetSlug}/tools/{toolSlug}/run \
  -H "Authorization: Bearer $JINBA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": {"name": "World"}}'

MCP（Model Context Protocol）

Claude DesktopなどのMCP対応クライアントから接続できます。ToolSetの公開設定に応じてエンドポイントが異なります。詳しくはMCP連携を参照してください。

Public ToolSet

他組織のユーザーにも共有可能なエンドポイント:

{
  "mcpServers": {
    "my-toolset": {
      "url": "https://tool-registry-api.jinba.io/v1/public/{orgSlug}/{toolsetSlug}/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Private ToolSet（組織エンドポイント）

自組織のツールに接続する場合:

{
  "mcpServers": {
    "my-toolset": {
      "url": "https://tool-registry-api.jinba.io/v1/orgs/{orgId}/toolsets/{toolsetSlug}/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

JinbaApp連携

ToolSetの詳細画面のサイドバーに表示される「Connect with JinbaApp」ボタンから、ワンクリックでJinbaAppにMCP接続を追加できます。

ボタンをクリックすると、API Keyの取得（または新規作成）が自動で行われ、JinbaAppが開いて接続設定が自動入力されます。

JinbaFlow連携

JinbaFlowのフローからJinba Tool Registryのツールを呼び出せます。詳しくはJinbaFlow連携を参照してください。

ToolSetの詳細画面のサイドバーに表示される「Connect with JinbaFlow」ボタンから、ワンクリックでJinbaFlowにレジストリを登録できます。ボタンをクリックすると、API Keyの取得（または新規作成）が自動で行われ、JinbaFlowのWorkspace設定画面が開きます。

手動で設定する場合:

JinbaFlowのWorkspace Settings > Tool Access Control > Add Registry
Manifest URLを入力: https://tool-registry-api.jinba.io/v1/public/jinbaflow/manifest
API Keyを入力
保存すると、組織内のPublish済みToolSetがJinbaFlowのフローエディタから利用可能になります

JinbaFlow連携では、組織内の全てのPublish済みToolSetがまとめて公開されます（ToolSet単位ではなく組織単位）。

コスト負担について

ツール実行時のクレジット消費は、常に実行者の組織から行われます。詳しくはクレジットと課金を参照してください。

他組織のPublicツールを実行: あなたの組織のクレジットが消費
自組織のツールを実行: 自組織のクレジットが消費

ツールを公開しても、提供者のクレジットは消費されません。

次のステップ

ツール開発ガイド - ツールの書き方を詳しく学ぶ
SDK - TypeScript SDKで操作する
Import/Export - ローカルで開発してZIPでインポート
FAQ - よくある質問

クイックスタート

On this page