MCP連携

MCPとは

MCP（Model Context Protocol）は、AIモデルが外部ツールを呼び出すための標準プロトコルです。Jinba Tool Registryに登録したツールを、Claude DesktopやJinbaAppなどのMCP対応クライアントから直接利用できます。

エンドポイント

ToolSetの公開設定に応じて2種類のエンドポイントがあります。

種類	エンドポイント	用途
組織	`/v1/orgs/:orgId/toolsets/:slug/mcp`	自組織のToolSet（Private/Public）
公開	`/v1/public/:orgSlug/:toolsetSlug/mcp`	PublicToolSetの外部共有

有効化

ToolSetでMCPを有効にするには、mcpEnabledをtrueに設定します。

Web UI

ToolSetの設定画面で「MCP」のトグルをオンにします。

API

curl -X PATCH https://tool-registry-api.jinba.io/v1/orgs/{orgId}/toolsets/{slug} \
  -H "Authorization: Bearer $JINBA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mcpEnabled": true}'

SDK

await client.updateToolSet("my-toolset", { mcpEnabled: true });

設定方法

Claude Desktop（組織エンドポイント）

claude_desktop_config.jsonに以下を追加:

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

Claude Desktop（公開エンドポイント）

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

JinbaAppワンクリック設定

ToolSetの詳細画面のサイドバーにある「Connect with JinbaApp」ボタンをクリックすると、自動でAPIキーの取得（または新規作成）が行われ、JinbaAppに接続設定が自動入力されます。

動作の仕組み

MCPエンドポイントはJSON-RPC 2.0 over HTTPで動作します。

サポートされるメソッド

メソッド	説明
`tools/list`	ToolSet内のTool一覧を返す
`tools/call`	指定したToolを実行する

リクエスト例

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

レスポンス例

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "my-tool",
        "description": "A description of the tool",
        "inputSchema": {
          "type": "object",
          "properties": {
            "name": { "type": "string" }
          },
          "required": ["name"]
        }
      }
    ]
  }
}

トラブルシューティング

「MCP is not enabled」エラー

ToolSetのmcpEnabledがfalseになっています。Web UIまたはAPIで有効化してください。

「Unauthorized」エラー

APIキーが正しくない、または有効期限が切れています。APIキー管理で新しいキーを発行してください。

ツールが表示されない

ToolSetがPublish済みであることを確認してください
公開エンドポイントの場合、ToolSetのvisibilityがpublicであることを確認してください
mcpEnabledがtrueであることを確認してください

MCP連携

On this page