メインコンテンツへスキップ
APIキーは、Jinba Toolbox APIへのリクエストを認証します。ツールの実行、ToolSetの管理、実行履歴の参照など、すべてのAPI呼び出しに有効なAPIキーが必要です。キーは組織にスコープされ、その組織のリソースへのアクセスを提供します。

​
APIキーの仕組み

Authorization: Bearer jtb_xxxxxxxxxxxx
すべてのAPIキーはjtb_プレフィックスを使用します。キーを作成すると、完全なキー値は一度だけ表示されます。以降は、識別用にマスクされたプレフィックスのみがコンソールに表示されます。 APIキーは作成された組織に紐付けられます。組織AのキーでOrganization Bのリソースにアクセスすることはできません（公開ツールの実行を除く。公開ツールは有効なキーであればどれでも実行可能です）。

​
APIキーの作成

1

API Keysに移動

組織のサイドバーでAPI Keysを開きます。既存のキーの一覧が表示されます（ある場合）。
2

キーの作成をクリック

ページ上部のCreate API Keyボタンをクリックします。モーダルが表示されます。
3

名前を入力

キーの用途を識別するための分かりやすい名前を付けます（例：「Production Backend」、「CI/CD Pipeline」、「Local Development」）。この名前は参照用であり、キーの権限には影響しません。
4

キーをコピー

Create Keyをクリックすると、完全なAPIキーが表示されます。すぐにコピーして安全な場所に保存してください。
完全なAPIキーは作成時に一度だけ表示されます。紛失した場合は、新しいキーを作成する必要があります。
5

完了

Doneをクリックしてモーダルを閉じます。新しいキーが一覧に表示され、名前、マスクされたプレフィックス、作成者、作成日、最終使用日が確認できます。

​
APIキー一覧

API Keysページには以下のカラムを持つテーブルが表示されます：
カラム説明
Nameキーに付けた説明的な名前
Key Prefix識別用のキーのマスクされたプレビュー（例：jtb_abc1...）
Created Byキーを作成したユーザー
Createdキーが作成された日時
Last Usedこのキーで行われた最新のAPI呼び出しのタイムスタンプ

​
APIキーの失効

キーを失効させるには、一覧のキーの横にある削除アクションをクリックします。確認ダイアログが表示されます。失効すると：
  • キーは即座に無効化されます。
  • このキーを使用するすべてのAPIリクエストは401 Unauthorizedエラーを返します。
  • この操作は永続的で元に戻すことはできません。
キーの失効は、過去の実行記録やデータには影響しません。そのキーを使用した将来のAPI呼び出しのみが防止されます。

​
認証スコープ

APIキーは以下のスコープに基づいてアクセスを提供します：

Read

ToolSet、ツール、バージョン、実行記録、その他の組織リソースの一覧表示と取得を行います。

Write

ToolSet、ツール、環境変数、その他のリソースの作成、更新、削除を行います。

Execute

ツールの実行と実行記録の作成を行います。API実行とMCPツールコールの両方に必要です。

Admin

組織設定、メンバー、APIキーの管理を行います。完全な管理者アクセスです。

​
APIキーの使用

​
REST API

Authorizationヘッダーにキーを含めます： 
curl -X POST \
  https://toolbox-api.jinba.dev/v1/orgs/{orgId}/toolsets/{slug}/tools/{toolSlug}/run \
  -H "Authorization: Bearer jtb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"name": "Alice"}'

​
TypeScript SDK

SDKクライアントの作成時にキーを渡します： 
import { createClient } from "@jinba-toolbox/sdk";

const client = createClient({
  apiKey: process.env.JINBA_TR_API_KEY,
  organizationId: "your-org-id",
});

const result = await client.run("slack-tools", "post-message", {
  channel: "#general",
  text: "Hello from Jinba Toolbox!",
});

​
MCP Endpoint

AIエージェントをToolSetのMCPエンドポイントに接続する際は、接続設定の一部としてAPIキーを提供します。MCPエンドポイントURLは、MCP Serverが有効になっている場合にToolSet詳細ページで確認できます。

​
個人キーと組織APIキー

Jinba Toolboxは2つのレベルのAPIキーをサポートしています：
タイプスコープ場所
組織APIキー単一の組織のリソースにスコープ組織サイドバー > API Keys
個人APIキーユーザーのアカウントにスコープダッシュボード > API Keys
ほとんどのユースケースでは組織APIキーを推奨します。個人のユーザーアカウントに影響を与えることなく、管理、ローテーション、失効が容易です。

​
ベストプラクティス

  • 分かりやすい名前を付ける — 用途と環境でキーに名前を付けます（例：「Production API Server」、「Staging CI」）。必要な場合にどのキーを失効させるべきか特定しやすくなります。
  • 定期的にキーをローテーションする — 漏洩の影響を限定するために、定期的に新しいキーを作成し、古いキーを失効させます。
  • キーをソースコードにコミットしない — キーは環境変数またはシークレット管理ツールに保存します。
  • 環境ごとに別々のキーを使用する — 開発、ステージング、本番環境ごとに個別のキーを作成します。
  • 未使用のキーを失効させる — キーが不要になったら、すぐに失効させます。「Last Used」カラムを確認して、使用されていないキーを特定します。
  • 組織キーを優先する — アプリケーション統合には、個人キーではなく組織スコープのキーを使用します。