Developers — build apps on VTC

カーソルルールパック

パブリック リポジトリ — アプリ作成ルールのみ。 .cursor/rules/ としてプロジェクトにコピーします (決してシンボリックリンクしないでください。また、.cursor/ をアプリ リポジトリにコミットしないでください)。

git clone https://github.com/vtcdotcom/vtc-app-rules.git ~/vtc-app-rules

git clone [email protected]:vtcdotcom/vtc-app-rules.git ~/vtc-app-rules

~/vtc-app-rules/scripts/copy-cursor-rules.sh /path/to/your-app

• アプリフォルダーのルートで Cursor を開きます (ワークスペースごとに 1 つのアプリ)。
• スキャフォールディング時に scaffold-checklist.mdc に従うようにカーソルに指示します。
• 共有アプリはスペースごとにデータを分離します。専用アプリは 1 つの発行者データベースを使用します。
• ルールの更新を定期的に取得し、copy-cursor-rules.sh を再実行します。

Cursor のスペース MCP

すでに所属しているスペースに Cursor（または Claude / VS Code）を接続します。MCP はスペース単位です — 外部の製品データベースを VTC に接続する方法ではありません。

1. 1

   接続

   Cursor Settings → MCP に https://mcp.vtc.com/mcp を追加します（設定は下記）。Connect をクリックすると、VTC ログイン用のブラウザが開きます。

2. 2

   サインインしてスペースを選ぶ

   ポップアップで OTP を完了し、スペースを選んで Cursor に戻ります。クライアントはトークンを自動で保存・更新します。

3. 3

   そのスペースに対して尋ねる

   Shared アプリのデータ（list_collections → sample/find）、カタログとマニフェスト、Guide アクション（list_available_actions → execute_action）、またはワークフローの提案/実行を確認できます。変更と実際のワークフロー実行には、先に表示される confirmation_token が必要です。

{
  "mcpServers": {
    "vtc-space-db": {
      "type": "http",
      "url": "https://mcp.vtc.com/mcp"
    }
  }
}

対話型クライアントは OAuth Connect（ブラウザログイン + スペース選択）を使用します。ヘッドレス エージェントは代わりに Developer Help の管理者 JWT を Bearer として渡せます。

• 該当する場合、製品内 Guide と同じロール制限と課金経路を使用します。
• CI / ヘッドレス：Developer Help で管理者 JWT を生成し、MCP ヘッダーに Authorization: Bearer <jwt> を設定します。
• DB ツール用に別の group_id を捏造しないでください — サイロは JWT のスペースのみです。