前提条件
- CloudThinker に読み取らせたいボードを閲覧できる monday.com アカウント。
- monday.com の OAuth フローで CloudThinker を認可する権限。
- monday.com がまだ接続されていない CloudThinker ワークスペース。
エージェントが見えるのは認可したアカウントが見えるものだけです。そのアカウントが開けないボードは CloudThinker からも見えません。
セットアップ
1
CloudThinker を開く
CloudThinker ワークスペースで Connections → monday.com に移動します。
2
OAuth フローを開始する
Connect をクリックして monday.com の認可ページを開きます。
3
CloudThinker を認可する
使用したいボードにアクセスできる monday.com アカウントでサインインし、アクセスを承認します。
4
CloudThinker に戻る
認可後、CloudThinker は OAuth トークンを保存し、Connected ステータスを表示します。
接続詳細
monday.com は OAuth を使用するため、手動で入力する接続フィールドはありません。CloudThinker は認可フロー完了後にトークンを自動的に保存します。必要な権限
CloudThinker は OAuth 時に付与された monday.com のアクセス権を引き継ぎます。- 読み取り操作の対象は、認可したアカウントがすでに開けるワークスペース・ボード・アイテム・アップデート・ドキュメント・ユーザー・チーム・オートメーション・スプリントです。
- アイテムの作成、アイテムのカラム値の変更、アップデートの投稿という書き込み操作には、対応する monday.com の権限と CloudThinker での明示的な承認が必要です。
エージェントの機能
接続後、エージェントは以下を実行できます:接続を確認する
プロンプト例
トラブルシューティング
OAuth フローが完了しない
OAuth フローが完了しない
ブラウザーが別の monday.com アカウントでサインインしている可能性があります。目的のアカウントでサインインし、CloudThinker で接続フローをやり直してください。
エージェントがボードを空だと報告する
エージェントがボードを空だと報告する
monday.com は、存在しない・削除済み・閲覧できないボード ID に対してエラーではなく空のレコードを返します。まずワークスペースとボードの一覧を出させ、その一覧からボードを指定してください。
自分には見えるボードをエージェントが見つけられない
自分には見えるボードをエージェントが見つけられない
そのボードにアクセスできないアカウントで OAuth フローが実行された可能性があります。ボードを開けるアカウントで接続し直してください。最近アクセスしたボードは全体の一覧ではありません。ボードはワークスペースに属するため、エージェントはワークスペースを読まないと一覧を作れません。
スプリントサマリーが取得できない
スプリントサマリーが取得できない
スプリントサマリーには sprint summary カラムを持つ monday dev ボードが必要です。そのカラムがないボードはサマリーを返さないため、スプリントメタデータかボードレビューを依頼してください。
アイテムを変更する前にエージェントが停止する
アイテムを変更する前にエージェントが停止する
アイテムの書き込みは承認制です。CloudThinker で保留中のアクションを承認するか、認可した monday.com アカウントにそのボードの書き込み権限があるか確認してください。
セキュリティ
- 最小権限 — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
- デフォルトで読み取り専用 — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
- 認証情報のローテーション — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
- オフボーディング時に失効 — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。
- 書き込みの承認 — アイテムの作成・カラムの変更・アップデートは CloudThinker で承認制を維持してください。
- 取り消し手段がない — monday.com には削除やアーカイブのツールがないため、エージェントが作成したものは monday.com 側で直接削除してください。
関連
Atlassian 接続
Jira と Confluence の課題追跡とナレッジベース
承認
承認ゲート付きアクションの仕組み