はじめかた

いまのあなたに合った
入口をいっしょに選びます

Git やプログラミングがはじめてでも、プロダクトを少しずつ良くしていきたい方。4つの質問に答えると、おすすめの開始レッスンが分かります。最初は契約名です。迷ったら「分からない」や「まだ」を選んで大丈夫です。

1. いまの契約は、新しい契約の Free / Plus ですか?
2. Cursor と保管庫(GitHub や Origin など)は用意できていますか?
3. Cloud Agent を動かしたことはありますか?
4. Pull Request(変更提案)を読んだことはありますか?

よくある入口のパターン

いまの位置を確認したい方

4章・17レッスンのロードマップで、次にやるレッスンが分かります。琥珀が現在地、ティールが済です。

学習ロードマップへ

完全にはじめての方

第1章を順番どおり進めるのがおすすめです。約45分で初回起動までたどり着けます。

レッスン 01 から

GitHub がまだ無い/試作から始めたい方

公式では GitHub 接続なしでも Cloud Agent を起動できます。保管庫ピッカーの Start from scratch と Origin(早期ベータ)が入口です。有料プランと Origin が必要です。作業中の画面は Agents Window の Forwarded Ports、公開は Vercel(チームなら Hobby より上)、CI は Origin ホストなら Depot / Buildkite。画面に出ないときは GitHub 本線で進みます。

Start from scratch の節へ

手元 PC を閉じても作業を続けたい方

Cloud Agent はクラウド側で進み、端末は司令塔です。複数 Agent を並列で走らせることもできます。

4ステップのループへ

スマホから手元 PC の Agent を続けたい方

いちばん簡単な入口は iOS アプリのペアリングです。パソコンが一覧に出るのでタップし、Desktop で承認します。手元の Agent は動かしたままで、Cloud Agent は不要です。Enterprise 以外は既定オン。PC は電源接続・ふたを開けたまま起こします。会話の指揮をクラウドへ移すなら `/remote-control` です。

iOS のペアリングへ

Desktop の作業をクラウドへ移したい方

Move to Cloud は、会話をクラウド VM 上の Agent へ移す操作です。会話の履歴は移ります。未コミットの手元の変更は写りません。移す前にコミットするか stash します。保存していないファイルのまま続けたいときは Remote Control です。

Move to Cloud とのちがいへ

起動時に Cloud machine / Team Pool / My Machines と出た方

はじめては Cloud machine で問題ありません。鍵が要る仕事も Cloud machine。手元 PC のファイルを触りたいときは My Machines か Remote Control(ダッシュボードの Secrets は届きません)。社内専用の作業場が必要な Team Pool は、公式では Enterprise プランが前提です。鍵は Secret sync(`--sync-dashboard-secrets`)です。自前作業場ではコード本体は残り、会話に必要な抜粋と成果物はクラウドへ届きます。

実行先の選び方へ

会社の Lambda / Cloudflare / Daytona で Agent を動かしたい方

本線は Cursor が用意する Cloud machine です。Team Pool は Enterprise 前提で、会社がすでに使っているサンドボックス(Superserve 含む)の上にも置けます。Kubernetes の新規は anysphere/k8s-workers。待たせたくないときは `--warm-idle`。使っていない作業場は休眠できます。

Cloud だけでかなり行けるへ

CLI で Skill を1通だけ使いたい方

CLI の `/` メニューで Enter は今の1通に付けるだけです。ピン留め(Custom Mode)は Desktop と同じ ⌥ Enter(Windows は Alt+Enter)です。

Custom Mode の節へ

同僚に Agent の URL を送したが開けない方

Agent は起動した Cursor チームのメンバーに見えますが、チームのメンバーであるだけでは開けません。複数チームにいるときはワークスペースが一致しているか、相手の GitHub 接続とリポジトリ権限も確認しましょう。

チーム共有と follow-ups へ

会話をリンクで渡したいが、Agent の URL と Share のちがいが分からない方

Agent の URL はその実行(会話・差分・成果物)です。見出しの Share は Shared transcripts で、会話の写しだけです。Public は cursor.com/s/ で、サインインなしで読めます。使えるのは Teams と Enterprise で、鍵の消去は保証されません。

会話の写しの節へ

個人用 Skill がモバイルで効かない方

リポジトリの `.cursor/skills/` に入っていない個人用 Skill は、Cursor に同期(synced)されていないとモバイル起動から使えません。同期されるのは `~/.cursor/skills/` だけです。`~/.agents/skills/` はコピーされません。チーム共有ならリポジトリへ PR で入れるのが確実です。

モバイル起動でも効く Rules / Skills へ

Cloud Agent や My Machines で個人用 Skill が効かない方

`~/.agents/skills/` や未同期の手元 Skill は Cloud Agent・Remote SSH・自前ワーカーには届きません。同期は `~/.cursor/skills/` だけ。自前ワーカーならリポジトリの Skill か、イメージへの焼き込みです。

Skill の作り方へ

Claude や Codex 向けに Skill を置いている方

Cursor は `.claude/skills/` と `.codex/skills/`(ホームの `~/.claude/skills/` なども含む)も読みます。同期や Cloud Agent へ届くのはこれまでどおり `~/.cursor/skills/` です。

Skill の作り方へ

Skill やプラグインをどこから入れればよいか分からない方

Desktop ならサイドバーの Customize がまとめて扱う画面です。プラグイン・Skill・MCP・サブエージェント・Rules・コマンド・Hooks を自分 / 作業場 / チームで絞れます。コミュニティは cursor.directory です。

Skill の作り方へ

個人用 Skill をチームに配りたい方

Teams / Enterprise なら Customize → Skills から Default marketplace へ Publish できます。公開しても同僚は自分で入れます。管理者が Allow Members to Publish をオフにすると、新規公開は管理者だけです。その保管庫だけなら `.cursor/skills/` への PR の方が分かりやすいです。

チームへ公開する節へ

チーム marketplace の元リポジトリを GitHub で開けない方

GitHub から取り込んだチーム marketplace なら、管理者が Marketplace Settings の Serve marketplace from Cursor をオンにすると、Cursor がコピーを配ります。GitLab / Bitbucket / Azure DevOps からの取り込みは元リポジトリから配信のままです。

チームへ公開する節へ

チーム marketplace を消したら Cloud Agent の MCP も消えた方

リンクした MCP プラグインを marketplace から外す/marketplace 自体を消すと、Team MCP サーバーも消えることがあります。確認ダイアログを読んでから進めてください。

チームへ公開する節へ

手元の plugins/local が Customize に出ない方

Teams / Enterprise では管理者が Allow Local Plugin Imports をオンにする必要があります。Enterprise の既定はオフです。シンボリックリンクは行き先が local フォルダの中だけです。

手元でプラグインを試すときへ

作った Skill が長すぎると出る/黄色い警告が出た方

name は64文字まで、description は1024文字まで、本文はおよそ5000トークンです。CLI の `/skills` で黄色い警告の件数が出ます。長い手順は references/ へ分けます。

Skill の上限と黄色い警告へ

言葉だけではイメージできない/触って試せる見本が欲しい方

`/canvas` で会話の横に触って試せる画面やダッシュボードを出せます。コード変更ではなく理解用の見本です。開き方は返信末尾のカード、コマンドパレットの Open Canvas、Agents Window の新しいタブです。

/canvas とビルトイン Skills へ

Canvas を同僚に見せたいがチャット履歴は渡せない方

ツールバーの Publish でリンクをコピーして送ります。ダッシュボードの Shared Canvases に出るのは自分が公開したものだけです。同僚の分はリンクをもらって開きます。閲覧は読み取り専用。有料プランかつチーム所属が必要です。

Canvas の3つの形へ

ダッシュボードに同僚の Canvas が出ない方

公式では、Shared Canvases の一覧は自分が Publish したものだけです。同僚の見本は共有リンクをもらってブラウザで開きます。会議なら全画面表示が向きます。

Canvas の3つの形へ

画面のラフや構成図の画像が欲しい方

Agent に『ラフ画像を作って』と頼むと、文章や参考画像から画像を作れます。Design Mode は既存の画像やプレビューに印を付ける側です。できた画像をそのまま本番に載せないで、方向が合ってから実装を依頼します。

添付と具体物へ

GitLab / Azure DevOps の PR に @cursor と書いても動かない方

公式 Cloud Agent の PR コメント起動は GitHub と Bitbucket だけです。GitLab / Azure DevOps は cursor.com/agents や Desktop の Cloud から起動しましょう。

他の起動場所の節へ

GitLab Free で Connect が進まない方

公式 GitLab 連携は Premium または Ultimate が必要です。Free プランでは Project access token が作れません。

GitLab / Azure DevOps の節へ

Azure DevOps の Connect が途中で止まる方

初回接続では Microsoft Entra ID の管理者同意(admin consent)が必要なことが多いです。Cursor チーム管理者と Azure AD 管理者の両方に依頼しましょう。

GitLab / Azure DevOps の節へ

clone が止まる・依存保管庫でエラーが出る方

作業対象の保管庫だけでなく、取り込んでいる別保管庫(サブモジュール)にも読み書き権限が必要です。GitHub なら Integrations の Selected repositories、GitLab なら Manage → Sync Repos で依存先も含まれているか確認しましょう。

依存保管庫の節へ

Agent は動かしたが、PR が不安な方

第2章の「確認と反映」から入るとスムーズです。

確認と反映へ

開発には近いけれど、Cloud は未経験の方

第2章のサイクル図と第4章を重点的に見てみてください。

サイクル図から

毎週の確認を自動化したい方

手動の Cloud Agent で一度成功してから、`/automate` と Automations レッスンへ進むのが安全です。

Automations へ

チームで Agent を共有したい方

URL を送る前に、相手の Integrations 接続と follow-ups のちがいを押さえておくとトラブルが減ります。

初回起動レッスンへ

Slack から頼むことが多い方

作業先の明示(repo=)と、調査だけのときの autopr=false を覚えてから、初回起動レッスンの Slack 節へ進むと安心です。進捗を別チャンネルへ出すなら `channel=#名前`。Team Pool が既定なら `@Cursor pool` で確認し、今回だけクラウドに戻すなら `self_hosted=false` です。

Slack の保管庫と作業場へ

Slack から頼んだら自前の作業場で動いた方

自分の My Machines 既定ワーカーが、チャンネル/チーム既定プールより先に効くことがあります。それが無ければチームまたはチャンネルの既定 Team Pool です。確認は `@Cursor pool`。今回だけ Cloud machine に戻すならメッセージに `self_hosted=false` を付けます(公式 Slack)。

Slack の保管庫と作業場へ

Slack から頼んだら自分の PC で動いた方

その保管庫向けの自分の My Machines 既定ワーカーは、チャンネルやチームの既定 Team Pool より優先です。今回だけクラウドなら `self_hosted=false`。今回だけ名前付きプールなら `pool=名前`。

Slack の保管庫と作業場へ

Slack のチャンネル既定が勝手に変わった方

チャンネルの既定リポジトリとチャンネル既定プールは、Cursor チームのメンバーなら誰でも変えられます。`@Cursor settings` や `@Cursor pool` のスレッドに、だれが何から何へ変えたかが出ます。同じ値なら自分だけに『変わっていない』と届きます。

Slack の保管庫と作業場へ

Slack の請求や保管庫が別の Cursor チームになった方

有料の Cursor チームが複数あると、Slack から起動した Cloud Agent は Team for Slack Agents で選んだチームで動きます。つなぐときの Cursor Team、または Dashboard → Cloud Agents の Team for Slack Agents を確認してください。cursor.com のチーム切替だけでは変わりません。

Slack のチーム選びへ

別の会話を見ているあいだに Agent が終わった方

終わった/未読にした Agent は、メニューバーと Dock の先頭に出ます。入りきらないときは N more unread。Agents Window を開いているあいだ、サイドバーに出ていない Cloud Agent は数字に入りません。

終わった Agent はメニューバーと Dock に出るへ

Slack で一瞬だけエラーが出て Agent が動かない方

保管庫つきの Team Pool なのに保管庫が決まっていない、またはそのプールがその保管庫を扱わないときです。自分だけに短い返信が来て、Cloud machine には自動で切り替わりません。`repo=` か `pool=` を足すか、`self_hosted=false` です。

Slack の保管庫と作業場へ

Microsoft Teams から頼むことが多い方

チャットアプリの Microsoft Teams は Cursor の Teams プランとは別です。`repo=` や `env=` は使えます。調査だけなら本文に『コード変更はまだしない』と書いてください(Slack の autopr=false 相当は公式にありません)。

Microsoft Teams 実務へ

Jira のチケットから頼むことが多い方

Teams / Enterprise で Jira Cloud(Rovo あり)なら、担当を Cursor にするかコメントで `@Cursor` です。`repo=` で保管庫を明示できます。続きは Rovo チャットか Cloud Agent 画面です。

Jira 実務へ

Notion の仕様やタスクから頼むことが多い方

ベータです。Notion Business / Enterprise と GitHub 接続、Cursor の User API Key が必要です。コメントで @メンションするか、タスク担当を Cursor にします。ページ本文よりコメントが確実です。

Notion 実務へ

Linear の Issue から頼むことが多い方

担当を Cursor にするか、コメントで `@Cursor` です。保管庫は `[repo=組織/リポジトリ]`。ラベルで決めるなら親グループ名は repo。開発以外の Issue は公式が自動でスキップします。triage で自動担当にするなら、いまは人の担当者が要ります。

Linear 実務へ

Linear で @Cursor しても動かない方

接続は Cursor 管理者です。ソース管理未接続、従量課金オフ、または開発以外としてスキップされたこともあります。triage で自動担当にしているなら、人の担当者を残してください。準備はアカウント準備レッスンの Linear 節へ。

Linear の準備へ

Linear の triage で Cursor に自動担当したのに動かない方

公式では Linear の triage rules が動くのに人の担当者が要ります。Cursor だけを担当にして人を外すと発火しないことがあります。手動なら担当を Cursor にするか `@Cursor` です。

Linear 実務へ

GPT-5.6 の Sol / Terra / Luna で迷う方

はじめては Grok / Composer です。他社モデルを試すなら Terra が中間、Sol はいちばん強くて高い、Luna は短い仕事向き。Other Models 枠から引かれ、Fast は2倍です。Start にはこの枠がありません。

GPT-5.6 の見分け方へ

Claude の Opus / Sonnet / Fable で迷う方

はじめては Grok / Composer です。Claude を安く試すなら Haiku 5.5、日常は Sonnet 5.5、いちばん難しい仕事は Opus 5.5。努力 max は既定の high より約6倍のトークンです。Fable 5.1 は他社モデルで、Privacy Mode のチームと Enterprise では承認するまでオフです。料金は入力 $10/M、出力 $50/M です。

Claude の見分け方へ

Fable を選んだのに Opus になった方

失敗ではありません。安全のための制限に触れると、エラーにせず Claude Opus へ自動で回します。やり直しも、モデルの切り替えも不要です。一覧に Fable が無いときは、Privacy Mode のチームか Enterprise の既定オフを疑います。

Fable の自動切り替えへ

Gemini 4 Argon と Muse Wonder で迷う方

はじめては Grok / Composer です。どちらも他社モデルで、週の枠には入りません。Gemini 4 Argon の努力の既定は medium、窓は 200k(最大 1M)です。Muse Wonder は Muse Spark 1.3 の後継で、努力の既定は high、窓は 300k(最大 1M、単価は同じ)です。定期実行に選ぶと最大の窓になります。

Gemini と Muse の見分け方へ

Gemini が3つあって迷う方

はじめては Grok / Composer です。3.8 Flash は速い側(努力の既定は high)、3.1 Pro は画面のラフを読む側、4 Argon は考える側です。3つとも週の枠の外です。3.1 Pro は入力が 200k を超えると単価が上がり、定期実行の最大 1M はその条件に入ります。

Gemini の3つの見分けへ

Grok 4.5 / 4.6 / 4.7 と Composer で迷う方

4つとも週の枠です。標準速度の Grok は同じ単価です。Fast の出力は、4.6 と 4.7 が $12、Composer が $15、4.5 が $18 です。500k の窓があるのは 4.7 だけです。安く回すなら Composer の標準速度です。

Cursor の4つの見分けへ

チームなのに週の枠が同僚と一緒に見える方

Teams の週の枠は有料の席ごとです。同僚が使っても、あなたの枠は減りません。減るのはチーム共通の前払い(追加利用)のことがあります。Enterprise だけ、利用者のあいだで使い回すプールです。

席ごとの週の枠と追加利用へ

起動直後、まだファイルが変わらない方

最初の数ターンは読み取り専用の探索になることがあります。書き込み可能な環境に切り替わってから本格的に直し始めます。

ACT 2 の節へ

スクショやプレビュー確認が付かない方

依頼文より先に、仕事場(実行環境)と Secrets を疑うと早いです。『書いたつもり』と『動かして確認した』のちがいから読みましょう。

実行環境レッスンへ

会社の GitHub Organization を守りたい方

個人の Cursor から社内リポジトリを触らせたくないときは、Protected Git Scopes を管理者に頼む型をアカウント準備レッスンで押さえましょう。特定の保管庫だけ外したいときは repository blocklist です。

接続と保護へ

Automations をチーム共有にしたい方

Private で一度成功してから、Share の Run as を Service account にします。Webhook の再発行と MCP の付け替えチェックリストがあります。『待って続けて』と書いていた文は、きっかけへ書き換えます。

Service account のチェックリストへ

Service account の Automation が CI を待ってくれない方

Run as が Service account の Automation には、`/subscribe` も待ちの道具も付きません。CI completed などのきっかけで新しい実行にするか、自分の Agent に待ちを頼んでください。

Service account は待たないへ

API キーを会話に出したくない方

Secrets には種類があります。漏れたくない値は Runtime Secret(会話やコミットに伏せる)にする型を、実行環境レッスンの図解から押さえましょう。

Secrets の種類へ

チーム共通の約束を毎回書いている方

Rules は個人・チーム・リポジトリの三層があります。共有したいトーンや禁止事項は、チーム Rules かリポジトリの Rules へ。

Rules と Skills へ

Automations の部品が多すぎて迷う方

骨格は Trigger / Prompt / Tools / Repository の4つ。図解から入ると全体像が掴めます。最初は `/automate` で下書きでも十分です。

Automations へ

clone / commit / push が分からず会話についていけない方

コマンドは不要です。共有の場所と作業場のあいだを履歴が旅する図から入ると、PR の話が追いやすくなります。

Git の図解へ

Agent の会話やコードがクラウドに残るのが不安な方

会話は長く残りやすく、使わない環境スナップショットは、30日で消えるのが上限です。会話を90日で消す方針とは別です。はじめて向けの保持の要点を実行環境レッスンで押さえましょう。

データ保持へ

Slack にコード断片が出て困る方

外部チャンネルへの Agent 要約表示は、Slack Connect やゲストがいるチャンネルにも効きます。チームのセキュリティ設定で止められることがあります。

チーム共有の安全へ

社内 GitHub(Enterprise Server)を使う方

github.com とは別の接続です。社内 URL と Organization 名を管理者に伝える型を、アカウント準備レッスンで押さえましょう。

接続と GHES へ

会社の GitHub の住所が ghe.com で終わる方

住所はghe.com、です。データ居住の GitHub Enterprise Cloud です。登録は社内サーバーと同じ、です。ベースURLはその住所、です。github.com の Connect ではありません。

住所はghe.comへ

github.com なのに Agent が入れない方

Organization の IP 許可リストで Cursor の GitHub アプリがブロックされていることがあります。GitHub の Organization → Security → IP allow list で「インストール済み GitHub Apps による IP 許可リスト設定を有効にする」をオンにするか、接続 IP の追加を管理者に依頼しましょう。

接続と IP 許可へ

git は通るのに、gh や API が IP で止まる方

