接続を追加する
1
サービスを選択
以下のカタログを参照し、接続したいサービスのガイドを開きます。
2
認証情報を作成
ガイドに従って最小権限の認証情報を作成します。可能な限り読み取り専用で設定してください。
3
接続
CloudThinker で Connections に移動し、サービスを選択して認証情報を入力します。接続は Connected ステータスに変わります。
4
確認
エージェントに新しい接続に対する質問をします。各ガイドには確認用プロンプトが含まれています。
Environment を設定する
各接続には Environment があります: Production、Staging、Development、Not set のいずれかです。これは接続を読む人とエージェントのためのラベルです。エージェントの変更を実行するか、人の承認を待つか、拒否するかを決める条件である Rules は、この項目を読みません。接続ダイアログは environment を尋ねないため、接続した直後に設定してください。Microsoft Azure のように接続を 1 つしか持てないサービスと、GitHub のように OAuth でサインインするサービスは、Not set から変更できません。接続ごとに扱いを変えたい場合は、その接続を名前で指定する Rule を書いてください。
接続した後に起きること
接続が初めて Connected になると、CloudThinker は Discovery を実行します。これは接続したサービスを 1 回だけバックグラウンドで調査するものです。結果は接続の詳細パネルの Discovery セクションに入ります。
Discovery は自動で 1 回、最大 30 分実行されます。最初に得られる有用な答えになることが多いので、最初のプロンプトを書く前に確認してください。認証情報の権限を広げた後などは、Run Discovery で再実行できます。再実行にはワークスペースの Admin ロールが必要です。
Discovery はクレジットを消費し、費用はサービスが保持しているデータ量によって変わります。デイリークレジットは使えないため、ワークスペースの残高にクレジットが必要です。残高が不足すると通知を出して一時停止するので、クレジットを追加して Run Discovery をクリックしてください。
Discovery はチャットと同じツールと Approvals を使いますが、答える人がいないため承認を待つことはありません。人に尋ねることになる呼び出しはスキップされ、Discovery は読み取れる範囲で続行します。時間の上限に達した場合は Partial discovery として終了し、すでに検証した結果を保持します。何も検証できなかった場合は Discovery could not finish と表示されます。どちらの場合も接続は動作し続けます。
アクセスの仕組み
すべての接続は 1 つのワークスペースに属します。そのワークスペースで作業する人は誰でも、CloudThinker とカスタムエージェントも含めて、設定をやり直すことなく利用できます。
Organization の Owner と Admin は、すべてのワークスペースで Admin を持ちます。ワークスペースロールを参照してください。
エージェントが接続で何をできるかは、2 つの制御で決まります。
Manual は書き込みのたびに人に尋ねます。新しいワークスペースの既定は Auto · Rules + AI · Ask me で、Allow Rule または AI の判断が安全な変更を承認し、残りはあなたに尋ねます。Allow Rule が実際に判断するのは、CloudThinker があなたのワークスペースで Rule の適用を有効にした後だけです。これは既定では無効なので、それまでは Manual を選んでください。
各セットアップガイドの Write access または Agent capabilities セクションに、その接続がどの状態で始まるかが書かれています。切り替えを持たない接続もあります。その場合は認証情報が上限を決め、変更はすべて Approvals を通ります。Rancher のような読み取り専用の接続には、許可できる書き込み操作がそもそもありません。
プライベートなサービスに到達する
接続は CloudThinker Cloud から実行されるため、サービスはインターネットからの接続を受け付けられる必要があります。社内の vCenter、PostgreSQL、Prometheus、Argo CD など、プライベートネットワーク上にあるものではこれが問題になります。認証情報をローテーションする
保存済みの認証情報は、接続を解除せずに差し替えられます。接続はエイリアス、設定、履歴をそのまま保ちます。AWS の IAM ロール接続は短命な STS 認証情報を使うため、ローテーションするものはなく、External ID も変わりません。アクセスキー、クライアントシークレット、JSON キー、API トークンにはローテーションが必要です。1
プロバイダー側で新しい認証情報を作成する
先に新しいキーまたはトークンを作成します。入れ替えが終わるまで古いものは有効にしておきます。
2
CloudThinker で差し替える
More → Workspace settings → Connections でサービスを開き、アカウントの行の鉛筆アイコンをクリックし、Edit Instance で保存済みの認証情報の横にある Replace… をクリックします。新しい値を入力して Save and test をクリックします。Success state: テストが通り、接続は Connected のままになります。テストが失敗した場合、CloudThinker は以前の認証情報を保持してエラーを表示します。
3
古い認証情報を失効させる
プロバイダー側で古いキーを削除または無効化します。
- 解除から再接続までの間、エージェント、スケジュールされた automation、Optimize の更新はそのサービスを使えません。
- Discovery が再実行され、クレジットを消費します。
- Allow writes は既定値に戻ります。多くの接続では既定がオンです。オフにしていた場合は、もう一度オフにしてください。
- その接続を名前で指定している Rules が、まだ一致しているか確認してください。
接続が壊れたとき
バックグラウンドで認証情報が使えなくなると (トークンの期限切れ、キーの失効、ロールの削除)、接続は Error に切り替わります。AWS では連続して 3 回バックグラウンドで失敗する必要があるため、一度の不調では切り替わりません。他の接続は、バックグラウンドのトークン更新または実行が認証エラーになった時点で切り替わります。ワークスペースの admin には、障害 1 件につき 1 通の通知が届きます。再試行の失敗ごとではありません。自分で実行したテストでは誰にも通知されません。 接続が Error の間、それに依存するスケジュール実行はスキップされます。Optimize のコスト更新、スケジュールされた automation、Pulse のアラート取得が含まれます。 復旧の手順:- プロバイダー側で原因を解消します。たとえばロールを復元する、新しいキーを発行するなどです。
- 接続を開きます。詳細パネルにエラーが表示されます。Retry をクリックして保存済みの認証情報を再テストするか、Replace credentials をクリックして新しい値を入力します。OAuth 接続の場合は Connect をクリックして再度サインインします。
- ステータスが Connected に戻ると、スケジュール実行は次の周期から再開します。
接続を解除する
More → Workspace settings → Connections でサービスを開きます。アカウントの行があるサービスでは、アカウントの行のゴミ箱アイコンをクリックします。接続を 1 つしか持てないサービスでは、詳細パネルの Disconnect をクリックします。Disconnect ダイアログで確認します。これは取り消せません。 解除が完了した時点で、エージェントはそのサービスへのアクセスを失います。解除してもプロバイダー側のロール、キー、トークンは削除されないため、その後プロバイダー側で削除してください。 サービスを再び接続すると、それは新しい接続になります。- Discovery が再実行され、クレジットを消費します。
- Allow writes は既定値に戻り、Environment は Not set に戻ります。
- Rules は Alias で接続を照合します。再接続時に同じ Alias を使えば、その接続を指定した Rule は引き続き一致します。
クラウドプラットフォーム
インフラとアクセス
データベース
メッセージングとストリーミング
オブザービリティと監視
CI/CDとコード品質
インシデントとチケット管理
カスタムMCP
カタログにないサービスは、カスタムMCP接続として追加できます。コネクターコードは不要です。
セキュリティ
- 最小権限 — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
- デフォルトで読み取り専用 — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
- 認証情報のローテーション — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
- オフボーディング時に失効 — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。
関連
AWSを接続
IAMロールまたはアクセスキーで最もよく使われる接続を設定します。
カスタムMCP接続
Model Context Protocolに対応するあらゆるツールでエージェントを拡張します。
エージェントを確認
CloudThinker が接続でできることを確認します。
自動化と自律性
Manual または Auto モードで、エージェントが接続サービスに対してアクションを実行できるようにします。