monday.com App ガイド
OOMOL では monday.com を一度接続するだけで、認可済み monday.com ツールを対応 AI エージェント、再利用可能な Skills、workflows から利用できます。このガイドでは、monday.com App の追加方法、OOMOL が使用する権限、エージェントが monday.com で実行できること、よくある問題の解決方法、App の削除方法を説明します。
OOMOL は、外部アカウントを接続する前にユーザーのサインインを要求します。monday.com App をインストールするには、OOMOL にサインインし、Connections を開き、monday.com を検索し、Connect を選択して monday.com OAuth 認可フローを開始します。
前提条件
- OOMOL アカウント。
- 第三者 App の認可が許可されている monday.com アカウント。
- https://console.oomol.com/ の OOMOL Console へのアクセス。
- 要求された monday.com scopes を持つ App を認可する monday.com 権限。
- monday.com アカウントが組織に管理されている場合、認可する前に monday.com 管理者が OOMOL App を承認する必要があります。
- Department administration tools には、departments が有効な monday.com Enterprise アカウントが必要です。アクションに応じて、接続済みユーザーには、対象 department の owner access や users を管理する account-level permission など、monday.com が要求する department administration rights が必要です。
App を追加する
- OOMOL Console にサインインします。
- Connectables を開くか、直接 Connections に移動します。
- monday.com を検索します。
- monday.com を選択し、Connect を選びます。
- OOMOL が monday.com にリダイレクトします。求められた場合は monday.com にサインインします。
- 要求された権限を含め、monday.com の認可画面を確認します。
- monday.com から選択を求められた場合は、接続する account または workspace を選択します。
- Authorize、Allow、または monday.com が表示する同等の認可アクションを選択します。
- monday.com から OOMOL に戻った後、OOMOL の connections で monday.com が接続済みとして表示されることを確認します。
いずれかの手順が失敗した場合は、トラブルシューティング を参照してください。
認可後、OOMOL は monday.com ツールをお客様に代わって呼び出すために必要な接続を保存します。その後、OOMOL 対応エージェント、再利用可能な Skills、workflows から monday.com ツールを使用できます。
OOMOL が monday.com で行うこと
OOMOL は、アカウントを接続した後に monday.com アクションを利用可能にします。実行するアクションに応じて、エージェントは account context、boards、items、updates、docs、assets、workspaces、users、teams、departments を読み取れます。ユーザーが board data の作成や更新、updates の投稿、docs の作成や更新、workspaces の整理、departments の管理を依頼した場合、エージェントは monday.com に書き戻すこともできます。
OOMOL は、インストール後に自動で monday.com を使い始めません。monday.com ツールは、認可済みユーザー、再利用可能な Skill、対応エージェントアクション、または承認済み OOMOL ツール呼び出しが必要な入力を提供したときに実行されます。
主な用途:
- Board automation: board data を読み取り、items を作成または更新し、結果を monday.com に書き戻します。
- Project updates and reporting: item updates を要約し、status reports を生成し、monday.com docs または item updates に reports を書き込みます。
- File and document tasks: monday.com assets を読み取り、files から情報を抽出し、monday.com docs を作成または更新します。
- Team routing: monday.com users、teams、departments を使って、作業を適切な owner または group にルーティングします。
- Workspace and department administration: 明示的な administration actions を通じて、認可済みユーザーが workspaces を整理し、monday.com departments を管理できるようにします。
インストール後
monday.com から OOMOL に戻った後、OOMOL Console で monday.com 接続が接続済みとして表示されていることを確認します。その後、以下を行えます。
- 対応 AI エージェント環境で接続済み monday.com ツールを使いたい場合は、
oo-cliを設定します。 - デモ boards、items、updates、docs、assets、workspaces を使って、読み取りと書き込みアクションをテストします。
- monday.com アカウントが department administration をサポートし、接続済みユーザーが対象 department の owner access や users を管理する account-level permission など、monday.com が要求する department administration rights を持つ場合にのみ、デモ departments を使用してください。
使い方
monday.com ツールは、monday.com アカウントを接続した後にのみ利用できます。OOMOL に表示される正確なツール一覧はコネクタの更新により変わる場合がありますが、現在の monday.com コネクタには、接続済み user、account、boards、workspaces、users、teams、updates、docs、assets、departments の読み取りツールと、必要な scopes が付与された場合に boards、workspaces、updates、docs、departments へ書き込むツールが含まれます。
oo-cli で monday.com ツールを使う
接続済み monday.com ツールを対応 AI エージェント環境で利用できるようにするには、OOMOL にサインインした後で oo-cli をインストールして設定します。
- OOMOL Console にサインインします。
- oo-cli インストールページ を開きます。
- そのページの手順に従います。対応 AI エージェント環境に
oo-cliをインストールして設定するためのワンクリックコピー用プロンプトが用意されています。 oo-cliの設定が完了し、monday.com が OOMOL に接続されたら、デモ boards、docs、updates、departments を使って接続済み monday.com ツールを使用するようエージェントに依頼します。
具体的なエージェントプロンプトは環境によって異なります。たとえば、接続済み account の確認、demo board の要約、test item の作成、status update の投稿、monday.com doc の生成、departments の一覧表示、またはアカウントが department administration をサポートする場合は demo department の作成を依頼できます。
使用する権限
OOMOL は monday.com 権限を使用し、認可済み monday.com ユーザーが monday.com を OOMOL の App として接続し、承認済み monday.com ツールをエージェント、再利用可能な Skills、workflows で利用できるようにします。
monday.com OAuth 中に表示される正確な scopes が、そのインストールの正しい情報源です。現在の monday.com コネクタは、お客様のアカウントで有効なツールに応じて以下の scopes を要求する場合があります。
| monday.com scope | 使用するツール | OOMOL が使用する理由 |
|---|---|---|
me:read | Get Current User | 接続を認可した monday.com ユーザーを識別し、OOMOL に接続済み account を表示するため。 |
account:read | Account read tools | ユーザーやエージェントがツール実行前に、どの monday.com account が接続されているか確認できるように基本 account 情報を読み取るため。複数の monday.com accounts にアクセスできるユーザーに役立ちます。 |
boards:read | Board read tools | ユーザーの依頼や workflows に必要な boards、items、columns、groups、board structure をエージェントが読み取れるようにするため。 |
boards:write | Board write tools | ユーザー、Skill、workflow が OOMOL に結果を monday.com へ書き戻すよう依頼したとき、エージェントが board data を作成または更新できるようにするため。 |
workspaces:read | Workspace read tools | monday.com data の読み取り、整理、書き込みの前に、エージェントが適切な workspace、board、folder を見つけられるようにするため。 |
workspaces:write | Workspace administration tools | 認可済みユーザーが workspace administration を明示的に依頼したとき、エージェントが workspaces を作成、更新、整理できるようにするため。 |
users:read | User read tools | assignments、routing、mentions、ownership、audit context のために monday.com users を解決できるようにするため。 |
teams:read | Team read tools | monday.com team membership を理解し、作業を適切な team にルーティングできるようにするため。 |
updates:read | Update read tools | summaries、reports、follow-up tasks、context gathering のために item updates を読み取れるようにするため。 |
updates:write | Update write tools | comments、summaries、workflow results、follow-up notes を item updates に投稿できるようにするため。 |
docs:read | Doc read tools | ユーザーが選択した、または workflow が入力として使う monday.com docs をエージェントが読めるようにするため。 |
docs:write | Doc write tools | reports、briefs、generated documentation、tool outputs などの monday.com docs を作成または更新できるようにするため。 |
assets:read | Asset read tools | workflow 入力として使われる monday.com の添付 files と asset metadata を読み取れるようにするため。 |
departments:read | Department read tools | departments を一覧表示し、department ownership、membership、routing context を理解できるようにするため。 |
departments:write | Department administration tools | 認可済みユーザーが明示的なエージェントアクションと administration tasks を通じて monday.com departments を管理できるようにするため。 |
monday.com 管理者が必要な権限を付与しない場合、monday.com 接続が失敗するか、その権限に依存するツールが権限付与まで利用できない場合があります。Department write actions には、対象 department の owner access や users を管理する account-level permission など、monday.com が要求する department administration rights も必要です。
対応 monday.com ツール
| ツール領域 | 対応機能 | 主な用途 | 前提条件 |
|---|---|---|---|
| Current user | 認可済み monday.com user のプロフィール情報を読み取ります。 | エージェントまたは workflow が monday.com を使う前に、どの monday.com user が接続されているか確認します。 | monday.com が OOMOL に接続され、接続済み account が有効であること。 |
| Account | 接続済み monday.com account の基本情報を読み取ります。 | workflow 実行前に account context を確認します。特にユーザーが複数の monday.com accounts に属している場合に役立ちます。 | monday.com が OOMOL に接続され、接続済み account が有効であること。 |
| Boards | 接続済み account がアクセスできる board data を読み書きします。 | board を要約し、items を作成または更新し、task results を columns にコピーし、project report を準備します。 | 接続済み account が target board にアクセスでき、workflow に有効な board または item identifiers があること。 |
| Updates | item updates を読み取り、投稿します。 | recent activity を要約し、action items を抽出し、generated status update を item に投稿します。 | 接続済み account が target item または board にアクセスでき、workflow に target update または item context があること。 |
| Docs | monday.com docs を読み取り、作成、更新します。 | board activity を project report、meeting note、brief、reusable documentation に変換します。 | 接続済み account が target doc または location にアクセスでき、workflow に必要な doc content があること。 |
| Assets | 接続済み account で利用できる files と asset metadata を読み取ります。 | attachments を extraction、summarization、reporting、document generation の workflow 入力として使用します。 | 接続済み account が target asset にアクセスできること。 |
| Users and teams | monday.com users と teams を読み取ります。 | assignees、owners、reviewers、mentions、team routing、escalation paths を解決します。 | 接続済み account が関連 user または team 情報にアクセスできること。 |
| Workspaces | workspaces を読み取り、作成、更新、整理します。 | project area の設定、boards または folders の整理、workspace administration tasks の支援を行います。 | 接続済み account が workspace action に必要な monday.com 権限を持つこと。 |
| Departments | department 情報を読み取り、作成、更新、削除、割り当て、クリアします。 | 明示的な administration tasks を通じて department structure と user department assignments を維持します。 | 接続済み account が departments 有効の monday.com Enterprise account であり、接続済み user が対象 department の owner access や users を管理する account-level permission など、monday.com が要求する department administration rights を持つこと。 |
account context、boards、updates、docs、assets、users、teams、departments を読む
用途: 作業の要約、report 生成、follow-up 準備、task routing、要求された action の実行前に、エージェントが monday.com context を収集できるようにします。
前提条件:
- monday.com が OOMOL に接続されている。
- 接続済み monday.com account が、要求された account information、board、item、update、doc、asset、user、team、workspace、department にアクセスできる。
- エージェント、Skill、workflow が必要な identifier、search input、または選択済み monday.com object を持っている。
ツールが行うこと:
- 接続済み account と付与済み OAuth scopes で利用できる monday.com data を読み取ります。
- 要求されたエージェントアクションまたは workflow に必要な monday.com data を返します。
- 読み取り専用アクション中に monday.com を変更しません。
boards、updates、docs、workspaces に書き込む
用途: board data の作成または更新、status update の投稿、doc の生成、workspace の整理など、ユーザー依頼または workflow の結果をエージェントが monday.com に書き戻せるようにします。
前提条件:
- monday.com が OOMOL に接続されている。
- 接続済み monday.com account に target object を変更する権限がある。
- ユーザー、Skill、workflow が target と書き込む content を提供している。
- valid board IDs、item IDs、doc IDs、column values、workspace IDs、required fields など、値が monday.com に対して有効である。
ツールが行うこと:
- 提供された入力に基づいて、対応する monday.com objects を作成または更新します。
- アクション完了後に monday.com が利用可能にする結果を返します。
- active workflow がその targets を提供しない限り、無関係な monday.com objects には書き込みません。
departments を管理する
用途: department structure の維持や monday.com departments と社内組織 workflow の整合など、認可済みユーザーが明示的な department administration actions を通じて monday.com departments を管理できるようにします。
Department administration tools は departments:write を使用し、以下を含みます。
各 account member は一度に 1 つの department にのみ所属できます。user を department に割り当てると、その user の既存 department assignment が置き換えられます。user の department をクリアすると、現在の department assignment が削除されます。
| ツール | 対応機能 | 必須入力 | 結果 |
|---|---|---|---|
create_department | department を作成します。 | name を含む data。reserved_seats は任意です。 | 作成された department を返します。id、name、reserved_seats、assigned_seats、members、owners が含まれます。 |
update_department | 既存 department を更新します。 | department_id と、name または reserved_seats の少なくとも一方を含む data。 | 更新された department を返します。 |
delete_department | department を削除します。 | department_id。 | monday.com が利用可能にする削除済み department 情報を返します。 |
assign_department_members | users を 1 つの department に割り当て、それら users の既存 department assignment を置き換えます。 | department_id と user_ids。 | monday.com から successfulUsers と failedUsers を返します。 |
clear_users_department | users の現在の単一 department assignment をクリアします。 | user_ids。 | clearedUsers を返します。 |
前提条件:
- monday.com が OOMOL に接続されている。
- 接続済み monday.com account が departments 有効の Enterprise plan である。
- 接続済み monday.com user が、対象 department の owner access や users を管理する account-level permission など、monday.com が要求する department administration rights を持っている。
- ユーザー、Skill、workflow が必要な department ID、user IDs、update data を提供している。
ツールが行うこと:
- ユーザー、Skill、agent action、workflow が department administration を明示的に要求した場合にのみ実行します。
- 提供された入力に基づいて department data を作成、更新、削除、割り当て、クリアします。
- user を新しい department に割り当てると、その user の現在の department assignment を置き換えます。
- monday.com が提供する場合、successful と failed の user assignment results を含む monday.com 結果を返します。
delete_department と clear_users_department は organization-level structure と user assignments に影響する可能性があります。これらのアクションを実行する前に target department と user IDs を確認し、テストでは demo departments を使用してください。
App をテストする
App の認可が許可されている account で monday.com App をテストできます。読み取りと書き込みアクションを安全に試すため、demo boards、demo docs、demo updates、demo assets、demo departments を使用してください。
顧客オンボーディングのデモフロー
この flow は独自の demo item を作成し、返された IDs を再利用します。特定の名前を持つ既存 item、doc、asset には依存しません。
始める前に:
- 接続済み monday.com account が items を作成できる demo board を選択します。
acme-demo-requirements.txtなどの小さな demo file を用意します。- デモデータのみを使用してください。実際の customer、employee、project、confidential content を使用しないでください。
-
接続済み monday.com context を確認し、demo board を見つけます。
Use Monday to confirm the connected user and account, then list available workspaces and boards. Keep the output concise and include ids. -
target board に demo item を作成します。
<BOARD_ID>を前のステップで返された board ID に置き換えます。Use Monday to create a new item in board ID <BOARD_ID> named "Customer onboarding - Acme Demo". Then post an update on the new item explaining that it tracks the demo customer's onboarding work. Return the new item id and update id. Keep the output concise. -
monday.com で新しく作成した item を開き、item の Files タブに demo file をアップロードします。続行する前に、その file が monday.com に表示されることを確認します。
-
demo item、updates、attached assets を読み取ります。
<NEW_ITEM_ID>を item 作成時に返された item ID に置き換えます。Use Monday to read item ID <NEW_ITEM_ID>, including item details, recent updates, and attached assets. Summarize the item status, updates, and asset metadata such as file name, asset id, file type, and file size. Keep the output concise. -
demo doc を作成し、読み返します。
<WORKSPACE_ID>を最初のステップで返された workspace ID に置き換えます。Use Monday to create a Monday doc named "Acme Demo onboarding status report - video demo" in workspace ID <WORKSPACE_ID>. After creating it, read the newly created doc by its returned id and confirm its id and title. Do not add body content to the doc. Keep the output concise. -
demo item に status report を投稿します。
Use Monday to post an update on item ID <NEW_ITEM_ID> with a concise status report based on the item updates and attached asset metadata. Keep the output concise.
この flow は、エージェントが使う主要なコネクタ動作を確認します。account context の確認、boards と item context の読み取り、updates と assets の読み取り、docs の作成、monday.com への updates の書き戻しです。Department と workspace administration は、それらの admin tools が接続済み account で有効な場合に、demo data で別途テストできます。
テストプロンプト例
- 現在接続されている monday.com user と account を取得して。
- 接続済み account に表示される monday.com boards を一覧表示して。
- demo board を要約し、その summary を item update として投稿して。
- test board に demo item を作成して。
- demo item の recent updates を読んで。
- demo project summary から monday.com doc を作成して。
- test item に添付された demo asset を読んで。
OOMOL Demo Workspaceという名前の demo workspace を作成し、OOMOL Demo Workspace Archiveに名前変更して。- 接続済み account に表示される monday.com users と teams を一覧表示して。
- monday.com departments を一覧表示して。
OOMOL Demo Departmentという名前の demo department を作成して。- demo department の reserved seats を更新して。
- test user を demo department に割り当て、その user の現在の department assignment を置き換えて。
- test user の現在の department assignment をクリアして。
- demo department を削除して。
テスト中はデモデータのみを使用してください。テストプロンプトに実際の customer、employee、project、confidential monday.com content を使用しないでください。
トラブルシューティング
monday.com App を追加できない
- 正しい OOMOL アカウントにサインインしていることを確認します。
- 接続したい monday.com アカウントにサインインしていることを確認します。
- monday.com アカウントが第三者 Apps と要求された OAuth scopes を許可していることを確認します。
- monday.com アカウントが組織に属している場合、OOMOL App に承認が必要かどうか monday.com 管理者に確認します。
- OOMOL で失敗または途中状態の monday.com 接続を切断し、もう一度接続してみます。
- 問題が続く場合は、OOMOL サポートに連絡し、OOMOL アカウントのメール、利用可能であれば monday.com account または organization、試行時刻、エラーメッセージまたはスクリーンショットを含めてください。
monday.com ツールが board、item、update、doc、asset、workspace、user、team、department を見つけられない
- 接続済み monday.com account が要求された object にアクセスできることを確認します。
- workflow が正しい monday.com ID、search input、board、item、doc、asset、workspace、user、team、department を使用していることを確認します。
- object が OOMOL に接続された monday.com account に存在するか確認します。
- monday.com 権限または App scopes を最近変更した場合は、認可状態を更新するために monday.com を OOMOL で再接続します。
monday.com ツールがデータを書き込めない
- 接続済み monday.com account が monday.com で同じ変更を直接実行できることを確認します。
- ツール呼び出しにすべての必須入力が含まれていることを確認します。
- column values、item IDs、board IDs、workspace IDs、doc content、department IDs、user IDs など、提供された値が monday.com に対して有効であることを確認します。
- monday.com が policy または permission error を返す場合、monday.com 管理者に接続済み account の権限と App 認可を確認してもらいます。
department action が失敗する
- 接続済み monday.com account が Enterprise plan で、departments が有効であることを確認します。
- 接続済み user が、対象 department の owner access や users を管理する account-level permission など、monday.com が要求する department administration rights を持つことを確認します。
- department ID と user IDs が有効であることを確認します。
- 各 user は 1 つの department にのみ所属できることを覚えておいてください。user を department に割り当てると、既存の department assignment が置き換えられます。
assign_department_membersでは、monday.com が受け入れた users と拒否した users を確認するためにsuccessfulUsersとfailedUsersを確認します。update_departmentでは、編集可能なフィールドnameまたはreserved_seatsの少なくとも一方を含めます。delete_departmentとclear_users_departmentでは、demo data または意図した production data を対象にしていることを確認します。
App を削除する
monday.com App は OOMOL または monday.com のどちらからでも削除できます。OOMOL に monday.com へのアクセスを許可し続けたくない場合は、両方から削除することを推奨します。
OOMOL から monday.com を削除する
- OOMOL Console にサインインします。
- Connections を開きます。
- 接続済み Apps から monday.com を探します。
- monday.com 接続の詳細を開きます。
- Disconnect、Remove、または OOMOL に表示される同等の削除アクションを選択します。
- 削除を確認します。
monday.com から OOMOL を削除する
- monday.com にサインインします。
- アカウントの monday.com App management、admin、または connected apps settings を開きます。
- OOMOL を探します。
- App の詳細を開きます。
- App をアンインストール、切断、削除するアクションを選択します。
- 削除を確認します。
monday.com で Apps を削除できない場合は、monday.com 管理者に App の削除を依頼してください。
削除後に起きること
- monday.com 接続が削除または認可解除されると、OOMOL はそのアカウントで monday.com ツールを使用できなくなります。
- monday.com に依存する workflows、agents、Skills、その他の tasks は、monday.com を再接続するまで失敗する場合があります。
- 削除前に作成または更新された既存の monday.com boards、items、updates、docs、assets、workspaces、departments、assignments は、monday.com で変更または削除しない限り monday.com に残ります。
- App を削除しても OOMOL アカウントは削除されません。
データの取り扱い
OOMOL は、monday.com ユーザーが App を認可し、ユーザー、Skill、承認済みエージェントアクション、または workflow が monday.com を必要とする場合にのみ monday.com データへアクセスします。OOMOL は、OOMOL 対応エージェント、再利用可能な Skills、workflows を通じて要求された monday.com ツールを提供する目的でのみ monday.com データを使用します。
- monday.com OAuth トークンは暗号化して保存されます。
- monday.com OAuth トークンは AI エージェント、プロンプト、プロジェクトファイル、エンドユーザーに公開されません。
- monday.com ツールが呼び出されたとき、OOMOL は monday.com account、user、team、department、workspace、board、item、update、doc、asset metadata を処理する場合があります。
- monday.com データは、ユーザーに表示されるツール結果、利用記録、実行履歴、運用記録に必要な範囲でのみ保存される場合があります。
- 保存データは保存時に暗号化され、TLS/SSL で送信されます。
- OOMOL は monday.com データを販売しません。
- OOMOL は monday.com データを広告に使用しません。
- OOMOL は非公開の顧客コンテンツを AI モデルのトレーニングに使用しません。
- OOMOL はこのコネクタの一部として、monday.com account data をバックグラウンドで継続的に同期または複製しません。monday.com データは、認可済みユーザー、Skill、承認済みエージェントアクション、または workflow が monday.com ツールを呼び出したときにアクセスされます。
- monday.com App を削除または認可解除すると、OOMOL は取り消された monday.com 認可の使用を停止します。OOMOL は通常の接続削除プロセスに従って、保存された monday.com 認可トークンを削除または無効化します。
- 一部のログ、サポート記録、セキュリティ記録、請求関連記録は、プライバシーポリシー に記載のとおり保持される場合があります。
FAQ
有料 monday.com アカウントは必要ですか?
ほとんどの OOMOL monday.com ツールでは、要求された scopes を認可できる monday.com アカウントが必要です。一部の monday.com 機能、App approval controls、department administration tools、workspace permissions、account policies は、monday.com プランと組織設定に依存する場合があります。
複数の monday.com アカウントを接続できますか?
OOMOL Console で、お客様のアカウントまたは workspace で現在利用できる接続オプションを確認してください。複数の monday.com accounts について支援が必要な場合は、サポートに連絡してください。
接続後、エージェントは monday.com を自動的に使えますか?
monday.com を接続すると OOMOL で monday.com ツールが利用可能になりますが、ツールの利用は選択した agent、workflow、Skill、権限、承認に依存します。アカウントベースのサービスでは引き続きお客様の認可が必要です。
OOMOL は monday.com データを継続的に同期しますか?
いいえ。OOMOL はこのコネクタの一部として、monday.com データをバックグラウンドで継続的に同期または複製しません。monday.com データは、認可済みユーザー、Skill、承認済みエージェントアクション、または workflow が monday.com ツールを呼び出したときにアクセスされます。
OOMOL は monday.com データを削除できますか?
現在の monday.com コネクタには、明示的な department administration actions 用の delete_department が含まれます。OOMOL は、ユーザー、Skill、承認済みエージェントアクション、または workflow が必要な target 情報を指定して対応削除ツールを使用しない限り、monday.com データを削除しません。
department administration はすべての monday.com プランで使えますか?
いいえ。monday.com department APIs は、departments をサポートする Enterprise accounts でのみ利用できます。Write actions には、対象 department の owner access や users を管理する account-level permission など、monday.com が要求する department administration rights も必要です。
サポートに連絡する
monday.com App の追加、使用、テスト、削除について支援が必要な場合は、OOMOL サポートに連絡してください。
- Email: support@oomol.com
- サポートページ: https://oomol.com/ja/support/
OOMOL アカウントのメール、関連する場合は接続済み monday.com account または organization、実行しようとしたアクション、エラーメッセージまたはスクリーンショットを含めてください。