gitの出口はチームだけ、です。個人のアカウントには、その出口はありません。出口は有効にしたあと、です。ghは出口を通らない、です。APIも出口を通らない、です。使うなら Cloud Agent の出口の範囲も許可リストへ足します。

ghは出口を通らないへ

GitHub Apps の IP 許可をオンにすると、ほかのソフトまで通るのではと心配な方

オンにすると、Cursor の GitHub アプリに登録した一覧を受け継ぎます。アプリに登録した一覧を継ぐ、です。同じアドレスを使うほかのソフトまで通す、ではありません。そのアドレスの誰でもは通さない、です。

そのアドレスの誰でもは通さないへ

別チームの GitHub を、うちのチームでも使いたい方

同じ Organization なら、インストールを持つチームの管理者が Share with another team で渡せます。アプリの入れ直しは要りません。利用量は渡した先のチームに付きます。Bugbot は保管庫につき1チームだけです。Revoke すると、そのチームの Bugbot 設定も消えます。

インストール共有の節へ

GitHub installation is already connected to another Cursor target と出た方

そのインストールは、別の Cursor アカウントか別のチームが持ったままです。入れ直しても移りません。同じ Organization なら、持っているチームの管理者に Share with another team を頼みます。同じチームの人が個人でつないでいるときだけ、チーム管理者がつなぐとチームへ移ります。はじめての Connect は、その時点ではアプリを入れません。

インストールの持ち主の節へ

iPad でレビューしたい方

チャットをサイドバーに残したまま PR レビューを横に開けます。Design Mode では Apple Pencil で囲んで指示もできます。

iPad の節へ

GitLab / Bitbucket で Automations を使う方

基本の PR トリガーは使えますが、GitHub ほど種類は多くありません。フォーク PR では動かない点は共通です。

GitLab / Bitbucket 節へ

GitLab / Bitbucket で承認されたときだけ自動化したい方

GitHub の PR review submitted とは別に、Pull request approved トリガーがあります。MR / PR が承認されたタイミングだけ後続処理を動かしたいときに使います。

Pull request approved の節へ

フロントと API を同時に直したい方

multi-repo 環境で1つの Agent が複数保管庫を横断できます。Web からの Cloud Agent は標準モードです。Long-running 設定は公式に廃止されたので、日をまたぐ仕事は保管庫ごとに分けるか Projects を使いましょう。

リポジトリレッスンへ

Sentry / PagerDuty から調査を自動化したい方

まず手動の Cloud Agent で調査だけ成功してから、監視トリガーの Automation へ。最初はコード変更なしが安全です。

監視連携(発展)へ

Microsoft Teams から Cursor を使いたい方

チャットアプリの Microsoft Teams は、Cursor の Teams プランとは別です。Dashboard → Integrations で Connect し、チャンネルで `@Cursor` と依頼します。日常の依頼はこちら、定期実行は予定や PR の Automation が分かりやすいです。

Microsoft Teams の節へ

Jira で @Cursor しても動かない方

Integrations 未接続、Jira 側に Rovo が無い、Cursor が Teams / Enterprise ではない、ソース管理未接続、または従量課金オフが多いです。アカウント準備の Jira 節を先に見てください。

Jira の準備へ

Notion で Cursor を @メンションしても動かない方

Agent mentioned トリガーがオフ、ページ本文に書いた、そのページへのアクセス未許可、または Tools & access にページが入っていないことが多いです。アカウント準備の Notion 節を先に見てください。

Notion の準備へ

大きな目標を終わるまで任せてほしい方

Agent は通常、1通を1つの仕事として読みます。日をまたぐ目標は `/goal` で終わるまで追い続けてもらえます。開いた PR を見守るなら `/autopilot`。レビュー待ちは Subscriptions です。

/goal の節へ

いきなり直されるのが怖い/先に調べたい方

Desktop / CLI なら Ask Mode(Shift+Tab または `/ask`)でファイルを変えずに調べられます。Cloud Agent なら調査だけテンプレや Slack の autopr=false が同じ役割です。

Ask / Plan の節へ

大きな仕事をいきなり実装させて外れた方

Plan Mode です。先に計画を見て直してから作ります。Shift+Tab または `/plan`。作ってから直すより、戻して計画を練り直す方が早いことが多いです。

Ask / Plan の節へ

開いた PR を見守って直してほしい方

チャットで `/autopilot` と打つと、指摘・コンフリクト・赤い Checks を見守って直せます。Subscriptions を自分で組み立てるより短いです。条件が揃ったら反映するのは auto-merge です。

/autopilot とレシピへ

差分の意図が分からない方

`/cursor-blame` で AI が書いた変更と、そのときの依頼文を調べられます。残す/戻すを決めてから追加指示しましょう。

確認チェックリストへ

機能づくり・移行・日常の手入れを任せたい方

1つの Cloud Agent や `/goal` は1本の仕事向きです。1回のチャットで終わらない仕事は、Projects(コーディネーター)が計画して複数 Agent に振り分けます。Desktop は左ナビ、iPhone は inbox の New Project。使えるのは Cloud Agent がある契約だけです。新しい契約は Premium 以上で、Plus と Free にはありません。Enterprise の Desktop は Cursor 3.21.9 以降。Hobby と Privacy Mode(Legacy)では出ません。

Projects の節へ

Enterprise なのに Projects が出ない方

Cloud Agent がある契約で使えます。新しい契約の Plus と Free にはありません。Enterprise の Desktop が Cursor 3.21.9 より古いと左ナビに出ません。Hobby と Privacy Mode(Legacy)でも出ません。管理者がオフだと、iPhone の区画も隠れます。

Projects の契約と iPhone へ

iPhone から Projects を始めたい方 / 手元の Agent を入れた方

iPhone は inbox の Projects です。New Project は名前からで、保管庫・枝・モデルは任意です。Add to Project(ドラッグでも同じ)は会話を残しますが、作業はパソコンのままです。Remote Control がオンである必要があります。クラウドへ移すのは Move to Cloud です。

iPhone と Add to Project へ

Projects が自前 PC へ仕事を置く前に確認してくる方

チーム設定『Automatically allow Projects to place their work』がオフだと、新しい My Machines / Team Pool を使う前にチャットで確認します。Enterprise は既定オフです。許可すれば進みます。

作業場の許可へ

作業中に追加したら Agent が途中で止まった方

cursor.com/agents では Send now(または Enter 2回)で、いまの一手を止めずに次の道具呼び出しで方向を変えられます。ターンのあとまで待たせるなら Tab でキューです。

作業中の追加指示へ

キューに入れた追記の順番を変えたい方

会話の下に並んだキューのカードをドラッグします。ターンが終わってもキューは残ります(3.23)。すぐ読んでほしいならキューではなく Send now です。

キューの並べ替えへ

ターンが終わったらキューの追記が消えた方

Cursor 3.23 ではターンが終わってもキューは残ります。消えたように見えるときは Desktop を最新にして、会話の下を見てください。

キューの並べ替えへ

サブエージェント同士が同じファイルを壊す方

子は既定では親と同じ作業コピーを共有します。衝突を避けたいときは『それぞれ別環境で走らせて』と頼んでください。

起動中に見ることへ

Explore / Bash / Browser のカードが出た方

設定不要のビルトインサブエージェントです。保管庫探し・長いコマンド出力・画面操作の途中ノイズを親の会話から外します。自分で作る必要はありません。Desktop の `@browser` や Cloud のコンピュータ操作とは別です。

起動中に見ることへ

手元の会話を止めずに次の仕事だけクラウドへ渡したい方

Desktop / CLI なら `/in-cloud` です。次の依頼だけ別 VM・別枝のクラウド子 Agent になります。会話ごと移す `&` や Move to Cloud とは別です。

/in-cloud の節へ

Webhook で Automations を呼び出したい方

Webhook URL は Automation を保存して初めて発行されます。Share の Run as を Service account に変えたあとは API キー再発行も要ることがあります。

Automations へ

PR なしの push だけで Automation を動かしたい方

Pull Request を開かずにブランチへ push する運用なら、Push to branch トリガーを選びます。PR トリガーとは別物です。

Push to branch 節へ

チーム全員が Agent を起動できない方

Cursor チーム管理者が GitHub などを Connect していないと、組織の保管庫では誰も起動できないことがあります。個人接続だけでは足りない場合があります。

管理者 Connect へ

定期 Automation の時刻がずれる方

設定時刻より前には始まりません。遅れの幅は、予定の遅れの節です。負荷が理由、とは書いてありません。

予定の遅れの幅へ

予定が、書いた時刻よりあとに始まる方

遅れは間隔の5分の1まで、です。書いた時刻より前には始まりません。必ずその幅だけ遅れる、とは書いてありません。最大です。

遅れは間隔の5分の1までへ

1日1回の予定が、何十分も遅れるように見える方

遅れの上限は5分、です。1日1回は最大5分遅れ、です。5分を過ぎても実行履歴が空なら、止まったときの見方を開きます。1時間ごとの分数は、例としては書いてありません。

遅れの上限は5分へ

15分ごとの予定が、時刻どおりに始まらない方

15分ごとなら最大3分遅れ、です。動く回数は変わらない、です。1時間ごとや、ちょうど0分だけ、ではありません。

15分ごとなら最大3分遅れへ

Security Reviewer が GitHub のラベルで動かない方

ラベルでは以前は動かない、でした。きっかけが Pull request label changed なら、付いたときも外したときも、いまは動きます。合うラベルだけ、です。

ラベルでは以前は動かないへ

保存済みの Security Reviewer に、ラベルの直しを効かせたい方

既存は開いて保存する、です。GitLab、Bitbucket、Origin のラベルまでは、この一文では断定しません。

既存は開いて保存するへ

Automation の Slack で人を呼んでも通知が来ない方

人を呼ぶ印は地の文、です。バッククォートには入れない、です。グループの番号はSで始まる、です。表示名だけを書けば同じ、とは書いてありません。

人を呼ぶ印は地の文へ

手元の Agent でウェブアプリを出そうとした方

アプリはクラウドで作る、です。動くのはクラウドの Agent だけです。手元では作れない、です。依頼に、アプリを作ってほしい、と書いてください。Origin の Marketplace の連携アプリとは別です。

アプリはクラウドで作るへ

プレビューは見えたのに、外から開けない方

トレイのプレビューは、まだ公開ではありません。出すのは自分で公開したあと、です。確認が止めたら、通らなければ外には出ない、です。直してから、もう一度公開します。

出すのは自分で公開したあとへ

マイクを押したのに、Agent が声で返さない方

隣のマイクは口述、です。マイクは文字にする、です。声で話す通話は、送る場所の波形です。波形は声の会話、です。

波形は声の会話へ

声の通話のボタンが見当たらない方

空のときだけ波形、です。入力欄を空にして、Agent が止まってから見てください。仕事の途中は、その場所が止めるボタンです。

空のときだけ波形へ

声の通話で Microphone blocked と出る方

止めたマイクは戻す、です。以前にマイクを拒否しています。戻してからかけ直す、です。隣のマイクが文字にする話とは別です。

止めたマイクは戻すへ

マイクの戻し先が、画面の英文で違う方

画面はシステムかブラウザ、なら、システムの設定かブラウザの設定です。iPhoneの画面は Settings、なら、iPhone の設定です。どの段かは、公式には書いてありません。

画面はシステムかブラウザへ

通話中なのに、別の端末のチャットに文字が無い方

通話の文字はチャットに出る、です。クラウドの通話中はほかの端末へ、です。手元の Agent の通話まで同じかは、この一文では書いてありません。

通話の文字はチャットに出るへ

プライバシーモードなのに、通話の文字がほかの端末へ出ると思った方

プライバシーモードでは同期しない、です。オンのときは、通話中の文字はほかの端末へ届きません。通話が終わったあとまでは、書いてありません。

プライバシーモードでは同期しないへ

声の通話で、聞こえるのが短い方

声の更新は短い、です。コードを直す側が、声に出す中身を選びます。ふだんは全文を読まない、です。全文はチャットに残ります。

声の更新は短いへ

声の通話が、急に長い文を読み上げた方

無いときは書いた返事を読む、です。そのターンに声の文が無いと、チャットに書いた返事を代わりに読みます。必ず短い声だけ、とは限りません。

無いときは書いた返事を読むへ

通話中に声を変えたのに、別の Agent では元に戻った方

通話中に変えた声は残る、です。そのAgentに残る、です。別の Agent の声までは変わりません。すべての Agent の既定になる、とは限りません。

通話中に変えた声は残るへ

同じ Agent なのに、自分の既定の声で話し始めた方

その Agent が声を保存していれば、保存した声は既定より先、です。設定画面のどの段かは、この一文では書いてありません。

保存した声は既定より先へ

声で『何が変わった?』と聞いたら、ファイルまで直ったと思った方

調べは読むだけ、です。差分、実行、Agent の様子を聞く調べは、ファイルを書き換えません。コードを直す仕事を渡す話とは別です。

調べは読むだけへ

声で、この Agent の前の話を探したい方

このAgentの履歴を探す、です。対象は、いま話しているこの Agent の以前のメッセージと通話です。ほかの Agent の履歴までは、この一文では書いてありません。

このAgentの履歴を探すへ

声の通話を、別のワーカーに移したい方

ワーカーがいる Project では、通話を別のワーカーへ、です。ワーカーがいないときまで移せる、とは限りません。自分が始めたワーカーの短い報告とは別です。

通話を別のワーカーの節へ

声で『終わった』と言ったら、直す仕事まで止まったと思った方

終わったと言うと切れる、です。切れるのは通話です。コードを直す仕事まで止まる、とは書いてありません。

終わったと言うと切れるへ

声の通話を、ボタンの名前を探さずに終えたい方

声での終わりが切断、です。終わった、と伝えると通話が終わります。どのボタンか、ボタンの日本語名は、この一文では書いてありません。

声での終わりが切断へ

黙ったまま切れたのか、自分で終えたのか分からない方

言い終わりで通話が終わる、です。終わった、と声で伝えたときの切れ方です。黙ったまま約10分で終わる切れ方とは別です。

言い終わりで通話が終わるへ

Agent の起動だけがいつも長い方

Cloud Agent Builds が未有効、または Build 失敗で古い準備に頼っていることがあります。Environments の Builds タブで履歴とログを確認しましょう。

Builds の節へ

前回と違う環境で Agent が動いた方

Agent 画面でリポジトリ名にカーソルを載せると、使った環境と Version history を確認できます。警告付き Environment ready も疑いましょう。

実行環境レッスンへ

Automation が Fork pull requests not supported で止まる方

フォークから開いた PR ではソース管理トリガーが動きません。ブランチを自社リポジトリへ push してから PR を開く運用を確認しましょう。

Automations へ

Secrets タブが見えない方

登録は Web の Cloud Agents 設定が正です。タブが無いときは権限不足が多いので、Runtime Secret のキー名だけ管理者に依頼しましょう。

実行環境レッスンへ

Secrets を入れたのに Agent が使わない方

追加直後は反映されないことがあります。新しい実行を始めるか、正しい Cursor チームに登録されているか確認しましょう。My Machines ならダッシュボードの Secrets は届きません。Team Pool は Secret sync です。

実行環境レッスンへ

同僚が Agent の URL を開けない方

同じ Cursor チームのメンバーであるだけでは足りません。相手も Integrations で GitHub などを Connect し、そのリポジトリを開ける必要があります。Cursor は閲覧者の権限も確認します。

URL 共有の前提へ

GitHub 接続をやり直したい方

Integrations の Disconnect Account から切り離し、あらためて Connect します。PR だけ Permission denied なら、アプリ権限やブランチ保護も確認しましょう。

接続のトラブルシュートへ

Origin で作った変更の PR が GitHub に無い方

Origin 上で作った保管庫の PR は Origin 側(cursor.com/codebase)に出ます。GitHub から同期した保管庫だけ GitHub の PR になります。

Origin の置き場の節へ

GitHub 同期の Origin 保管庫で Depot / Buildkite が動かない方

公式では Depot / Buildkite は Origin 上で作った保管庫向けです。GitHub から同期した保管庫の CI は GitHub 側のままです。公開 URL は Vercel の Publish か Apps タブです。

Origin の Apps へ

Origin の PR で GitHub と同じ確認画面を探している方

4つ目のタブ名は Changes です。GitHub の Files changed に相当します。中で Diff と Tour(案内)を切り替えます。GitHub 同期なら、Cursor 上に出るのは GitHub の PR です。

案内(Code Tours)へ

Origin と git の origin が同じに見える方

製品名 Origin は Cursor の保管場所、git の origin は共有場所の通称、origin コマンドは Origin CLI です。Agent CLI(agent)とは別物です。はじめての方はコマンドを自分で入れず、Agent に『Origin に置いて』と頼んでください。

名前の見分けへ

Origin への push が 100MB 超えで失敗した方

Origin は 100MB を超えるファイルを受け付けません。エラーにファイル名が出ます。『先に pull して』ではありません。大きいファイルは履歴から外すか Git LFS です。

Origin に送れない大きなファイルへ

GitHub 同期の origin/ 枝から PR が出ない方

名前が origin/ で始まる枝は Origin 側だけの作業場です。GitHub の PR の先頭にはなりません。普段の Cloud Agent の PR は普通の枝名です。

Origin だけの枝へ

GitHub 同期をやめて Origin を正本にしたい方

保管庫の Settings → General の Danger Zone で Detach from GitHub します。同期が止まり Origin が正本になります。GitHub 側の保管庫は消えません。

Origin / Detach へ

Origin の PR がマージできない/グレーの方

Origin 上で作った保管庫では Settings の Rules and Protections(GitHub のブランチ保護の対応)を疑います。GitHub 同期なら GitHub 側のブランチ保護です。

マージがグレーのときへ

Origin の Apps を保管庫 Settings で探せない方

保管庫の Apps タブは、その保管庫で動いているアプリの確認です。探す・入れるのはコードベース設定の Apps(cursor.com/codebase/settings/apps)です。開くと Marketplace と Manage に分かれます。Verified by Cursor は Marketplace 掲載の印です。

Origin App Marketplace へ

アプリを Public にしたのに Marketplace に出ない方

Public は直リンクで入れられる段階です。一覧に出るのは Cursor が承認した Listed です。申請には、ログインなしで見られるデモ動画(およそ5〜10分)と説明文が要ります。一度外して Public に戻しただけでは、再掲載されません。

掲載の3段階へ

Origin の PR が Draft のままの方

Origin CLI で作る PR は既定が Draft です。画面で Ready にするか、Agent に『Ready にして』と頼んでください。

確認と反映へ

Origin の Checks が古いままの方

Checks は先頭コミット向けです。push したのに古い結果なら Agent に『PR を refresh して』と頼むか origin pr refresh。通常は push で新しい版が作られます。

Checks の refresh へ

Origin の PR にまだ足りないものを知りたい方

origin pr requirements で、必須の門・承認・人だけが触れられる道・Code Review Gate・スタックの止まりが並びます。付いている Cloud Agent は origin pr view --agents。

Origin の反映済み一覧と Gate へ

Start from scratch したのに保管庫が無い方

有料プランと Origin が必要です。チームで Origin がまだなら先に案内へ進みます。管理者が Origin をオフにしていると、Create Project の Start from scratch もエラーにせず保管庫なしで始まります。残したいときはオンにするか GitHub 本線へ。

Origin / ゼロから始めるへ

Create repo の名前が通らない方

英字・数字・ハイフン・アンダースコアで、最大100文字です。スペースや日本語は使えません。おすすめ名から選ぶか、Other で付け直してください。

Start from scratch の節へ

試作中の画面プレビューの出し方が分からない方

Agents Window の Forwarded Ports から Detected のポートを転送し、Open in internal browser で内部ブラウザを開きます。Auto-Forward Ports で自動にもできます。公開 URL は Vercel の Publish です。

Forwarded Ports へ

Publish できない / Vercel で止まる方

