> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# monday.com

> monday.com を CloudThinker に接続し、ボードのレビュー、停滞作業の分析、スプリント報告、承認制のアイテム更新を実現

monday.com アカウントを接続すると、CloudThinker のエージェントがボードをレビューし、動きの止まった作業を見つけ、アイテムの議論を読み、承認後にアイテムを更新できます。

monday.com は monday.com がホストする MCP サーバー経由で **OAuth** を使用するため、API トークンの作成や認証情報の貼り付けは不要です。

***

## 前提条件

* CloudThinker に読み取らせたいボードを閲覧できる **monday.com アカウント**。
* monday.com の OAuth フローで CloudThinker を認可する権限。
* monday.com がまだ接続されていない CloudThinker ワークスペース。

<Info>
  エージェントが見えるのは認可したアカウントが見えるものだけです。そのアカウントが開けないボードは CloudThinker からも見えません。
</Info>

***

## セットアップ

<Steps>
  <Step title="CloudThinker を開く">
    CloudThinker ワークスペースで **Connections → monday.com** に移動します。
  </Step>

  <Step title="OAuth フローを開始する">
    **Connect** をクリックして monday.com の認可ページを開きます。
  </Step>

  <Step title="CloudThinker を認可する">
    使用したいボードにアクセスできる monday.com アカウントでサインインし、アクセスを承認します。
  </Step>

  <Step title="CloudThinker に戻る">
    認可後、CloudThinker は OAuth トークンを保存し、**Connected** ステータスを表示します。
  </Step>
</Steps>

***

## 接続詳細

monday.com は OAuth を使用するため、手動で入力する接続フィールドはありません。CloudThinker は認可フロー完了後にトークンを自動的に保存します。

| フィールド          | 説明                                    |
| -------------- | ------------------------------------- |
| **OAuth トークン** | monday.com が発行し自動的に保存されます。手動での入力は不要です |

***

## 必要な権限

CloudThinker は OAuth 時に付与された monday.com のアクセス権を引き継ぎます。

* **読み取り操作**の対象は、認可したアカウントがすでに開けるワークスペース・ボード・アイテム・アップデート・ドキュメント・ユーザー・チーム・オートメーション・スプリントです。
* アイテムの作成、アイテムのカラム値の変更、アップデートの投稿という**書き込み操作**には、対応する monday.com の権限と CloudThinker での明示的な[承認](/ja/guide/approval)が必要です。

<Tip>
  CloudThinker に必要なボードだけに限定したアカウントで認可してください。monday.com の MCP サーバーには削除やアーカイブのツールがないため、エージェントが作成したものは monday.com 側で削除する必要があります。
</Tip>

***

## エージェントの機能

接続後、エージェントは以下を実行できます：

| 機能              | 説明                                                 |
| --------------- | -------------------------------------------------- |
| **アカウント検出**     | ワークスペース・ボード・ユーザー・チームの一覧表示と、他のリクエストが必要とするボード ID の取得 |
| **ボードレビュー**     | ボードのグループとカラム、およびステータスと担当者ごとの作業分布の要約                |
| **停滞作業**        | 指定期間内に動きのないアイテムを、古い順に検出                            |
| **アイテムのコンテキスト** | 行動する前にアイテムのアップデート・ボードのアクティビティ・monday ドキュメントを参照     |
| **スプリント報告**     | monday dev のスプリントボード・スプリントメタデータ・スプリントサマリーの参照       |
| **アイテムの書き込み**   | アイテムの作成、カラム値の変更、アップデートの投稿 — いずれも明示的な承認後に実行         |

### 接続を確認する

```text theme={null}
@alex list my monday.com workspaces and boards
```

### プロンプト例

```text theme={null}
@alex review the Tasks board on monday.com and #report how work splits by status and owner
@alex find monday.com items that have not moved in 14 days and #recommend what to chase first
@alex read the updates on the checkout bug item and summarize what is blocking it
```

***

## トラブルシューティング

<Accordion title="OAuth フローが完了しない">
  ブラウザーが別の monday.com アカウントでサインインしている可能性があります。目的のアカウントでサインインし、CloudThinker で接続フローをやり直してください。
</Accordion>

<Accordion title="エージェントがボードを空だと報告する">
  monday.com は、存在しない・削除済み・閲覧できないボード ID に対してエラーではなく空のレコードを返します。まずワークスペースとボードの一覧を出させ、その一覧からボードを指定してください。
</Accordion>

<Accordion title="自分には見えるボードをエージェントが見つけられない">
  そのボードにアクセスできないアカウントで OAuth フローが実行された可能性があります。ボードを開けるアカウントで接続し直してください。最近アクセスしたボードは全体の一覧ではありません。ボードはワークスペースに属するため、エージェントはワークスペースを読まないと一覧を作れません。
</Accordion>

<Accordion title="スプリントサマリーが取得できない">
  スプリントサマリーには sprint summary カラムを持つ monday dev ボードが必要です。そのカラムがないボードはサマリーを返さないため、スプリントメタデータかボードレビューを依頼してください。
</Accordion>

<Accordion title="アイテムを変更する前にエージェントが停止する">
  アイテムの書き込みは承認制です。CloudThinker で保留中のアクションを承認するか、認可した monday.com アカウントにそのボードの書き込み権限があるか確認してください。
</Accordion>

***

## セキュリティ

* **最小権限** — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
* **デフォルトで読み取り専用** — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
* **認証情報のローテーション** — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
* **オフボーディング時に失効** — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。

- **書き込みの承認** — アイテムの作成・カラムの変更・アップデートは CloudThinker で承認制を維持してください。
- **取り消し手段がない** — monday.com には削除やアーカイブのツールがないため、エージェントが作成したものは monday.com 側で直接削除してください。

***

## 関連

<CardGroup cols={2}>
  <Card title="Atlassian 接続" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/atlassian.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=64fcf0381646a233832602a9086a14eb" href="/ja/guide/connections/atlassian" width="24" height="24" data-path="images/icons/atlassian.svg">
    Jira と Confluence の課題追跡とナレッジベース
  </Card>

  <Card title="承認" icon="shield-check" href="/ja/guide/approval">
    承認ゲート付きアクションの仕組み
  </Card>
</CardGroup>
