Jinba FlowをMCPサーバーとして公開する

Jinba Flowのワークスペースでは、選択した公開済みフローをStreamable HTTPのMCPサーバー経由でツールとして公開できます。ワークスペースのMCP設定でフローを選択し、表示されるエンドポイントとワークスペースAPIキーを使ってMCPクライアントを接続します。

フローをMCPツールとして設定するワークスペースのMCP設定 — ワークスペースのMCP設定で、ツールとして公開するフローとクライアント接続情報を確認できます

フローを準備する

MCPツールとして使うフローを公開します。クライアントから受け取る値ごとにINPUT_*ステップを追加してください。入力ステップのIDがパラメータ名になるため、意味の分かるIDと説明を設定します。次の例は、名前を受け取り、挨拶を返すフローです。

name: Greeting
steps:
  - id: name
    tool: INPUT_TEXT
    input:
      - name: value
        value: Jinba

  - id: greeting
    tool: OUTPUT_TEXT
    needs: [name]
    input:
      - name: value
        value: "Hello, {{ steps.name.result }}!"

ワークスペースのMCP設定で公開済みフローを選択し、クライアントが用途を判断できる説明を追加します。設定したフローがMCPツールとして公開されます。

ツールのアノテーション

各 MCP ツールの設定ダイアログには、ツールと一緒に AI クライアントへ送られる 2 つのアノテーションがあります。

読み取り専用ツール — 状態の確認や読み取りだけを行い、作成・変更・送信などの副作用がないフローに付けます。クライアントはこのツールを再実行しても安全なものとして扱います。たとえば Jinba App Neo の wait_for_flow は、読み取り専用に設定されたツールのみを受け付けます。
破壊的アクション警告 — 削除・変更・取り消せない操作を行うフローに付けます。クライアントは実行前にユーザーへ確認を求めます。読み取り専用ツールが破壊的になることはないため、読み取り専用が ON の間はこのオプションを設定できません。

MCPクライアントを接続する

ワークスペースのMCP設定からクライアント設定をコピーします。現在のエンドポイントと接続方法が含まれます。Streamable HTTPクライアントの設定は次のような形式です。

{
  "mcpServers": {
    "jinbaflow": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "https://api.jinba.io/api/v2/workspaces/WORKSPACE_ID/mcp",
        "--header",
        "Authorization: Bearer YOUR_TOKEN"
      ]
    }
  }
}

YOUR_TOKEN を、ワークスペースAPIキーまたはプロフィール設定で発行した個人APIキー（sk-user-…）に置き換えてください。個人APIキーを使う場合、その所有者が対象ワークスペースのメンバーであり、フローの実行権限を持っている必要があります。凍結・アーカイブ済みのワークスペースには接続できません。個人APIキーでの実行はキー所有者として記録され、フロー内の個人シークレットもその所有者のものを使用します。クレジットはフローが属するワークスペースの組織から消費されます。個人APIキーは複数のワークスペースで使えるため、他の人と共有しないでください。キーを失効させるかWSから脱退すると、その後のリクエストは拒否されます。ツールの実行中にクライアントがリクエストをキャンセルすると、背後のフロー実行もキャンセルされ、実行履歴にはキャンセル済みとして表示されます。ワークスペースAPIキーは、そのワークスペースのMCPサーバーへのアクセス権を持ちます。キーを公開したり、公開プロンプトに貼り付けたりしないでください。

接続を確認する

Jinba Flowで生成した設定を使ってクライアントを接続します。
クライアントで利用可能なツールを更新または一覧表示します。
設定したフローが表示されることを確認し、安全なテスト入力で呼び出します。

接続できてもツールが表示されない場合は、フローが公開済みで、ワークスペースのMCP設定で選択されているか確認します。認証に失敗する場合は、設定画面から最新のワークスペースAPIキーとエンドポイントをコピーします。MCP呼び出しはフローを実行するため、安全に実行できるテスト用フローを選んでください。

リクエストの上限

MCPエンドポイントは、次の上限を超えるリクエストを拒否します。

4 MiBを超えるリクエストボディはHTTP 413で拒否されます。tools/callのツール引数も含みます。
33件以上のメッセージを含むJSON-RPCバッチはHTTP 400で拒否されます。
Jinba Flowが発行していないMcp-Session-IdにはHTTP 404を返し、クライアントは新しいセッションを開始します。標準のMCPクライアントはinitializeでサーバーが返したセッションIDを再利用するため、影響はありません。

​フローを準備する

​ツールのアノテーション

​MCPクライアントを接続する

​接続を確認する

​リクエストの上限

フローを準備する

ツールのアノテーション

MCPクライアントを接続する

接続を確認する

リクエストの上限