Vercel アカウントが必要です。Cursor のチームなら Hobby より上の Vercel チームへ出す、という公式の案内があります。プラグインがまだなら Add Vercel から足します。

Publish の節へ

Origin の保管庫がチームから見えない方

Origin のプライバシーはコードベース名の持ち主の Privacy Mode に従います。コードベース設定からアクセスを依頼できます。Private に切り替えた人は管理者権限が残ります。

Origin の節へ

git を使わず Origin のコードを見たい方

cursor.com/codebase で Find repo... から開けます。緑の Code から clone URL も取れます。

Origin の置き場の節へ

会社の SSO でモバイルにログインできない方

組織で SSO が必須の場合、iOS アプリでも SSO 経由でサインインします。Privacy Mode(Legacy)からの切り替えも必要なことがあります。

スマホで起動できないときへ

CI が赤いが、再実行・調査・修正のどれを選べばいいか分からない方

一時的なら PR 画面から再実行、原因不明なら新しい Agent に調査だけ、直してほしければ Fix with Agent か `@cursor`。迷ったら調査から始めると安全です。

PR を読み解くへ

外出先で赤い CI を調査させたい方

アプリや Web から新しい Agent を起動し、調査だけを頼めます。既存 PR なら Fix with Agent や `@cursor` も使えます。

公式の使い方の例へ

PR の Deployments や CI 再実行が分からない方

Checks のほかに Deployments でプレビュー状態を見られることがあります。一時的な CI 失敗なら PR 画面から再実行も試せます。

PR を読み解くへ

PR が behind(本線より遅れている)と表示される方

本線に新しい変更が入ったあと、ブランチが古いままの表示です。GitHub やスマホアプリの Update branch(ブランチ更新)で取り込めます。

PR を読み解くへ

コンフリクト(競合)と表示されてマージできない方

本線と PR の両方が同じ箇所を変えています。自分で直すより、Agent に『main の最新を取り込んでコンフリクトを解消して』と頼む方が安全なことが多いです。

PR を読み解くへ

Update branch したら Checks がまた赤くなった方

本線を取り込んだあと CI が再実行され、一時的に失敗することがあります。behind / コンフリクトが解消されていれば、3択図の①再実行から試しましょう。

PR を読み解くへ

マージボタンが押せない / グレーになっている方

Checks が赤、behind、コンフリクト、必須レビュー未承認、ブランチ保護、マージ権限不足の6原因が多いです。review-and-merge のマージブロック図を上から順に確認しましょう。

マージブロック図へ

マージや Approve のボタンが出ない方

会社の GitHub カスタムリポジトリロールやブランチ保護の影響かもしれません。Cursor アプリは custom repository roles を参照して表示を決めます。

アカウント準備へ

レビューコメントを Agent に直してほしい方(スマホでも)

PR に `@cursor` と書くか、Cursor for iOS のレビュー画面から Agent に戻れます。Fix with Agent との使い分けもあります。

追加指示とやり直しへ

PR 出したあと毎回『続けて』と書きたい方

Subscriptions でレビューや CI を待って Agent が自動再開します。GitHub の auto-merge(自動反映)や `@cursor autofix`(CI 自動修正)とは別です。`/subscribe` か依頼文に待ち条件を書きます。

Subscriptions 節へ

/loop が止まらない / 何度も起きてくる方

定期確認の `/loop` は、止めるまで続きます。間隔を書かないと Agent が起きるタイミングを決めます。『ループを止めて』と追記するか、イベント待ちなら `/subscribe` です。

/loop の節へ

Agent が終わったことに気づかない方

iPhone ではターン終了のプッシュ通知に加え、Live Activities と Dynamic Island で最大8件まで追えます。通知が来ないときは OS とアプリの通知設定を確認しましょう。

起動中に見ることへ

iPhone の音声通話がロック画面に出ない方

システムの通話画面が出せるときは、アプリの Live Activity は出ません。出せないときだけ、ロック画面と Dynamic Island に通話のロック画面が出ます。ロック画面からはミュートと切断ができます。画面上部の狭い表示にボタンがあるかは、いちばん末尾の節です。進捗を最大8件まで追う表示とは別です。

通話のロック画面へ

iPhone の Dynamic Island を押してもミュートできない方

狭い島にはボタンが無い、です。ミュートと切断は、広げた島でミュートと切断、か、ロック画面でもミュートと切断、です。狭い表示にボタンが無いことだけを、故障と決めつけないでください。

狭い島にはボタンが無いへ

通話中に自分の声の文字が見えない方

通話中のチャットは、声の文字起こしと中身の無い Worked を隠します。消えたのではなく、見えるのは返事、質問、計画、編集です。通話カードは始めた位置に出ます。画面の下には固定されません。

通話カードの位置へ

iPhone Duo で一覧とチャットが折り目をまたぐ方

横にして半開き、iOS 27.1 以降なら、Agent の一覧は折り目で終わり、チャットはもう半分に収まります。半分が狭すぎるときは、いつもの並びのままです。分かれなくても、故障とは限りません。

折り目で分かれるへ

iPhone Duo を全部開いたら、プロフィールや閉じるの位置が変わった方

内側の画面を全部開くと、向きは端末に合わせて上下が逆さまになりません。モデル選択・検索・レビューのシートは、閉じるボタンを上のバーに残します。inbox のプロフィールはサイドバーへ移ります。半開きの分かれ方とは別です。プロフィール画面を開いてアプリが落ちる話は、別の節です。

折り目で分かれるへ会話やプロフィールで落ちる話へ

iPhone の保管庫ピッカーに Start from scratch の下書きが無い方

iPhone と iPad のアプリは、未公開の Start from scratch の下書きを保管庫ピッカーに出さなくなりました。最初から選んだ状態にもしません。一覧に無いことだけを、消えた印と決めつけないでください。ゼロから始める入口そのものが消えた、とは限りません。

未公開の下書きへ

保管庫が最初から下書きを選ばなくなった方

未公開の Start from scratch の下書きは、ピッカーを開いたときに最初から選ばれません。選ばれていないのは故障とは限りません。Create repo で残した保管庫や、Pull Request の下書きとは別です。

未公開の下書きへ

iPhone の会話で Thinking に考えた時間が付かない方

動いている会話で Thinking の節がひとつだけのとき、考えた時間は、その節が終わってから表示が更新されます。終わる前に時間が無いことだけを、止まった印と決めつけないでください。

考えた時間へ

考えた時間が付いたのに、会話はまだ動いている方

時間が付くのは、そのひとりの Thinking が終わったあとです。会話全体が終わった印ではありません。返事や次の作業は、そのあとに続くことがあります。Project の Worked の時間とは別です。

考えた時間へ

新しい Agent で、送った文や画像がすぐ見えない方

cursor.com/agents、Pull Request の Agent パネル、ウェブの横の会話では、新しい Agent の最初の一文はすぐ出る、です。付けた画像も最初から入る、です。見えなくても失敗とは限りません。2通目以降の速さは、この案内では断定しません。

最初の一文はすぐ出るへ

コードベースのページで、会話がマウスでは動かない方

コードベースのページの Agent のサイドバーでは、ホイールで会話が動く、です。Page Up と Page Down も動きます。cursor.com/agents の会話本体や、iPhone のアプリまで同じかは、この案内では断定しません。ウェブの会話は、Desktop の Agents Window と 同じ会話の並び です。

同じ会話の並びへ

Android から Agent を使う方

ネイティブアプリは準備中です。Chrome で cursor.com/agents を開き、Install App(PWA)を使うとホーム画面から起動しやすくなります。

初回起動レッスンへ

スマホでファイルを直接編集したい方

モバイルは IDE ではなく差分ビューが中心です。細かい修正は Agent への追記か Desktop のファイルツリーで行いましょう。

モバイルのできることへ

スマホに Rules や Automations の設定画面がない方

管理画面は Web にありますが、リポジトリの Rules・Skills・AGENTS.md は Agent が読みます。すでに Git に入っていれば、モバイル起動でも効きます。

モバイルでも効く Rules へ

PR の Actions が赤なのに Automation が動かない方

Workflow run completed は、push で始まった Actions だけです。PR(pull_request)や、手動(workflow_dispatch)、Actions の予定(schedule)では動きません。PR の Checks は CI completed です。絞るときは deploy.yml のようなファイル名です。

Workflow run completed の節へ

Checks は緑だが Actions が赤で Automation が動かない方

PR の失敗は CI completed です。Workflow run completed は push で始まった Actions だけなので、PR の Actions が赤でも動きません。

Workflow run completed の節へ

Slack から追記したのに、PR にコメントが付かない方

Automation への追記の返事は、Send to Slack や Comment on pull request を使いません。返事は、追記を送った場所に戻ります。PR のコメントは、きっかけで始まった最初の実行か、PR のきっかけの新しい実行です。

追記の返事の節へ

Web から追記した返事が Slack に出ない方

追記の返事は、送った場所に届きます。Web の会話へ追記した返事は Slack へは出ません。Slack へ出すのは、きっかけで始まった最初の実行です。

追記の返事の節へ

GitHub Issue にコメントしたときだけ Automation を動かしたい方

PR 向けの Comment added ではなく Issue comment を選びます。ラベルだけなら Issue label changed です。

Automations へ

Automation が毎回 PR を出してしまう方

Prompt に品質バー(いつ PR を開く/コメントだけ/何もしないか)を書くと、不要な PR を減らせます。Automations の具体例節を参照しましょう。

Automations へ

会話に見慣れない表やボタンの画面が出てきた方

MCP Apps です。MCP の道具が会話の中へ触れる画面を出せます。画面が出なくても、同じ道具はふつうの返答として動きます。触ってよいか分からなければ詳しい人にサーバー名を聞いてください。

MCP 接続の節へ

Cloud Agent や Web で MCP のログインが失敗する方

Desktop 用の戻り先(localhost:8787/callback)だけ登録されていることが多いです。Web / Cloud Agent は https://www.cursor.com/agents/mcp/oauth/callback も許可リストへ入れてください。

MCP 接続の節へ

Figma / Linear の MCP が固定の Client ID を求めて進めない方

動的な登録が使えない MCP は、mcp.json の auth(CLIENT_ID)で静的 OAuth につなぎます。戻り先 URL は Web と Desktop の両方を許可リストへ。秘密はリポジトリに直書きせず環境変数から読みます。

MCP 接続の節へ

MCP が途中で追加の入力を聞いてくる方

Elicitation です。壊れたのではなく、MCP サーバーが追加の入力を求める公式の動きです。内容が分からなければそのまま進めず、詳しい人にサーバー名を伝えてください。

MCP 接続の節へ

会社の Cursor で MCP が灰色/使えない方

Enterprise の MCP Allowlist です。管理者が Team Settings → MCP Configuration で許可したサーバーだけ使えます。Allowlist は配布ではなく承認です。管理者に『この MCP を Allowlist へ』と頼んでください。

MCP 接続の節へ

MCP が Cloud only や Read-only と出る方

Plugins & MCPs の各サーバーに状態が出ます。マウスを載せると、IDE や CLI で止まる理由が分かります。Team list の強制がオンのときだけ効く許可ルールもあります。状態の名前を管理者に伝えてください。

MCP 接続の節へ

SharePoint のプラグインが管理者に聞いて、と出る方

チーム全体の接続は、管理者が Integrations で委任かアプリの権限、テナント、管理者の同意、必要なら書き込みを終えます。途中で止まると、プラグインを足した人にはその案内が出ます。

MCP 接続の節へ

stdio の MCP に API キーを直書きしたくない方

stdio なら mcp.json の envFile(例: `.env`)から読めます。HTTP / SSE の遠隔サーバーには envFile は使えず、環境変数(env)から読む書き方です。ファイルを Git に入れないでください。

MCP 接続の節へ

inbox / Agents 一覧で会話がどれか分からない方

いま見ている実行に『この会話の名前を『(短い題)』にして』と頼めます。Cursor Cloud MCP の rename-chat が一覧と会話の見出しを付け直します(200文字まで。いまの実行だけ)。

MCP 接続の節へ

Agent のブラウザが社内サイトに行けない/外部へ出てしまう方

Enterprise の Browser Origin Allowlist です。管理者が MCP Configuration で自動移動してよいサイトを決めます。空なら全サイト可。人が手動で開くのは可ですが、許可外のサイトにいるあいだはクリックや入力などのブラウザ道具は止まります。許可リスト外へリンクやリダイレクトで行くことは止めきれません。画面が出ないときは Cursor の担当へ有効化を依頼してください。

MCP 接続の節へ

Bugbot に社内のチケットや DB を見せたい方

Teams / Enterprise では Bugbot に MCP を足せます。接続は MCP の手順どおり、道具のオンは Automations の Bugbot 側です。個人プランにはありません。

Cursor 管理 Agent の節へ

MCP 経由で想定外の操作がされた方

MCP は接続したサーバーの道具をすべて使えます。信頼できるサーバーだけ接続し、Prompt と Trigger の範囲を絞ってください。

Automations へ

Automation の Memories がおかしくなった方

Slack や Webhook など信頼できない外部入力がある Automation では、誤ったメモが残りやすいです。ツール設定から編集・削除するか、Memories をオフに検討しましょう。

権限と Memories 節へ

スマホから PR のレビュアーを足したい方

iOS アプリの PR レビュー画面から、レビュアーの追加・変更ができます。差分ビュー中心ですが、マージや auto-merge の切り替えも同じ画面から行えます。

モバイルのできることへ

無料や Plus で Cloud Agent が動かない方

新しい契約(The X Subscription)では、無料と Plus に Cloud Agent がありません。この学習パスの本体は Premium 以上です。これまでの契約なら Start / Pro などです。初回は spend limit の設定も求められることがあります。

いまの契約とこれまでの契約へ

App Store / Google Play のプランで枠を超えて続けたい方

アプリ内では追加利用を買えません。ブラウザの cursor.com/dashboard → Spending でカードを登録し、On-Demand Usage の月額上限を設定します。プラン料金はこれまでどおりストア側です。

起動できないときのチェックへ

利用上限に達したのに、もう少し使えてしまった方

到達判定は一瞬ではないので、少し超えることがあります。超えた分は一時的なクレジット(返金ではない)。同じ月に上限を上げると、その分が請求対象になることがあります。止めたいなら上限はそのまま、または従量をオフです。

利用上限とアラートへ

チームの従量上限を管理者だけが変えたい方

Spending の Permissions で『管理者だけが利用設定を編集できる』をオンにします。席数に合わせて上限を変えるなら Dynamic Spend Limits。メールで知らせるだけなら Spend alerts(止めません)。

利用上限とアラートへ

グループの Soft limit で止まったように見える方

組織グループの Soft limit はメンバーを止めません。ペースの通知と組み合わせられます。Hard limit は月額に達するとそのメンバーを止めます。チーム全体の Spending 上限とは別です。

利用上限とアラートへ

同期したグループへメンバーを移せない方

IdP から同期したグループは Synced と出ます。Move member の行き先には出ません。手で作ったグループは Manual です。名前の下の slug で、どのグループかを伝えられます。

利用上限とアラートへ

入ったあとに招待メールが閉じた方

SSO やドメイン参加、SCIM、直接追加のどれかでチームに入ると、そのチームへのほかの保留中の招待は閉じます。古い招待リンクでも、その人はチームへ着きます。

チームで初めて使うときへ

Privacy Mode(no training)と Legacy(no storage)のちがいが分からない方

no training は学習に使わない今の Privacy Mode です。no storage は保存しない旧モードです。Cloud Agent には今の Privacy Mode が必要です。仲間を招待するとき、Share Cursor Analytics にチェックすると新しいチームの設定が変わります。

データはどれくらい残るかへ

Start プランなのに Automations / Bugbot が使えない方

Start は Cloud Agent 自体は使えますが、Bugbot・Automations・Cursor SDK・Auto は含まれません(公式 Models & Pricing。Start はインド向け)。手動の Cloud Agent で一周を回し、Grok / Composer を直接選んでください。自動化と Auto は Pro 以上です。新しい契約の Plus は別物で、Cloud Agent 自体がありません。

いまの契約とこれまでの契約へ

Start プランで Fast や努力レベルが選べない方

Start の Cursor Models 枠(Grok 4.7 / 4.6 / 4.5 / Composer 2.5)は高速モード(Fast)なしです。Grok の努力レベルは medium 固定で、他社モデル枠もありません。新しい契約の Plus も Fast はオフです。変えられるのは Premium 以上と、これまでの Pro 以上です。

起動できないときのチェックへ

Grok 4.7 の利用量が急に増えた方

Premium 以上、およびこれまでの Pro 以上では、Grok 4.7 の速さの既定が Fast(標準の2倍)です。Plus は Fast オフです。窓を 500k にして入力が 256k を超えると、標準は2倍・Fast は3倍です。迷ったら窓は 256k。Grok 4.5 の Fast は出力が別です。

Grok 4.7 の速さと入力の長さへ

GPT-5.6 を選んだら利用量が跳ねた方

Sol は旗艦で料金がいちばん高いです。Fast は2倍、入力が 272k を超えるとさらに割増です。短い仕事なら Luna、日常なら Terra。はじめては Grok / Composer に戻してよいです。

GPT-5.6 の見分け方へ

Fable 5.1 がデータ保持の承認で使えない方

Fable 5.1 は害防止のため Anthropic 側で入力と出力を保管します(学習には使いません)。ゼロデータ保持(ZDR)や Privacy Mode のチームは Opus 5.5 を使います。追加の保持承認はありません。料金も Opus 5.5 より高く、入力と出力で約2.5倍です。

Claude の見分け方へ

Teams で他社モデルの利用量が想定より多い方

Teams / Enterprise では他社モデルに Cursor Token Rate(100万トークンあたり $0.25)が API 料金の上に乗ります。Grok / Composer は対象外です。Auto が他社モデルへ振り分けたときも同じです。

起動できないときのチェックへ

残りの利用量やリセット日が分からない方

これまでの契約は、エディタ設定と cursor.com/dashboard/usage の月2枠(Cursor Models / Other Models)です。新しい契約は grok.com/dashboard の週の枠です。CLI なら `/usage` で残量・プラン名・リセット日も見られます。

いまの契約とこれまでの契約へ

Start プランで Auto が選べない方

Start には Auto が含まれません。Grok 4.7 / 4.6 / 4.5 / Composer 2.5 を直接選んでください。Auto は Pro 以上。Optimize For の3モード(Cursor Router)は Teams / Enterprise です。

Auto と Cursor Router へ

Optimize For や Cost / Balance / Intelligence が出ない方

Cursor Router の3モードはいま公式では Teams / Enterprise 向けです。Enterprise は既定オフなので、管理者に有効化を頼んでください。振り分けには Grok 4.6 が必要です。

Auto と Cursor Router へ

Auto にしたら利用量が想定より速い方

Balance と Intelligence は Cost より利用枠を速く使います。はじめては Cost。課金は振り分け先モデルの定価で、他社モデルなら Cursor Token Rate も乗ります。

Auto と Cursor Router へ

Teams で Auto / Cursor Router が動かない方

公式では振り分けが働くために Cursor Grok 4.6 が必要です。Grok 4.6 を止めると Router が動かないことがあります。モデルを止めすぎると振り分けの質も落ちます。

Auto と Cursor Router へ

モデルが Auto から変えられない方

チームの Impose Auto が Hard だとモデル選択が Auto に固定されます。Soft は新しい会話の既定が Auto なだけで、切り替えはできます。どちらも既定オフです。

Auto と Cursor Router へ

本線の Agent を止めずに横で調べたい方

`/side` または `/btw` の Side chat です。Desktop でも Cloud Agent でも本線は止まらず、横の会話だけ進みます。Cloud では横会話が別の Cloud Agent になります。Projects の中ではスレッドです。あとから探すならコマンドパレット(ラベルは Side chat)。昨日の本線会話を探すなら Agents Window の Cmd+K です。

