API・MCPアクセス

APIキーを生成して、外部アプリケーションからJiteraのエージェント、プロジェクトデータ、MCPツールにアクセスします。

APIキーを使うと、外部アプリケーションからJiteraプロジェクトのエージェント、データ、MCPツールにアクセスできます。APIはOpenAI互換です。OpenAI APIに対応するツールやSDKであれば、ベースURLとAPIキーを変更するだけでJiteraに接続できます。

​

APIキー設定への移動

プロジェクトから、設定 > 開発 > APIキー に移動します。

​

APIキーの作成

APIキーを作成できるのはプロジェクトのオーナーと管理者のみです。すべてのプロジェクトメンバーが既存のキーを閲覧できます。

1. + 新しいキー をクリック

   

2. キーの説明的な名前を入力（例：「Claude Desktop」、「CIパイプライン」）

3. 作成 をクリック

4. ダイアログに3つの項目が表示されます — すぐにすべてコピーしてください:

   • APIシークレットキー — 完全な認証トークン（一度だけ表示）
   • APIベースURL — APIリクエストのエンドポイント
   • MCP JSON — すぐに使えるMCPサーバー設定
   

APIシークレットキーは作成時に一度だけ表示されます。安全に保管してください。紛失した場合は、新しいキーを作成してください。

​

MCPクライアントでの利用

MCP JSON 設定をMCP互換ツールに直接コピーして使用できます。例えば、Claude DesktopやCursorでJiteraのエージェントとツールを利用するには:

1. 上記の手順でAPIキーを作成
2. ダイアログから MCP JSON をコピー
3. 外部ツールのMCPサーバー設定に貼り付け
4. 外部ツールからMCP経由でJiteraエージェントのツールにアクセス可能になります

MCP JSONは以下の形式です:

{
  "mcpServers": {
    "jitera-mcp": {
      "url": "https://mcp.jitera.ai",
      "headers": {
        "Authorization": "Bearer <your-api-secret-key>"
      }
    }
  }
}

代替URL: https://proxy-us.jitera.ai/gateway/boost

日本サーバーをご利用のエンタープライズのお客様は、エンドポイントが異なります。日本サーバーをご契約の場合は、URLを以下のいずれかに置き換えてください:

• https://gateway-proxy.jitera.app/gateway/boost
• https://ai.jitera.app

​

OpenAI互換APIとしての利用

Jitera APIは OpenAI API仕様 に準拠しています。OpenAI互換のSDKやHTTPクライアントから、Jitera APIベースURLを指定するだけで利用できます。

​

認証

すべてのAPIリクエストには Authorization ヘッダーが必要です:

Authorization: Bearer <your-api-secret-key>

​

利用可能なエンドポイント

メソッド	エンドポイント	説明
GET	/v1/models	利用可能なモデル一覧
GET	/v1/models/{model_id}	特定のモデルを取得
POST	/v1/chat/completions	チャット補完（ストリーミング/非ストリーミング）
POST	/v1/files	ファイルのアップロード
GET	/v1/files	ファイル一覧
GET	/v1/files/{file_id}	ファイルメタデータの取得
DELETE	/v1/files/{file_id}	ファイルの削除
GET	/v1/files/{file_id}/content	ファイル内容のダウンロード

​

チャット補完

POST /v1/chat/completions

Jiteraエージェントにチャットリクエストを送信します。リクエストとレスポンスはOpenAI Chat Completionsフォーマットに準拠しています。

リクエスト:

{
  "model": "jitera/chat:latest",
  "messages": [
    { "role": "user", "content": "こんにちは！" }
  ],
  "stream": false
}

レスポンス:

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1711700000,
  "model": "jitera/chat:latest",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "こんにちは！何かお手伝いできることはありますか？"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 15,
    "total_tokens": 25
  }
}

​

ストリーミング

"stream": true を設定すると、レスポンスがServer-Sent Events（SSE）として返されます。各イベントは data: フィールドのJSONチャンクです:

data: {"id":"chatcmpl-abc123","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant","content":"こんに"},"finish_reason":null}]}

data: {"id":"chatcmpl-abc123","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"ちは！"},"finish_reason":null}]}

data: {"id":"chatcmpl-abc123","object":"chat.completion.chunk","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: [DONE]

​

モデル

model フィールドでリクエストを処理するエージェントを選択します:

モデルID	説明
jitera/chat:latest	デフォルトのJiteraチャットエージェント
jitera/<agent_id>	特定のカスタムエージェント（エージェントのIDを使用）

GET /v1/models を呼び出して、プロジェクトで利用可能なすべてのモデルを確認できます。

​

使用例: OpenAI SDK (Python)

from openai import OpenAI

client = OpenAI(
    api_key="<your-api-secret-key>",
    base_url="<your-api-base-url>/v1",
)

response = client.chat.completions.create(
    model="jitera/chat:latest",
    messages=[
        {"role": "user", "content": "プロジェクトの要件をまとめてください"}
    ],
)

print(response.choices[0].message.content)

​

使用例: cURL

curl <your-api-base-url>/v1/chat/completions \
  -H "Authorization: Bearer <your-api-secret-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jitera/chat:latest",
    "messages": [{"role": "user", "content": "こんにちは！"}]
  }'

​

APIキーの管理

APIキー一覧には以下が表示されます:

列	説明
名前	キーに付けた名前
作成日	キーが作成された日時
最終使用	キーが最後にAPIリクエストに使用された日時
作成者	キーを作成したチームメンバー

キーを失効させるには、横にある削除アクションをクリックします。失効したキーはすべてのAPIおよびMCPリクエストで即座に使用できなくなります。

​

関連

• アプリ (MCP) — エージェントへのMCPアプリの接続
• エージェント管理 — エージェントの作成と設定
• オートメーション — エージェントタスクのスケジューリング