YOU

Cursor 動的ワークフロー

you-agent-factory の Factory Session と動的ワークフローツール向けに、Cursor を MCP ホストとして使います。

概要

Cursor 動的ワークフローとは、you-agent-factory 向けに Cursor を Model Context Protocol (MCP) ホストとして使うことです。Cursor は you mcp serve を子プロセスとして起動し、JavaScript または TypeScript の動的ワークフローを検証・開始・検査する Factory Session ツールを呼び出します。この製品では、動的ワークフローは JavaScript オーケストレーター駆動のファクトリーであり、稼働中の実行は依然として Factory Session です。MCP パスは、検証・開始・状態確認のたびに別ターミナルへ切り替える代わりに、その作業をエディター内に保ちます。

いつ使うか

Cursor から JavaScript または TypeScript の動的ワークフローを作成・駆動し、エディター内で Factory Session ツールを MCP ツールとして使いたいときに、この道筋を使います。CLI のインストール → 実行 → 投入だけでよく、Cursor から Factory Session ツールを呼ぶ必要が無いときは、MCP なしの通常のファクトリーループと投入バッチを優先します。エディターやエージェントが Cursor でなくても MCP を話す場合は、別の MCP ホストガイドを優先します。

手順またはワークフロー

you CLI がインストールされていることを確認し、you mcp serve 用の Cursor Model Context Protocol (MCP) サーバー項目を追加し、子プロセスが起動するよう Cursor を再読み込みし、最初の Factory Session ループを実行します。ソースを検証し、セッションを開始し、状態または結果を確認します。

Cursor MCP 設定の場所

ワークフローがそのリポジトリにあるときはプロジェクトファイル .cursor/mcp.json にサーバー項目を置き、複数プロジェクトで同じサーバーを使いたいときはグローバルファイル ~/.cursor/mcp.json に置きます。1 つのワークフロールートなら、通常はプロジェクト設定で十分です。

Cursor MCP サーバー項目の例

{
  "mcpServers": {
    "you-agent-factory": {
      "command": "/absolute/path/to/you",
      "args": ["mcp", "serve"],
      "cwd": "/absolute/path/to/project"
    }
  }
}
Cursor がシェル PATH を見られないときは、command を you バイナリの絶対パスに置き換えてください。args は mcp serve のままにします。ソースが解決されるよう cwd をワークフローのプロジェクトルートに設定します。ファイルを保存したあと、Cursor を再起動するか Developer: Reload Window を実行し、Cursor が MCP 子プロセスを再起動するようにします。

Cursor からの最初の Factory Session ループ

再読み込み後、Cursor に Factory Session ツールが表示されることを確認します。you.factory_session.* 名を優先してください。ホストが古い you.workflow.* エイリアスを一覧表示しても、同じハンドラーに解決されます。

ワークフローソースを検証する

you.factory_session.validate_source
JavaScript または TypeScript のオーケストレーターソースに対して you.factory_session.validate_source を呼び出します。互換エイリアス: you.workflow.validate。検証が通れば、Cursor が you mcp serve に到達し、プロジェクト cwd がワークフローを解決できることが確認できます。

Factory Session を開始する

you.factory_session.start_async
ポーリングしたいときは you.factory_session.start_async で、完了を待ちたいときは you.factory_session.start_sync で 1 つのセッションを開始します。同期開始の互換エイリアス: you.workflow.run。

状態と結果を確認する

you.factory_session.get
you.factory_session.get_result
進捗は you.factory_session.get で読み、セッションの準備ができたら結果は you.factory_session.get_result で読みます。互換エイリアス: you.workflow.status と you.workflow.result。その検証 → 開始 → 状態または結果の道筋で、Cursor 統合を証明するのに十分です。完全なツール一覧、ランタイム対応の serve フラグ、動的ワークフロー API の詳細は、MCP と動的ワークフローのドキュメントページにあります。この最初のループを終えるために、それらのページを開く必要はありません。

よくある落とし穴

Cursor が PATH 上で you を見つけられない場合は、シェル PATH に頼らず you バイナリの絶対パスを command に設定してください。validate や start がワークフローソースを解決できない場合は、cwd が入れ子のパッケージやホームディレクトリではなく、ワークフローのプロジェクトルートであることを確認してください。MCP 設定を変えたあとは、MCP 子プロセスが再起動するよう Cursor を再起動するか Developer: Reload Window を実行してください。ファイルを保存しただけでは足りません。このガイドは最初の Cursor 統合ループだけを扱います — 完全なツール一覧、serve フラグ、動的ワークフロー API の詳細は、下にリンクした MCP と動的ワークフローのドキュメントページにあります。

タグ

On this page

概要いつ使うか手順またはワークフローよくある落とし穴タグ