横の質問と過去の会話へ

さっきの Side chat をあとから探せない方

コマンドパレット(Mac は Cmd+Shift+P)で検索します。結果は Side chat とラベルされ、親の Agent 名が出て、親を開きます。最近使ったものは Agents Window の横のレール(最大5つ。残りは N more)にも出ます。Cmd+K は本線の過去会話向けです。

横の質問と過去の会話へ

Side chat が横に5つしか出ない / N more と出る方

Agents Window の横のレールは、最近更新した Side chat を最大5つ出します。6つ目以降は N more。レールをアイコンだけに畳むと Side chats の1ボタンから全部開けます。

Side chat へ

Agent が急に前の話を忘れた / 会話が重い方

入力欄の横のリングがいっぱいになると、古いやり取りは要約されて会話は続きます。直近の依頼文は残ります。クリックして内訳を見てください。CLI なら `/summarize` です。

会話がいっぱいになっても続くへ

差分が多すぎて、いま直したところだけ見たい方

Desktop の Changes タブを Last Agent Turn にします。ターン末尾の Review やファイルからも、その範囲で開きます。

いまのターンだけ見るへ

PR をマージしたのに待ちが突然終わった方

1つの PR を待っている購読は、その PR がマージまたはクローズされると自分で終わります。同じ枝を使う別の開いた PR があるときだけ、CI 待ちは残ります。

Subscriptions 節へ

画像生成が止まった / 内容の制限と出た方

商標・ブランド名・実在の人名を避け、被写体を自分の言葉で描き直します。回数の上限や提供側の障害なら少し待ってやり直します。

画像が作れなかったときへ

Cloud Agent の起動に失敗して依頼文が消えた方

失敗した依頼は入力欄に戻ります。直して送り直せます。『Open in Cursor』は新しいチャットではなく、その Agent を開きます。エディタが前面でも Incorrect Repository にはなりません。

起動に失敗した依頼は戻ってくるへ

Agent が動いているように見えるが赤い Error と出た方

赤い Error は失敗です。動いている途中ではありません。入力欄の上に Retry / Manage Usage / Manage Environments の次の一手が出ます。

止まったときの赤い Error へ

チャット下に Usage N% の輪が出た方

月の利用量が表示の閾値を超えると、チャット下に利用量のリングが出ます。クリックすると内訳。入力欄の横の会話の空きリングとは別です。

チャット下の利用量のリングへ

『送らないで』と言ったのに下書きが進む方

Auto-review は下書き・プレビュー・計画は止めません。確認が掛かるのは最後の送信や反映です。

Run Modes へ

フォルダごと消すコマンドなのに確認が出ない方

Auto-review は、再帰・強制・ワイルドカード・mirror の削除で対象が書き方と違う可能性があるとき、確認カードを出します。『いつも確認して』と書いた操作も必ず確認します。

Run Modes へ

Agent の返信の表を Notion や Slack に貼ると崩れる方

表にマウスを載せて Copy table、または右クリック → Copy Table です。大きく見たいときは Expand table。Notion・Slack・Google ドキュメントには表のまま貼れます。文字だけの行き先は Markdown のままです。

表をコピーするへ

入力欄の上に Goal / Queued / Canvas の印が出た方

Agents Window の入力欄の上の印です。押すとパネルが開き、もう一度押すと畳まれます。Goal は目標、Queued は待ちの追記、Debug は再現手順、Canvas は見本、Open Browser は開発サーバーの下見です。

入力欄の上の印へ

Agent が会話に出したファイルを手元に保存したい方

ファイルのリンクを右クリック → Download File です。既定は Downloads。Cloud Agent が仕事場で作ったファイルでも同じです。

会話のリンクからファイルを保存するへ

Side chat や子役を開いたら親の会話が見えなくなった方

Agents Window では、子役や Side chat は親のタブとして並びます。親の会話は残ります。戻るは Back で、開く前の画面です。

Side chat へ

Debug の再現手順が出ているのにキューの追記がすぐ送られる方

再現手順が出ているあいだ、キューはすぐ送られません。Debug の印がキューの横に残ります。進めるのは Proceed / Mark Fixed、または Debug をやめたときです。

キューの順番へ

Run on に Not cloned と出た方

その保管庫はまだこのパソコンにコピーがありません。Not cloned の行を選ぶとクローンが始まり、進捗の通知が出ます。

手元に無い保管庫と HTML の下見へ

Cloud Agent が直した HTML をブラウザで下見したい方

ファイル一覧の HTML を右クリック → Open in Browser です。リモートやクラウドの仕事場でも、手元のコピーで下見できます。

手元に無い保管庫と HTML の下見へ

Open in Cursor で Incorrect Repository と出る方

エディタのウィンドウが前面でも、Open in Cursor は Agents Window でその Agent を開きます。以前の Incorrect Repository(保管庫が違う)は出ません。

起動に失敗した依頼は戻ってくるへ

長い会話で新しい返信を見逃した方

未読の返信の始まりに New Messages の印が出ます。押すとその位置へ飛びます。自分の依頼へ戻るのは Cmd+↑ です。

未読の返信の始まりへ

タブを間違えて閉じた方

Cmd+Shift+T(Windows は Ctrl+Shift+T)で、いちばん最近閉じたタブが戻ります。Cmd+W は直前のタブへ戻るだけです。新しい会話は作らないでください。

タブを閉じても戻れるへ

チャットタブがどれか分からない方

題にマウスを載せると、サイドバーと同じ Agent のカードが出ます。名前はタブのダブルクリックです。サイドバーを隠しているときは Cmd(Windows は Ctrl)を押し続けると、ショートカットが出ます。

チャットタブの幅と名前へ

Escape で確認が消えない方

承認、エラー、枝が違うときの確認カードは、Escape では閉じません。ボタンで答えてください。選んだ自前の作業場は、更新やフォークのあとも残ります。

確認カードは Escape では消えないへ

Fix with Agent で下書きが消えたように見えた方

Bugbot の指摘から Fix with Agent を押しても、入力欄の下書きは残ります。次の送信に Bugbot の報告は付きません。コミットをやめても、そのあと PR は開きません。

直すときに下書きとコミットを守るへ

Skill を作ったら黄色い警告が出た方

SKILL.md の上限です。name は64文字まで(フォルダ名と同じ)。description は1024文字まで。本文はおよそ5000トークン。CLI の `/skills` で黄色い件数が出て、選ぶと直す場所が下に出ます。

Skill の上限と黄色い警告へ

同期した Skill が Automation で効かない方

同期した個人用 Skill は、自分で起動した Cloud Agent に載ります。Automation の実行には、Run as が Me でも載りません。手順は保管庫の .cursor/skills/ に置きます。チームのスイッチがオフなら、管理者に Security & Identity を確認します。

同期した Skill は、Automation には載らないへ

前の依頼を直したら会話が空になった方

Agents Window では、送った依頼を直しても上のやり取りは残ります。状態が見つからないときは直しが失敗し、会話はそのままです。ファイルを戻すなら Checkpoints です。

前の依頼を直しても、上のやり取りは残るへ

パソコンを起こしたら Cloud Agent が失敗と出た方

Agents Window はパソコンを起こすと Cloud Agent に自分でつながり直します。作業はクラウド側で続いています。赤い Error とは別です。手元 Agent なら電源とふたです。

パソコンを起こすと Cloud Agent に戻れるへ

音声入力の送信キーワードが日本語で効かない方

送信キーワードは日本語でも効きます。Settings に保存します。話す内容はこれまでどおり5要素です。

音声の送信キーワードへ

口述がどこでも効かない/一時チャットが残る方

チーム管理者が Grok タブで口述をオフにしていることがあります。組織の管理者は、全部のチームで口述や一時チャットをオフにできます。一時チャットをオフにすると、書き出しのために会話が残ります。

音声の送信キーワードへ

長い会話で自分の依頼を見失った方

Cmd+↑ / Cmd+↓(Windows は Ctrl+↑ / Ctrl+↓)で自分のメッセージだけ辿れます。端へは Shift を足します。入力欄が空なら、入力中でも同じです。会話の中を探すのは Cmd+F です。

横の質問と過去の会話へ

Grok Bot と Cloud Agent のどちらを使えばいいか分からない方

このサイトのコードを直して PR を出すなら Cloud Agent。名前付きの助手に Web や社内ツールをまたいで頼むなら Grok Bot(別プロダクト)。Grok 4.7 はモデル名で、Grok Bot とは別です。

Grok Bot の切り分けへ

Team Bot に話しかけたら自分のログインが見えた方

公式では、チームの Team Bot はだいたいあなたのクラウドパソコンの上で動きます。相手のパソコンではありません。画面は作業場所で、安全の仕切りではありません。

Grok Bot のパソコンと安全な頼み方へ

Grok Bot にパスワードをチャットへ貼ってよいか分からない方

貼らないでください。パスワードや二要素は Bot があなたにパソコンを渡します。その場だけで入力し、止めたいときは『Stop now』(いま止めて)です。

Grok Bot のパソコンと安全な頼み方へ

Grok Bot の定期実行と Automations で迷う方

名前付き同僚の繰り返し仕事は Grok Bot の定期実行。コードを直して PR を出す自動起動は Automations です。利用量のリセットも週(Grok Bot)と月(Cloud Agent)で違います。

Grok Bot のパソコンと安全な頼み方へ

Grok Bot のプラグインを止めたのに Web に入れる方

プラグイン方針と Network Controls は別です。止めてもサイトは開けます。サイト側も閉じるのは Enterprise の Network Controls(未設定は全部許可)です。

Grok Bot のプラグイン節へ

Slack の Team Bot が自分のログインを使わない方

1対1のチャットではだいたいあなたのパソコン。Slack のチャンネル・スレッド・グループでは Team Bot 専用のパソコンです。

Grok Bot のプラグイン節へ

Grok Bot の定期実行を Test したら本番が動いた方

Test は本番と同じ仕事をします。試し打ちは安全な入力で、送信・購入・削除は承認の後ろに置いてください。

Grok Bot のプラグイン節へ

Grok Bot が手元のパソコンでコマンドを走らせる方

クラウドパソコンと手元は別です。ローカル実行の既定はコマンドごとに確認です。触る理由が無ければ Never です。

Grok Bot の手元実行節へ

Grok Bot が社内サイトに届かない方

Settings → Computer の『このデスクトップ経由で通信する』です。Enterprise の Allow Local Egress がオフだと約5分で経路が止まります。

Grok Bot の手元実行節へ

Grok Bot が Cloud Agent を起動した方

Grok Bot はコード直しを Cloud Agent に渡せます。PR の本線は Cloud Agent のままです。管理者は委任をオフにできます。

Grok Bot の手元実行節へ

Grok Bot の Auto Review と Desktop の Auto-review で迷う方

Grok Bot 側の確認は Auto Review です。Desktop の Run Modes(Auto-review)とは別です。お金や共有アカウントは Allow once を優先します。

Grok Bot の手元実行節へ

Grok Bot が終わったのに通知が来ない方

通知は Bot ごとです。会話の上の Bot 名 → Bot settings → Notifications。画面を開いているあいだは出ません。iPhone は OS の許可と Bot の設定の両方です。

Grok Bot の通知と直し方へ

Grok Bot のパソコンが届かない/古い方

アプリとクラウドパソコンの更新は別です。いちばんやさしい手から: やり直す → アプリ再起動 → Recover → Update → Reset。会話は Reset しても残ります。

Grok Bot の通知と直し方へ

Team Secrets を Bot に使わせたい方

Team Secrets は Team Setup の手順が読む環境変数です。Bot には直接渡りません。Bot の仕事に使う秘密は Bot 側に置きます。

Grok Bot の通知と直し方へ

自分のグループだけ手元実行が緩い方

Enterprise のグループ設定は、チームの上限を緩める方向だけです。厳しくすることはできません。複数グループならいちばん緩い結果になります。

Grok Bot の通知と直し方へ

Cursor アプリと Grok Bot アプリのどちらを入れればいいか分からない方

Cloud Agent の指揮は App Store の『Cursor』(iOS / iPadOS 26)。名前付き同僚は『Grok Bot』(iOS 18)。同じアカウントで、2回目の購入は不要です。

Grok Bot のスマホ節へ

iPhone で Teach a task / Test / Update が無い方

公式ではその3つはデスクトップ側です。見せて教える手順は Teach a task 節。iPhone ではメッセージ、パソコンの監視と引き継ぎ、承認、定期実行の一時停止/再開ができます。

Grok Bot のスマホ節へ

Grok Bot の iPhone アプリから PR を出したい方

PR を出して確認する本線は Cursor アプリか cursor.com/agents の Cloud Agent です。Grok Bot からコード直しを渡せるのは委任です。

Grok Bot のスマホ節へ

自分の Bot をグループにしたら、Slack の Team Bot と同じだと思った方

自分の Bot 2〜6人のグループは、あなたのクラウドパソコンの上です。Slack のチャンネルで Team Bot と話すグループは専用パソコンです。

Grok Bot のグループと複製へ

グループで Bot が同じ仕事を二重に始めた方

段階ごとに担当は一人にしてください。一人に渡すなら @、全員向けなら @everyone です。

Grok Bot のグループと複製へ

iPhone で Duplicate したら会話が空だった方

Duplicate はプロフィール・設定・Skill・定期実行・画像のコピーです。会話履歴と覚えた記憶はコピーされません。作業を振る前に名前と範囲を直してください。

Grok Bot のグループと複製へ

Hide したら定期実行が止まると思った方

Hide は一覧から外すだけで、仕事も定期実行も残ります。消すとプロフィール・会話・定期実行が無くなります。

Grok Bot のグループと複製へ

Grok Bot に添付が送れない方

デスクトップは1通あたり6つまで。文書・画像・音声は各25MB、動画は200MBです。何のファイルでどう使うかを一文で書いてください。

Grok Bot のグループと複製へ

Slack の新着全部で Grok Bot が動く方

定期実行の Slack 合図は狭い条件にしてください。『全部の新着』はノイズと利用量になります。プラグインや Automations とは別です。

Grok Bot の定期実行と共有へ

Grok Bot の Slack きっかけと Automations で迷う方

名前付き同僚の繰り返しは Grok Bot の定期実行(Cursor アカウント連携)。コードを直して PR を出す自動起動は Automations。Slack の @cursor は Cloud Agent です。

Grok Bot の定期実行と共有へ

長いあいだ使っていなかったら定期実行が止まっていた方

公式では、長いあいだ使っていないと続けてよいか聞かれ、返事が無いと一時停止することがあります。再開は Bot の Tasks です。

Grok Bot の定期実行と共有へ

Grok Bot の残したいファイルが消えた方

残すものは /workspace の分かりやすいフォルダへ。一時フォルダや自分で入れたアプリは、更新や Recover で消えることがあります。

Grok Bot の定期実行と共有へ

チームの Team Bot がサイドバーから消せない方

管理者の Manage Team Bots で自動追加された Bot は、自分では Hide できません。外したいときは管理者へ。

Grok Bot の定期実行と共有へ

Bot の公開テンプレートを社外に出したくない方

公開リンクは設定のコピーです。Teams / Enterprise の管理者はチーム外公開を止められます。Enterprise は最初オフです。

Grok Bot の定期実行と共有へ

Grok Bot に何でも頼んで役職がぼやける方

公式ではよい役職は繰り返せる成果です。『何でも聞いて』ではなく、確認リストのように終わりが見える仕事にします。

Grok Bot の役職の作り方へ

Grok Bot の定期実行が送ってしまった/本番を変えた方

はじめては読む・まとめるまでです。送る・買う・本番変更は承認の後ろ。Skill にして別入力でも試してから定期実行します。

Grok Bot の役職の作り方へ

説明文とメッセージのどちらにルールを書けばいいか分からない方

いつもの境界は説明文(例: お客様に連絡しない)。今回の仕事はメッセージ(例: この12件の下書き)です。

Grok Bot の役職の作り方へ

Grok Bot の定期実行が想定と違う時刻に動く方

時刻の定期実行は Settings の Bot にあるタイムゾーンに従います。会話の『8時』だけではずれることがあります。

Grok Bot の役職の作り方へ

Skill を作らずに Grok Bot の定期実行を始めた方

公式の順は、1回うまくいく → Skill にして別入力でも試す → 失敗時が決まってから定期実行です。

Grok Bot の役職の作り方へ

Grok Bot の定期実行を作ったのにすぐ動かない方

新しい時刻指定は次の予定まで待ちます。今日 8:05 に毎日 8:00 と作ると、初回は明日です。すぐ試すなら Test です。

Grok Bot の定期実行と共有へ

Grok Bot の Webhook が 200 なのに終わっていない方

200 は受け付けて走り始めた、という意味です。終わったかは Bot の会話を見てください。

Grok Bot の定期実行と共有へ

Grok Bot の定期実行で週の利用量が1日で減る方

1時間ごとや、忙しいチャンネルの全メッセージは回数が多くなります。使わない定期実行は一時停止し、合図は狭くしてください。

Grok Bot の定期実行と共有へ

Teach a task のボタンが無い/グループで使えない方

1対1の会話でパソコン画面を開いたデスクトップ向けです。出ないときは、終わった仕事から Skill にして、と頼んでください。

Grok Bot の Teach a task へ

Teach a task で作った Skill が / に出ない方

Settings → Plugins → Yours で、いまの Bot 向けにオンにしてください。

Grok Bot の Teach a task へ

Teach a task の下書き Skill のまま定期実行した方

できた Skill は下書きです。失敗したときと承認の境界を足し、安全な入力で試してから定期実行します。

Grok Bot の Teach a task へ

Browser と @browser とコンピュータ操作で迷う方

会話の Browser カードはビルトインの子役です。Desktop の `@browser` はエディタ内のブラウザ枠。Cloud Agent の画面確認はコンピュータ操作です。

Cloud だけでかなり行けるへ

自前ワーカーの画面は見せたいが操作は渡したくない方

Linux の `--share-desktop` は見るだけ(view)か、マウスとキーボードも渡す(view_and_control、既定)を選べます。共有されるのは隔離デスクトップで、クリップボードは渡りません。

Cloud だけでかなり行けるへ

Mac の自前ワーカーでスクショが急に止まった方

macOS 15 以降は画面収録の許可を定期的に聞き直すことがあります。ログイン画面の『1か月許可』と、Cursor Computer Use への許可を確認してください。

Cloud だけでかなり行けるへ

Automation の PR が別リポジトリに開く方

予定や Slack 起点では、PR 作成の向け先は Automation 設定のリポジトリです。GitHub の PR イベント起点なら、その PR の保管庫へ向きます。

Automations へ

inbox の source: iosApp と agent/source が違う方

モバイル inbox の `source: iosApp` は UI 表示です。Hooks 向けメタデータ API の `agent/source` は WEBSITE / API / SLACK / AUTOMATIONS など別の公式キーです。

メタデータ節へ

Automation の PR 作者が cursor になっている方

Share の Run as が Service account だと PR が cursor 名義になることがあります。Me なら作成者の GitHub アカウントです。Automations 画面の Share を確認しましょう。

実行者表示の節へ

PR に cursor のコメントが付いたが自分の Automation ではない方

Bugbot・Security Agents・Rollouts など Cursor 管理の Agent、または Service account 名義の Automation の可能性があります。実装担当の Cloud Agent とは別枠です。いまの公式の既定は Incremental Review(前回からの差分だけ)です。フル差分に戻したいときや、同じ指摘が続くときは管理者に確認しましょう。push 前に先に読んでもらうなら `/review` です。

Cursor 管理の Agent へ

Bugbot が新しい差分しか見ない方

既定の Incremental Review です。PR 全体を毎回読ませたいときは Bugbot Automations でオフにします。

Incremental Review へ

Cursor Bugbot が失敗していないのに指摘がある方

指摘があるときの既定の結論は中立(neutral)です。ブランチ保護で Check を必須にしても、指摘そのものではマージを止めません。

