環境とは何か
人が開発するとき、PC に言語ランタイムや依存パッケージを入れ、起動コマンドを覚えます。Cloud Agent にも同じものが必要です。公式ドキュメントも、環境を渡さないことは『エンジニアに PC を渡さない』ことに近い、と表現しています。
依存のインストール、起動方法、必要な秘密情報、ネットワーク。これがそろうほど、Agent は『書いたつもり』ではなく『動かして確認した』ところまで進めます。公式も、環境づくりが Cloud Agent の効果を上げるいちばん大切な一歩だ、と位置づけています。
公式のベストプラクティスでも、『まず環境を整える』『必要な Secrets と通信先が届くか確認する』『手元でも再現しにくいものはクラウドでも難しい』と書かれています。依頼文を磨く前に、仕事場を疑う習慣が近道です。
『書いた』と『確認した』のちがい
仕事場が足りない Agent は、ファイルを直すところまではできても、テストや画面確認で止まりがちです。あなた側から見ると、『スクショが付かない』『プレビュー手順が無い』『確認できなかったと書く』といった形で現れます。
逆に仕事場がそろうと、Agent は自分で起動し、クリックし、成果物を添えてから PR を出せます。これが公式の言う『閉じたループ』(書いて終わりにせず、検証まで自分で回す)です。
- スクショや短い動画が欲しい → アプリを起動できる環境が必要
- ログイン後の画面を見てほしい → ログイン用 Secrets(必要なら 2FA)が必要
- 社内 API まで触ってほしい → ネットワーク許可や接続の準備が必要
環境の作り方は3系統
公式のセットアップでは、だいたい次のどれか(または組み合わせ)で仕事場を用意します。名前を覚える必要はありません。『環境がない』と『環境の作り方を選ぶ』は別問題だと知っておくと、開発者との会話が速くなります。
Dockerfile を使うときは、`environment.json` の `build.dockerfile` と `build.context` は `.cursor` フォルダ基準です(詳しい人向け)。`context` を省略すると `.cursor` になり、`.` / `./` / `..` はリポジトリルートを指す特別扱いです。`install` コマンド自体はプロジェクトルートで実行されます。
- Agent 主導のセットアップ(ガイド付き): Cloud Agents ダッシュボードまたは Desktop の Agents Window から始め、GitHub / GitLab / Azure DevOps / Bitbucket を接続し、依存の install に必要な Secrets 名だけを渡して Agent に仕事場を作ってもらう(公式の推奨。多くの場合10分以内のイメージ)
- 保存済みスナップショット: 一度整えた状態を使い回す。ダッシュボードで作ったスナップショット ID を `.cursor/environment.json` の `snapshot` フィールドに書いて固定することもできます(詳しい人向け)
- Dockerfile / .cursor/environment.json: リポジトリ側に環境定義を置く。プロジェクト全体を Dockerfile で COPY しないのが公式の前提です(Cursor がワークスペースを管理し、正しいコミットを checkout する)。Dockerfile を変えたときはレイヤーキャッシュで変更した層だけ再ビルドされ、毎回ゼロからではない、と公式にあります(詳しい人向け)。Dockerfile ベースではコンピュータ操作(画面確認)は Debian / Ubuntu 系 Linux が前提です。Enterprise では Cursor が Dockerfile を提案する private beta もあります(詳しい人向け)
- Cloud Agent Builds: 起動前に clone と install を済ませた型をバックグラウンドで作る(新環境では既定)
Cloud Agent Builds(事前に仕事場を温める)
公式の Cloud Agent Builds は、Agent が動く前にバックグラウンドで clone と依存の install を済ませた『起動可能な型』を作ります。下書き以外の環境では、自分では Builds をオフにできません。管理者が Require Self-Hosted Machines にしたチームだけは止まります。そのときの見方は、このレッスン末尾です(公式 Cloud Agent Builds)。新しい Agent は最新の成功 Build から始まります。毎回ゼロから npm install するより、起動が速く、いつも同じ道具立てから始めやすくなります。
ダッシュボードの Environments → 対象環境 → Builds タブで、Build の成功/失敗・ログ・開始時刻を確認できます。Agent の実行記録には、どの Build から起動したかも残ります。『前回と違う挙動』のときは、Version history だけでなく Build の履歴も見ると原因に近づけます。
新しい Build が失敗しても、最後に成功した Build が使われ続けます。依存の更新ミスで、いきなり全員の Agent が動かなくなる心配は小さくてよい、という公式の説明があります。Builds 自体に追加課金はなく、Cloud Agent に含まれます。
以前 Builds をオフにしていた環境も、いまは有効な Build と定期チェックの失敗が見えるようになっています。Trigger build のダイアログに『Builds がオフ』という警告は出ません(公式 Cloud Agents release notes、Week of Sep 28, 2026)。Test build は、設定を直したあとに本番の定期チェックを待たず試す入口です。
main(本線)で起動するとき、Build に記録されたコミットから始まることがあります。Builds タブの Update stale builds をオンにすると、Build が Staleness threshold(既定24時間)より古いとき、起動時に main の最新を取りに行きます。threshold を 0 にすると毎回最新を取りに行きます。オフのときは Build 作成時点の main に固定されます。
機能ブランチで起動するときは、Build で温めた依存の上に、選んだブランチのソースが載せ替えられます。ブランチ側で package.json など依存が変わったときは、Agent が install をやり直すことがあります。
- install: Build のたびに走る。依存の取得・コンパイル・キャッシュの温め。npm install / pnpm install のように、何度実行しても安全な書き方(冪等)がよい。ダッシュボードや古い資料では update script と書かれていることもありますが、いまの公式名は install(install スクリプト)です。Build 中も Agent と同じローカルソケットからエージェントメタデータを読んだり OIDC トークンを発行したりできる、と公式にあります(詳しい人向け)
- start: Agent 起動のたびに走る。Docker・DB・トンネルなど、サービスの起動。多くのリポジトリでは省略できます。Docker が必要なときは `sudo service docker start` を start に書く、という公式例があります
- terminals: Agent 起動のたびに tmux でアプリプロセスを起動し、Agent と共有するターミナルとして使う
- Test build: 設定を直したあと、定期チェックを待たずに試す
- Update stale builds: main のコードの新しさを Build 時点と起動時の pull で調整する
Build はいつ走るか
Build はバックグラウンドで次のようなきっかけで始まります。公式のライフサイクルは、きっかけ → clone と install → ディスクを型として保存 → 成功した Build が有効(active)になる → 新しい Agent がその型から起動、という流れです。
Builds タブでは、きっかけが4種類のラベルで表示されます。Recurring(定期チェック)・Configuration change(環境設定や Secrets の保存・変更)・Manual(Trigger build などの手動)・Agent-requested(環境直しを Agent に頼んだときなど)。名前を全部覚えなくて大丈夫です。『いつ・なぜ走ったか』の手がかりとして見れば十分です。
有効(active)な Build は、起動をさらに速くするためにあらかじめ温められたコピーが待機していることもあります。毎回 clone と install から始める必要が減る、という公式の説明です。
最初の Build がまだ1回も成功していない環境では、従来どおり Agent 起動のたびに clone と install が走ります。失敗した Build だけがあっても、いま動いている Agent の流れは止まりません。
- Recurring(定期): 型を定期的に作り直し、main のコミットを更新しやすくする
- Skipped(スキップ): Recurring だけの状態。main の新コミットも環境設定の変更も無いとき。install は走らず、有効な Build はそのまま。Success と Skipped が混ざるのは正常です
- Configuration change: 環境の版を保存したときや Secrets を変えたとき。必ず install が走ります
- Manual: Builds タブの Trigger build / Test build。手動で今すぐ試す。必ず install が走ります
- Agent-requested: Cloud Agent に環境直しを頼んだときなど、Agent 側から Build を頼むこともある
Builds タブでできること(概要)
詳しい人向けですが、Builds タブには Build ごとのきっかけ(trigger)・状態・開始時刻が並びます。Recurring / Configuration change / Manual / Agent-requested のどれで始まったかが分かるので、『なぜ今走ったか』の切り分けに使えます。
進行中の Build はキャンセルできます。下書き(draft)の Build を有効化したり、いま使われている Build をいったん止めたりもできます。
通常は『最新の成功 Build』から Agent が起動します。挙動を比べたいときだけ、特定の Build から Agent を起動する、という使い方も公式にあります。そのときの environment.json と設定は、その Build に記録されたものです。記録された設定で動きます(このレッスンの末尾)。Trigger build の隣から、Build が動くかを新しい Agent で見る入口もあります。出る条件は、下の Verify with Agent の節です。
Build と main の新しさ
Build は速く始めるための型ですが、main のソースが Build 作成時点に固定されることがあります。Update stale builds と Staleness threshold で、『いつ main を最新に取りに行くか』をチームで調整します。
Build が失敗したとき(ログと再現)
Builds タブには成功・失敗・進行中の Build が並びます。失敗した Build を開くと、イベントとログを読めます。新しい Build が失敗しても、Agent の起動は最後に成功した Build を使い続けるので、いきなり全員が動かなくなる心配は小さい、という公式の説明があります。
原因を特定するときは、失敗した Build から Agent を起動して、壊れた状態のまま調査させる方法もあります(詳しい人向け)。その起動の用意は、その Build に記録された設定です(末尾)。Fix Build なら、スナップショットが期限切れでも動きます。最新の成功 Build から起動し、失敗した Build のログを読みます。Dockerfile の失敗から起動すると、調査用の依頼文が入力欄に入ることがあります。スナップショットが消えた Build には Snapshot expired と出ます。有効化はできません。いま有効な Build を外すときは、代わりが無いと警告が出ます。ソース管理が一時的に届かないときは、連続3回失敗するまで自動のやり直しが続きます。自前の Git サーバー停止は、ソース管理の障害として出ます(公式 Cloud Agents release notes)。Builds タブの Trigger build や Test build で、設定を直したあとに再実行できます。
組み込みの Cursor Cloud MCP を使えば、Cloud Agent に『最新の失敗 Build を調べて Test build で直す』と頼む流れも公式例にあります。代表的な道具は list-environment-builds(Build 一覧)、environment-build-logs(install ログ)、trigger-environment-build(テスト Build の実行)、propose-environment-json(install / start コマンドの提案)、take-environment-snapshot / check-environment-snapshot(動いた環境の保存と完了確認)、request-environment-setup-actions(Secret 追加など、セットアップ待ちの依頼記録)です。普段は意識しなくてよく、詳しい人や Agent 自身が環境トラブルを直すときに使います(外部ツール MCP との接続節も参照)。
どの環境が選ばれるか(解決の優先順位)
同じリポジトリでも、環境の決まり方には順番があります。公式の解決順は、先に当たった方が使われます。
保存した環境があるときは、その環境に保存された設定で動きます。リポジトリの `.cursor/environment.json` を読むのは、その環境の『environment.json の場所』がファイルを指しているときだけです。新しく作った環境の場所は、最初 None(skip environment.json。ファイルを読まない)です。コミットしたファイルを使うなら、環境を作るときにその保管庫を選びます。指していない環境があるあいだは、ファイルがあっても3番には進みません。失敗したときの出方は、このレッスンの末尾です。
まだ保存した環境が無い保管庫で Cloud Agent を始めると、保管庫が1つのときは、コミット済みの `.cursor/environment.json` を調べます。中身が有効なら、新しくできる環境の場所がそのファイルを指します。そのあとの Agent と Build も、そのファイルを使います(公式 Cloud Environment Setup)。
Desktop で新しい Cloud Agent を始めるときは、この順番のあと『その保管庫の既定の環境』が使われます。同僚が保存した環境は、いまは先に選ばれません。Continue on Cloud では保存した名前が出ます。いつもの道具立てが使えず既定のイメージへ戻ったときは、会話の環境の行に警告が出ます(公式 changelog。first-cloud-agent 末尾)。保管庫も環境も選ばないときの仕事場は、このレッスンの末尾です。チームの既定の保管庫なしです。
Version history では、公開 API から保存した変更に API と付きます(公式 Cloud Agents release notes)。人が画面から直したのか、スクリプトから直したのかの見分けです。
Build の土台になる `.cursor/environment.json` は、環境がファイルを指しているときの話です。中身は環境の既定ブランチ(多くは main)が使われます。機能ブランチだけに追加・変更したときは、commit して push したうえで、そのブランチから Agent を起動してください(公式 Cloud Environment Setup)。特定の Build を選んで始めたときは、いまの environment.json ではなく、その Build の設定です(末尾)。
Builds が有効な環境では install(旧ダッシュボード名: update script)は多くの場合 Build の段階で済みます。Build が無い/失敗しているときは Agent 起動のたびに依存更新が走ることがあります。Enterprise で VM のメモリや CPU が足りないときは、サポートへ上限引き上げを相談できます(自己サービス設定は今後追加予定、と公式)。
- 1. 個人用に保存した環境
- 2. チーム共有の保存した環境
- 3. リポジトリの `.cursor/environment.json`(保存した環境が無く、保管庫が1つのとき)
どの環境で動いたか確認する
同じリポジトリでも、`.cursor/environment.json` の有無や警告付きの Environment ready などで、実行ごとに土台が変わることがあります。テストが通らない・スクショが付かないときは、コードより先に『いつもの仕事場か』を疑うと早いです。
公式では、Agent の実行画面で画面上部のリポジトリ名にカーソルを載せると、その実行で選ばれた環境と Version history を確認できます。実行記録には、どの Cloud Agent Build から起動したかも残ります。Cloud Agents ダッシュボードでも、環境名・Build 履歴・Version history を一覧できます。
環境のページに出る履歴は、その環境だけです。別の環境の保存は混ざりません。Duplicate をダブルクリックしても、コピーは1つです(公式 Cursor web release notes、Week of Oct 5, 2026)。
警告付きの『Environment ready』
保存したスナップショットが期限切れや読み込み失敗になると、Cursor は既定の土台へ戻して起動を続けることがあります。画面には『Environment ready (with warnings)』のような警告と、会話内の環境カードが残ります。
これは『Agent がサボった』ではなく、『いつもの道具立てが一時的に使えなかった』サインです。警告からセットアップを開き、詳しい人と環境を直すか、Version history から前の版を戻すかを相談しましょう。自動では古い版に切り替わりません。
ネットワーク制限
Cloud Agent がインターネットのどこへ届けるかも設定できます。全部許可、既定ドメイン+許可リスト、許可リストのみ、といった段階があります。ユーザー/チーム/環境ごとに決められ、環境に独自設定があるときはそちらが優先されます。
『パッケージが取れない』『外部 API に届かない』ときは、コードの問題ではなく通信制限のことがあります。はじめての方は『どのドメインが必要そうか』を言葉にして、詳しい人に渡すだけで十分です。
社内だけのサービスへ届けたいときは、Tailscale などのプライベート接続や、Enterprise 向けの Private Connectivity を組み合わせるチームもあります。公式の Cloud Environment Setup では、Tailscale は userspace networking モード(`tailscaled --tun=userspace-networking` とプロキシ変数)や、社内 VPC 向けの Cloudflare Tunnel(`cloudflared`)の例もあります。userspace networking では VM を tailnet の exit node にはできません(社内リソースへ届けば十分なことが多いです)。
Cloudflare Tunnel で社内 HTTP サービスへ届けるときは、社内ネットワークに `cloudflared` コネクタを置き、認証付きホスト名(例: vpc.example.com)をトンネル経由でプライベート先へ向けます。Cloudflare Access を使うなら、Secrets に `CF_ACCESS_CLIENT_ID` / `CF_ACCESS_CLIENT_SECRET` を入れ、HTTPS リクエストに `CF-Access-Client-Id` / `CF-Access-Client-Secret` ヘッダーを付ける公式例があります。プライベート TCP(データベースなど)向けには `cloudflared access tcp` を start に書き、ローカルリスナーへ向けるパターンもあります。トンネルトークンや Access の秘密はリポジトリに置かず Secrets に入れます(詳しい人向け)。
設定自体は詳しい人向けですが、『社内 VPN 内の API が必要』『Cloudflare Access 付きの社内ホスト名が必要』と伝えられるだけで会話が進みます。
許可リストを厳しくしたあと、スクショや動画などの成果物だけ付かなくなったときは、成果物のアップロード先ホスト(公式ドキュメントにある cloud-agent-artifacts の S3 ホスト)を許可リストへ足す必要があることがあります。`*.s3...` のような広いワイルドカードは、意図しない桶まで開けてしまうので避けます。一方、`*.example.com` のような許可リストは親ドメイン `example.com` 自身も含みます(公式 Cloud Agents release notes、Week of Sep 28, 2026)。『サブドメインだけ足したのに本体に届かない』と疑う必要は、いまは小さくなっています。
自前作業場(My Machines / Team Pool)では逆で、同じ成果物ホストへの通信を塞ぐと、アップロードだけ止まります。Agent の作業そのものは続きます(公式 Self-Hosted Machines / Secrets & Network)。『スクショを社外に出したくないが、コード直しは続けたい』ときの止め方です。Cloud machine の許可リスト不足と混ぜないでください。Enterprise の Lock Network Access Policy(ネットワーク方針のロック)も Cloud machine 向けで、自前作業場や Require Self-Hosted Machines で回した実行には届きません。自前側は作業場のファイアウォールや HTTPS プロキシで決めます。
Docker を使うリポジトリでは、公式の Cloud Environment Setup でも触れられています。単純な `docker run` なら Docker を入れてデーモンを起動するだけで動くことが多いです。一方、Cloud Agent の VM はコンテナの中で動くため、複雑な Docker 構成(ネストしたコンテナなど)では `fuse-overlayfs` や `iptables-legacy` などの追加設定が必要になることがあります(詳しい人向け。公式に Dockerfile 例あり)。
制限つき通信(許可を絞った Cloud Agent)で、広い CloudFront の配信が届かなくなったとき、Cursor に置いた保管庫の取得、実行中に通信の許可を変えたときの見方は、このレッスンの CloudFront の節です。最初から残るのは、公開の入れ物を取るためのホストだけです。ほかのドメインは許可リストへ足します(公式 Cloud Agents release notes、Week of Oct 19, 2026)。用意されている既定の環境がルート証明書を信用しなくなった話は、証明書の節です。自前作業場を Desktop から開く入口は、このレッスンのライブの作業場の節です。
モデルとコンテキスト窓(はじめて向け)
手動で Cloud Agent を起動するときは、使うモデル(AI の頭脳)を選べます。Cloud Agent が使えるモデルは、公式が選んだ一覧から選ぶ形です(curated selection)。Auto を選ぶと、その依頼に向くモデルを Cursor が振り分けます。Teams / Enterprise では裏側が Cursor Router で、Optimize For(Cost / Balance / Intelligence)だけ決めます(accounts-setup の Auto 節。公式 Cursor Router)。
Web や Desktop では、対応モデルについてコンテキスト窓(一度に読める文脈の大きさ)も選べます。大きいほど長い会話や大きなリポジトリを一度に扱えますが、トークン消費とコストが増えやすい点に注意しましょう。Grok 4.7 の通常は 256k、必要なら 500k です。入力が 256k を超えたときだけ割増(標準は2倍、Fast は3倍)で、入力が短ければ長い窓を選んでいても定価のままです。500k の窓と、この割増が公式に書いてあるのは Grok 4.7 だけです。Grok 4.6 と Grok 4.5 のページには、この窓も割増もありません(公式 Grok 4.7 / Grok 4.6 / Grok 4.5。accounts-setup)。
いまの会話がいっぱいかに近いかは、入力欄の横のリングでも見られます。クリックすると内訳が出ます。モデルの窓サイズを変える話とは別に、まずリングで空きを見ます(prompting のコンテキストのリング節。公式 Prompting)。
Automations でもモデルは選べますが、コンテキスト窓の切り替えはなく、常にそのモデルの最大窓で動きます(公式)。Gemini 4 Argon の最大は 1M(通常 200k)、Muse Wonder の最大も 1M(通常 300k)です。Gemini 3.8 Flash と Gemini 3.1 Pro の最大も 1M です。3.1 Pro は入力が 200k を超えると単価が上がるので、定期実行の最大窓はその条件に入ります。この4つを定期実行に選ぶと、手動の通常窓より大きい窓で動きます(公式 Gemini 4 Argon / Muse Wonder / Gemini 3.1 Pro。見分けは accounts-setup 末尾)。そのため、手動起動よりトークンを使いやすい、という注意があります。定期実行の Prompt は短く、完了条件を明確にすると節約になります。Start プランには Auto も Automations もありません。新しい契約の Plus も同じで、Automations は Premium 以上です(accounts-setup 末尾)。
Secrets の扱い
API キーやトークンは、コードやチャットに貼らず、Web の Cloud Agents 設定(cursor.com/dashboard/cloud-agents)の Secrets へ入れます。スマホアプリからは主に使う側で、秘密情報の登録や環境そのものの編集は Web 側の作業です。
Secrets には種類があります。上の図のとおり、はじめての方は『漏れたくない値は Runtime Secret』と覚えるだけで十分です。迷ったら Runtime Secret を選びましょう。
- Runtime Secret(旧称 Redacted): 作業には使うが、会話・ツール結果・コミット文面には `[REDACTED]` と伏せる。API キー向け
- Environment Variable: Agent にも見える設定値。公開 URL やフラグなど、読ませてよいもの向け
- Build Secret: Dockerfile のビルド時だけ使う鍵。実行中の Agent には渡らない
Secrets を環境やモノレポで分ける
複数リポジトリを束ねた環境では、その環境だけに効く Secrets(環境スコープ)も使えます。ステージング用の鍵を、別プロダクトの実行へ漏らしたくないときに便利です。どこで見るかは、末尾の環境のページの秘密です。
1つのリポジトリの中に `.env.local` が複数ある(フロントと API など)ときも、Secrets タブへまとめて入れます。名前がぶつかるキーは `NEXTJS_*` と `CONVEX_*` のように接頭辞を付けて区別し、各アプリから参照させます。スナップショット作成時に `.env.local` を含めると保存されることもありますが、管理しやすさでは Secrets タブが公式の推奨です。
Secrets タブが見えないとき
Secrets の追加・編集は、主に cursor.com/dashboard/cloud-agents の Secrets タブ(Cloud Agents 設定)で行います。モバイルアプリは設定の正ではなく、すでに登録済みの Secrets を Agent が使うイメージです。
タブ自体が見えないときは、Cloud Agent 用の権限やチームロールが足りないことが多いです。値を入れたいだけなら、チーム管理者か詳しい人に『Runtime Secret で(名前だけ)を登録してほしい。値は別経路で渡す』と依頼すれば十分です。環境だけの鍵は、全体のタブではなく、その環境のページの欄です(末尾の環境のページの秘密)。
Secrets を足したあと
新しい Secrets を登録した直後、すでに動いている Agent には反映されないことがあります。公式のトラブルシュートでは、Secrets 追加後に Cloud Agent を再起動(新しい実行を始める)することを案内しています。
秘密を直す画面で All repositories(すべての保管庫)を選んで保存すると、その値は見える保管庫の全部に入ります。1つだけにしたいときは、保管庫を指定してから保存します(公式 Cursor web release notes、Week of Oct 5, 2026)。
チーム/ワークスペースを間違えていないかも確認しましょう。Secrets はチーム単位で、別アカウントに入っていると見えません。
起動先でも届き方が変わります。Cloud machine ならダッシュボードのチーム/利用者/環境 Secrets が使えます。My Machines には届かず、手元 PC にある鍵だけです。Team Pool は、管理者が Secret sync をオンにし、作業場を `--sync-dashboard-secrets` で起動しているときだけ、チーム/利用者分が届きます(環境スコープと Build Secret は対象外。Create An Agent の envVars は届く。公式 Choose where Cloud Agents run / Self-Hosted Machines)。鍵が要る仕事は、はじめては Cloud machine のままが安全です。
ログインが必要な画面を見せたいとき
会員ページや管理画面など、ログイン後にしか見えない変更は、Agent にもログイン情報が必要です。手元で使っているテスト用のユーザー名/メール/パスワードを Secrets に入れます(本番の個人アカウントは避けます)。
アプリが TOTP 形式の 2FA(認証アプリの6桁)を使うなら、その共有秘密(shared / root secret)も Secrets に入れられることがあります。公式例では Agent が `oathtool --totp -b "$TOTP_SECRET"` のように6桁を生成します。詳しい人が設定する前提で、『ログイン後画面の確認まで進めたい』と伝えるだけで十分です。値そのものはチャットに書かないでください。
AGENTS.md:Cloud 向けの作業メモ
Cloud Agent はリポジトリの `AGENTS.md` も読みます。公式は、見出し例として `Cursor Cloud specific instructions` を置き、起動や確認の手順を書いておくことを勧めています。
はじめての方でも、『プレビューの開き方』『触ってほしくない範囲』『完了時に欲しい成果物』を箇条書きで提案できます。長くなりそうなら、詳細ファイルへのリンクでも大丈夫です。Rules(いつも守る約束)と併用できます。
外部ツール(MCP)との接続
Cloud Agent は MCP という接続口で、社内ツールやデータベースなどへ手が届くことがあります。追加や管理は主に Web(cursor.com/agents の MCP、またはチームの Integrations)側です。スマホでは『この実行でどれを使うか』を選ぶイメージです。
接続の仕方には HTTP(推奨)と stdio があります。Cloud Agent はどちらも公式サポートし、OAuth が必要な MCP サーバーにも対応しています(接続は Integrations や起動時の MCP 選択で行い、チーム共有でも利用者ごとの認証が必要なことがあります)。HTTP のほうが、鍵やトークンが Agent の作業用コンピュータに直接渡らず安心です。stdio は作業場の中で動く方式で、環境が整っていないと失敗しやすいです。SSE や mcp-remote 方式は Cloud Agent ではサポートされません。stdio を使う場合、起動してみないと成功可否が分からないこともある、という公式の注意もあります。詳しい人に『HTTP でつなげるか』と聞くだけで十分です。
MCP 設定を保存したあと、環境変数(env)・HTTP ヘッダー・OAuth の CLIENT_SECRET など敏感な項目は、誰も画面から読み戻せません(暗号化保存)。値を失念したときは、詳しい人と一緒に作り直す必要があります。
OAuth が必要な MCP(Figma や Linear など、固定の Client ID を使うもの)は、戻り先 URL が Desktop と Web / Cloud Agent で違います。Desktop は `http://localhost:8787/callback`、Web と Cursor Agents は `https://www.cursor.com/agents/mcp/oauth/callback` です。片方だけ許可していると、手元ではつながってもブラウザや Cloud Agent ではログインに失敗します。両方使うなら、MCP 側の OAuth アプリに両方を登録します(公式 MCP)。
Figma や Linear のように、MCP 側が固定の Client ID を渡し、戻り先 URL の許可リストを求めるときは、動的な登録ではなく mcp.json の `auth`(CLIENT_ID、必要なら CLIENT_SECRET と scopes)でつなぎます。公式は静的 OAuth と呼んでいます。CLIENT_SECRET はリポジトリに直書きせず、`${env:…}` で環境変数から読むのが公式の案内です。はじめての方は『固定の Client ID と、Web / Desktop 両方の戻り先 URL で静的 OAuth』と詳しい人に伝えれば十分です。CLI なら `agent mcp login (名前)` でも同じ設定のログインを進められます(公式 MCP / CLI MCP)。
チーム共有の MCP は、管理者が Default team marketplace へリンクしておくと、Cloud Agent からも使え、同僚が Agent Window / IDE / CLI へ入れる形にもできます。OAuth が必要な MCP は、チーム共有でも接続は利用者ごとです。
加えて、実行診断用の『Cursor Cloud MCP』が組み込まれています。いまの実行の状態、同じ環境の他の実行、会話ログ、環境設定、セットアップログ、実行イベント(setup_failed / pr_creation_failed / artifact_created など)、Build 履歴と install ログなどを Agent 自身が調べるための道具です。Build が失敗したときの節で触れた list-environment-builds / environment-build-logs / trigger-environment-build / propose-environment-json / take-environment-snapshot / check-environment-snapshot / request-environment-setup-actions も、この診断用 MCP の一部です。
公式の典型的な調査の流れは run-info(いまの実行)→ get-events(イベント一覧)→ environment-info(環境の版と設定)→ list-cloud-agents / batch-fetch-details(他の実行)です。list-cloud-agents では起動元・状態・日付・コード変更の有無・PR 作成の有無に加え、archived(アーカイブ済み)かどうかでも絞れます。古い失敗実行を除いて『いま動いている実行だけ』を見たいときに便利です。他の実行のダッシュボードイベントまでまとめて見るときは、batch-fetch-details の include_events を使います(1回最大50件)。batch-fetch-details では、コードを変えたか・PR を開いたかといった差分メタデータも取れます。Automation の実行を追うときは get-automation もあります。Subscriptions や Automations で『待っているのに動かない』ときは、get-message-queue で未処理のフォローアップが残っているかも確認できます。普段は意識しなくてよく、トラブル時に詳しい人が使うイメージで十分です。一般メンバーは自分の実行だけです。チーム管理者は、自分が開ける保管庫と環境の範囲なら、他の人の実行と会話も読めます。Service account 名義の Automation が使うサービスアカウントも、一般メンバーと同じ閲覧ルールに従います。チーム管理者は Dashboard の MCP 設定から、この診断用 MCP を無効にすることもできます。
MCP クライアントによっては、道具名の前に cursor-cloud- のような接頭辞が付いて見えることがあります(例: cursor-cloud-run-info)。中身は同じ道具です。
会話の名前が分かりにくいときは、いまの実行に『この会話の名前を『(短い題)』にして』と頼めます。Cursor Cloud MCP の rename-chat が一覧(cursor.com/agents)と会話の見出しを付け直します。公式の上限は 200文字で、いま見ている実行だけです(公式 capabilities)。
MCP の認証に失敗したときは、ダッシュボードの実行イベントに `mcp_auth_error` と出ることがあります(くわしくは次の節)。道具の呼び出しが、サインインに無い権限の名前で拒まれたときの案内は、このレッスンの、権限の名前が載る案内の節です。メールと予定表の道具の直しは、末尾の Gmail の節です。表を別のつながっているアカウントでやり直す話は、表の節です。引数のよくある間違いを直す話は、いちばん末尾です。認証失敗の記録とは別です。
はじめての方としては、『Agent に触らせてよい外部サービスはどれか』をチームで決めておくことが大切です。よく分からない接続は、詳しい人に確認してからオンにしましょう。
公式 MCP には Apps という拡張もあります。道具の結果といっしょに、会話の中へ触れる画面(UI)を出せます。画面が出ない環境でも、同じ道具はふつうの返答として動く、という公式の説明です(プログレッシブエンハンスメント)。はじめての方は『MCP の道具が表やボタンを出してきた』ときの名前だと覚えれば十分です。自分で MCP Apps を作る必要はありません。
MCP のサーバーが途中で『追加の入力が欲しい』と聞いてくる動き(Elicitation)もあります。壊れたのではなく、公式がサポートする確認の一種です。聞かれた内容が分からなければ、そのまま進めず詳しい人にサーバー名を伝えてください(公式 MCP)。
会社の Enterprise では、管理者が『どの MCP を使ってよいか』を MCP Allowlist で決めます。場所は Team Settings → MCP Configuration(Plugins & MCPs からも入れます)。Allowlist は『使ってよい設定を承認する』だけで、サーバーを全員に配ったり自動で入れたりはしません。stdio はコマンドの型、HTTP / SSE は URL の型で許可します。道具の許可リストを空にすると、そのサーバーの道具は全部自動実行の対象です。絞ると、許可した道具だけ自動で、他は確認が入ります(公式 MCP)。
Plugins ページでは、管理者が Team list の強制をオンまたはオフにできます。URL の MCP やプラグインは、詳細のダイアログでライブプレビューから使ってよい道具だけを選べます。MCPs タブの Allowlist rules には、Team list がオンのときだけ効くルールに印が付きます。各サーバーには Read-only や Cloud only のような状態が出て、マウスを載せると IDE や CLI で止まる理由が分かります。Plugins & MCPs は、入っているプラグインと MCP が1つの検索できる表です。名前を押すと別ページではなくダイアログで詳細が開きます。途中まで止まった SharePoint の接続は、管理者が Integrations で委任かアプリの権限、テナント、管理者の同意、必要なら書き込みを終えます。メンバーがプラグインを足しても、途中なら管理者へ聞く案内になります(公式 Cursor web release notes、Week of Oct 5, 2026)。
手元の stdio MCP には、通信の範囲(全部許可 / 許可リスト / 全部拒否 / sandbox なし)もあります。管理者が『自分で MCP を足してよい』にしているときは、管理者の型に入らない接続先を User MCP Network Denylist で止められることがあります。会社で MCP が灰色やエラーになるときは、まず管理者に Allowlist を確認してもらってください。
同じ MCP Configuration には、Enterprise 向けのブラウザ制限もあります。『browser features』をオンにしたうえで、Browser Origin Allowlist(v2.1+)に自動で行ってよいサイトを足します。空なら全サイト可。例は `http://localhost:3000` や社内ホストです。制限されるのは自動の移動と MCP 道具で、人が手動で開くのは可です。ただし許可外のサイトにいるあいだは、クリック・入力・移動などのブラウザ道具は止まります(手動で開いたあとも同じ)。許可外へリンクやリダイレクトで行くことは止めきれない、と公式は注意しています。画面が出ないときは、組織ごとに有効化が必要です。Cursor の担当へ依頼してください(公式 Browser)。
stdio の MCP は、鍵を mcp.json に直書きせず `envFile`(例: `.env`)から読めます。HTTP / SSE の遠隔サーバーには `envFile` は使えません。そのときは `${env:…}` です。ファイルを Git に入れないでください(公式 MCP)。
ダッシュボードの実行イベントを読む
Cloud Agent の実行画面(cursor.com/agents やダッシュボード)には、公式のイベント一覧があります。会話の要約だけでは分からない『どこで止まったか』を、短い kind 名で確認できます。
- setup_started / setup_completed: 仕事場の準備が始まった/終わった
- setup_failed: 仕事場の準備に失敗。Builds タブや setup ログを開き、install / start のエラーを直す
- setup_started のまま長く止まる: Secret 追加などのユーザー操作待ちのことがあります。会話に request-environment-setup-actions の記録が無いか確認し、Secret 名だけを管理者へ伝えて対応後に続きを頼みます
- pr_created: Pull Request が開けた
- pr_creation_failed: PR 作成に失敗。GitHub 連携の PR 権限・ブランチ保護・対象ブランチを確認。差分は残っていることが多い
- artifact_created: スクショや動画などの成果物がアップロードされた。Agent 画面の成果物欄や PR(設定次第)を開く
- mcp_auth_error: MCP 認証失敗。その MCP だけスキップされ実行は続く。Integrations で再接続するか MCP 選択から外す
- 権限の名前つきの案内: 道具の呼び出しが、サインインに無い権限の名前で拒まれたとき。失敗の代わりに出る。mcp_auth_error とは別。切り分けは権限の名前が載る案内の節。メールと予定表の直しは末尾の Gmail の節。表を別のつながっているアカウントでやり直す話は表の節。引数のよくある間違いを直す話はいちばん末尾
はじめての方ができる貢献
環境そのものの作成は、詳しい人が担うことが多いです。あなたは、『どの外部サービスが必要か』『プレビューで何ができれば十分か』『Secrets に入れるべき値の名前(値そのものではない)と種類(Runtime Secret か)』『AGENTS.md に書いてほしい確認手順』を言葉にすることで、十分に貢献できます。
データはどれくらい残るか(はじめて向け)
Cloud Agent の実行では、だいたい2種類のデータが残ります。会話履歴(依頼文・返答・ツール結果・成果物)と、環境スナップショット(仕事場のディスクの型)。公式の retention(保持)の要点だけ押さえておくと、不安が減ります。
会話は既定で無期限です。使わない環境スナップショットは、30日で消えるのが上限です。起動や再開のたびに、期限がまた30日伸びます。プランや保持の方針では延びません。一部の Enterprise では、会話だけを90日で消す方針を選べますが、スナップショットの30日は変わりません(公式 Secrets & Network)。
- 会話履歴: 既定では無期限。あとから見返したり、続きを頼めたりするためです
- 環境スナップショット: 使われない状態が最大30日続くと、自動で消えます。30日で消える、が上限です。起動や再開のたびに、期限がまた30日伸びます。プランや保持の方針では延びません
- Enterprise: 一部のチームでは、管理者が会話の保持を『無期限』か『90日』に決められます(早期アクセス)。90日にすると、その期間より古い会話は削除されます。無期限に戻しても、すでに消えた会話は戻りません。この90日は会話の話です。スナップショットは30日のままです
- 明示削除: Delete Agent API などで会話を消せる場合があります。スナップショットはオンデマンドでは消えず、上記の30日ルールに従います
- 画面の名前: Privacy Mode(no training)は学習に使わない今のモード。Legacy(no storage)は保存しない旧モード。個人プランから仲間を招待するとき、Share Cursor Analytics にチェックを入れると新しいチームのプライバシー設定が変わり、入れなければ Privacy Mode のままです(公式 Cursor web release notes、Week of Oct 5, 2026)
OIDC トークンとエージェントメタデータ(詳しい人向けの概要)
はじめての方は、名前だけ知っておけば十分です。いずれも Cloud Agent の作業用コンピュータ内のローカルソケット(`CURSOR_AGENT_SOCKET`、既定は `/run/cursor/api.sock`)から読み取る公式の仕組みで、OIDC トークン発行とエージェントメタデータ取得が同じ入口を共有します。
OIDC トークンは、短い有効期限(約5分)の署名付き JWT を作業用コンピュータ内で発行し、AWS IAM の AssumeRoleWithWebIdentity や社内 API などへ『この実行だ』と証明するための道具です。長期の API キーを Secrets に置きたくないとき、詳しい人が使います。GCP Workload Identity Federation、Azure 連携、Vault など OIDC 対応の検証先でも同じ流れです。Agent に『OIDC トークンの公式手順に従って接続して』と頼む流れも公式にあります。
AWS 向けの公式例では、Secrets に `CURSOR_AWS_ASSUME_IAM_ROLE_ARN`(引き受ける IAM ロールの ARN)を入れ、チーム設定で External ID を発行し、AWS 側の信頼ポリシーを合わせると、Agent 起動中は `AWS_PROFILE=cursor-cloud-agent`・`AWS_CONFIG_FILE`(Cursor 管理の設定ファイル)・`AWS_SDK_LOAD_CONFIG=1` が自動設定され、長期の `AWS_ACCESS_KEY_ID` を自分で export しなくても AWS CLI / SDK が動く、と説明されています(管理者・詳しい人向け)。STS の一時認証情報は1時間で失効し、Agent が再開するときは失効15分前から自動更新される、とも公式にあります。
エージェントメタデータは、Agent ID(`agent/id`、bcId)、ダッシュボード名(`agent/name`)、起動元(`agent/source`:WEBSITE / API / SLACK / AUTOMATIONS など)、実行基盤(`agent/runtime` は Cursor 管理 VM では `managed`)、所有者(`owner/user-id` / `owner/team-id` / 必要なら `owner/service-account-id`)、いまのターンを送った人(`turn/user-id` など)、このターンの ID(`turn/id`。`agent/id` とは別)、ターン開始時刻(`turn/started-at`)、このターンで動いたモデル(`turn/model`。Auto を選んでも実名が入る)、保管庫(`workspace/repo-url` は主リポジトリ、`workspace/repo-urls` は複数行で全保管庫。主リポジトリが先頭で残りはソート)、ブランチ、環境 ID、Automation ID(`workspace/automation-id`)などをキーと値で読む仕組みです。Hooks や install スクリプト、ログのタグ付けに使います。
team follow-ups では、所有者(`owner/user-id`)と、このターンを送った人(`turn/user-id`)が違うことがあります。公式例では、追記者が所有者と違うときに別の監査パスを通す、といった使い方があります。
`turn/` 配下(`turn/id` / `turn/user-id` / `turn/model` / `turn/started-at` など)は、コーディングターンが動いている間だけ存在します。ターンとターンのあいだは `turn/` 自体が消え、404 になります。Hooks で読むときはターン中だけ値があり、ターンをまたいでキャッシュしない、と公式は注意しています。
起動直後にソケットがまだ無いときは、接続を再試行します。読み取りエラーは 403 が致命的(再試行しない)、429(rate_limited)/ 503(saturated・同時接続が多すぎる)/ 500 / 502 / 504 は Retry-After を見てバックオフで再試行、という公式の整理があります(429 は1分あたり120回・最大20件のバースト上限。ソケットへの同時接続は最大8で、OIDC 発行と共有されます)。
所有者や送信者のメール(`owner/user-email` / `turn/user-email`)も読めますが、許可リストには変わりにくい `owner/user-id` を使うのが公式の推奨です。ソケットに届くプロセスは全キーを読めるので、メタデータを秘密情報の代わりにしないでください。
メタデータに署名はなく、認証情報の代わりには使いません。クラウドへ ID を証明したいときは OIDC トークンを使い、『誰がこのターンを送ったか』『どのモデルが動いたか』などはメタデータから読む、と公式は整理しています。エージェントメタデータはプレビュー段階の公式機能です。
VM の外から Agent を作る Cloud Agents API や SDK で付ける metadata タグとは別物です。API キーで外から管理するタグと、作業用コンピュータ内の実行メタデータは混同しないでください。
Agent に読ませたいときは、公式の metadata / identity ページの手順を Prompt に含める形が推奨されています(例: 『エージェントメタデータを読むには https://cursor.com/docs/cloud-agent/metadata の手順に従って』)。
管理者・詳しい人に頼むときの型
公式も、環境づくりは Agent 主導のセットアップを推奨しています(ダッシュボードや Agents Window から始め、あとでスナップショット保存)。ダッシュボードでは Update with Agent(いまの環境を直す)、New Setup Run(いちから組み直す)、Version history の Restore(前の版に戻す)も選べます。あなたがコードを書かなくても、次の一文で依頼を始められます。
- やりたいこと: Cloud Agent がプレビュー(またはテスト)まで自分で確認できるようにしたい
- 対象リポジトリ: (名前)
- 必要な外部サービス: (例: プレビュー用 API、画像配信、なし)
- Secrets に入れたい名前だけ: (値はチャットに書かない。漏れたくない値は Runtime Secret。ログイン用や環境スコープの要否も一言)
- お願い: Agent 主導セットアップ → 動いたらスナップショット保存 → できれば `.cursor/environment.json` と AGENTS.md の Cloud 節もリポジトリへ
会話に載せたくないファイル(.cursorignore)
鍵は Secrets タブ(漏れたくない値は Runtime Secret)が本線です。それでも保管庫に `.env` や証明書が残ることがあります。公式 Ignore file では、保管庫の一番上の `.cursorignore` で、Agent・Tab・@ 指定から外します。.gitignore と同じ書き方です。
公式の注意として、ターミナルと MCP はこのリストをすり抜けます。『書いたら絶対に触れない』ではありません。会話の文脈に載せない、が主な効果です。完全な防護は保証されない、とも書いてあります。
- 例: `**/.env`、`**/.env.*`、`**/credentials.json`、`**/*.pem`。コメントは `#`
- 全プロジェクト共通なら Cursor Settings → Indexing → Ignore Files(グローバル)。空が既定
- `.gitignore` に書いてあるものも、既定で索引の対象外。`!` で戻せる
- ターミナルと MCP は止めきれない。鍵は Runtime Secret。保管庫ごと外すなら repository blocklist(accounts-setup)
自前作業場では environment.json を読まない
Cloud machine の仕事場は、リポジトリの `.cursor/environment.json` とダッシュボードの環境設定(install / start / Dockerfile / スナップショット / ネットワーク)で決まります。自前作業場(My Machines / Team Pool)では、公式どおり環境から使うのは保管庫の一覧だけです。`.cursor/environment.json` は読まれません。
だから『environment.json に書いたのに My Machines で install が走らない』は壊れではなく、公式の切り分けです。代わりの置き場は作業場側です。Linux のマシンなら、Desktop からファイルとターミナルを開く入口もあります。条件は、このレッスンのライブの作業場の節です。
- install / start / terminals: 作業場の `.cursor/hooks.json` の sessionStart、Team Pool なら `--on-session-start`、またはワーカーのイメージ
- Dockerfile / スナップショット / Builds: 作業場そのもの、または温めてあるワーカー
- ネットワーク許可リスト: 作業場のファイアウォールや HTTPS プロキシ。Enterprise の Lock Network Access Policy は届かない
- 環境スコープの Secrets と Build Secret: 届かない。Team Pool の鍵は Secret sync。My Machines は手元の鍵
- MCP の環境ごとの上限: 無い。チームの MCP が毎回使える
MCP のログインがループするとき
MCP のログイン画面が何度も出るときは、押し直す前にメッセージを読みます。会社の管理者が止めたときと、ログイン期限が切れたときでは、次の一手が違います(公式 changelog 3.24)。
Google Workspace や Microsoft Entra の管理者ポリシーで止められている、と出たら、ボタンを連打せず管理者に許可を頼みます。Slack、Supabase、Make、HubSpot でログイン期限切れと出たら、一度だけ再接続します。同じ失敗を繰り返す状態ではなくなっています。
Microsoft の MCP は、どのアカウントで入るかを選ぶ画面が出ます。会社と個人を取り違えないでください。MCP 側が自分のパソコン向けの戻り先 URL を拒否するときは、Cursor が用意した戻り先のページでログインできます。別の Cursor の窓が手元の戻り先ポートを使っていても、ログインは完了します(公式 changelog 3.24)。
Desktop と Web で戻り先 URL が違う話は、このレッスンの MCP 節のままです。実行ログの mcp_auth_error は、その MCP だけがスキップされ、仕事自体は続きます。道具の呼び出しが権限の名前で拒まれた案内は、権限の名前が載る案内の節です。メールと予定表の道具の直しは、末尾の Gmail の節です。表を別のつながっているアカウントでやり直す話は、表の節です。引数のよくある間違いを直す話は、いちばん末尾です。ログイン画面の連打とは別です。
- 管理者ポリシー(Google Workspace / Entra): 連打せず、許可を頼む
- Slack / Supabase / Make / HubSpot の期限切れ: 一度だけ再接続
- Microsoft の MCP: アカウント選択が出る。会社と個人を混ぜない
- パソコン向けの戻り先を拒否する MCP: Cursor の用意した戻り先ページで入れる
- 別の Cursor の窓が戻り先ポートを使っていても、ログインは完了する
environment.json のコメントは設定として効く
`.cursor/environment.json` に `//` やブロックコメント、末尾のカンマを書いても、いまの公式はどこで読んでも設定として扱います。コメント付きのファイルがある保管庫は、「環境をセットアップしてください」と促されなくなりました。スナップショットやネットワークの設定も、黙って無視されず適用されます(公式 Cloud Agents release notes、Week of Oct 5, 2026)。
以前はコメントがあると、ファイルが無いのと同じ扱いになり、設定したつもりが効かないことがありました。メモをコメントで残してよい、と覚えてください。自前作業場(My Machines / Team Pool)が environment.json を読まない話は、上の節のままです。こちらは Cloud machine の話です。
複数の保管庫を束ねた環境では、Build が各保管庫の SSH の接続先を先に HTTPS へ直します。その Build から始まる Cloud Agent は、最初の返事が早くなりやすい、という公式の改善です。全員に開放されています。
MCP が回数の上限(レート制限)を返したとき、その道具だけ、サーバーが指定した時間だけ休みます。ほかの道具は使い続けます。いつ再試行できるかも Agent に伝わります。Slack の上限が続くときは、待ちがおよそ1分で頭打ちになります。MCP のサーバーが再起動したあとの道具呼び出しは、失敗のままにせず回復します。引数がおかしいときは、理由が具体的に出ます。Gmail の道具だけが回数で止まったあとの待ち方と、Google カレンダーが権限不足のときに出す案内は、末尾の Gmail の節です。Slack のおよそ1分とは別です。スプレッドシートを別のアカウントでやり直す話は、表の節です。Slack、Google スプレッドシート、Airtable、Jira のよくある引数の間違いを自動で直す話は、いちばん末尾です。理由が具体的に出る話とは別です。
- `//` とブロックコメント、末尾のカンマは、environment.json のどこで読んでも有効
- コメント付きでも「環境をセットアップしてください」とは出ない。スナップショットとネットワーク設定は適用される
- 自前作業場は今までどおり environment.json を読まない
- 複数保管庫の Build は SSH を先に HTTPS へ直すので、最初のターンが早くなりやすい
- MCP の上限: その道具だけ休む。ほかは続く。Slack の待ちはおよそ1分まで
- MCP の再起動後は道具が回復する。引数の誤りは理由が出る
環境はスクリプトからも作れる(Environments API)
ダッシュボードで作る「保存した環境」を、スクリプトからも作ったり直したりできるようになりました。公式はベータです。画面の環境設定からも、スクリプトで同じ仕事をする入口があると案内されています(公式 changelog / Cloud Agents API / Cloud Agents settings)。はじめての方は自分で API を叩かず、名前とエラーの読み方だけ知っておけば十分です。
1つの環境に入れられる保管庫は最大300です。起動時に保管庫を直接指定するときも、公式の上限は300です。保管庫の一覧を空にすると、保管庫の無い環境になります。大きな環境の読み込みは、公式の発表では5倍速くなりました。300を目指す必要はありません。触ってよい保管庫を先に決める習慣は、repository の複数リポジトリの節のままです。他のチームからアクセスを許された Origin を、画面の一覧から同じ環境へ足す話は、このレッスンの共有された Origin の節です。
名前は、その持ち主(個人かチーム)の中で重複できません。同じ名前だと environment_name_conflict です。エラーに、すでにある環境の ID が入ることがあります。接続から届かない保管庫は repository_access です。設定の中身が壊れていると validation_error です。
名前と設定を同時に直すときは、両方成功するか、両方そのままです。設定の更新は environment.json の全体の置き換えです。一部だけ足す書き方ではありません。削除は取り消せません。
一覧に出ないものがあります。下書き、削除済み、そしてメンバー個人の環境(チーム管理者の一覧には出ません)。チーム環境は、その中の保管庫を全部開ける人だけが見えます。チーム管理者と、サービスアカウントの鍵は、チーム環境を全部見ます。特定の保管庫だけに限ったサービスアカウントの鍵は、保管庫があり、かつその範囲に収まる環境だけです。
権限の確認が時間切れになると、一覧から一時的に抜けることがあります。もう一度取りに行くと出ます。並びは最終更新が新しい順です。ページを送っているあいだに更新された環境は先頭へ戻り、後ろのページで抜けたり、別の環境が繰り返されたりします。1ページは既定20件、最大100件です。続きの印が無くなるまで次を見ます。印が無いときは、空の値ではなく項目ごと出ません。設定の中身は、一覧ではなく1件を開いたときに見ます。
- ベータ。画面で作る環境と同じものを、スクリプトから作る・見る・直す・消す
- 保管庫は最大300。空なら保管庫なし。大きな環境の読み込みは5倍速くなった、という発表
- 同じ名前: environment_name_conflict。届かない保管庫: repository_access。壊れた設定: validation_error
- 更新は設定全体の置き換え。名前と設定は両方成功するか両方そのまま。削除は取り消せない
- 一覧に無い: 下書き、削除済み、管理者から見たメンバー個人の環境。チーム環境は中の保管庫を全部開ける人だけ
- 時間切れで一時的に抜けることがある。続きの印が無いところまでページを送る
自前を必須にすると、クラウドの Build は止まる
下書き以外の環境では、ふだん自分では Builds をオフにできません。例外は、管理者が Require Self-Hosted Machines(Cloud Agent を全部、自前作業場へ回す)にしたチームです。Build は Cursor が用意するクラウドのマシンで走るので、そのチームでは止まります(公式 Cloud Agent Builds)。
止まる範囲は、チームの環境だけではありません。メンバー個人の環境も、Cursor は Build しません。Builds タブには environment builds are turned off と出て、Trigger build は出ません。環境スナップショットの保存も、そのチームとメンバーからは拒否されます。自前作業場で動いている実行からも、スナップショットは保存できません。自前作業場の実行は、そのマシンのいまの状態から始まります。温めた Build からは起動しません。
すでに Cursor のクラウドで走っていた Agent は、追記を受け付けなくなります。画面は、自前作業場で新しい Agent を始めるよう案内します(公式 Cloud Agents release notes、Week of Oct 12, 2026)。当時の画面名は Require Private Workers for All Cloud Agents です。いまの公式の設定名は Require Self-Hosted Machines です。全部を自前へ回す、という同じ種類の設定なので、英文がどちらでもこの節を見てください。
自前のマシンが落ちたときも、クラウドの Build へは戻りません。プールのマシンが作業中に落ちると、Agent はその同じマシンが戻るまで待ち、戻ってから続きをします。別のマシンへ移るのは、そのあとです。切れている My Machines へ起動したり追記したりすると、何分も待たず、およそ15秒で machine-offline と出ます(公式 Cloud Agents release notes、Week of Oct 12, 2026)。
- Require Self-Hosted Machines: チームの環境も個人の環境も Build しない
- Builds タブ: environment builds are turned off。Trigger build は出ない
- スナップショット保存: そのチームとメンバー、および自前作業場の実行からは拒否
- クラウドで走っていた Agent: 追記は止まり、自前作業場で新しい Agent を始める
- プールが落ちた: 同じマシンが戻るまで待つ。戻らなければ別のマシン
- 切れた My Machines: およそ15秒で machine-offline
environment.json は、指しているときだけ読む
保存した環境には、『environment.json の場所』があります。None(skip environment.json)なら、リポジトリに `.cursor/environment.json` があっても読みません。保存した設定のままです。新しく画面から作った環境は、最初この None です。コミットしたファイルを使うなら、作るときにその保管庫を選びます(公式 Cloud Environment Setup)。
場所がファイルを指しているのに、そのファイルが無い、空、または読めないとき、Build は失敗します。エラーには、ファイル名と保管庫の名前が出ます。以前のように、黙って `.cursor/environment.json` や、もっと古い保存設定へ戻ることはしません(公式 Cloud Agents release notes、Week of Oct 12, 2026)。Agent の起動そのものは、最後に成功した Build を使い続けます。失敗の調べ方は、上の『Build が失敗したとき』の節です。
ファイルで定義された環境には、一覧に Config as code の印が付きます。同じ印のスイッチで、その環境だけに絞れます。名前を変えるときは、環境の詳細で名前の横の鉛筆です。
Build が失敗した理由が、GitHub アプリから保管庫へ届かないことなら、案内に届かない保管庫の名前が出て、GitHub のインストール設定へのリンクが付きます。アプリの入れ直しの前に、その名前を見ます。
ダッシュボードで環境を新しく作るとき、または個人の環境をチームへ上げるときは、同じ名前や同じ保管庫の環境を上書きせず、いつも新しい環境を作ります。チームに同じ名前があると、先に自分の名前を変えるよう聞かれます。スクリプトの同じ名前は、これまでどおり environment_name_conflict です(上の Environments API の節)。同じ保管庫の組み合わせで始めた Agent は、1つの環境を使い回します。すでにある環境へファイルだけ載せ直す CLI は、次の節です。
- 場所が None: リポジトリの environment.json は読まない。新しく作った環境の最初はここ
- ファイルを使う: 環境を作るときに、その保管庫を選ぶ
- 指しているファイルが無い・空・読めない: Build は失敗し、ファイル名と保管庫名が出る。黙って古い設定には戻らない
- 一覧の Config as code: ファイルで定義された環境。スイッチで絞れる。名前は鉛筆
- GitHub アプリから届かない失敗: 案内に保管庫名と、インストール設定へのリンク
- 画面から作る・チームへ上げる: 上書きしない。同じ名前なら先に改名。同じ保管庫の組は1つの環境を使い回す
すでにある環境へ、ファイルを載せ直す
ダッシュボードで環境を新しく作るときや、個人の環境をチームへ上げるときは、同じ名前でも上書きせず、別の環境を作ります(直前の節)。すでにある Cloud Agent の環境へ、environment ファイルだけ載せ直す入口は、CLI の `agent env deploy --env` です(公式 CLI changelog v2026.10.22)。画面の Update with Agent(Agent にいまの環境を見て、新しい用意を提案させる)とは別です。
`--env` のあとには、`agent env list` が先頭に出す公開 ID を渡します。JSON の出力でも、公開 ID は先頭です。対象は個人の保存した環境です(公式 CLI changelog v2026.10.15)。載せ直したあとも、その環境の名前と保管庫は残ります。だから保管庫を指定する `--repo` は省略できます。
渡した `--name`、`--repo`、または保管庫の内部 ID(`--scm-repo-node-id`)が、保存されている環境と違うと、コマンドは止まります。エラーは、どこが違うかを説明します。その場で新しい環境にはなりません。公開 ID と、その環境の名前・保管庫に合わせるか、画面で新しい環境を作ります。
`agent env get` は、指定した保管庫の個人の保存環境と、それぞれの environment.json を出します。`--ref` はもう取りません。`agent env delete` は公開 ID を受け取ります。古い数字の ID を渡すと、公開 ID を使うよう案内します(公式 CLI changelog v2026.10.15)。
載せ直すファイルには、コメントと末尾のカンマを書けます。壊れたファイルは、読み取りが止まった場所を指す文法エラーで止まります(公式 CLI changelog v2026.10.08)。リポジトリにファイルがあるだけで Agent が読むかどうかは、上の『場所』の節のままです。場所が None なら、ファイルを置いただけでは読みません。自前のワーカーがどのチームに付くかは、次の節です。
- 載せ直す: `agent env deploy --env` と、`agent env list` の公開 ID。個人の保存環境
- 名前と保管庫は残る。`--repo` は省略できる
- 名前・保管庫・内部 ID が違う: 止まって違いを説明する。新しい環境にはならない
- 削除も公開 ID。古い数字の ID は、公開 ID を使うよう案内が出る
- `agent env get` に `--ref` は無い
- コメントと末尾カンマは可。壊れたファイルは、止まった場所の文法エラー
- 場所が None なら、リポジトリに置いただけでは読まない(上の節)。Update with Agent とは別
自前のワーカーは、選んだチームで動く
自分のパソコンや会社のマシンを、Cloud Agent の作業場として出すコマンドは、CLI の `agent worker start` と、様子を見る `agent worker debug` です。これらは、アカウントに付いている既定のチームではなく、`agent login` で選んだチーム、またはそのあと `agent team switch` で切り替えたチームに登録され、そのチームで使えるかを確認します(公式 CLI changelog v2026.10.22)。
そのチームで Cloud Agent が使えないと、ワーカーは止まります。メッセージには、そのチームの名前が出て、`agent team switch` を使うよう案内します。パソコンが落ちた、とは限りません。別のチームに入ったまま起動していることがあります。アカウントの既定のチームへは、自動では移りません。出す前に、いまのチームを合わせます。
Require Self-Hosted Machines(全部を自前へ回す)や、切れた My Machines の machine-offline とは別の止まり方です。こちらは、ワーカーを登録するチームの話です。起動画面で Cloud machine / My Machines / Team Pool を選ぶ話は、first-cloud-agent の実行先の節のままです。環境のページでその環境の秘密を見る話は、次の節です。
- 登録先: `agent login` で選んだチーム、または `agent team switch` で切り替えたチーム。アカウントの既定のチームではない
- 対象のコマンド: `agent worker start` と `agent worker debug`
- そのチームで Cloud Agent が使えない: ワーカーは止まる。チーム名と `agent team switch` の案内が出る
- 既定のチームへは自動では移らない。出す前にチームを合わせる
- machine-offline や environment builds are turned off とは別
環境のページで、その環境の秘密を見る
Cloud Agents ダッシュボードでは、それぞれの環境のページに Secrets の欄があります。そこで、その環境の秘密を見て、新しいものを足せます。これが環境のページの秘密です。ダッシュボード全体の Secrets タブ(チームや自分の秘密を入れる場所)とは別の入口です。設定がロックされている環境では、その欄から見たり足したりはできません。ロックの理由は、このリリースノートには書いてありません(公式 Cloud Agents release notes、Week of Oct 19, 2026)。
公式のセットアップが、この欄の説明として指しているのは、その環境だけに効く秘密(環境スコープ)です。その環境の中の保管庫には届きます。別の環境には届きません。自前作業場(My Machines / Team Pool)にも届きません(公式 Cloud Environment Setup)。ステージング用の鍵を、別の環境へ漏らしたくないときの置き場です。上の『Secrets を環境やモノレポで分ける』と同じ種類です。
チームの管理者は、Cloud Agents のセキュリティ設定で Disable personal secrets をオンにできます。オンにすると、メンバーは個人の秘密(利用者分)を足したり直したりできません。すでに足してあった個人の秘密も、Cloud Agent には渡らなくなります。消すことだけは、メンバー自身ができます。個人の秘密は渡さない、と覚えてください。チームの秘密や、環境のページの秘密まで止まるとは、この一文では書いてありません(公式 Cloud Agents release notes、Week of Oct 19, 2026)。
足した直後の、すでに動いている Agent には届かないことがあります。新しい実行を始める話は、上の『Secrets を足したあと』のままです。値そのものは、チャットに書かないでください。保管庫も環境も選ばずに始めたときの仕事場は、次の節です。
- 環境のページの秘密: その環境のページで見て、足せる。設定がロック中は、その欄から見たり足したりはできない
- 届く範囲: その環境の Agent だけ。別の環境と自前作業場には届かない
- ダッシュボード全体の Secrets タブとは別。チームや自分の秘密の置き場が消えたわけではない
- Disable personal secrets: 個人の秘密は足せない、直せない。すでにある個人の秘密は Agent に渡らない。消すことはできる
- 個人の秘密は渡さない。チームの秘密や環境のページの秘密まで止まるかは、この一文では断定しない
保管庫も環境も選ばないと、チームの既定で動く
チームのメンバーが、保管庫も環境も選ばずに Cloud Agent を始めると、いまはチームの共有の、保管庫の無い既定の環境で動きます。以前は、個人の隠れた環境でした。これがチームの既定の保管庫なしです。公式の英語は team's default no-repo environment です(公式 Cloud Agents release notes、Week of Oct 19, 2026)。
このチームの既定は、誰も編集できません。名前の変更、再ビルド(Build の作り直し)、削除、環境の秘密の追加もできません。個人の秘密とチームの秘密は、この既定にも届きます。環境のページで足す種類の秘密は、ここには足せません。
名前の無い、保管庫の無い個人の環境は、名前を付けるまでロックされます。名前を付ける場所は、このリリースノートには書いてありません。ロック中にどのボタンが消えるかも、書いてありません。名前を付けるまでロック、と覚えてください。前の節の『設定がロック』(環境のページの秘密が見えない、足せない)と、同じものとは書いてありません。
保管庫を選んで始めるときの解決順(個人の保存、チームの保存、その次にファイル)とは別です。Desktop で保管庫を選んで Cloud にするときの、保管庫の既定の環境(first-cloud-agent)とも別です。Start from scratch は保管庫ピッカーで選ぶ入口です。Automation の『リポジトリなし』は、その自動化の設定です。どちらも、このチームの既定ではありません。同僚が、保管庫を持たない個人の環境で動く Agent へ追記できるかは、最初の Cloud Agent レッスンのいちばん末尾です。こちらはチームの共有の既定で、個人の環境そのものではありません。
個人の秘密とチームの秘密は届く、とこの一文は書いてあります。Disable personal secrets をオンにしたとき、個人の秘密は Cloud Agent に渡らない、は前の節です。オンのとき、このチームの既定に個人の秘密が届くかは、この一文では断定しません。チームに入っていない人が同じ既定を使うかも、この一文では断定しません。特定の Build から始めたときの設定は、次の節です。
- 保管庫も環境も選ばない: チームの共有の、保管庫の無い既定。以前は個人の隠れた環境
- 誰も、編集・改名・再ビルド・削除・環境の秘密の追加ができない
- 個人の秘密とチームの秘密は届く。環境の秘密は足せない
- 名前の無い、保管庫の無い個人の環境は、名前を付けるまでロック
- 解決順、保管庫の既定の環境、Start from scratch、Automation のリポジトリなしとは別
特定の Build は、記録された設定で動く
ふだんの Cloud Agent は、最新の成功した Build から始まります(上の『Builds タブでできること』)。それとは別に、Builds タブから特定の Build を選んで Agent を始められます。試すときや、失敗した Build の再現です(公式 Cloud Agent Builds)。Cloud Agent も子役も、特定の環境の Build から始めたときは、その Build に記録された environment.json と設定で起動します。リポジトリの、いまの environment.json ではありません。親の Agent が持っている、より新しい環境の版でもありません。これがその Build の設定です。公式の英語は started on a specific environment build です(公式 Cloud Agents release notes、Week of Oct 19, 2026)。
始めた Build と、仕事場の用意をそろえるためです。その特定の Build から始めた実行は、記録された設定で動きます。起動のときに使うのは、その Build に記録された environment.json と設定です。リポジトリにいまあるファイルで用意し直す、とは書いてありません。親が新しい環境の版を持っていても、その Build から始めた子役は、親の新しい環境の版では起動しません。
どの環境が選ばれるかの解決順(個人の保存、チームの保存、その次にファイル)とは別です。場所が None でファイルを読まない話とも別です。機能ブランチのファイルを効かせるために、そのブランチから始める話とも別です。新しい Build が失敗したあと、ふだんの起動が最後に成功した Build を使い続ける話とも別です。Fix Build は、最新の成功 Build から、失敗した Build のログを読みます。失敗した Build そのものから Agent を始めたときは、その Build の設定です。
自前作業場(My Machines / Team Pool)は Build から起動しません。上の自前作業場の節のまま、この節の対象外です。ソースコードのどのコミットを取るか(機能ブランチや、古くなった Build で新しい既定ブランチを取るか)は、この一文では断定しません。こちらは environment.json と設定の話です。Trigger build の隣から見る入口は、次の節です。
- 特定の Build から始めた Cloud Agent と子役: その Build に記録された environment.json と設定
- 使わない: いまの environment.json。親の新しい環境の版
- ふだんの起動は最新の成功 Build。こちらは、選んだその Build。記録された設定で動く
- 解決順、場所が None、機能ブランチ、最後に成功した Build、Fix Build とは別
- 自前作業場は対象外。コードのどのコミットかは、この一文では断定しない
Verify with Agent は、Trigger build の隣
Cloud Agents のダッシュボードで、環境の Builds のところに、Verify with Agent というリンクがあります。場所は Trigger build の隣です。押すと、新しいタブで新しい Agent が開きます。その Agent は、Build が動くかを確かめる用意ができています。新しいタブで確かめる用意、と覚えます。公式の英語は Verify with Agent です(公式 Cloud Agents release notes、Week of Oct 19, 2026)。
リンクが出るのは、ふたつそろったときだけです。ひとつは、あなたが Build を手動で始められること。もうひとつは、チームが手動のBuildを許していることです。どちらかが無いと、隣には出ません。チーム側の設定画面の英語名は、この一文には書いてありません。
Trigger build や Test build は、Build そのものを今すぐ走らせる入口です。Manual では必ず install が走ります。Verify with Agent は、そのボタンではありません。新しい Agent を開くリンクです。install が走るか、どの Build を選ぶか、入力欄にどんな文が入るかは、この一文では断定しません。
特定の Build を選んで Agent を始める話とは別です。あちらは、その Build の設定で、記録された設定で動きます。失敗した Build から調べる話、Fix Build、Cursor Cloud MCP の trigger-environment-build とも別です。Require Self-Hosted Machines で Trigger build が出ないときは、Build を手動で始められません。隣のリンクも、出せる条件を満たしません。環境の保管庫一覧に、他のチームの Origin が出る話は、次の節です。
- 場所: 環境の Builds。Trigger build の隣。名前は Verify with Agent
- 押すと: 新しいタブの新しい Agent。新しいタブで確かめる用意
- 出るとき: あなたが Build を手動で始められ、チームが手動のBuildを許している
- ちがうもの: Trigger build / Test build(Build を走らせる)。特定の Build から始める(その Build の設定)
- 入力欄の文、どの Build を選ぶか、install が走るかは、この一文では断定しない
共有された Origin は、自分のチームのあとに出る
Cloud Agents の環境を新しく作るとき、またはその環境の保管庫を直すとき、保管庫の一覧には、自分のチームの保管庫のあとに、別の並びが出ます。アクセスを許された、他のチームの名前空間にある Origin です。自分のチームのあとに出る、と覚えます。公式の英語は Origin repositories from other teams' namespaces です(公式 Cloud Agents release notes、Week of Oct 19, 2026)。
これで、名前空間をまたいだ複数の保管庫を、1つの環境にまとめられます。名前空間をまたいで足す、です。以前、このまたぎは API からだけでした。いまはダッシュボードの一覧から足せます。API が止まった、とは書いてありません。スクリプトから環境を作る話は、上の Environments API の節のままです。
一覧に出るのは、あなたにアクセスが許されている Origin だけです。許可を誰が出すかは、この一文には書いてありません。一覧に無いことだけを、消えた印と決めつけないでください。GitHub の保管庫が同じ並びに出るかは、この一文では断定しません。
cursor.com/agents で仕事を始めるときの保管庫ピッカーや、iPhone の未公開の下書きが出ない話とは別です。こちらは、環境を作るときと、環境の保管庫を直すときの一覧です。自分のチームの保管庫より前に出る、とは書いてありません。触ってよい保管庫を先に決める習慣と、1つの環境の上限300は、repository の複数リポジトリの節のままです。制限つき通信で届く先が狭くなった話は、次の節です。
- 場所: 環境を作るとき、または環境の保管庫を直すときの一覧
- 並び: 自分のチームの保管庫のあと。自分のチームのあとに出る
- 対象: アクセスを許された、他のチームの名前空間の Origin
- できること: 名前空間をまたいで足す。画面から。以前は API からだけ
- 断定しない: 許可の出し方。GitHub が同じ並びか。起動時のピッカー
制限つき通信では、CloudFrontは全部は開かない
通信を絞った Cloud Agent(制限つき通信。公式の英語は restricted network egress)では、CloudFront のホストが最初から全部届く、とはもう言えません。以前の既定は `*.cloudfront.net` の全部でした。いま最初から残るのは、公開されているコンテナイメージ(プログラムの入れ物)を取るために必要な CloudFront のホストだけです。CloudFrontは全部は開かない、と覚えます。公式の英語は no longer reach every *.cloudfront.net host by default です(公式 Cloud Agents release notes、Week of Oct 19, 2026)。
環境が、それ以外の CloudFront のドメインを使うなら、ネットワークの許可リストへ、そのドメインを足します。広い `*.cloudfront.net` が最初から開いている、とは考えないでください。自分で許可リストに書いたドメインまで消えるかは、この一文では書いてありません。残るホスト名の一覧も、この一文にはありません。成果物(スクショ)のアップロード先や、`*.example.com` が親ドメインを含む話は、上のネットワーク制限の節のままです。
同じ一文に、Cursor に置いた保管庫の話もあります。制限つき通信でも、その取得はいま速くなっています。Cursorに置いた保管庫は速く取れる、と覚えます。公式の英語は Repositories hosted on Cursor now clone faster under restricted egress です。何秒速いかは書いてありません。GitHub など、Cursor 以外に置いた保管庫まで速くなるとは書いてありません。
動いている Cloud Agent の実行中にネットワークの設定を変えると、その Agent には、古いままの許可ではなく、その Agent の、いまの環境の許可リストが当たります。実行中に許可リストが入れ替わる、と覚えます。公式の英語は applies that agent's current environment allowlist instead of a stale one です。ほかの実行中の Agent まで同時に変わるかは、この一文では断定しません。Agent を最初からやり直す必要があるかも、書いてありません。全部許可のモードまで同じかも、書いてありません。自前作業場のファイアウォールとは別です。用意されている既定の環境が、ふたつのルート証明書を信用しなくなった話は、次の節です。チームの既定の保管庫なしとは別です。
- 対象: 制限つき通信の Cloud Agent。最初から届く *.cloudfront.net は、もう全部ではない
- 残るもの: 公開のコンテナイメージを取るための CloudFront のホストだけ。CloudFrontは全部は開かない
- ほかの CloudFront: 必要なドメインを、ネットワークの許可リストへ足す
- Cursor に置いた保管庫: 制限つき通信でも取得が速い。Cursorに置いた保管庫は速く取れる。数字は無い
- 実行中に設定を変えたとき: その Agent の、いまの環境の許可リスト。実行中に許可リストが入れ替わる
- 断定しない: 残るホスト名の一覧。自分で書いた許可まで消えるか。ほかの実行中の Agent。全部許可のモード。自前作業場
既定の環境は、危ないルートは信用しない
Cloud Agent が最初から使う既定の環境は、ふたつのルート証明書を、もう信用しません。名前は emSign ECC Root CA - G3 と、AAA Certificate Services です。危ないルートは信用しない、と覚えます。ルート証明書は、接続先が本物かを確かめるときの、大もとの印です。公式の英語は default environments now distrust the emSign ECC Root CA - G3 and AAA Certificate Services roots です(公式 Cloud Agents release notes、Week of Oct 19, 2026)。
信用をやめた理由は、そのルートの下にある中間の証明書の、秘密鍵が漏れた、と公式が書いているからです。中間の秘密鍵が漏れた、です。漏れた経緯の詳細や、どのサイトがこの印を使っているかは、この一文には書いてありません。保管庫に置いた証明書ファイルを会話に出さない話や、チームの既定の保管庫なしとは別です。
コンピュータが持っている証明書の一覧(公式の英語は system certificate store)は、更新されています。用意されている既定の土台(公式の英語は default image)では、Java というプログラムが使う信用の一覧も、その更新された一覧から作り直されます。既定の土台はJavaも作り直す、と覚えます。公式の英語は the Java trust store is rebuilt from it です。
その結果、このルートを通して署名された接続は、信用されずに失敗します。失敗するのは故障ではなく、信用しないための動きです。信用を戻す手順は、この一文にはありません。自分で用意した Dockerfile、保存したスナップショット、自前作業場まで、同じ Java の作り直しがあるかは、この一文では断定しません。Node や Python の一覧まで作り直されるかも、書いてありません。制限つき通信の CloudFront の節とは別です。自前作業場のファイルを Desktop から開く話は、次の節です。
- 対象: Cloud Agent が最初から使う既定の環境。危ないルートは信用しない
- 名前: emSign ECC Root CA - G3 と AAA Certificate Services
- 理由: その下の中間の証明書の秘密鍵が漏れた。中間の秘密鍵が漏れた
- 一覧: コンピュータの証明書の一覧は更新される。既定の土台はJavaも作り直す
- 結果: このルートを通した接続は、信用されずに失敗する
- 断定しない: 止まるサイトの名前。自分の Dockerfile。保存したスナップショット。自前作業場。Node や Python
自前作業場は、Desktop からライブの作業場を開く
自前作業場(My Machines または Team Pool。公式の英語は Self-Hosted Machines)で動いている Agent は、Cursor のデスクトップアプリから開けます。開くと、その作業場のファイル、変更、ターミナル、転送されたポートがあります。ライブの作業場を開く、と覚えます。公式の英語は live workspace です(公式 Cloud Agents release notes、Week of Oct 19, 2026)。
この入口をオンにするのは、Linux のマシンを始めるときです。Linuxを始めるときにオン、と覚えます。公式の英語は Turn on the live workspace when you start a Linux machine です。macOS や Windows のマシンにも同じ操作があるかは、この一文では断定しません。すでに動いているマシンへ、あとから足せるかも、書いてありません。
そのマシンが再起動したあとは、同じ Agent を開くと、またそのマシンにつながります。開き直すとつながる、と覚えます。公式の英語は If the machine restarts, opening the agent reconnects to it です。開き直さなくてもつながり続ける、とは書いてありません。
Cloud machine(Cursor が用意するクラウドの作業場)まで同じ入口があるかは、この一文では断定しません。スマホのアプリには、エディタもターミナルもファイルの一覧も出ません。見る中心は差分のままです(first-cloud-agent)。Agents Window の Forwarded Ports(転送ポート)は、Cloud の仕事場で待ち受けているポートの下見です。言葉は近くても、この節の入口ではありません。Remote Control は、手元の Agent をスマホから動かす話です。途中でマシンが落ちて別の空いているマシンへ移る話や、切れた My Machines がおよそ15秒で machine-offline と出る話とも別です。ルート証明書を信用しない話は、前の節です。プールやマシンの名前を書かない自前の実行がどこへ行くかは、次の節です。
- 対象: 自前作業場で動いている Agent。開く場所は Cursor のデスクトップアプリ
- 中にあるもの: ファイル、変更、ターミナル、転送されたポート。ライブの作業場を開く
- オンにするとき: Linux のマシンを始めるとき。Linuxを始めるときにオン
- 再起動のあと: その Agent を開くと、またそのマシンにつながる。開き直すとつながる
- 断定しない: macOS や Windows。あとから足せるか。Cloud machine。開き直さなくてもつながるか
- 別の話: スマホの差分。Forwarded Ports。Remote Control。別マシンへの移動。machine-offline
指名しない自前の実行は、チームの既定のプールへ
チームの管理者は、Cloud Agents ダッシュボードの Self-Hosted(自前作業場)で、Default pool を1つ選べます。チームの既定のプール、と覚えます。公式の英語は Team admins can pick a Default pool in the Self-Hosted section of the Cloud Agents dashboard です(公式 Cloud Agents release notes、Week of Oct 19, 2026)。選ぶ人として書いてあるのは、チームの管理者です。メンバーが同じ欄を選べるか、個人の契約に同じ欄があるかは、この一文には書いてありません。
寄るのは、自前の実行のうち、プールの名前もマシンの名前も書いていないものです。プールもマシンも指名しない、と覚えます。公式の英語は self-hosted runs that don't name a pool or machine です。行き先は、保管庫の名前だけでは決まりません。保管庫だけでは決まらない、と覚えます。公式の英語は go there instead of routing by repository alone です。`pool=` で名前を書いた実行や、1台のマシンを指名した実行は、この一文の外です。
分かれは3つです。選んだ既定のプールが、その実行の保管庫を扱うなら、そのプールが受けます。扱わないなら、その保管庫を扱う別のチームのプールが受けます。どの保管庫でも受ける、が残りの実行を受けます。公式の英語は If the default pool serves the run's repository, it takes the run. If not, another team pool that serves the repository takes it, and an any-repo default pool takes everything else です。画面のどの項目が「どの保管庫でも受ける」になるかは、この一文には書いてありません。
保管庫を開けるかの確認は、これまでどおりかかります。公式の英語は Repository access checks still apply です。プールへ行けることと、その保管庫を開けることは別です。Slack のチャンネル既定、メッセージの `pool=` や `worker=`、自分の My Machines 既定ワーカーが先に効く順は、この一文では書き換えていません。Cloud machine へ自動で戻る、とも書いてありません。すでに動いている作業場を Desktop から開く話は、前の節です。MCP の道具が、サインインに無い権限の名前で拒まれたときの案内は、次の節です。
- 選ぶ人: チームの管理者。場所は Cloud Agents ダッシュボードの Self-Hosted。チームの既定のプール
- 対象: 自前の実行で、プールもマシンも指名しないもの
- 決まり方: 保管庫だけでは決まらない。既定がその保管庫を扱うなら、そこが受ける
- 扱わないとき: その保管庫を扱う別のチームのプール。残りは、どの保管庫でも受ける
- 権限: 保管庫を開けるかの確認は残る。行けることと、開けることは別
- 断定しない: メンバーが選べるか。個人の契約。Slack の順が変わるか。Cloud machine へ自動で戻るか。名前を書いた pool= や 1台の指名
道具と足りない権限のカード
Cloud Agent が MCP の道具を呼んだとき、サーバーが、あなたのサインインに無い権限の名前を挙げて拒むことがあります。そのとき Agent は、失敗で終わらず、サインインのカードを出します。カードには、呼ぼうとした道具の名前と、足りない権限の名前が出ます。これが道具と足りない権限のカード、です。公式の英語は When an MCP server refuses a Cloud Agent's tool call because your sign-in is missing a permission the server names, the agent shows a sign-in card that names the tool and the permission it needs, instead of failing です(公式 Cloud Agents release notes、Week of Oct 19, 2026)。カードが会話のどの位置に出るか、ボタンの英文が何かは、この一文には書いてありません。カードが出ているあいだ、実行が待つか進むかも、書いてありません。iPhone のアプリまで同じカードかは、断定しません。手元の Desktop の Agent まで同じかも、断定しません。
もう一度サインインしても、その権限を付けられないことがあります。そのときは、Agent が管理者の承認が要る、と伝えます。もう一度入っても届かない、と覚えます。公式の英語は If signing in again can't grant it, the agent tells you an admin needs to approve it です。管理者が Cursor のチーム管理者なのか、つないだサービスの管理者なのかは、この一文では書いてありません。承認の画面の場所も、書いてありません。
このカードで許した権限は、次にサインインしたときも残ります。許した権限は次の入室にも残る、です。公式の英語は Permissions you grant this way are kept the next time you sign in です。別の MCP サーバーまで同じ権限が残る、とは書いてありません。あなたがあとから取り消したあとも残る、とは書いてありません。チームを替えたあとも残るかは、断定しません。
別の止まり方と混ぜないでください。ダッシュボードの mcp_auth_error は、MCP の認証に失敗した記録です。その MCP の道具だけがスキップされ、実行自体は続きます(このレッスンの実行イベントの節)。ログイン画面が何度も出る切り分けは、上のログインがループする節です。子役が質問や MCP のサインインで止まって Agents の印が黄色になる話は、follow-up-loop です。コマンドで動く MCP(stdio)は、Cursor のサインインが無く、Cloud Agent はその種類のサインインカードでは止まらなくなった、と別の週のノートにあります(Week of Oct 12, 2026)。このカードが stdio にも出るかは、この一文では断定しません。Gmail が回数で止まったあとの待ち直しと、Google カレンダーが権限不足のときに出す案内は、次の節です。スプレッドシートを別のつながっているアカウントでやり直す話は、表の節です。引数のよくある間違いを直す話は、いちばん末尾の節です。チームが持っている MCP へ入るときの衝突が消えた話も、同じ節です。チームの既定のプールは、前の節です。
- 出るとき: Cloud Agent の道具の呼び出しが、サインインに無い権限の名前で拒まれた。失敗の代わりに、道具と足りない権限のカード
- カードに載るもの: 呼ぼうとした道具の名前と、足りない権限の名前。位置とボタンの英文は、ノートに無い
- もう一度入っても届かない: Agent が、管理者の承認が要る、と伝える。Cursor 側かサービス側かは断定しない
- 許した権限は次の入室にも残る。別の MCP、取り消し後、チームを替えたあとは断定しない
- 断定しない: 実行が待つか。iPhone。stdio。手元の Desktop
- 別の話: mcp_auth_error。ログイン画面の連打。Agents の黄色い印。メールと予定表の直しは次の節。表を別のつながっているアカウントでやり直す話は表の節。引数のよくある間違いを直す話はいちばん末尾
Gmailは待ってやり直す
Cloud Agent の Gmail の道具が、回数の上限で拒まれたとき、Agent は Google が求める短いあいだ待って、その呼び出しをやり直します。Gmailは待ってやり直す、と覚えます。公式の英語は When Gmail rate-limits a request, the agent now waits briefly as Google asks and retries the call です(公式 Cloud Agents release notes、Week of Oct 19, 2026)。何秒待つかは、この一文には書いてありません。待っているあいだ、画面に何が出るかも、書いてありません。待つのが一度だけかも、書いてありません。iPhone のアプリまで同じ待ち方かは、断定しません。手元の Desktop の Agent まで同じかも、断定しません。
以前は、そのあとの Gmail の呼び出しが、クールダウンのあいだまとめて止まっていました。いまは、その止め方にはなりません。あとのGmailは止めない、と覚えます。公式の英語は instead of having later Gmail calls blocked for a cooldown period です。ほかの道具まで、この待ち方になるとは書いてありません。Slack の上限がおよそ1分で頭打ちになる話は、上の回数の上限の節です。そちらは、上限を返した道具だけが休み、ほかの道具は続く、です。Gmail のこの直しは、あとの Gmail の呼び出しをクールダウンで止めない、という話です。Grok Bot の Gmail プラグインは、アカウント全体に効く別の入口です(when-desktop)。こちらは Cloud Agent の Gmail の道具です。Automation の実行も Cloud Agent ですが、この一文が Automation の画面まで同じとは書いてありません。
Google カレンダーの呼び出しが、接続に足りない権限のために失敗したとき、Agent は権限エラーの生の文を出さず、アカウントを接続し直すよう伝えます。カレンダーはつなぎ直す、と覚えます。公式の英語は When a Google Calendar call fails because the connection is missing a permission, the agent now tells you to reconnect the account instead of showing a raw permission error です。案内の英文が何か、どの画面で接続し直すかは、この一文には書いてありません。接続し直せば必ず通る、とは書いてありません。管理者の承認が要る、とも書いてありません。iPhone のアプリに同じ文が出るかも、断定しません。
別の止まり方と混ぜないでください。サインインに無い権限の名前で拒まれて出るカードは、前の節です。道具の名前と権限の名前が載る案内で、失敗の代わりに出ます。カレンダーのこの直しは、生の権限エラーの代わりに、接続し直しを伝える、です。同じカードとは書いてありません。ログイン画面が何度も出る切り分けは、上のログインがループする節です。Google Workspace の管理者ポリシーで止まる話も、そちらです。ダッシュボードの mcp_auth_error は、認証に失敗した記録で、その MCP の道具だけがスキップされます。スプレッドシートを、別のつながっているアカウントでやり直す話は、次の節です。引数のよくある間違いを直す話は、いちばん末尾の節です。チームが持っている MCP へ入るときの衝突が消えた話も、同じ節です。期間で予定を絞る話や、迷惑メールとごく新しいメールの検索が空でなくなる話は、別の週のノートです。
- 対象: Cloud Agent の Gmail の道具が、回数の上限で拒まれたとき。Gmailは待ってやり直す
- 待ち: Google が求める短いあいだ待って、その呼び出しをやり直す。何秒か、待ちの画面、一度だけかはノートに無い
- あとのGmailは止めない: 以前のように、あとの Gmail をクールダウンでまとめて止めない
- カレンダーはつなぎ直す: 接続に権限が足りず失敗したとき。生の権限エラーの代わりに、アカウントの接続し直しを伝える
- 断定しない: iPhone。手元の Desktop。Automation の画面。案内の英文。どの画面で接続し直すか。接続し直せば必ず通るか。管理者の承認
- 別の話: 権限の名前が載るカード。ログイン画面の連打。mcp_auth_error。Slack のおよそ1分。Grok Bot の Gmail。表を別のつながっているアカウントでやり直す話は次の節。引数のよくある間違いを直す話はいちばん末尾
表は別のアカウントでやり直す
Cloud Agent の Google スプレッドシート(Google Sheets)の道具が、いま使っているアカウントではその表を開けずに失敗したとき、Agent はほかにつながっている表のアカウントを見て、開けるほうでその呼び出しをやり直せます。表は別のアカウントでやり直す、と覚えます。公式の英語は If a Google Sheets tool call fails because the account in use can't open the spreadsheet, the agent now sees your other connected Sheets accounts and can retry with one that has access です(公式 Cloud Agents release notes、Week of Oct 19, 2026)。ノートの見出しの英語は Google Sheets calls recover when the wrong account is connected です。失敗の条件として書いてあるのは、いまのアカウントではその表を開けない、です。必ずやり直す、とは書いてありません。やり直して必ず開ける、とも書いてありません。どのアカウントを選ぶかも、書いてありません。ほかにつながっている表のアカウントが無いときや、どれも開けないときは、書いてありません。iPhone のアプリまで同じかは、断定しません。手元の Desktop の Agent まで同じかも、断定しません。
見える、は Agent がほかの表のアカウントを見る、です。ほかの表アカウントが見える、と覚えます。あなたにアカウントの一覧画面が出る、とは書いてありません。開ける表でやり直せる、と覚えます。公式の英語は can retry with one that has access です。開けるアカウントで、その呼び出しをやり直せます。何回までか、自動で一度だけかは、書いてありません。接続し直すボタンの英文も、書いてありません。
別の止まり方と混ぜないでください。Gmail が回数で止まったあとの待ち直しと、カレンダーの接続し直しは、前の節です。カレンダーは、生の権限エラーの代わりに接続し直しを伝える、です。表のこの直しは、別のつながっているアカウントでやり直せることです。同じ接続し直しとは書いてありません。サインインに無い権限の名前で拒まれて出るカードは、さらに前の節です。道具の名前と権限の名前が載る案内で、失敗の代わりに出ます。この節の直しは、そのカードとは書いてありません。ログイン画面が何度も出る切り分けは、上のログインがループする節です。引数のよくある間違いを直す話(Slack、Google スプレッドシート、Airtable、Jira)は、次の節です。チームが持っている MCP へ入るとき、自分の同じ URL の入口とぶつからなくなった話も、次の節です。
- 対象: Cloud Agent の Google スプレッドシートの道具が、いまのアカウントでは表を開けずに失敗したとき。表は別のアカウントでやり直す
- ほかの表アカウントが見える: ほかにつながっている表のアカウントを、Agent が見る。一覧があなたに出る、とは書いていない
- 開ける表でやり直せる: 開けるアカウントがあれば、その呼び出しをやり直せる。必ずやる、必ず開ける、どれを選ぶかはノートに無い
- 断定しない: ほかにアカウントが無いとき。どれも開けないとき。回数。iPhone。手元の Desktop。案内の英文
- 別の話: Gmail の待ち直し。カレンダーの接続し直し。権限の名前が載るカード。ログイン画面の連打。引数のよくある間違いを直す話は次の節。チームが持っている MCP の入口の衝突が消えた話も次の節
よくある引数は自動で直る
Cloud Agent の Slack、Google スプレッドシート、Airtable、Jira の道具呼び出しで、よくある引数の間違いは自動で直されます。よくある引数は自動で直る、と覚えます。公式の英語は Common argument mistakes in Slack, Google Sheets, Airtable, and Jira tool calls are repaired automatically です(公式 Cloud Agents release notes、Week of Oct 19, 2026)。ノートの見出しの英語は Fixes to MCP connectors です。どの引数がよくある間違いか、直したあとの引数の中身、直したことをあなたに見せるかは、この一文には書いてありません。直したあとに必ず成功する、とは書いてありません。何回までかも、書いてありません。iPhone のアプリまで同じかは、断定しません。手元の Desktop の Agent まで同じかも、断定しません。Automation の実行も Cloud Agent ですが、この一文が Automation の設定画面まで同じとは書いてありません。
名指しされているのは、この四つです。名指しはSlackと表とAirtableとJira、と覚えます。正式には Slack、Google スプレッドシート、Airtable、Jira です。ほかの MCP の道具まで同じ直しになるかは、書いてありません。引数がおかしいときに理由が具体的に出る話は、上の、コメントが設定として効く節です(公式 Cloud Agents release notes、Week of Oct 5, 2026)。あちらは、間違った引数の理由が出る、です。こちらは、よくある間違いを自動で直す、です。同じ話とは書いてありません。
同じ週の直しに、もう一つあります。チームが持っている MCP サーバーへサインインしても、同じ URL の自分の入口とはぶつからなくなりました。チーム所有は入口とぶつからない、と覚えます。公式の英語は signing in to a team-owned MCP server no longer conflicts with your own entry for the same URL です。入口が画面のどの欄か、両方が残って使えるか、あなたがどちらを選ぶかは、この一文には書いてありません。stdio のコマンドで動く MCP まで同じかは、断定しません。iPhone のアプリ、手元の Desktop の Agent まで同じかも、断定しません。
別の止まり方と混ぜないでください。表を別のつながっているアカウントでやり直す話は、前の節です。条件は、いまのアカウントではその表を開けない、です。この節のスプレッドシートは、引数のよくある間違いを直す、です。同じ直しとは書いてありません。メールの待ち直しと、予定表の接続し直しは、さらに前です。サインインに無い権限の名前で拒まれて出る案内は、さらに前です。ログイン画面が何度も出る切り分けは、上のログインがループする節です。認証失敗の記録は、実行イベントの節です。
- 対象: Cloud Agent の Slack、Google スプレッドシート、Airtable、Jira の道具呼び出し。よくある引数は自動で直る
- 名指しはSlackと表とAirtableとJira: ノートが名指ししている四つ。正式には Slack、Google スプレッドシート、Airtable、Jira。ほかの道具まで同じかは書いていない
- チーム所有は入口とぶつからない: チームが持っている MCP へ入っても、同じ URL の自分の入口とはぶつからない。欄の場所や、両方が残るかはノートに無い
- 断定しない: どの引数がよくある間違いか。直しの中身が見えるか。必ず成功するか。回数。iPhone。手元の Desktop。stdio。Automation の設定画面
- 別の話: 表を別のつながっているアカウントでやり直す話。メールの待ち直し。予定表の接続し直し。権限の名前が載る案内。ログイン画面の連打。引数がおかしいときに理由が出る話
理解チェック
- 環境不足の症状(インストール失敗、テスト不能、起動不能、成果物なし)を想像できる
- 『書いたつもり』と『動かして確認した』のちがいを言える
- Secrets を GitHub のファイルに置かないと言える
- 漏れたくない値は Runtime Secret にすると説明できる
- モノレポで名前がぶつかりそうな Secrets は接頭辞で分けるとよいと知っている
- 警告付き Environment ready を、スナップショット問題のサインとして疑える
- 会話は長く残りやすく、使わない環境スナップショットは最大30日で消え、会話の90日とは別だと説明できる
- 画面の Privacy Mode(no training)は今のモード、Legacy(no storage)は旧モードだと知っている
- 招待時の Share Cursor Analytics を入れると、新しいチームのプライバシー設定が変わると知っている
- 環境の用意に『Agent 主導 / スナップショット / 定義ファイル』があると言える
- ガイド付きセットアップでは共有ターミナルで install の進捗を見られると説明できる
- Dockerfile 変更時はレイヤーキャッシュで変更層だけ再ビルドされると知っている(詳しい人向け)
- Dockerfile でプロジェクト全体を COPY せず、Cursor がワークスペースを checkout する公式前提を知っている(詳しい人向け)
- environment.json の build.dockerfile / build.context は `.cursor` 基準で、install はプロジェクトルートで動くと知っている(詳しい人向け)
- start コマンドは多くのリポジトリで省略でき、Docker 必要時は service docker start の例があると知っている
- Cloudflare Tunnel で社内 API へ届けるとき CF_ACCESS の Secrets とヘッダー例があると知っている(詳しい人向け)
- AWS IAM 連携の STS 認証情報は1時間で失効し、Agent 再開時に自動更新されると知っている(詳しい人向け)
- 社内 API 向けに Tailscale や Cloudflare Tunnel の公式例があると知っている(詳しい人向け)
- 外部通信が止まったとき、ネットワーク制限も疑える
- 許可リスト後に成果物だけ消えたとき、アップロード先ホストも疑える
- 自前作業場でスクショだけ止めたいときは成果物ホストを塞ぐと知っている
- 複雑な Docker 構成では fuse-overlayfs などの追加設定が必要なことがあると知っている(詳しい人向け)
- 環境整備を詳しい人に頼むとき、リポジトリ名と必要なサービス名を伝えられる
- Secrets タブが見えないとき、権限を管理者に確認できる
- Secrets 追加後は新しい実行を始めると反映されやすい
- ダッシュボードの Secrets は Cloud machine に届き、My Machines には届かないと知っている
- Team Pool の鍵は Secret sync だと知っている
- Team Pool の Secret sync は作業場側の `--sync-dashboard-secrets` が要ると知っている
- 自前作業場でスクショだけ止めたいときは成果物ホストを塞ぐと知っている
- Grok 4.7 の窓は 256k が通常で、入力がそれを超えると割増になると知っている
- Cloud Agent の MCP は HTTP / stdio のみで、SSE や mcp-remote は使えないと知っている
- MCP Apps は道具が会話の中へ画面を出せる拡張で、画面が出なくても道具自体は動くと知っている
- Web / Cloud Agent の MCP OAuth は Desktop と違う戻り先 URL だと知っている
- Figma / Linear など固定 Client ID の MCP は静的 OAuth(auth.CLIENT_ID)だと知っている
- MCP が途中で追加の入力を聞いてくるのは Elicitation で、壊れではないと知っている
- Enterprise の MCP Allowlist は承認だけで、全員への配布ではないと知っている
- MCP が Cloud only や Read-only と出たら、Plugins ページの状態を管理者に伝えると知っている
- stdio の MCP は envFile から鍵を読め、HTTP / SSE には envFile が使えないと知っている
- rename-chat でいまの実行の会話名を付け直せる(200文字まで)と知っている
- Enterprise の Browser Origin Allowlist は自動で行ってよいサイトの許可リストで、許可外にいるあいだはブラウザ道具が止まると知っている
- ダッシュボードの実行イベント(setup_failed / pr_creation_failed / artifact_created / mcp_auth_error など)を読んで切り分けられる
- artifact_created が無いのに『確認した』と書かれているとき、環境不足を疑える
- Cloud Agent Builds が起動を速くする仕組みだと説明できる
- 下書き以外では自分では Builds をオフにできないが、Require Self-Hosted Machines のチームは environment builds are turned off だと知っている
- Fix Build はスナップショット期限切れでも、最新の成功 Build から失敗ログを読んで直すと知っている
- スナップショットが消えた Build は Snapshot expired で、有効化できないと知っている
- ソース管理が一時的に届かないときは、連続3回失敗するまで自動でやり直すと知っている
- 新しい Cloud Agent は保管庫の既定の環境になり、同僚の保存環境は先に選ばれないと知っている
- Edit Secret の All repositories は、見える保管庫の全部に秘密を保存すると知っている
- 環境の履歴はその環境だけで、Duplicate のダブルクリックはコピー1つだと知っている
- Version history の API 印は、公開 API からの保存だと知っている
- `*.example.com` の許可リストは親ドメイン example.com 自身も含むと知っている
- Update stale builds が main のコードの新しさに関わると知っている
- Build が失敗しても最後に成功した Build が使われ続けると知っている
- 環境や Secrets の保存が Build のきっかけになりうると知っている
- Build trigger の4種類(Recurring / Configuration change / Manual / Agent-requested)を説明できる
- Skipped が出るのは Recurring だけで、手動や設定変更の Build は必ず走ると知っている
- Cursor Cloud MCP で Build 履歴や install ログを Agent に調べさせられると知っている
- request-environment-setup-actions で Secret 追加待ちを記録できると知っている
- take-environment-snapshot で動いた環境をスナップショット保存できると知っている
- check-environment-snapshot でスナップショット保存の完了を確認できると知っている
- run-info → get-events が公式の診断の入口だと知っている
- batch-fetch-details で他の実行のイベントや差分メタデータを調べられると知っている
- batch-fetch-details は1回最大50件まで、と知っている
- 待っているのに再開しないとき、get-message-queue で未処理フォローアップを確認できると知っている
- get-message-queue が空でも、Subscriptions の待ち条件が未達なら Agent は再開しないと知っている
- GitHub の CI 待ちは Checks が全部終わるまで1つの結果で、pending の Check が1つでも全体が届かないと知っている
- pending の Check は GitHub の action_required(要対応)で完了させると、待ちが進むと知っている
- list-cloud-agents で同じ環境の他の実行を一覧できると知っている
- list-cloud-agents で archived フィルタを使い、アーカイブ済み実行を除いて調べられると知っている
- OIDC トークンは長期鍵の代替で、エージェントメタデータは認証情報ではないと説明できる
- agent/source と turn/model がメタデータで読めると知っている
- Auto の振り分け先は既定で隠れ、詳しい人は turn/model で見られると知っている
- turn/id と agent/id(bcId)が別物だと説明できる
- turn/ 配下はコーディングターン中だけ存在し、ターン間は消え、キャッシュしないと説明できる
- owner/service-account-id と workspace/automation-id があると知っている
- VM 内のエージェントメタデータと、API/SDK の metadata タグは別物だと知っている
- setup_started のまま止まるとき、ユーザー操作待ちを疑える
- 最初の Build 成功前は、従来どおり起動時に clone / install が走ると知っている
- Agent 画面でリポジトリ名にカーソルを載せると、使った環境を確認できる
- `.cursorignore` で Agent / Tab / @ 指定からファイルを外せるが、ターミナルと MCP は止めきれないと知っている
- 自前作業場は `.cursor/environment.json` を読まず、代わりは hooks.json や `--on-session-start` だと知っている
- Enterprise のネットワーク方針ロックは自前作業場に届かないと知っている
- MCP のログインがループするときは、管理者ポリシーと期限切れを分けて読むと知っている
- environment.json のコメントと末尾のカンマは設定として読まれ、セットアップ催促にはならないと知っている
- 複数保管庫の Build は SSH を先に HTTPS へ直すので、最初のターンが早くなりやすいと知っている
- MCP の回数上限では、その道具だけ休み、ほかの道具は続くと知っている
- 環境はスクリプトからも作れ、保管庫は最大300で、大きな環境の読み込みは5倍速くなったと発表されていると知っている
- 環境の同じ名前は environment_name_conflict で、一覧に下書きや削除済みは出ないと知っている
- Require Self-Hosted Machines ではクラウドの Build が止まり、タブは environment builds are turned off だと知っている
- そのチームでは個人の環境も温まらず、Trigger build もスナップショット保存も無いと知っている
- クラウドで走っていた Agent は追記を受け付けず、自前作業場で新しい Agent を始めると知っている
- 切れている My Machines はおよそ15秒で machine-offline と出て、プールは同じマシンが戻るまで待つと知っている
- 環境の解決順は、個人の保存、チームの保存、その次にファイルだと知っている
- 保存した環境の場所が None なら、リポジトリの environment.json は読まないと知っている
- 指しているファイルが無い・空・読めないと Build は失敗し、黙って古い設定には戻らないと知っている
- 一覧の Config as code はファイルで定義された環境で、名前は鉛筆だと知っている
- 画面から環境を作る・チームへ上げるときは上書きせず、同じ名前なら先に改名すると知っている
- すでにある環境へファイルを載せ直すときは agent env deploy --env と公開 ID で、名前と保管庫は残り、違う指定は止まると知っている
- 自前のワーカー(agent worker start / agent worker debug)は、ログイン時に選んだチームで動き、そのチームで Cloud Agent が使えないと agent team switch を案内して止まると知っている
- 環境のページの秘密は、その環境のページで見て足せ、設定がロック中はその欄からできないと知っている
- Disable personal secrets がオンだと個人の秘密は足せず直せず、Cloud Agent に渡らず、消すことだけはできると知っている
- 個人の秘密は渡さない、がチームの秘密や環境のページの秘密まで止まるとは、この一文では断定しないと知っている
- 保管庫も環境も選ばずに始めると、チームの共有の保管庫なしの既定で動き、誰もその既定を直せないと知っている
- 名前の無い、保管庫の無い個人の環境は、名前を付けるまでロックされると知っている
- チームの既定には個人の秘密とチームの秘密は届き、環境の秘密は足せないと知っている
- 特定の Build から始めた Cloud Agent と子役は、その Build に記録された environment.json と設定で動くと知っている
- その起動は、いまの environment.json でも、親の新しい環境の版でもなく、記録された設定で動くと知っている
- 環境の Builds では Trigger build の隣に Verify with Agent があり、新しいタブで確かめる用意だと知っている
- そのリンクは、あなたが Build を手動で始められ、チームが手動のBuildを許しているときだけ出ると知っている
- 環境を作るとき、または保管庫を直すとき、アクセスを許された他のチームの Origin は自分のチームのあとに出ると知っている
- 名前空間をまたいだ複数の保管庫は、ダッシュボードの一覧から足せ、以前は API からだけだったと知っている
- 制限つき通信では CloudFrontは全部は開かない、と知り、ほかの CloudFront のドメインは許可リストへ足すと知っている
- 実行中にネットワーク設定を変えると、その Agent では実行中に許可リストが入れ替わると知っている
- Cursorに置いた保管庫は速く取れる、と知り、GitHub など Cursor 以外まで同じとは断定しないと知っている
- 用意されている既定の環境は emSign ECC Root CA - G3 と AAA Certificate Services を信用せず、危ないルートは信用しないと知っている
- 中間の秘密鍵が漏れた、が理由で、このルートを通した接続は信用されずに失敗すると知っている
- 既定の土台はJavaも作り直す、と知り、自分の Dockerfile や自前作業場まで同じとは断定しないと知っている
- 自前作業場の Agent は Cursor のデスクトップアプリからライブの作業場を開くと知っている
- その入口は Linuxを始めるときにオンで、macOS や Windows、Cloud machine まで同じとは断定しないと知っている
- マシンが再起動したあとは開き直すとつながる、と知り、落ちたあとの別マシンへの移動とは別だと知っている
- プールもマシンも指名しない自前の実行は、チームの管理者が選んだチームの既定のプールへ先に寄ると知っている
- その振り分けは保管庫だけでは決まらない、と知り、既定がその保管庫を扱うときだけそこが受けると知っている
- 扱わないときは別のチームのプールか、どの保管庫でも受ける側が残りを受け、保管庫を開けるかの確認は残ると知っている
- 道具の呼び出しがサインインに無い権限の名前で拒まれると、失敗の代わりに道具と足りない権限のカードが出ると知っている
- もう一度入っても届かないときは、Agent が管理者の承認が要ると伝え、管理者が Cursor 側かサービス側かは断定しないと知っている
- この案内で許した権限は次の入室にも残る、と知り、別の MCP や取り消し後まで残るとは断定しないと知っている
- Cloud Agent の Gmail の道具が回数の上限で拒まれると、Gmailは待ってやり直す、と知っている
- その待ちは、あとのGmailは止めない、で、クールダウンでまとめて止める以前の動きではないと知っている
- Google カレンダーの呼び出しが接続の権限不足で失敗すると、カレンダーはつなぎ直す、と伝え、生の権限エラーの代わりだと知っている
- 何秒か、Gmail の待ちの画面、カレンダーの案内の英文、どの画面で接続し直すか、iPhone、手元の Desktop までは断定しないと知っている
- Cloud Agent の Google スプレッドシートの道具が、いまのアカウントでは表を開けずに失敗すると、表は別のアカウントでやり直す、と知っている
- そのとき Agent は、ほかの表アカウントが見える、と知り、見えるのはほかにつながっている表のアカウントだと知っている
- 開ける表でやり直せる、と知り、必ずやり直す、必ず開ける、どのアカウントを選ぶかまでは断定しないと知っている
- Cloud Agent の Slack、Google スプレッドシート、Airtable、Jira の道具では、よくある引数は自動で直る、と知っている
- 名指しはSlackと表とAirtableとJira、と知り、ほかの道具まで同じかは断定しないと知っている
- チームが持っている MCP サーバーへ入るときは、チーム所有は入口とぶつからない、と知り、欄の場所や両方が残るかは断定しないと知っている
開いただけでは「済」になりません。チェックできたら押してください。
実践
チームの Cloud Agent 環境に何が入っているか(または何が足りないか)を1つ確認してみましょう。足りなければ、上のコピペ用メッセージを自分の案件向けに書き換えて、詳しい人への下書きにしてみてください。スクショが付かない案件なら、ログイン用 Secrets(Runtime Secret)や AGENTS.md の確認手順が要るかも一言添えてみましょう。`.env` が保管庫に残っているなら、末尾の `.cursorignore` 節も見てください。MCP のログインが繰り返すなら、末尾の切り分けも見てください。environment.json にコメントがあるのにセットアップを促されるなら、末尾のコメントの節も見てください。MCP が全部止まったように見えたら、上限で休んでいる道具が1つかも見てください。環境をスクリプトで揃えたいときは、末尾の Environments API の節を見て、名前の衝突と一覧に出ない条件も一言添えてみてください。Builds タブが environment builds are turned off なら、末尾の自前必須の節を見て、管理者に Require Self-Hosted Machines かを聞いてみてください。machine-offline なら、パソコンの電源を先に見てみてください。リポジトリに environment.json があるのに効かないなら、末尾の場所の節を見て、None でないかを見てみてください。すでにある環境へファイルだけ載せ直すなら、末尾の載せ直しの節を見て、agent env list の公開 ID を先に確認してみてください。名前や保管庫が違うエラーなら、新しい環境にはなっていません。自前のワーカーがすぐ止まって agent team switch と出たら、末尾のワーカーのチームの節を見て、案内のチーム名を先に確認してみてください。既定のチームへは自動では移りません。環境のページに Secrets が無い、または足せないなら、末尾の節を見て、設定がロックされていないかを管理者に聞いてみてください。個人の秘密だけ足せない、または以前の個人の秘密が届かないなら、Disable personal secrets がオンかを見てみてください。個人の秘密は渡さない、です。値はチャットに貼りません。使わない環境スナップショットは、30日で消えるのが上限です。会話の90日とは別です。保管庫も環境も選ばずに始めた Agent が、自分だけの隠れた環境ではないなら、末尾の節を見てください。チームの既定の保管庫なしです。直せない、消せない、環境の秘密を足せないのは故障ではありません。名前の無い個人の環境がロックされていたら、名前を付けるまでロックです。特定の Build から始めたのに、直した environment.json が効かないなら、末尾の節を見てください。その Build の設定です。記録された設定で動きます。いまの environment.json や、親の新しい環境の版は使いません。Builds に Verify with Agent が無い、または押すと新しいタブが開くなら、Verify with Agent の節を見てください。新しいタブで確かめる用意です。出ないときは、チームが手動のBuildを許しているかを先に見てください。Trigger build が出せないときも、隣には出ません。環境の保管庫一覧に他のチームの Origin が無い、または自分のチームより上に出ないなら、共有された Origin の節を見てください。自分のチームのあとに出る、です。名前空間をまたいで足す、は画面からできます。以前はこのまたぎが API からだけでした。許可の出し方は、この案内にはありません。制限つき通信で CloudFront の配信が取れない、または実行中に通信の許可を変えたのに古い許可のままなら、CloudFront の節を見てください。CloudFrontは全部は開かない、です。必要なドメインは許可リストへ足します。実行中に許可リストが入れ替わる、のは、その Agent の、いまの環境の許可です。Cursorに置いた保管庫は速く取れる、も同じ節です。残るホスト名の一覧は、この案内にはありません。既定の環境で、いつもの接続が証明書エラーになるなら、証明書の節を見てください。危ないルートは信用しない、です。既定の土台はJavaも作り直す、も同じ節です。中間の秘密鍵が漏れた、が理由です。どのサイトが止まるかは、この案内にはありません。自前作業場なのに Desktop にファイルやターミナルが無い、またはマシンを再起動したあとに切れたように見えるなら、ライブの作業場の節を見てください。ライブの作業場を開く、です。Linuxを始めるときにオン、です。開き直すとつながる、も同じ節です。macOS や Windows、Cloud machine、スマホまでは、この案内では断定しません。プールもマシンも書いていない自前の実行が、思った作業場へ行かないなら、チームの既定のプールの節を見てください。チームの既定のプール、です。プールもマシンも指名しない、です。保管庫だけでは決まらない、も同じ節です。どの保管庫でも受ける、が残りを受けます。保管庫を開けるかの確認は残ります。Slack の順は、この節では書き換えていません。MCP の道具が失敗したように見えたら、権限の名前が載る案内の節を見てください。道具と足りない権限のカード、です。もう一度入っても届かない、なら管理者の承認です。許した権限は次の入室にも残る、も同じ節です。mcp_auth_error や、ログイン画面の連打とは別です。Gmail の道具が回数で止まったあとも、あとの呼び出しまで止まったように見えたら、Gmail の節を見てください。Gmailは待ってやり直す、です。あとのGmailは止めない、も同じ節です。Google カレンダーが権限の生の文で止まったように見えたら、カレンダーはつなぎ直す、です。スプレッドシートの道具が、いまのアカウントでは表を開けずに止まったように見えたら、表の節を見てください。表は別のアカウントでやり直す、です。ほかの表アカウントが見える、も同じ節です。開ける表でやり直せる、です。必ずやり直す、必ず開ける、とは書いてありません。引数のよくある間違いで止まったように見えたら、いちばん末尾の節を見てください。よくある引数は自動で直る、です。名指しはSlackと表とAirtableとJira、です。チームの MCP へ入ったあとに自分の入口が消えたように見えたら、チーム所有は入口とぶつからない、です。どの引数が直るか、必ず成功するか、入口の欄がどこかは、書いてありません。
このレッスンで出てくる用語
全部覚える必要はありません。気になる言葉だけ開いてみてください。
- SecretsAPI キーなど、コードに書かない秘密情報の置き場です
- Secret syncTeam Pool へ、ダッシュボードのチーム/利用者 Secrets を届ける仕組みです。My Machines には届きません。Cloud machine なら同期なしで Secrets が使えます
- Cloud onlyPlugins & MCPs のサーバーに出る状態のひとつです。Read-only と並び、マウスを載せると IDE や CLI で止まる理由が分かります。Team list の強制がオンのときだけ効く許可ルールもあります
- Privacy Mode の画面名プライバシー設定の表示は Privacy Mode(no training)と Legacy(no storage)です。no training は学習に使わない今のモード、no storage は保存しない旧モードです。個人プランから仲間を招待するとき、Share Cursor Analytics にチェックすると新しいチームの設定が変わり、入れなければ Privacy Mode のままです
- MCP外部サービス(DB や社内ツールなど)を Agent につなぐ接続口です
- MCP AppsMCP の道具が、会話の中へ触れる画面(表やボタン)を出せる拡張です。画面が出ない環境でも、同じ道具はふつうの返答として動きます
- 静的 OAuthFigma や Linear のように、固定の Client ID と戻り先 URL の許可リストで MCP へログインするつなぎ方です。動的な登録が使えないときの公式の方法です
- ElicitationMCP のサーバーが、途中で追加の入力をあなたに聞く動きです。壊れたのではなく、公式がサポートする確認の一種です
- MCP Allowlist会社の Enterprise で、どの MCP サーバーを使ってよいかを管理者が決める許可リストです。承認するだけで、全員に自動では入りません
- rename-chatいま見ている Cloud Agent の会話の名前を、Agent に付け直してもらう道具です。一覧と会話の見出しに出ます(200文字まで)
- Browser Origin Allowlist会社の Enterprise で、Agent のブラウザが自動で行ってよいサイトを管理者が決める許可リストです
- mcp_auth_errorMCP サーバーの認証に失敗したとき、Agent の実行イベントに出る公式の記録です。その MCP の道具だけスキップされ、実行自体は続きます
- setup_startedCloud Agent の仕事場の準備が始まったとき、実行イベントに出る公式の記録です。失敗イベントの手前に並ぶことが多いです
- setup_completedCloud Agent の仕事場の準備が終わったとき、実行イベントに出る公式の記録です。`setup_started` のあとに出れば、準備自体は成功しています
- setup_failedCloud Agent の仕事場(環境)の準備に失敗したとき、実行イベントに出る公式の記録です。Build ログや setup ログを見て原因を直します
- pr_creation_failedAgent が Pull Request を開こうとして失敗したとき、実行イベントに出る公式の記録です。権限・ブランチ保護・接続を疑います
- artifact_createdスクショ・動画・ログなどの成果物がアップロードされたとき、実行イベントに出る公式の記録です。PR や Agent 画面に添付されます
- Build triggerBuilds タブに表示される『きっかけ』の種類です。Recurring(定期)・Configuration change(設定変更)・Manual(手動)・Agent-requested(Agent 依頼)の4つがあります
- request-environment-setup-actionsCursor Cloud MCP の道具のひとつ。環境セットアップが Secret 追加などのユーザー操作待ちで止まったとき、Agent が『何をしてほしいか』を記録して依頼できます
- take-environment-snapshotCursor Cloud MCP の道具のひとつ。Agent が環境を直して動作確認できたあと、仕事場のスナップショットを保存するよう頼めます
- check-environment-snapshotCursor Cloud MCP の道具のひとつ。take-environment-snapshot で始めたスナップショット保存が完了したか、Agent に確認させられます
- run-infoCursor Cloud MCP の道具のひとつ。いま見ている実行の ID・URL・ブランチ・モデル・状態などを Agent に調べさせる入口です。診断はここから始めます
- get-eventsCursor Cloud MCP の道具のひとつ。いまの実行のダッシュボードイベント(setup_failed / pr_created など)を Agent に一覧させられます
- get-message-queueCursor Cloud MCP の道具のひとつ。いまの実行に、まだ処理されていないフォローアップ(追記メッセージ)が残っているかを Agent に確認させられます
- batch-fetch-detailsCursor Cloud MCP の道具のひとつ。複数の実行 ID をまとめて調べ、会話ログ・差分の有無・他の実行のイベントなどを Agent に取得させられます
- list-cloud-agentsCursor Cloud MCP の道具のひとつ。同じ環境や保管庫で動いた他の Cloud Agent 実行を、Agent に一覧させられます。診断のあと段です
- OIDC トークンCloud Agent の作業用コンピュータ内で、短い有効期限の認証トークンを発行する公式の仕組みです。AWS などへ長期の鍵を Secrets に置かずにアクセスしたいとき、詳しい人が使います
- エージェントメタデータCloud Agent の作業用コンピュータ内から読める、実行の付帯情報です。Agent ID、所有者、いまのターンを送った人、保管庫名など。Hooks やログ用で、認証情報ではありません
- pr_createdAgent が Pull Request を開けたとき、実行イベントに出る公式の記録です。PR タブが無くても、まずイベント一覧を確認します
- AGENTS.mdリポジトリに置く、Agent 向けの作業メモです。Cloud Agent 専用の起動・確認手順を書いておくと、検証まで届きやすくなります
- ガイド付きセットアップCloud Agents ダッシュボードや Agents Window から始める、公式推奨の環境づくりです。Agent に依存の install を任せ、共有ターミナルで進捗を見ながら、成功後に環境を保存します
- 環境スナップショット一度整えた Cloud Agent の仕事場を保存した『型』です。次回から同じ道具立てで素早く始められます
- Cloud Agent BuildsAgent が動く前に、clone と依存の install を済ませた仕事場の型をバックグラウンドで作る仕組みです。起動が速く、失敗しにくくなります
- environment builds are turned off管理者が Cloud Agent を全部、自前作業場へ回しているとき、クラウド側で環境を温める Build が止まっている印です。Builds タブにこの英文が出ます
- .cursorignoreAgent や Tab、@ 指定から外したいファイルのリストです。.gitignore と同じ書き方。API キーや .env を会話の文脈に載せたくないときに使います。ターミナルや MCP からは止めきれない、というのが公式の注意です
- Runtime SecretAgent の作業には使えますが、会話・ツール結果・コミット文面には『[REDACTED]』と伏せて出る秘密情報の種類です。API キーなど漏れたくない値向けです
- データ保持Cloud Agent の会話や環境スナップショットが、クラウドにどれくらい残るかのルールです。会話は既定で無期限、使わないスナップショットは、30日で消えるのが上限です。会話の90日とは別です
- Fix Build失敗した環境 Build を、Agent に調べさせて直す入口です。スナップショットが期限切れでも、最新の成功 Build から起動し、失敗ログを読みます
- environment.json のコメント`.cursor/environment.json` の `//`、ブロックコメント、末尾のカンマは、設定として読まれます。コメントがあっても「環境をセットアップしてください」とは出ません
- environment.json の場所保存した環境が、リポジトリの `.cursor/environment.json` を読むかどうかの指定です。None なら読みません
- 環境の載せ直しCLI で、すでにある Cloud Agent の環境へ environment ファイルを載せ直すことです。名前と保管庫は残ります
- ワーカーのチームCLI で出す自前のワーカーは、アカウントの既定のチームではなく、ログイン時に選んだチーム、または agent team switch で切り替えたチームで動きます
- 環境のページの秘密Cloud Agents ダッシュボードの、それぞれの環境のページで、その環境の秘密を見て足せる欄です。設定がロック中は、その欄から見たり足したりはできません。管理者が Disable personal secrets をオンにすると、個人の秘密は渡さない
- チームの既定の保管庫なしチームのメンバーが、保管庫も環境も選ばずに Cloud Agent を始めると使われる、チームの共有の、保管庫の無い既定の環境です。以前は個人の隠れた環境でした。誰も編集、改名、再ビルド、削除、環境の秘密の追加ができません
- その Build の設定特定の環境の Build から始めた Cloud Agent と子役が、起動時に使う用意です。その Build に記録された environment.json と設定です。記録された設定で動く、と覚えます。いまの environment.json でも、親の新しい環境の版でもありません
- Verify with Agent環境の Builds で、Trigger build の隣にあるリンクです。押すと新しいタブで新しい Agent が開き、Build が動くかを確かめる用意ができています。新しいタブで確かめる用意、と覚えます。あなたが Build を手動で始められ、チームが手動のBuildを許しているときだけ出ます
- 自分のチームのあとに出る環境を作るとき、または環境の保管庫を直すとき、保管庫の一覧に出る並びです。アクセスを許された、他のチームの名前空間の Origin が、自分のチームの保管庫のあとに出ます。自分のチームのあとに出る、と覚えます。名前空間をまたいで足す、は画面からできます
- チームの既定のプールチームの管理者が、Cloud Agents ダッシュボードの Self-Hosted で選ぶ自前の実行の行き先です。チームの既定のプール、と覚えます。プールもマシンも指名しない実行は、保管庫だけでは決まらないで、ここへ先に寄ります。そのプールがその保管庫を扱うなら、そこが受けます。扱わなければ、その保管庫を扱う別のチームのプールが受けます。どの保管庫でも受ける、が残りを受けます。保管庫を開けるかの確認は残ります
- 道具と足りない権限のカードCloud Agent の MCP の道具が、サインインに無い権限の名前で拒まれたとき、失敗の代わりに出るサインインの案内です。道具と足りない権限のカード、と覚えます。呼ぼうとした道具と、足りない権限の名前が載ります。もう一度入っても届かないときは、管理者の承認が要ります。この出し方で許した権限は次の入室にも残る、です
- Gmailは待ってやり直すCloud Agent の Gmail の道具が回数の上限で拒まれたとき、Google が求める短いあいだ待って、その呼び出しをやり直す案内です。Gmailは待ってやり直す、と覚えます。あとのGmailは止めない、です。以前のように、あとの Gmail の呼び出しをクールダウンでまとめて止めません。Google カレンダーの呼び出しが、接続に足りない権限で失敗したときは、生の権限エラーの代わりにアカウントの接続し直しを伝えます。カレンダーはつなぎ直す、です
- 表は別のアカウントでやり直すCloud Agent の Google スプレッドシートの道具が、いま使っているアカウントではその表を開けずに失敗したとき、ほかにつながっている表のアカウントを見てやり直せます。表は別のアカウントでやり直す、と覚えます。ほかの表アカウントが見える、です。開ける表でやり直せる、です。必ずやり直す、必ず開ける、とは書いてありません
- よくある引数は自動で直るCloud Agent の Slack、Google スプレッドシート、Airtable、Jira の道具呼び出しで、よくある引数の間違いは自動で直されます。よくある引数は自動で直る、と覚えます。名指しはSlackと表とAirtableとJira、です。チームが持っている MCP サーバーへサインインしても、同じ URL の自分の入口とはぶつからなくなりました。チーム所有は入口とぶつからない、です。どの引数が直るか、直したあとに必ず成功するかは、書いてありません
- ライブの作業場を開く自前作業場で動いている Agent を、Cursor のデスクトップアプリから開く入口です。ファイル、変更、ターミナル、転送されたポートがあります。ライブの作業場を開く、と覚えます。オンにするのは Linux のマシンを始めるときで、Linuxを始めるときにオン、です。マシンが再起動したあとは、その Agent を開くとまたつながります。開き直すとつながる、です
- 危ないルートは信用しないCloud Agent が最初から使う既定の環境は、emSign ECC Root CA - G3 と AAA Certificate Services を、もう信用しません。危ないルートは信用しない、と覚えます。中間の秘密鍵が漏れた、が理由です。コンピュータの証明書の一覧は更新され、既定の土台はJavaも作り直す、です。このルートを通した接続は、信用されずに失敗します
- CloudFrontは全部は開かない制限つき通信の Cloud Agent では、CloudFront のホストが最初から全部は届きません。残るのは、公開のコンテナイメージを取るためのホストだけです。CloudFrontは全部は開かない、と覚えます。ほかのドメインは許可リストへ足します。Cursorに置いた保管庫は速く取れる、も同じ変更です。実行中に許可リストが入れ替わる、のは、その Agent のいまの環境の許可です
- Environments API保存した Cloud Agent の環境(保管庫の束と environment.json)を、ダッシュボードと同じようにスクリプトから作ったり直したりする公式の入口です。いまはベータです
いま身についている開発者スキル
開発環境 / シークレット管理 / twelve-factor 的発想