どの Check が何を見ているかへ

Bugbot が勝手に直して別ブランチを作った方

Bugbot Autofix です。指摘を Cloud Agent が直します。CI が赤のときの `@cursor autofix` とは別物です。個人設定でオフ/新しい枝/既存枝を選べます。新しい枝は GitHub と Origin だけです。

Bugbot の要約と直し方へ

PR の説明文が勝手に増える方

Bugbot の PR Summary です。既定は説明文へ追記して、レビューのたびに更新します。コメントにするかオフにするかは Bugbot Automations と個人設定です。

Bugbot の要約と直し方へ

Fix in Web と Fix in Cursor のちがいが分からない方

どちらも Bugbot の指摘を Cloud Agent に直させる入口です。Fix in Cursor は Desktop、Fix in Web は cursor.com/agents。Autofix をオフにしていても使えます。Fix in Cursor は対象ファイルと行の範囲を書いた依頼文を下書きします。

Bugbot の要約と直し方へ

GitLab / Bitbucket で新しい枝の Autofix が出ない方

公式では新しい枝は GitHub と Origin だけです。GitLab / Bitbucket は既存枝への commit のみ。Azure DevOps は Autofix 自体がありません。

Bugbot の要約と直し方へ

下書き PR で Bugbot が動かない方

Security Reviewer は下書きを対象外のままです。Bugbot は Teams / Enterprise の個人設定で下書きも自動レビューに含められます。

Bugbot の要約と直し方へ

/review-bugbot したあと PR 側が動かない方

同じ差分なら、保管庫側の Bugbot は再実行を飛ばして『すでに読んだ』とコメントすることがあります。差分を変えて push すると改めて読みます。

確認チェックリストへ

/review と /agent-review のどちらを打てばいいか分からない方

Desktop で手元の変更を読むのが `/agent-review` です。PR や Cloud Agent 向けに先に読んでもらうのが `/review` / `/review-bugbot` です。まだ PR が無いかで切り分けます。

Agent Review の節へ

手元の変更を PR 前に読んでもらいたい方

チャットの `/agent-review` か Source Control タブです。設定は Cursor Settings → Agents → Agent Review。Cursor 3.11 以降は Git & PRs → Pull Requests に移ります。深さは Quick と Deep です。

Agent Review の節へ

Desktop の Agent が変な方向に進んだ/ファイルを戻したい方

Checkpoints です。チャットのタイムラインから戻り地点を見て Restore します。会話は消えず、ファイルだけ戻ります。Git のコミットとは別です。計画が外れたら、戻してから Plan を直して作り直します。Cloud Agent なら『戻して』と追記するか PR を閉じます。

Checkpoints の節へ

Shift+Tab でモードが変わった/Plan と Ask のちがいが分からない方

仕事の進め方は Agent(実装)・Plan(計画してから作る)・Ask(調べるだけ)に加え、再現バグ向けの Debug があります。小さな修正は Agent。先に方針を見たいなら Plan。触られたくないなら Ask。原因が分からない再現は Debug。Desktop 側の入口は when-desktop のモード節です。

Agent / Plan / Ask の節へ

再現できるのに原因が分からない/当てずっぽうで直されて外れる方

Desktop / CLI なら Debug Mode(モード選択、Shift+Tab、または `/debug`)です。仮説とログから原因を絞ってから直します。Cloud Agent には同じ画面が無いので、再現手順を書いて『ログを足して原因を特定してから直して』と依頼します。

Debug の節へ

ターミナル(CLI)の会話を Cloud Agent に渡したい方

メッセージの先頭に `&` を付けると Cloud Agent へ引き継げます。続きは cursor.com/agents やスマホです。同じパソコン上で切断しても続けたいなら `agent persist` で、`&` とは別です。

他の起動場所へ

CLI の sudo パスワードが AI に見えるか心配な方

伏せ字の入力が出ます。パスワードは sudo へ直接渡り、モデルには見えません。コマンドを箱の中で走らせるなら `/sandbox` です。

CLI の安全な作業場へ

CLI の Shell Mode でサーバーが立ち上がらない/途中で切れる方

Shell Mode は短い非対話コマンド向けです。公式では30秒で打ち切り、対話入力や長いサーバー起動は向きません。`cd` は次に残らないので `cd && …`。会話を出ずに打つ入口で、渡した文を実行する `/shell` スキルとは別です。

CLI の安全な作業場へ

ターミナルを閉じても CLI の Agent を続けたい方

`agent persist` です。離れるときは `/detach`、戻るときは `agent persist attach`。クラウドの作業場へ渡す `&` とは別物です。

CLI の安全な作業場へ

CLI がいま開いている枝を直接いじって困る方

別コピーの worktree です。CLI は `agent --worktree`。Desktop は `/worktree` か Agents Window。取り込みは `/apply-worktree` です。

CLI の安全な作業場へ

昨日の CLI 会話を続きから開きたい方

履歴から再開するのは `agent resume`(いちばん新しい会話)か `agent ls`(一覧)。動かしたまま離れる `agent persist` や、クラウドへ渡す `&` とは別です。会話が重いときは `/summarize` です。

CLI の会話を続きから開くへ

agent persist と agent resume のちがいが分からない方

persist は同じ実行を切断しても続ける起動。resume は終わった/閉じた会話を履歴から開き直します。席を離れてクラウドで続けたいなら `&` です。

CLI の会話を続きから開くへ

CLAUDE.md と AGENTS.md のどちらに書くか分からない方

CLI はどちらも Rules として読みます。Cloud Agent の起動手順は AGENTS.md、方針・禁止は `.cursor/rules`。Claude Code から来たチームが CLAUDE.md を置いていることがあります。

Rules はチームの取扱説明書へ

Desktop でコマンド確認が多すぎる/毎回聞かれる方

公式のおすすめは Auto-review です。Settings → Agents → Approvals & Execution。許可した操作はすぐ、箱の中で走らせられるコマンドは sandbox、それ以外だけ確認します。

Run Modes の節へ

Ask Every Time(毎回聞く)が見つからない方

Cursor 3.5 で廃止され、新規では選べません。同じ動きが欲しければ Allowlist の許可リストを空にします。

Run Modes の節へ

Auto-review がグレーアウト/選べない方

分類はいま Gemini 3.5 Flash Lite、予備は Claude 4.5 Haiku です。会話で使う Haiku 5.5 とは別です。チームで 4.5 Haiku が止まっているとグレーになり Allowlist になります。詳しい人に Team Settings → Models を確認してもらい、Cursor を完全に終了して開き直してください。

Run Modes の節へ

Desktop の Agent が作業場の外のファイルまで読む方

Read Access の既定は System(確認なし)です。Workspace にすると外を読む前に確認カードが出ます。場所は Settings → Agents → Approvals & Execution → Read Access です。

読み取り範囲へ

Read Access を Workspace にしたら共有フォルダまで確認される方

同じ画面の Read Allowlist に、確認なしで読んでよい場所を足します。絶対パスのフォルダか * のパターンです。

読み取り範囲へ

Read Access の設定が画面から消えた方

Run Everything では確認しないので、この設定は隠れます。Auto-review か Allowlist に戻すと出ます。Cloud Agent はこの設定を使いません。

読み取り範囲へ

Cloud Agent なのにコマンド承認が出ない方

正常です。Run Modes は手元 Agent 向けです。Cloud Agent は専用の作業用コンピュータの中で動くので、コマンドごとに聞きません。確認は終わったあとの要約・差分・成果物です。

起動中に見ることへ

Team Pool が選択肢に出ない/選べない方

公式では Team Pools は Enterprise プランが前提です。はじめては Cloud machine。社内専用の作業場が必要なら、管理者に Self-Hosted / Enterprise を確認してください。会社の Lambda / Cloudflare / Daytona などは、Team Pool の置き場になり得ます。

実行先の選び方へ

APPROVAL_POLICY.md を同じ PR で直したのに甘く承認されない方

公式では、同じ PR で承認ポリシーや ROUTING.md を変えても、その PR の審査を甘くする材料には使いません。本線の版を見るか、人の確認にします。

Cursor 管理の Agent へ

.cursor/rules を書いたのに Bugbot が無視する方

プロジェクト Rules(*.mdc)は Bugbot には効きません。レビュー用は `.cursor/BUGBOT.md` です。使われたルールを見るなら `cursor review verbose=true` です。

BUGBOT.md へ

bugbot.yaml を PR に入れたのに効かない方

Bugbot は取り込み先の枝(本線)の `.cursor/config/bugbot.yaml` を読みます。作業枝だけに置いても、その PR 自身のレビューは変わりません。本線へ入れてから効きます。

Bugbot の設定ファイルへ

BUGBOT.md と bugbot.yaml のちがいが分からない方

BUGBOT.md はレビューの約束文。bugbot.yaml は画面の設定(下書き、Effort、要約、Autofix)です。yaml の Autofix はダッシュボードより厳しくできますが、オフをオンにはできません。

Bugbot の設定ファイルへ

Bugbot のレビューが遅い/利用量が多い方

従量課金の Bugbot なら Effort(Low / Default / High / Smart)を疑います。速さや費用を優先するなら Low / Default、取りこぼしが多いなら High です。

Bugbot Effort へ

チームのレビュー約束を毎回 PR に書いている方

PR に `@cursor remember (覚えさせたいこと)` と書くと、学習したルールとして以降の Bugbot レビューに入ります。長い約束は `.cursor/BUGBOT.md` です。

@cursor remember へ

チームが IntelliJ / PyCharm で、Cursor Desktop が要るか分からない方

JetBrains IDE の AI Chat から Cursor の Agent を ACP で使えます。Cursor Desktop に移さなくても依頼できます。有料プランと AI Assistant プラグイン(2025.1+)が前提です。

Desktop が効いてくる合図へ

チームが Xcode で、Cursor Desktop へ全部移す必要があるか分からない方

Xcode 26.3 以降なら Intelligence の Xcode Tools をオンにし、Cursor の MCP に xcrun mcpbridge を足します。画面・mcp.json・CLI のどれでもよい。Xcode を開いたまま使います。

Xcode MCP の節へ

Bugbot と同じ指摘がもう1本の Automation からも来る方

Bugbot と Marketplace の find bugs 系は別系統です。同じ PR で重ねると指摘が二重になります。一般的なバグ探しは Bugbot に任せ、自作は別の仕事に絞りましょう。

Cursor 管理の Agent へ

低リスクなのに PR Routing が承認しない方

Bugbot や Security Agents の指摘が人の確認を要する場合、PR Routing は自動承認しません。完全なコードレビューの代わりでもありません。

PR Routing へ

GitLab / Bitbucket で PR Routing が保存できない方

PR Routing & Approval の対象は GitHub と Origin だけです。GitLab / Bitbucket / Azure DevOps の保管庫は保存前に外します。

PR Routing へ

特定の保管庫だけ Cloud Agent から外したい方

repository blocklist は保管庫単位の除外です。Organization 全体を閉じる Protected Git Scopes とは別です。管理者に保管庫名を伝えてください。

会社の Organization を守りたいときへ

Agent が自分の見えない保管庫まで触るか心配な方

公式では権限は広がらず、起動した人がもともと開けた保管庫までです。管理者のアプリ導入と、利用者ごとの Connect が別層です。

触れる保管庫は、あなたの権限までへ

API キーや .env が Agent の会話に載るのが怖い方

保管庫の `.cursorignore` で Agent / Tab / @ 指定から外せます。ターミナルと MCP は止めきれないので、鍵は Runtime Secret です。

.cursorignore の節へ

mcpbridge が見つからない/Xcode の MCP が繋がらない方

Xcode 26.3 以降と、プロジェクトを開いた Xcode が動いていることが前提です。コマンドラインツールだけだと見つかりません。xcode-select をフルの Xcode に向けてください。

Xcode MCP の節へ

Security Agents の定期スキャンと PR レビューのちがいが分からない方

Security Reviewer は PR / MR の直前(下書きは対象外。保存に Tool / MCP が要る)。Vulnerability Scanner は保管庫を予定で読む側で、Tool なしでも Flagged vulnerabilities に出ます。

Security Agents へ

受け入れた Security の指摘が次の push でまた付いた方

直さずに解決した同じ問題は、次の push でも新しいコメントを開きません。同じ行の別問題は別コメントです。直した問題が戻ると、また報告します。途中で失敗したレビューは、問題なしとして自動承認しません。

Cursor が用意している Agent へ

Automations の一覧に自分のものが出ない方

一覧は Mine / Team / Explore です。自分のものは Mine、チームのものは Team、テンプレの全体は Explore です。チーム管理者は Team から開きます。

一覧のタブへ

一覧に Bugbot や Security が無い方

自分で作った Automation の行は Mine か Team です。Bugbot、Security Reviewer、Vulnerability Scanner、PR Routing は From Cursor のカードから開きます。行の一覧には出ません。

一覧のタブへ

公開の保管庫で Bugbot が自動で読まない方

チーム設定の Public repositories が、チームの外の人や bot の PR を自動で読むかを決めます。2026年10月22日以降に作ったチームは、変えていなければオフです。手動の cursor review は人が書けば動きます。

公開の保管庫の節へ

Bugbot が Request access になっている方

インストールの設定を変えられない人には、スイッチの代わりに Request access と出ます。押すと管理者へワンクリックのメールが届きます。管理者がオンにするまで、その保管庫はオフのままです。

公開の保管庫の節へ

Slack の Automation が失敗したのにチャンネルへ何も出ない方

きっかけのメッセージの砂時計が赤いバツに置き換わります。失敗の投稿はチャンネルへ出ません。理由は実行履歴です。

一覧のタブと保存した設定へ

Automation が Model is not allowed で止まる方

git・CI 完了・予定の実行は、保存したモデル・努力・コンテキスト・Max Mode・Fast で動きます。チームが Grok 4.7 の Fast を止めていても、その Automation は保存して動かせます。

一覧のタブと保存した設定へ

マージしたあとに本番で壊れていないか知りたい方

Rollouts が PR の監視プランを書き、デプロイ後に環境ごとの元気さを報告します。自分では切り戻しません。Teams / Enterprise で Automations の Rollouts から有効化します。

Rollouts へ

Rollouts の監視プランを直したい方

コメントに書かれたハンドルをメンションして「これを見て/これは無視して」と書きます。書き込み権限がある人だけ変えられます。対象外にした理由もコメントに出ます。

Rollouts の画面の見方へ

Rollouts が Pending のままの方

テレメトリ(Datadog など)が1つもつながっていないと、変更は Pending のままで問題を検出できません。デプロイ通知のパイプラインも確認してください。

Rollouts の画面の見方へ

本番に出たのに Rollouts がデプロイを見ていない方

記録されたデプロイが無いときは、その変更のページで Run checks を選び、環境とサービスを指定します。まだ始めない確認は Deferred と理由が出ます。Issue を閉じるときは Fixed や Duplicate などの理由を聞かれます。

Rollouts の画面の見方へ

Usage で SDK の分だけ見たい方

チームや組織の Usage ページでは、クライアントの絞り込みに SDK があります。Cursor SDK から動かした Agent の利用だけを見られます。

チャット下の利用量のリングへ

サービスアカウントの名前を Automation の ID だと思った方

automation- のうしろの ID も、sa_ で始まる ID も、Automation の ID ではありません。どの Automation かは、Automation の ID を get-automation に渡します。

Service account に変えるときのチェックリストへ

Vulnerability Scanner の指摘を直したい方

Flagged vulnerabilities 一覧から Fix in Cursor で Cloud Agent に渡せます。誤検知なら False Positive と理由を残して Dismissed にします。

Flagged vulnerabilities の直し方へ

Bitbucket Data Center で bugbot run と書いたのに動かない方

Data Center の Bugbot は PR が開いた/更新されたときに自動で読みます。コメントの bugbot run や cursor review は動かず、Cursor が返信してそう伝えます。Cloud Agent も Data Center では使えません。

GitLab / Bitbucket 節へ

Vulnerability Scanner に予定を2つ付けられない方

スキャナー1台につき予定は1つです。時刻を変えたいときはいまのきっかけを編集し、別の時刻が要るときはスキャナーをもう1台作ります。保管庫が 1,000 を超えると提供元の上限に当たることがあるので、範囲を分けます。

Flagged vulnerabilities の直し方へ

Security Reviewer の実行に Cloud Agent が無い方

チームの Security Reviewer が PR きっかけで動くときは Cursor 管理のホストで走り、Cloud Agent は付きません。From Cursor の Security Reviewer のページで、その種類だけの Recent Runs を読みます。スキャナーの実行は Vulnerability Scanner のページです。

Security Agents へ

Rollouts が指標は悪化していないのに Issue を開いた方

期待した効果が無い/エラー/動きが違うときも Issue を開きます。直しは Fix issue。Rollouts ページに並ぶのはマージ済みの PR です。

Rollouts の画面の見方へ

Secrets を入れたのに My Machines の Agent が鍵を使わない方

ダッシュボードの Secrets は Cloud machine に届きます。My Machines は手元 PC の鍵だけです。Team Pool は Secret sync でチーム/利用者分が届きます。鍵が要る仕事は Cloud machine のままが安全です。

Secrets を足したあとへ

Team Pool に Secrets を入れたのに鍵が届かない方

管理者が Secret sync をオンにし、作業場を `--sync-dashboard-secrets` で起動しているときだけ、チーム/利用者分が届きます。環境スコープと Build Secret は届きません。

Secrets を足したあとへ

My Machines で environment.json の install が走らない方

自前作業場はリポジトリの `.cursor/environment.json` を読みません。代わりは作業場の `.cursor/hooks.json`(sessionStart)か、Team Pool なら `--on-session-start` です。はじめて一周する仕事は Cloud machine のままがよいです。

自前作業場では environment.json を読まないへ

Require Self-Hosted Machines にしたら Cloud machine が選べない方

管理者の Require は Cloud Agent を全部自前作業場へ回します。クラウドの Build も止まり、Builds タブは environment builds are turned off です。Trigger build は出ません。任意なら Allow Self-Hosted Machines。はじめては Cloud machine のままが公式のおすすめです。

自前を必須にすると Build が止まるへ

自前作業場の Agent は動くのに PR にスクショが付かない方

成果物ホストへの通信が止まっていると、アップロードだけ失敗します。作業そのものは続きます。Cloud machine の許可リストでは同じホストを足します。

ネットワーク制限へ

Bitbucket の Bugbot が自分の名前で出る方

個人の Connect だけではアプリ名義になりません。ワークスペース管理者が Cursor アプリを入れて、Cursor チームへつなぐ必要があります。PR 作成は起動した人の名義のままです。

GitLab / Azure DevOps / Bitbucket へ

Team Pool で Dockerfile やスナップショットが効かない方

自前作業場は `.cursor/environment.json` を読みません。Dockerfile・スナップショット・install / start は Cloud machine 向けです。代わりは作業場の hooks.json(sessionStart)か `--on-session-start` です。

自前作業場では environment.json を読まないへ

/review-security が未コミット以外も読む方

既定は取り込み先の枝との差分(コミット済みも未コミットも含む)です。未コミットだけならそう頼む。取り込み先が main 以外なら枝名を伝えてください。

Security Agents へ

Security Agents の Issues fixed が増えない方

直ったかは、そのあとの差分を読んで判断します。Dismissed やフィードバックを残しただけでは直った件数に入りません。

Flagged vulnerabilities の直し方へ

Rollouts の古いサービスを一覧から外したい方

Services から開いて Archive すると一覧から外れます。デプロイの履歴は残ります。戻すときは Archived の Restore です。見る保管庫は最大 200 です。

Rollouts の画面の見方へ

GitLab Self-Hosted を切ったら Bugbot の設定が消えるか心配な方

Delete Instance は OAuth や Webhook・トークンは消します。Bugbot の保管庫設定・チーム設定・学習したルールは残り、同じホスト名でつなぎ直すと戻ります。

GitLab / Azure DevOps 節へ

Origin の PR が Request Changes のあとマージできない方

レビュー必須のとき、書き込み権限のある人の Request Changes は、その人が Approve するか、書き込み権限のある人がレビューを取り下げないとマージを止めます。

マージボタンがグレーのときへ

iOS に手元のパソコンが出ない方

同じアカウントでサインインしているか、Desktop 側で承認したかを見ます。Enterprise 以外は既定オンです。Enterprise は Org settings → Security and identity → Remote control。Cloud Agent は不要です。

ペアリングへ

cursor.com/agents のリンクが inbox に戻る方

iOS 1.12 以降は、会話内の Agent リンク(子 Agent 含む)がその会話を直接開きます。共有リンクも inbox ではなくチャットへ入ります。

スマホの会話リンクへ

Origin の反映済み PR が一覧に無い方

Pull Requests の Merged タブ、または検索の is:merged です。Gate の Check は CI に数えません。unknown はルール未読です。

Origin の反映済み一覧と Gate へ

Origin の Bugbot Check が赤い方

Origin 上の名前は Cursor / Cursor Bugbot です。エラーやレビュー投稿の失敗は失敗です(GitHub の指摘時の中立とは別)。新しい push でキャンセルされた実行は cancelled なので、必須 Check を満たしません。

Origin 上の Bugbot Check へ

依頼に今の PR を材料として付けたい方

Desktop の入力欄で # を打つと、自分の PR(いまの Agent が開いたものも含む)から選べます。Cloud / スマホなら URL か番号を本文に書きます。

入力欄の # で Pull Request を渡すへ

計画カードが入力欄を隠す方

Minimize で Plan の印に畳めます。右クリックの Remove で外せます。計画そのものを直す操作ではありません。

計画カードを小さくするへ

Team Owned / Team Visible の設定が見つからない方

いまの公式 UI は Share の Run as(Me / Service account)と Access(Private / Members can view / Members can edit)です。Team Owned は Service account に近いです。

権限と Memories へ

同じ型の Canvas 報告を毎回ゼロから頼む方

いつ使うか・欄・数字の取り方・単位を Skill に書いておくと、短い依頼で同じ形が再現されます。

Canvas の3つの形へ

Agent が docker compose や docker run で止まる方

Cloud Agent の VM はコンテナの中で動きます。単純な `docker run` は Docker 導入だけで動くことが多いですが、複雑な構成では fuse-overlayfs や iptables-legacy などの追加設定が必要です。公式の Dockerfile 例を environment.json に反映してもらいましょう。

ネットワーク制限の節へ

Build が失敗(赤)のまま残っている方

Builds タブで失敗 Build のログを開き、Fix Build か Test build / Trigger build で直します。スナップショットが期限切れでも Fix Build は、最新の成功 Build から失敗ログを読んで動きます。Agent 本体は最後に成功した Build を使い続けます。

Build が失敗したときへ

リポジトリに environment.json があるのに効かない方

保存した環境の場所が None(skip environment.json)だと、ファイルは読みません。新しく作った環境の最初は None です。使うなら、作るときにその保管庫を選びます。

environment.json は指しているときだけへ

Build が environment.json を読めず止まった方

指しているファイルが無い、空、または読めないと Build は失敗し、ファイル名と保管庫名が出ます。黙って古い設定には戻りません。Agent は最後に成功した Build を使い続けます。

environment.json は指しているときだけへ

個人の環境をチームへ上げたら同じ名前が消えたように見える方

画面は上書きしません。チームに同じ名前があると、先に名前を変えるよう聞かれ、新しい環境を作ります。一覧の Config as code は、ファイルで定義された環境です。

environment.json は指しているときだけへ

すでにある環境へファイルだけ載せ直したい方

画面で新しく作る、または個人の環境をチームへ上げるときは、同じ名前でも別の環境になります。載せ直すなら CLI の agent env deploy --env と、agent env list が先頭に出す公開 ID です。名前と保管庫は残ります。

環境の載せ直しへ

agent env deploy が名前や保管庫の違いで止まった方

渡した名前、保管庫、または保管庫の内部 ID が保存と違うと、コマンドは止まります。新しい環境にはなっていません。公開 ID とその環境の名前・保管庫に合わせるか、画面で新しい環境を作ります。

環境の載せ直しへ

自前のワーカーがすぐ止まる方

agent worker start と agent worker debug は、ログイン時に選んだチームで動きます。そのチームで Cloud Agent が使えないと止まり、チーム名と agent team switch の案内が出ます。既定のチームへは自動では移りません。

ワーカーのチームへ

ワーカーが別のチームに付いた方

出す前に agent team switch で、使いたいチームへ合わせます。アカウントの既定のチームへは移りません。machine-offline とは別の止まり方です。

ワーカーのチームへ

環境のページに Secrets が無い方

環境のページの秘密は、その環境のページの Secrets 欄で見て、足せます。設定がロック中は、その欄から見たり足したりはできません。ダッシュボード全体の Secrets タブとは別です。

環境のページの秘密へ

個人の秘密を足せない方

管理者が Disable personal secrets をオンにすると、個人の秘密は足せず直せません。すでに足した個人の秘密も、Cloud Agent には渡らなくなります。消すことだけはできます。個人の秘密は渡さない、です。

環境のページの秘密へ

保管庫も環境も選ばずに始めたのに、自分だけの環境ではない方

チームのメンバーが保管庫も環境も選ばずに始めると、チームの共有の、保管庫の無い既定で動きます。以前の個人の隠れた環境ではありません。チームの既定の保管庫なしです。誰も編集、改名、再ビルド、削除、環境の秘密の追加ができません。個人の秘密とチームの秘密は届きます。

チームの既定の保管庫なしへ

名前の無い、保管庫の無い個人の環境がロックされている方

名前を付けるまでロックされます。名前を付ける場所は、この案内にはありません。チームの既定を直せないことや、環境のページの秘密のロックとは別です。

名前を付けるまでロックへ

特定の Build から始めたのに、直した environment.json が効かない方

特定の環境の Build から始めた Cloud Agent と子役は、その Build に記録された environment.json と設定で起動します。いまの environment.json ではありません。記録された設定で動きます。ふだんの起動は、最新の成功した Build です。

その Build の設定へ

子役が親の新しい環境の版を使わない方

その Build から始めた子役は、親の新しい環境の版では起動しません。その Build の設定です。親のモデルで動いた話とは別です。コードのどのコミットかは、この案内では断定しません。

記録された設定で動くへ

Builds に Verify with Agent が無い方

環境の Builds では、Trigger build の隣に Verify with Agent が出ます。出るのは、あなたが Build を手動で始められ、チームが手動のBuildを許しているときだけです。どちらかが無いと隣には出ません。Trigger build は Build を走らせるボタンで、このリンクとは別です。

Verify with Agent へ

Trigger build の隣を押したら、新しいタブで Agent が増えた方

隣のリンクは、新しいタブで新しい Agent を開きます。新しいタブで確かめる用意、です。別の仕事が勝手に増えた印ではありません。入力欄の文と、どの Build を選ぶかは、この案内では断定しません。

新しいタブで確かめる用意へ

環境の保管庫一覧に、他のチームの Origin が無い方

環境を作るとき、または保管庫を直すとき、アクセスを許された他のチームの名前空間の Origin は一覧に出ます。名前空間をまたいで足す、です。以前はこのまたぎが API からだけでした。いまはダッシュボードから足せます。許可の出し方は、この案内にはありません。

名前空間をまたいで足すへ

他のチームの Origin が、自分のチームより上に出ない方

並びは、自分のチームの保管庫のあとです。自分のチームのあとに出る、と覚えます。上に無いことは故障ではありません。起動時の保管庫ピッカーや、iPhone の未公開の下書きとは別です。

自分のチームのあとに出るへ

制限つき通信で、CloudFront の配信が取れなくなった方

制限つき通信の Cloud Agent では、CloudFront のホストが最初から全部は届きません。CloudFrontは全部は開かない、です。残るのは、公開のコンテナイメージを取るためのホストだけです。ほかのドメインは、ネットワークの許可リストへ足します。残るホスト名の一覧は、この案内にはありません。

CloudFrontは全部は開かないへ

動いている Agent の通信設定を変えたのに、古い許可のままの方

実行中にネットワーク設定を変えると、その Agent には、いまの環境の許可リストが当たります。実行中に許可リストが入れ替わる、です。Cursorに置いた保管庫は速く取れる、も同じ変更です。ほかの実行中の Agent まで同時かは、この案内では断定しません。

実行中に許可リストが入れ替わるへ

既定の環境で、いつもの接続が証明書エラーになった方

用意されている既定の環境は、emSign ECC Root CA - G3 と AAA Certificate Services を、もう信用しません。危ないルートは信用しない、です。理由は、その下の中間の証明書の秘密鍵が漏れたことです。中間の秘密鍵が漏れた、です。失敗は、信用しないための動きです。どのサイトが止まるかは、この案内にはありません。保管庫も環境も選ばないときのチームの既定とは別です。

危ないルートは信用しないへ

Java のプログラムだけ、証明書で止まった方

コンピュータの証明書の一覧は更新されています。用意されている既定の土台では、Java の信用の一覧も、その一覧から作り直されます。既定の土台はJavaも作り直す、です。自分の Dockerfile や、保存したスナップショット、自前作業場まで同じかは、この案内では断定しません。

既定の土台はJavaも作り直すへ

自前作業場なのに、Desktop にファイルやターミナルが無い方

自前作業場で動いている Agent は、Cursor のデスクトップアプリから開けます。そこには、ファイル、変更、ターミナル、転送されたポートがあります。ライブの作業場を開く、です。オンにするのは、Linux のマシンを始めるときです。Linuxを始めるときにオン、です。macOS や Windows、Cloud machine まで同じかは、この案内では断定しません。

ライブの作業場を開くへ

自前のマシンを再起動したら、作業場が切れたように見える方

マシンが再起動したあとは、その Agent を開くと、またそのマシンにつながります。開き直すとつながる、です。開き直さなくてもつながり続ける、とは書いてありません。途中で落ちて別のマシンへ移る話や、machine-offline とは別です。

開き直すとつながるへ

プールもマシンも書いていない自前の実行が、思った作業場へ行かない方

チームの管理者は、Cloud Agents ダッシュボードの Self-Hosted で Default pool を選べます。プールもマシンも指名しない自前の実行は、そこへ先に寄ります。チームの既定のプール、です。名前を書いた実行や、1台の指名は、この案内の外です。

チームの既定のプールへ

保管庫に合うはずの自前の実行が、別のプールへ行った方

保管庫だけでは決まらない、です。選んだ既定がその保管庫を扱うなら、そこが受けます。扱わなければ、その保管庫を扱う別のチームのプールです。どの保管庫でも受ける、が残りを受けます。行けることと、その保管庫を開けることは別です。

保管庫だけでは決まらないへ

MCP の道具が失敗したように見えて、名前つきのカードが出た方

Cloud Agent の道具の呼び出しが、サインインに無い権限の名前で拒まれると、失敗の代わりに道具と足りない権限のカードが出ます。呼ぼうとした道具と、足りない権限の名前が載ります。カードの位置や、ボタンの英文は、この案内にはありません。

道具と足りない権限のカードへ

もう一度サインインしても、その権限が付かない方

もう一度入っても届かないときは、Agent が管理者の承認が要る、と伝えます。管理者が Cursor のチーム管理者なのか、つないだサービスの管理者なのかは、この案内では書いてありません。認証失敗の mcp_auth_error や、ログイン画面の連打とは別です。

もう一度入っても届かないへ

一度許した MCP の権限が、次に入ると消えたように見える方

この出し方で許した権限は次の入室にも残る、です。消えたように見えても、故障とは限りません。別の MCP まで残るか、取り消したあとも残るかは、この案内では断定しません。

許した権限は次の入室にも残るへ

Gmail の道具が回数で止まったあと、そのあとも使えない方

Cloud Agent の Gmail の道具が回数の上限で拒まれると、Gmailは待ってやり直す、です。Google が求める短いあいだ待って、その呼び出しをやり直します。あとのGmailは止めない、です。何秒待つかは、この案内にはありません。

Gmailは待ってやり直すへ

Google カレンダーが、権限エラーの生の文で止まった方

接続に足りない権限で失敗したときは、カレンダーはつなぎ直す、です。生の権限エラーの代わりに、アカウントの接続し直しを伝えます。どの画面で接続し直すかは、この案内にはありません。権限の名前が載るカードとは別です。

カレンダーはつなぎ直すへ

スプレッドシートが、いまのアカウントでは開けずに止まった方

Cloud Agent の Google スプレッドシートの道具が、いま使っているアカウントではその表を開けずに失敗すると、表は別のアカウントでやり直す、です。ほかの表アカウントが見える、です。必ずやり直す、とは書いてありません。

表は別のアカウントでやり直すへ

表を開けない失敗のあと、別のアカウントへ必ず移ったように見えない方

開ける表でやり直せる、です。必ずその場で移る、とは書いてありません。どのアカウントを選ぶか、何度までかは、この案内にはありません。カレンダーの接続し直しとは別です。

開ける表でやり直せるへ

Slack や表や Airtable や Jira の道具が、引数で止まったように見える方

Cloud Agent の Slack、Google スプレッドシート、Airtable、Jira の道具呼び出しでは、よくある引数は自動で直る、です。名指しはSlackと表とAirtableとJira、です。必ず成功する、とは書いてありません。

よくある引数は自動で直るへ

チームの MCP へ入ったら、同じ URL の自分の入口が消えたように見える方

チームが持っている MCP サーバーへサインインしても、同じ URL の自分の入口とはぶつからなくなりました。チーム所有は入口とぶつからない、です。入口の欄がどこかは、この案内にはありません。

チーム所有は入口とぶつからないへ

同僚の、保管庫が無い Agent へ追記したのに、読むだけに見える方

保管庫の無い個人の環境で動く Cloud Agent は、保管庫なしの個人環境は追記できる、です。以前は同僚には読むだけ、でした。届くかは Team Followups と Allow VM Sharing の設定どおりです。必ず届く、とは書いてありません。

保管庫なしの個人環境は追記できるへ

同僚の Agent は開けるのに、途中の保管庫で止まる方

他人の Agent を開くときも追記するときも、許された保管庫は全部要る、です。作業した保管庫を1つ開けるだけで足りる、とは限りません。足りないときに何が出るかは、この案内にはありません。

許された保管庫は全部要るへ

Cloud Agent が利用の上限で始まらない / 追記できない方

利用の上限で起動か追記が止まると、上限の案内が次を示す、です。次は、従量をオンにすることか、自分かチームの従量上限を上げることです。試用中なら Cursor のモデルか Auto へ、とも伝えます。三つが必ず全部出る、とは書いてありません。

上限の案内が次を示すへ

試用の上限のあと、追記を Auto にしてもまた止まったように見える方

試用の上限のあとはAuto、です。追記を Auto に切り替えると、もう一度止められずに続きます。試用でないときまで同じとは書いてありません。Buy Credits や Included Usage Reached とは別です。

試用の上限のあとはAutoへ

Agents のページで、設定がどこか分からない方

Agents のページでは、設定はカンマで開く、です。Mac は Cmd とカンマ、Windows と Linux は Ctrl とカンマです。どの設定の欄が開くかは、この案内にはありません。

設定はカンマで開くへ

横の一覧にマウスを載せても、開かない方

畳んだ横の一覧は、マウスを載せても開きません。畳んだ欄はボタンで開く、です。押すのは Open sidebar です。マウスを載せればまだ開く、とは書いてありません。

畳んだ欄はボタンで開くへ

会話を開いたら、横の Agent 一覧が畳まれた方

会話を開いて一覧が畳まれるのは、窓の幅が 1024px より狭いときだけです。狭い画面だけ畳む、です。それより広い窓で畳まれた理由は、この案内にはありません。iPhone の折り目とは別です。

狭い画面だけ畳むへ

iPhone の音声通話が、電波が落ちると切れたままに見える方

iPhone と iPad の Cursor アプリでは、切れた通話は自分で戻る、です。同じ会話の続きです。落ちているあいだに終えた仕事は、戻ったあとに渡されます。切れたあいだの仕事は渡す、です。何秒で戻るかは、この案内にはありません。

切れた通話は自分で戻るへ

音声通話を放置したら、エラーのように切れた方

あなたが約10分黙っていて、Agent に進行中の仕事が無いと、無音の約10分で切れる、です。終わり方は普通の切断で、エラーではありません。再生中の返事は途中で切りません。通信が落ちたあとの戻りとは別です。

無音の約10分で切れるへ

ウェブの Agents で引き出しを開くと、中身が空の方

ウェブの Agents では、引き出しは空で開かない、です。窓の幅が整数に割り切れないときも、割り切れない幅でも空ではない、です。どの倍率かは、この案内にはありません。iPhone のアプリまで同じとは限りません。

引き出しは空で開かないへ

ピン留めした Agent が、ウェブの一覧に出ない方

ピン留めは、ピンは先頭の千件で止まらない、です。全部見えます。付けられる数の上限は最大75件のままです。1,000 件ピンできる、という意味ではありません。別の端末で印が残る話は、一覧の並びです。

ピンは先頭の千件で止まらないへ

iPhone で会話を開くと、アプリが落ちる方

iPhone と iPad の Cursor アプリは、iOS 27 で会話を読み込むときに落ちなくなりました。会話の読み込みでは落ちない、です。アプリが 1.16.0 より前なら、App Store で更新してから、もう一度開きます。ほかの画面まで同じとは限りません。

会話の読み込みでは落ちないへ

プロフィールを開くと、アプリが落ちる方

プロフィール画面では落ちない、です。直ったのは iOS 27のその落ち方、です。ほかの iOS の版で落ちない、とは書いてありません。考えた時間や、下書きが無い話、ボタンがサイドバーへ移る話とは別です。

プロフィール画面では落ちないへ

iPhone や iPad で、入力欄の下に空きが残って見える方

iPhone と iPad の Cursor アプリでは、入力欄は下の安全域に乗る、です。依頼を書く欄が、画面の下の細い横棒に隠れない位置へ乗ります。アプリが 1.16.0 より前なら、App Store で更新してから、もう一度見てください。すべての隙間が無い、とは限りません。

入力欄は下の安全域に乗るへ

iPad の横の一覧と、入力欄の下が揃わない方

アカウントの行も揃う、です。揃うのは、iPad の横の一覧のアカウントの行と、依頼を書く入力欄です。iPhone に同じ行があるかは、この案内にはありません。行の中身も書いてありません。

アカウントの行も揃うへ

画面の下の細い横棒の上に、空きが残る方

ホームの上に余分な隙間は無い、です。直したのは、ホームインジケーターの上の余分な隙間です。すべての隙間が無くなった、とは書いてありません。ツールバーの大きさや、シートのつかみとは別です。

ホームの上に余分な隙間は無いへ

iPhone や iPad で、上の操作の印が端末と大きさが違う方

iPhone と iPad の Cursor アプリでは、ツールバーのアイコンは標準の大きさ、です。操作の帯の小さな絵が、端末の標準の絵に揃います。アプリが 1.16.0 より前なら、App Store で更新してから、もう一度見てください。どの画面の帯かは、この案内にはありません。

ツールバーのアイコンは標準の大きさへ

端末の標準の絵と、アプリの帯の絵が揃わない方

端末のアイコンと同じ大きさ、です。揃うのは、操作の帯の絵と、iPhone や iPad が最初から持っている操作の絵です。何ポイントかは、この案内にはありません。

端末のアイコンと同じ大きさへ

アプリの絵が、全部同じ大きさに直ったように見える方

ほかのアイコンまでは書かない、です。すべての画面の、すべての絵が同じ大きさになった、とは書いてありません。シートのつかみや、使えないときの画面の幅とは別です。

ほかのアイコンまでは書かないへ

下から出るシートに、上の細い棒が無い方

iPhone と iPad の Cursor アプリでは、シートのつかみは変えられるシートだけ、です。大きさを変えられるシートの上にだけ、細い棒が出ます。アプリが 1.16.0 より前なら、App Store で更新してから、もう一度見てください。どのシートが変えられるかは、この案内にはありません。

シートのつかみは変えられるシートだけへ

大きさを変えられないシートにも、上の棒があるように見える方

変えられないシートには出ない、です。棒が無いことだけを、壊れた印にしないでください。出るのは、大きさを変えられるシートだけです。

変えられないシートには出ないへ

どのシートも、見た目が変わったように見える方

すべてのシートまでは書かない、です。すべてのシートの見た目が変わった、とは書いてありません。使えないときの画面の幅や、操作の帯の絵の大きさとは別です。

すべてのシートまでは書かないへ

iPad で、使えないときの画面が細すぎて読めない方

iPad の Cursor アプリでは、使えない画面は読みやすい幅、です。画面の英語の名前は Access Disabled です。アプリが 1.16.0 より前なら、App Store で更新してから、もう一度見てください。いつその画面になるか、何ピクセルかは、この案内にはありません。

使えない画面は読みやすい幅へ

iPhone でも、使えないときの画面の幅が直ったように見える方

幅を保つのはiPadだけ、です。公式が名指ししているのは iPad です。iPhone まで同じ、とは書いてありません。

幅を保つのはiPadだけへ

どの画面も、幅が読みやすくなったように見える方

すべての画面の幅までは書かない、です。すべての画面の幅が変わった、とは書いてありません。シートの上の細い棒や、操作の帯の絵の大きさとは別です。

すべての画面の幅までは書かないへ

Enable Builds が見つからない / Builds をオフにしたい方

下書き以外の環境では、自分では Builds をオフにできません。以前オフだった環境も、有効な Build と定期チェックの失敗が見えます。タブが environment builds are turned off なら、管理者が自前作業場を必須にしています。

Cloud Agent Builds へ

ピン留めした Agent が別端末で消える方

Web のピン留めはアカウントに保存され、ブラウザやスマホを変えても残ります。Skill の Custom Mode ピン留めとは別です。一覧は『今日』『直近7日』『それより前』です。付けられる数は最大75件のままです。ウェブの引き出しで、ピンの表示が先頭で切れていた話は別の節です。

ピン留めと一覧の並びへピンの表示が先頭で切れていた話へ

閉じた PR の作業枝が消えている方

閉じた PR からでも Agent を始められます。作業枝が消えていても、取り込み先から新しい枝を切って直します。

閉じた PR からやり直すへ

Out of Other Models usage と出る方

他社モデル枠だけが尽きたときの公式メッセージです。Grok / Composer など Cursor Models へ切り替えるか、On-Demand を上げましょう。権限切れならエラーに保管庫名が出ます。

起動できないときの別チェックへ

許可リストに *.example.com を入れたのに本体に届かない方

公式では `*.example.com` は親ドメイン `example.com` 自身も含みます。まだ届かないときは別ホスト名か、許可リストのみモードを疑ってください。

ネットワーク制限へ

main の最新が Agent に入っていない気がする方

Cloud Agent Builds の Update stale builds と Staleness threshold で、main を Build 時点に固定するか、起動時に最新を取りに行くかを調整できます。

Build と main の新しさへ

Agent が CI 失敗を何度も直し続ける方

Agent 作成 PR では GitHub Actions の自動修正が走ることがあります。止めたいときは PR に `@cursor autofix off`、再開は `@cursor autofix on` です。

CI 自動修正の節へ

Cloud だけ stdio の MCP が動かない方

SSE や mcp-remote は Cloud Agent 非対応です。HTTP MCP を検討するか、実行環境で stdio コマンドが動くよう整えましょう。

MCP 接続の節へ

自分で画面を触って確かめたい方

Agent 画面の remote desktop control で、クラウド上のデスクトップを一時的に操作できます。試し終わったら Agent に戻せます。

確認と反映へ

Squash と Merge の違いが分からない方

Squash は変更を1つにまとめて本線へ入れる反映方式です。チームのルールが不明なら、マージ前に詳しい人へ確認しましょう。

反映のしかたへ

マージまで丸ごと任せたい方

いちばん簡単な入口は `/autopilot` です。Subscriptions で Agent に直し続けさせ、PR で auto-merge をオンにすると、条件が揃えば自動反映されます。レシピを参照してください。

マージまで任せるレシピへ

auto-merge / Subscriptions / autofix の違いが分からない方

auto-merge は GitHub の自動反映、Subscriptions は Agent がイベント待ちで再開、autofix は Agent 作成 PR の CI 自動修正です。開いた PR を見守る近道は `/autopilot` です。道具は別物です。

3道具の節へ

auto-merge をオンにしたのにマージされない方

条件(Checks・承認・behind・コンフリクト・権限)が未達のままか、Origin で積み重なった子が、いちばん下の開いている PR になるまで待っていることがあります。needs_restack とは別です。

順番待ちの節へ

個人プランで CI の自動修正(autofix)が動かない方

公式では autofix の自動追従はいま Teams 向けです。個人プランでは Subscriptions で『CI が通るまで続けて』と依頼するか、PR に `@cursor please fix the CI failures` と明示しましょう。

3道具の節へ

保管庫全体の PR を待たせたい方

いまの公式 GitHub Subscriptions は1つの PR の活動と、ブランチの CI 結果です。保管庫全体や特定作者の待ちは公式の待ち先にありません。広い監視は Automations へ。

GitHub の待ち範囲の節へ

Agent が待たなくなった / 購読が切れた方

Subscriptions は最大180日で、条件が満たされたとき Agent 自身が解除することもあります。長期タスクは区切りを決めて新しい Agent を起動しましょう。

Subscriptions 節へ

Subscriptions で待っているのに Agent が再開しない方

① CI が赤い・Checks が黄色(pending)・レビュー未承認など、まだ条件を満たしていない ② 購読が180日で切れた ③ フォローアップがキューに残っている、の3段階で切り分けます。④ Run as が Service account なら、待ちの道具自体がありません。

Subscriptions 節へ

/subscribe が無い / サービスアカウント名義で待てない方

待ちを頼めるのは、人が所有する Agent だけです。サービスアカウントが所有する Agent と、Run as が Service account の Automation には `/subscribe` も待ちの道具も付きません。自分の Agent に書くか、きっかけで新しい実行にします。

サービスアカウント名義では待てないへ

終わりかけに送った文がキューに入らない方

Cloud Agent がまとめているちょうどそのときに送った文は、別の追記になりません。いまの実行の、もう一手として答えます。別の仕事なら、この一手が終わってから送ってください。

終わりかけの同じ実行へ

読むだけのあとは次の指示がすぐ始まる方

直前の一手が、ファイルを読む・探すだけ、またはメッセージを送るだけだったとき、次の指示は作業場の写しを待たずに早く始まります。飛ばした故障ではありません。起動直後の読み取り専用の探索とは別です。

読むだけの次の指示へ

直したあとの次の指示だけ間が空く方

ファイルを直したあとは、変わった作業場を残すために写しを待ってから次へ進むことがあります。読むだけのあとが早いのと、直したあとに間が空くのは、どちらもいまの公式どおりです。

読むだけの次の指示へ

branch or commit not found と出て始められない方

GitHub の保管庫では、7文字以上の短いコミットから Cloud Agent を始められます。それより短い指定なら、7文字以上に伸ばしてください。同じ文字の枝やタグがあると、コミットよりその名前が優先されます。

短いコミットの節へ

自分が開いていない PR の説明を直すと断られた方

いまは断りません。既存の説明の下に足します。空ならその欄を埋めます。作者の文は消しません。下に増えただけなら、消えたのではありません。Bugbot の要約とは別です。

説明は下に足すへ

PR ページで Waiting on と出て、Agent が動かない方

開いている Agent は止まっていても、下の Agent がまだ動いていれば見出しは Waiting on です。故障ではありません。下の仕事が終わるのを待ちます。一覧は入力欄のすぐ上です。

PR ページの Agent 一覧へ

PR ページの Agent 一覧が読み込まれない方

Retry の案内が出たら、その案内を押します。何分も白い画面のまま待ちません。Privacy Mode(Legacy)と出たら、読み込み失敗ではなく Cloud Agent が止まっています。Retry では始まらないので、いまの Privacy Mode へ切り替えます。

PR ページの Agent 一覧へ

Cloud Agent の PR が最初から Ready で開いた方

Cloud Agent と Project のワーカーが開く PR は、既定で最初から Ready です。下書きは、あなたか依頼が頼んだときだけです。Ready は見てよい印で、反映済みではありません。Origin CLI で手で作る PR の既定 Draft とは別です。

最初から Ready の節へ

下書きで開いて、と頼んだのに Ready になる方

コードベース設定の Pull requests に Never open PRs as drafts があると、下書きの依頼があっても新しい PR は Ready のままです。下書きで出したいときは、このスイッチを先に見てください。

最初から Ready の節へ

非公開 Origin のコメントの末尾に Open in Web と出た方

非公開の Origin の提案書に、Cloud Agent が書いたコメント、返信、レビューの末尾に付くボタンです。押すと、その Agent の実行が開きます。故障の印ではありません。Teams の起動カードの Open in Web とは別です。

コメント末尾のボタンへ

GitHub や公開の Origin のコメントに Open in Web が無い方

公式が書いているのは、非公開の Origin の提案書です。公開の Origin や GitHub にも同じボタンがある、とはこの一文だけでは言えません。無いことだけを故障と決めつけないでください。

コメント末尾のボタンへ

cursor.com の PR で Fix with agent を押したら、別の会話が開いた方

cursor.com の Pull Request ページでは、Fix with agent と同じ種類の操作は、出した側の会話へ戻る、か、その提案書での自分の最近の会話へ戻る、です。別の仕事へ飛んだ故障とは限りません。どちらが先かは、この案内では書いてありません。

出した側の会話へ戻るへ

Fix with agent が、時刻の新しい Agent を開いた方

いまは、新しい順の会話は選ばない、です。一覧の上が新しく見えても、ボタンの行き先はそれとは限りません。開いた会話が、この提案書の仕事かを見てから送ってください。

新しい順の会話は選ばないへ

Linear の経過で、最後の返事が二度出た方

Linear 上の Cloud Agent の経過では、終わったあとの最後の返事は一度だけ、です。ふだんの言葉の要約がひとつです。途中経過の行が残っていても、要約の繰り返しではありません。

最後の返事は一度だけへ

Linear の経過に、実行や提案書の入口が無い方

Linear 上の Cloud Agent の経過には、経過に3つの入口が出ます。Open in Web、Open in Cursor、Pull Request です。提案書ができる前から Pull Request があるかは、この案内では書いてありません。無いことだけを、止まった印と決めつけないでください。

経過に3つの入口へ

Linear の課題から始めたのに、マージしても閉じない方

課題から始めた実行の提案書は、末尾が Fixesの一行で閉じる、です。Fixes <ISSUE-ID> があると、マージされたときに Linear が課題を閉じます。提案書が出ただけでは閉じません。

Fixesの一行で閉じるへ

Cloud Agent のリンクを開いても、見出しや状態がなかなか見えない方

ウェブで Cloud Agent へのリンクを直接開くと、直リンクは早く出る、です。見出しと状態は早く出る、です。何秒早いか、会話の残りが同時かは、この案内では書いてありません。一覧から開いたときまで同じとは限りません。

直リンクは早く出るへ

直リンクを開いても、最初に頼んだ文が見えない方

始めた依頼は早く出る、です。始めた依頼は、その実行を始めるときに送った依頼文です。画像が付いていたか、会話の残りが同時かは、この案内では書いてありません。新しい Agent で送った直後の文が見えない話とは別です。

始めた依頼は早く出るへ

一覧から開いたときも、直リンクと同じ速さだと思った方

公式が書いているのは、リンクを直接開いたときです。一覧からその実行を開いたとき、iPhone のアプリ、Desktop の Agents Window まで同じかは、この案内では断定しません。

見出しと状態は早く出るへ

子役が親のモデルで動いた方

自分で作った子役のモデルが、チームに止められている、Max Mode が要る、または使えないときは、失敗せず親のモデルで動きます。親はそのことを知ります。Explore / Bash / Browser のカードとは別です。

子役のモデルの代わりへ

Fast を禁止しているのに、引き継いだ子役が動いた方

親のモデルをそのまま引き継ぐ子役は、親が Fast を使っていなければ、チームの Fast 禁止では止まりません。動いたこと自体は、いまの公式どおりです。

子役のモデルの代わりへ

Gemini 3.1 Pro を止めたら画面確認まで止まった方

以前は、コンピュータ操作まで止まっていました。いまは直っています。使えなくなるのは動画の確認だけです。Agent はコンピュータ操作で試し続けます。Enterprise の操作オフや、自前ワーカーの許可不足とは別です。

コンピュータ操作は残るへ

コンピュータ操作は使えない、とモデル名が出た方

コンピュータ操作が使うモデルを、管理者が止めています。Agent は、モデルの名前と用途、管理者ならチームのモデル設定で戻せる、と伝えます。Gemini 3.1 Pro だけを止めたときは、この案内にはなりません。

コンピュータ操作は残るへ

実行に壊れた Skill の名前が出た方

SKILL.md の先頭が壊れている、description が無い、またはファイルが読めないとき、Cloud Agent の実行は Skill の名前と直し方を警告に出します。CLI の /skills の黄色い件数(長さの上限)とは別です。直し方は、その警告の文に従います。

壊れた Skill は、実行中に名前が出るへ

get-message-queue が空なのに Agent が再開しない方

キューが空なら③(キュー残り)は除外できます。① CI が赤い・Checks が黄色(pending)・必須レビュー未承認など、待ち条件がまだ満たされていないことが多いです。PR の Checks とレビュー状態を確認しましょう。

Subscriptions 節へ

テストは緑なのに CI 待ちの Agent が起きない方

GitHub の CI 待ちは Checks が全部終わるまで1つの結果です。人が承認するまで黄色(pending)の Check が1つあると全体が届きません。pending のままにせず、GitHub の action_required(要対応)で完了させる公式の対処があります。要対応でも必須 Check ならマージは止まります。

Subscriptions 節へ

自分でコミットを足したあと autofix が動かなくなった方

公式では人が後から push すると自動の CI 修正追従は止まります。PR に `@cursor please fix the CI failures` と頼むか、Subscriptions で続けて依頼しましょう。

autofix の節へ

追加メッセージを送ったあと autofix が動かなくなった方

follow-up を送ると autofix の自動追従は止まります。明示依頼か Subscriptions が代替です。

autofix の節へ

本線でも同じ Check が赤いのに autofix が動かない方

取り込み先(base)でも同じ Check が既に失敗していると、autofix は走りません。本線側を先に直すか、PR に明示依頼しましょう。

autofix の節へ

機能ブランチの environment.json が効かない方

Build の土台は既定ブランチ(多くは main)の設定が使われます。commit & push 後にそのブランチから Agent を起動してください。

環境の優先順位の節へ

Agent が CI 失敗を何度も直し続ける方

Agent 作成 PR では GitHub Actions の autofix が走ることがあります。1 PR だけ止めるなら `@cursor autofix off`、全体で止めるなら Dashboard → Cloud Agents → My Settings の Automatically fix CI Failures を確認しましょう。

autofix の節へ

Builds タブに Skipped がたくさん並んでいる方

公式では変更が無い定期チェック(Recurring)だけが Skipped として記録される正常な状態です。手動や設定変更の Build は必ず install が走ります。

Build はいつ走るかの節へ

Secrets を変えたのに Build が始まらない方

Configuration change として数分以内に Build が走ることが多いです。急ぎなら Builds タブの Trigger build で手動実行できます。

Build はいつ走るかの節へ

Android でネイティブアプリが欲しい方

公式では Android ネイティブアプリは開発予定です。いまは Chrome で cursor.com/agents を開き、Install App(PWA)を使います。

スマホでできることの節へ

setup_started のあと setup_completed が出ない方

まだ準備中か、直後に setup_failed になることが多いです。数分待ってからイベント一覧を再確認し、失敗なら Builds タブや setup ログを開いてください。

実行イベントの節へ

ダッシュボードに artifact_created と出たのに PR に画像が無い方

Agent 画面には成果物がありますが、PR 本文への埋め込みは Allow posting artifacts to GitHub 設定が必要です。秘密情報が写っていないか確認してからオンにしましょう。

成果物を PR 本文に載せる設定へ

Agent は完了したのにスクショや動画が無い方

実行イベントに artifact_created が無いことが多いです。環境不足・ネットワーク制限・依頼に成果物の指定が無い、を疑いましょう。

実行イベントの節へ

成果物の動画がいきなり音を出す方

Agents Window の会話や全画面の動画には Mute / Unmute があります。次の動画は直前に選んだ状態から始まります。突然音が出るのが嫌なら、最初の本でミュートしておきます。

成果物と Mute へ

ダッシュボードに mcp_auth_error と出た方

MCP 認証失敗の公式イベントです。その MCP の道具だけスキップされ、実行自体は続きます。Integrations で再接続するか、起動時の MCP 選択を見直してください。

実行イベントの節へ

ダッシュボードに setup_failed と出た方

環境のセットアップ(install / start など)が失敗した公式イベントです。setup ログや Builds タブの失敗 Build を確認し、環境設定を直してください。

実行イベントの節へ

Agent は動いたのに PR が無い方

実行イベントに pr_creation_failed が出ていることがあります。GitHub 連携の PR 権限・ブランチ保護を確認し、差分が残っていれば手動 PR か再依頼を検討してください。

実行イベントの節へ

Checks は緑なのにマージできない方

CI が通っていても、必須レビュー未承認・ブランチ保護・マージ権限不足で止まることがあります。マージブロック図の④⑤⑥を確認しましょう。

マージボタンがグレーのときへ

ガイド付きセットアップが進んでいるか分からない方

公式では Agent 主導セットアップ中、共有ターミナルで install の進捗を一緒に見られます。『止まっている』ように見えても依存の install 中のことが多いので、まずログを眺めましょう。

ガイド付きセットアップの節へ

環境セットアップが Secret 追加待ちで止まった方

Agent が request-environment-setup-actions で『Secret を足してほしい』と記録していることがあります。setup_failed ではなく setup_started のまま止まることもあります。Secret 名だけを管理者に伝え、値は別経路で渡したあと、新しい実行を始めるか続きを頼んでください。

実行イベントの節へ

環境を直したあとスナップショットを残したい方

Agent 主導セットアップ後にスナップショット保存を頼むか、Cursor Cloud MCP の take-environment-snapshot / check-environment-snapshot を Agent に使わせます。

管理者への依頼の型へ

Build が失敗して原因が分からない方

Agent に『Cursor Cloud MCP で最新の失敗 Build を調べて』と頼めます。list-environment-builds と environment-build-logs、直したら trigger-environment-build で Test build、という公式の流れがあります。

Build が失敗したときへ

実行 URL はあるが、どこで止まったか分からない方

Agent に run-info → get-events の順で調べさせるのが公式の診断の入口です。setup_failed / pr_creation_failed / mcp_auth_error などの kind を確認し、該当ログへ進みます。会話名を付け直すなら rename-chat です。

Cursor Cloud MCP の節へ

Agent に Cursor Cloud MCP の道具が出てこない方

チーム管理者が Dashboard の MCP 設定で組み込みの Cursor Cloud MCP を無効にしていることがあります。詳しい人に有効化を依頼するか、実行 URL と症状を伝えて手動で調査してください。

Cursor Cloud MCP の節へ

AWS などへ長期の API キーを Secrets に置きたくない方

公式の OIDC トークンで、作業用コンピュータ内から短い有効期限の JWT を発行し、AWS IAM などと連携できます。`CURSOR_AWS_ASSUME_IAM_ROLE_ARN` を使う IAM ロール連携も公式例にあります。詳しい人向けですが、長期鍵を置かない代替として知っておくと相談が速くなります。

OIDC とエージェントメタデータの節へ

社内 API にだけ届けたい方

許可リストだけでは足りないことがあります。公式の Cloud Environment Setup では Tailscale(userspace networking)や Cloudflare Tunnel(cloudflared、CF_ACCESS の Secrets 例あり)でプライベート接続する例があります。userspace networking では VM を tailnet の exit node にはできませんが、社内リソースへ届けば十分なことが多いです。詳しい人に『社内 VPN 内の API が必要』と伝えられると会話が進みます。

ネットワーク制限の節へ

外出先で電波が不安だが、直近の Agent を見返したい方

Cursor for iOS は cache-first です。一度読んだ inbox や会話は端末に残り、オフラインでも開けます。接続が戻ると同期されます。

スマホでできることの節へ

Auto を選んだのにどのモデルが動いたか知りたい方

Teams / Enterprise では Cursor Router が振り分け先を既定で隠します。管理者設定で表示するか、詳しい人は turn/model(Auto という文字列ではありません)。

Auto と Cursor Router へ

Automation から起動した Agent か分からない方

エージェントメタデータの agent/source が AUTOMATIONS のとき、Automation 起動です。PR 作者が cursor かどうかとも切り分けできます。

OIDC とエージェントメタデータの節へ

エージェントメタデータの turn/ が読めない(404)方

turn/ 配下はコーディングターンが動いている間だけ存在します。ターンとターンのあいだは消えるので、Hooks ではターン中だけ読む前提にしてください。

OIDC とエージェントメタデータの節へ

フォルダをドロップしたら一部しか付かない方

Cloud Agent の入力欄へフォルダを落とすと、隠しファイルは飛ばし、1回あたり最大20件です。それ以上は先頭20件だけ付き、画面にその旨が出ます。

添付と具体物へ

添付が too large(4MB limit)で付かない方

cursor.com/agents では、文書と画像が1ファイル 4MB、動画が15MB までです。ブラウザがアップロードの前に拒みます。窓や Max Mode を変えても上がりません。分けるか、保管庫にあるファイルは読んでもらいます。ZIP は文書添付に使えません。

Web の添付上限へ

新しい Cloud Agent が同僚の環境で動いている方

いまの公式は保管庫の既定の環境を使います。以前は同僚が保存した環境が先に選ばれることがありました。会話の環境の行の警告も見てください。

保管庫の既定の環境が選ばれるへ

GLM 5.3 が一覧に無い / 灰色の方

既定オフの Other Models です。Settings → Models から足します。Start プランには枠が無いので選べません。はじめては Grok / Composer で十分です。

GLM 5.3 の見分け方へ

Claude Haiku 5.5 が一覧に無い / 4.5 Haiku のままの方

公式は 4.5 Haiku の代わりに Haiku 5.5 を勧めます。Settings → Models から足します。100k 入力までは約1/10、それを超えると5倍です。会話の Haiku 5.5 と Auto-review の予備 4.5 Haiku は別です。Start には枠がありません。

Claude Haiku 5.5 の見分け方へ

Fable 5.1 が一覧に無い方

Privacy Mode のチームと、すべての Enterprise では既定オフです。承認はチーム全体に効きます。ゼロデータ保持のままなら Opus 5.5 です。選んだあとに Opus へ変わっても、やり直しは不要です。

Fable の自動切り替えへ

Gemini 4 Argon や Muse Wonder でクレジットが減った方

どちらも他社モデルです。週の Cursor モデル枠(Grok / Composer)には入りません。新しい契約は前払いクレジット、これまでの契約は Other Models 枠です。Muse Wonder がチームに出ないときは、管理者に Meta の提供者をオンにしてもらいます。定期実行に選ぶと最大 1M の窓です。

Gemini と Muse の見分け方へ

Gemini 3.8 Flash や 3.1 Pro でクレジットが減った方

速い側でも、画面のラフを読む側でも、他社モデルです。週の枠には入りません。3.1 Pro を定期実行にすると、200k 超の割増の条件に入ります。上がったあとの数字は料金表の行にありません。

Gemini の3つの見分けへ

Composer や Grok 4.5 の Fast で利用量が多い方

Composer の標準は4つのなかでいちばん安いです。製品の既定の Fast は出力 $15 で、Grok 4.7 の Fast($12)より高いです。Grok 4.5 の Fast は出力 $18 です。安く回すなら標準速度に戻します。

Cursor の4つの見分けへ

クレジットが残っているのに追加利用が止まった方

月の追加利用の上限に達すると、前払いが残っていても翌月か上限を上げるまで止まります。場所は grok.com/dashboard/billing の Additional usage credits です。組織グループの Soft / Hard や Spending とは別です。

席ごとの週の枠と追加利用へ

同僚が使ったせいで自分の週の枠が減った方

Teams の週の枠は有料の席ごとで、席のあいだでは移りません。Free 席はチームの枠を使いません。減っているのはチーム共通の前払いのことがあります。

席ごとの週の枠と追加利用へ

チームの Premium が月 $30 と月 $120 で違う方

いまの Premium 席は月 $30 です。前からのチームの Premium は月 $120 で、近い段はいまの Super 席です。移すのは任意で、一度移すと戻せません。入口は cursor.com/unify/team です。

Premium の席が2つあるへ

Max Mode のスイッチが無い方

モデル選択の横の Max Mode は、利用をリクエスト回数で数えるさらに古い契約だけです。The X Subscription と、月2枠の Start / Pro には含まれません。出ないのは故障ではありません。オンにできる契約では、API 料金に 20% が足されます。Muse Wonder の 1M や、Automations に保存した Max Mode とは別です。

Max Mode の節へ

Unpaid Admin と Free 席が同じに見える方

Unpaid Admin は役割です。請求されず、Cursor の有料機能は使えません。Free 席は席の段で、個人の契約から使います。チームには有料の人が1人と、Admin が1人必要です。

Premium の席が2つあるへ

Claude を選んだのに会社の AWS を通らない方

画面の『Claude Sonnet 5』や Auto は、Cursor の提供元のままです。会社の AWS(Bedrock)を通るのは、生の ID を選んだ依頼だけです。ダッシュボードで検証したあとも、Settings → Models のスイッチは自分でオンにします。

会社の AWS(Bedrock)へ

not supported by bedrock と出た方

AWS Bedrock のスイッチがオンのまま、Bedrock の ID が無いモデルを選んでいます。Cursor 側のモデルに戻すときは、スイッチをオフにします。モデル代がほぼゼロでも、Token Rate があるプランでは Cursor 側の料率が残ります。

会社の AWS(Bedrock)へ

週の上限で止まった / Buy Credits と出た方

Desktop の Settings → Plan & Usage から前払いクレジットを買うと、通った時点で止まりが解除されます。ダッシュボード Spending の従量や、スマホのアプリストア内課金とは別です。

週の上限とクレジットへ

iPhone に Included Usage Reached と出た方

いちばん上の個人プランで、含まれる利用枠を使い切った案内です。Manage Plan のボタンが付きます。押した先は、このリリースノートには書いてありません。Desktop の Buy Credits や Spending とは別です。

利用枠到達の節へ

チームで Manage Plan を押しても変わらない方

チームのアカウントでは、誰がプランを扱うかの案内です。メンバーは管理者へ、Enterprise の管理者は自分のアカウントチームへ。自分で契約を変えられる管理者は、プロフィールの Manage team subscription から cursor.com が開くことがあります。App Store の地域が許すときだけです。

利用枠到達の節へ

GitLab で Maintainer access is required と出る方

GitLab のプロジェクトで Maintainer または Owner が必要です。再接続ではなく権限です。つなぎ直したあとは待ち時間なしで使えます。

GitLab / Azure DevOps 節へ

Bitbucket の @cursor が無視された方

いまの公式は、コマンドが走れないとき理由を PR に返信します。アカウント未連携や書き込み権限不足です。まずその PR のコメント欄を見てください。

GitLab / Azure DevOps / Bitbucket へ

Agent の PR リンクをコピーしたい方

パネルやサイドバーのコピーメニューに Copy PR Link があります。いつもの確認先(GitHub など)の URL が入ります。

PR のリンクをコピーするへ

Auto-review なのに MCP のマージ確認が出る方

道具側が確認必須と印を付けた MCP(マージなど)は、Auto-review でも確認カードが出ます。確認なしは Run Everything か、その道具を許可リストに入れたときです。

Run Modes へ

PR 一覧が黄色で CI が落ちたと思った方

黄色の Action Required は人の承認待ちです。テストが落ちた CI Failing ではありません。マージできる PR は Ready と出ます。

PR 一覧の黄色へ

PR Routing のラベルきっかけが付け外し両方で動く方

Approver Agents のラベルきっかけは、付けたとき / 外したとき / どちらでも、を選べます。1つのラベル名に絞ることもできます。

PR Routing へ

Automation が動かない / 実行履歴に赤い印だけ出る方

実行履歴に、枝が無い・保管庫に入れない・地域でモデルが止まる・API キー上限・Slack チャンネルが無い、など具体的な理由と次の一手が出ます。あとから成功した実行は成功と出ます。

実行が止まったときの見方へ

予定を2つ付けたのに片方しか動かない方

いまの公式は複数の予定を全部動かします。以前は先頭だけ動くことがありました。動かないときは実行履歴の理由を見てください。

実行が止まったときの見方へ

GitHub アプリのインストールが途中までしか出ない方

インストールが多いとき、いまの公式は全部読みます。1ページ目だけではありません。トークン切れのアカウントが1つあっても、ほかは残ります。

GitHub 接続が切れやすいときへ

GitHub の一時障害のたびに Connect し直している方

短い拒否では接続を消しません。何度も失敗したときだけトークンを外します。作ったばかりの保管庫も、書き込めれば直後の詳細取得失敗では拒否されません。

GitHub 接続が切れやすいときへ

Slack のモデル一覧が Web と違う方

Slack 設定のモデル一覧は Web と同じカタログです。使えるモデルなら model= でも指定できます。固定の短い一覧ではありません。

Slack のモデル一覧は Web と同じへ

MCP のログインが何度も出る方

文面が管理者ポリシー(Google Workspace / Entra)なら連打せず許可を頼みます。Slack / Supabase / Make / HubSpot の期限切れなら一度だけ再接続します。パソコン向けの戻り先を拒否する MCP は、Cursor が用意した戻り先ページで入れます。

MCP のログインがループするときへ

会話の本文が広すぎる / 表が狭い方

Settings → Appearance → Agent Conversations の Chat Width です。読みやすくするなら Narrow、表やコードなら Wide です。チャットタブの幅(題の長さ)とは別です。

会話本文の幅へ

Buy Credits が先に出る / 自動追加を止めたい方

クレジットが要るモデルで、上位プランが無いときは Buy Credits が先に出ます。自動追加は同じ画面の Set Up でオフにできます。月額の従量は Spending です。

Buy Credits の案内と自動追加へ

environment.json にコメントを書いたのにセットアップを促される方

いまの公式は // とブロックコメント、末尾のカンマを設定として読みます。コメント付きでもスナップショットとネットワーク設定は適用されます。自前作業場は今までどおり environment.json を読みません。

environment.json のコメントへ

MCP が回数の上限で全部止まったように見える方

上限を返した道具だけが休み、ほかの道具は続きます。Slack の待ちはおよそ1分で頭打ちです。サーバーが再起動したあとは道具が回復します。

MCP の回数上限へ

親の Agent が止まったように見える方

子役の道具とメッセージは、親のタスクの下にその場で流れます。終わるまで真っ白ではありません。まず子の行を開いてください。障害のお知らせは右下のポップアップです。

子役の途中が見えるへ

Stop のあとに送った文がキューに残った方

いまの公式では、Stop のあとの送信は実行されます。動かないときは赤い Error を見てください。答えた質問は、読み込み直しても残ります。

止めたあとの送信へ

Projects で別の Agent の続きを使いたい方

コーディネーターにその Agent を @ で渡すと、やり取りを読んでメッセージを送れます。届くのは、あなたがメンションし、かつあなたが開ける Agent までです。

別の Agent に話しかけるへ

指名した作業場なのに違う保管庫で動く方

1台を指名したワーカーは、その作業場に登録された保管庫で働きます。Project 側の保管庫ではありません。プールを名前なしで置くと、1台の名前を指定するようエラーになります。

指名した作業場へ

起動時にどの保管庫が空か分からない方

入れない保管庫は名前つきで、空、拒否、接続が必要、のどれかが出ます。Connect GitHub のカードにも、必要な保管庫の名前が出ます。

起動時の保管庫名へ

Slack の成果物リンクがプレビューされない方

ファイル名と種類(動画なら長さ)が出るのは、貼った人がその成果物を見られるときだけです。ワークスペースの外と共有しているチャンネルでは出ません。失敗した起動の砂時計はバツに置き換わります。

Slack の成果物プレビューへ

Merge N PRs と出て、何件も入るのが怖い方

Origin で、開いている下の PR も一緒に本線へ入るときのボタンです。注記どおり1つのコミットとして入ります。閉じた PR は「N closed」に畳まれていて、消えていません。

積み重なった PR の見え方へ

親を反映したあと、子が needs_restack で止まる方

Origin で親だけを先に squash で本線へ入れると、子の土台がずれて積み直しが必要になります。反映ボタンを連打しても入りません。自分の変更だけを、いまの本線の先へ積み直します。

積み直しの節へ

積み重なった子の auto-merge が緑なのに入らない方

Origin では、子の auto-merge は、そのスタックでいちばん下の開いている PR になるまで待ちます。親が開いていれば、Checks が緑でもまだ入りません。needs_restack(土台のずれ)とは別です。

順番待ちの節へ

Squash を選んだのに Origin が拒否する方

ruleset が通常のマージだけ、または squash だけを許していることがあります。許されていない方法は拒否されます。方法を指定しない反映は、許されている方で入ります。

反映のしかたの制限へ

Agent Review を隠したのにまた出る方

隠すベータ設定 Hide Agent Review は無くなりました。タブは、チャットの Review を開閉しても、計画を戻しても残ります。消えたと思ったらタブの列を探してください。

レビューのタブは残るへ

差分の行が怖くて PR を読めない方

Origin の Changes タブで Tour を選ぶか、T を押します。何をなぜ変えたかが先に出て、コードはグループの横です。すでに書いてある案内を読むだけでは、利用量は減りません。

案内(Code Tours)へ

案内が大きすぎる、または Updating… のままの方

Too large for a tour は、その PR が案内に大きすぎる印です。View files で差分に戻るか、小さく分けます。新しいコミットのあとは Updating… が消えるまで待ち、消えなければ See latest。途中で止まったら Retry。無料と個人の試用中は、書いてある案内を読むだけです。

案内の止まり方へ

Review Changes で変更が無いように見える方

ファイルが多すぎると、中身が見られない、と警告します。変更ゼロの印ではありません。Apply は止まり、空のファイルは書き込まれません。PR の Files changed を見るか、小さな PR に分けるよう頼みます。

中身が見えない警告へ

Bugbot がきれいでないと出た方

手元の差分が大きすぎると、読んだ件数と読まなかったファイル名が出ます。指摘が全部落ちたときは、バグは無い、とは書かず、きれいでないと出ます。Manual Only ではマージ後の自動学習が止まり、`@cursor remember` は残ります。

読みきれなかった差分へ

Usage が残り $0 に見える方

月の上限を超えたときは、残り $0 ではなく超過額が出ます。リセット日と請求サイクルは、見ている人の現地の時刻です。すでに走っている依頼の超過は、その請求サイクルで上限を上げない限り請求されません。

利用量の超過と現地時刻へ

秘密が全部の保管庫に入った方

Edit Secret で All repositories を選ぶと、見える保管庫の全部に保存されます。1つだけなら保管庫を指定します。環境の履歴は、その環境だけです。Duplicate のダブルクリックはコピー1つです。

Secrets を足したあとへ

PR の要約が generating a summary のままの方

要約が止まったときは、その仮の文は残らず、消えるか Unable to generate summary(要約を出せなかった)になります。作者の本文だけを読みます。要約の下に貼った画像・動画・ファイルは、更新では消えません。

要約が止まったときへ

Autofix が直しているのに PR が増えない方

起動に失敗、または重大度のしきい値に届かない、と書いてあれば、直しは始まっていません。Fix in Web で自分から直すか、しきい値を確認します。分析の件数は UTC の日ごとで、同じ PR は期間中1回です。

直しが始まっていないときへ

Cloud Agent がキャンバスを出した方

作業の一部として作った見本です。カードから開き、同僚へは Publish したリンクを送ります。共有を作れるのは、新しい契約なら Premium 以上です。Plus はこの一覧に入りません。

Cloud Agent が作るキャンバスへ

環境の名前が衝突した方 / 一覧に出ない方

同じ名前は environment_name_conflict です。下書きと削除済みは一覧に出ません。チーム環境は、中の保管庫を全部開ける人だけが見えます。保管庫は最大300です。

スクリプトから作る環境へ

Desktop で管理者が Agent を無効にしたと出る方

契約切れでも利用上限でもありません。方針 AgentRemoteWorkspaceAuthorities が、手元の窓での Agent を止めています。会社が指定したリモートで開き直すか、管理者に方針名を伝えてください。

会社のパソコンで Agent が出ないへ

起動直後にモデル一覧が空の方

会社の Private Inference は、ゲートウェイが返事をしないあいだ最大5分試し続けます。切り替えは再起動のあとも残ります。オフにしたモデルでは、新しいチャットは始まりません。Okta FastPass の英文が残るときは、Cursor を最新にしてからサインインし直します。

モデル一覧と Okta へ

自分で打つと質問が出るのに、Agent だと飛ばす方

Agent がターミナルコマンドを実行するとき、環境変数 CI=1 が付きます。質問を飛ばしたり、自動の確認の場だけの道を通ったりします。止めるなら unset CI && を前に付けます。毎回なら Rules に書きます。クラウドの Agent まで同じ印かは、公式のこのヘルプだけでは断定できません。

CI=1 の節へ

新しい Project が Setting up project の一行だけの方

Desktop の Cursor 3.27 以降は、最初の出力までその一行です。環境の準備が消えたのではありません。もう一つ作り直さず待ちます。動き始めてからの Running commands などの一行とは別です。

準備中の一行へ

新しい Project でアプリのパネルが閉じている方

apps panel は最初閉じたまま始まります。故障ではありません。最初のタスクが出ると、Project のアプリが自分で開きます。3.27 より前で準備の手順が動いて見えるときは、Cursor を更新します。

閉じたパネルの見方へ

会話が Messages from の一行だけの方

Desktop の Cursor 3.27 以降は、Project が Agent に送った連絡が中央の一行にまとまります。消えたのではありません。名前をクリックすると、その Project のチャットのその位置が開きます。更新の本文は Update from を広げます。準備中の Setting up project とは別です。

連絡の一行へ

Project の親タスクが子より後ろに残っている方

タスクの表を使っている Project で、親に自分の Pull Request も Agent も無いときは、親タスクは子に合わせます。いちばん進んでいる子の順は In Progress、For Review、Queued です。子が全部終わると親は done です。親が止まって見えることだけを、故障と決めつけないでください。

親タスクは子に合わせるへ

終わったタスクからワーカーが外れない方

追記のメッセージでまだ忙しいワーカーや、同僚のワーカーは、ターンが終わっても閉じたタスクから外れません。番号だけの名前は、最初の報告のあとで仕事の中身の名前に変わります。ワーカーは表を読めますが、書き換えはできません。

タスクの表へ

言葉で該当レッスンを探したい方

用語集だけでなく、17レッスンの見出し・本文と困ったとき索引をまとめて探せます。2文字以上入力すると結果が出ます。

サイト内検索へ