monday.com 應用指南

OOMOL 支援你連接一次 monday.com 帳號，並把經過授權的 monday.com 工具提供給支援的 AI Agent、可重複使用的 Skills 和工作流程。本文說明如何新增 monday.com 應用、OOMOL 會使用哪些權限、Agent 可以在 monday.com 中做什麼、常見問題如何排查，以及如何移除應用。

連接外部帳號前，你需要先登入 OOMOL。要安裝 monday.com 應用，請登入 OOMOL，開啟 Connections，搜尋 monday.com，然後點擊 Connect 進入 monday.com OAuth 授權流程。

開啟 OOMOL Connections

前置條件

一個 OOMOL 帳號。
一個允許你授權第三方應用的 monday.com 帳號。
可以存取 OOMOL Console。
在 monday.com 中擁有授權所需 scopes 的權限。
如果你的 monday.com 帳號由組織管理，可能需要 monday.com 管理員先審批 OOMOL 應用。
Department 管理工具要求 monday.com Enterprise 帳號已啟用 departments。根據具體動作，目前連接使用者需要擁有 monday.com 對該動作要求的部門管理權限，例如相關 department 的 owner 權限，或帳號層級使用者管理權限。

新增應用

登入 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 後，確認 monday.com 已顯示為已連接。

如果任一步驟失敗，請查看常見問題排查。

授權後，OOMOL 會儲存呼叫 monday.com 工具所需的連接資訊。之後，你就可以在 OOMOL 支援的 Agent、可重複使用的 Skills 和工作流程中使用 monday.com 工具。

OOMOL 在 monday.com 中做什麼

連接帳號後，OOMOL 會提供可用的 monday.com 動作。根據你執行的動作不同，Agent 可以讀取 account 資訊、boards、items、updates、docs、assets、workspaces、users、teams 和 departments。當使用者要求寫回 monday.com 時，Agent 也可以建立或更新 board 資料、發布 updates、建立或更新 docs、整理 workspaces，或管理 departments。

安裝完成後，OOMOL 不會自行開始使用 monday.com。只有當已授權使用者、可重複使用的 Skill、支援的 Agent 動作或已批准的 OOMOL 工具呼叫提供必要輸入時，monday.com 工具才會執行。

常見使用方式包括：

Board automation：讀取 board 資料、建立或更新 items，並把結果寫回 monday.com。
Project updates and reporting：總結 item updates、產生狀態報告，並寫入 monday.com docs 或 item updates。
File and document tasks：讀取 monday.com assets、從檔案中擷取資訊，並建立或更新 monday.com docs。
Team routing：使用 monday.com users、teams 和 departments，把工作路由給正確負責人或團隊。
Workspace and department administration：協助授權使用者透過明確的管理動作整理 workspaces 和管理 monday.com departments。

安裝後檢查

monday.com 跳回 OOMOL 後，請先在 OOMOL Console 中確認 monday.com 連接狀態為已連接。之後你可以：

如果要在支援的 AI Agent 環境中使用已連接的 monday.com 工具，設定 oo CLI。
使用 demo boards、items、updates、docs、assets 和 workspaces 測試讀取和寫入動作。
僅在 monday.com 帳號支援 department 管理、且連接使用者擁有 monday.com 對該動作要求的部門管理權限時，使用 demo departments 測試 department 動作。這類權限包括相關 department 的 owner 權限或帳號層級使用者管理權限。

使用方式

monday.com 工具需要先連接 monday.com 帳號後才能使用。OOMOL 中顯示的具體工具列表可能隨 connector 更新而變化；目前 monday.com connector 包含讀取目前連接使用者、account、boards、workspaces、users、teams、updates、docs、assets 和 departments 的工具，也包含在授予所需 scopes 後寫入 boards、workspaces、updates、docs 和 departments 的工具。

透過 oo CLI 使用 monday.com 工具

如果你要在支援的 AI Agent 環境中使用已連接的 monday.com 工具，請在登入 OOMOL 後安裝並設定 oo CLI。

登入 OOMOL Console。
開啟 oo CLI 安裝頁面。
按照頁面中的說明操作。該頁面會提供一鍵複製的提示詞，用於在支援的 AI Agent 環境中安裝並設定 oo CLI。
完成 oo CLI 設定，並在 OOMOL 中連接 monday.com 後，就可以讓 Agent 使用已連接的 monday.com 工具處理 demo boards、docs、updates 和 departments。

具體 prompt 可以根據 Agent 環境調整。例如，你可以讓 Agent 確認目前連接的 account、總結 demo board、建立測試 item、發布狀態 update、產生 monday.com doc、列出 departments，或在帳號支援 department 管理時建立 demo department。

使用的權限

OOMOL 使用 monday.com 權限，讓已授權的 monday.com 使用者可以把 monday.com 作為一個 App 連接到 OOMOL，然後把經過授權的 monday.com 工具提供給 Agent、可重複使用的 Skills 和工作流程。

monday.com OAuth 授權頁面中顯示的具體 scopes 是目前安裝的準確資訊。根據帳號啟用的工具不同，目前 monday.com connector 可能請求以下 scopes：

monday.com scope	對應工具	OOMOL 使用原因
`me:read`	Get Current User	識別授權連接的 monday.com 使用者，並在 OOMOL 中顯示已連接帳號。
`account:read`	Account read tools	讀取基礎 account 資訊，讓使用者和 Agent 在執行工具前確認目前連接的是哪個 monday.com account。使用者可以存取多個 monday.com accounts 時，這個權限可以避免操作到錯誤帳號。
`boards:read`	Board read tools	讓 Agent 讀取使用者請求或工作流程所需的 boards、items、columns、groups 和 board structure。
`boards:write`	Board write tools	當使用者、Skill 或工作流程要求 OOMOL 把結果寫回 monday.com 時，建立或更新 board 資料。
`workspaces:read`	Workspace read tools	讓 Agent 在讀取、整理或寫入 monday.com 資料前找到正確 workspace、board 或 folder。
`workspaces:write`	Workspace administration tools	當授權使用者明確要求 workspace 管理時，讓 Agent 建立、更新或整理 workspaces。
`users:read`	User read tools	讓 Agent 解析 monday.com users，用於分派、路由、mentions、owner 和稽核上下文。
`teams:read`	Team read tools	讓 Agent 理解 monday.com team membership，並把工作路由給正確團隊。
`updates:read`	Update read tools	讓 Agent 讀取 item updates，用於摘要、報告、後續任務和上下文取得。
`updates:write`	Update write tools	讓 Agent 向 item updates 發布評論、摘要、工作流程結果或後續說明。
`docs:read`	Doc read tools	讓 Agent 讀取使用者選擇或工作流程作為輸入使用的 monday.com docs。
`docs:write`	Doc write tools	讓 Agent 建立或更新 monday.com docs，例如報告、brief、產生的文件和工具輸出。
`assets:read`	Asset read tools	當 monday.com 中的文件和 asset metadata 被用作工作流程輸入時，讓 Agent 讀取它們。
`departments:read`	Department read tools	讓 Agent 列出 departments，並理解 department owner、成員或路由上下文。
`departments:write`	Department administration tools	讓授權使用者透過明確的 Agent 動作和管理任務管理 monday.com departments。

如果 monday.com 管理員沒有授予某個必需權限，monday.com 連接可能失敗，或依賴該權限的工具不可用，直到該權限被授予。Department 寫入動作還要求目前連接使用者擁有 monday.com 對該動作要求的部門管理權限，例如相關 department 的 owner 權限，或帳號層級使用者管理權限。

團隊連接與 private boards

獲得共享 monday.com connection 使用權限的 Team 成員，可以透過這條 connection 已開放的操作，存取連接帳號可以存取的 boards，其中包括 private boards。

成員權限和介面呼叫範圍決定哪些成員可以使用每條 connection，以及可以呼叫哪些操作。完整權限模型請參閱權限控制。

支援的 monday.com 工具

工具範圍	支援的功能	常見使用情境	前置條件
Current user	讀取已授權 monday.com 使用者的 profile 資訊。	在 Agent 或工作流程使用 monday.com 前確認連接的是哪個 monday.com 使用者。	已在 OOMOL 中連接 monday.com，且連接帳號處於可用狀態。
Account	讀取已連接 monday.com account 的基礎資訊。	在執行工作流程前確認 account 資訊，尤其適合一個使用者屬於多個 monday.com accounts 的情況。	已在 OOMOL 中連接 monday.com，且連接帳號處於可用狀態。
Boards	讀取和寫入連接帳號可存取的 board 資料。	總結 board、建立或更新 items、把任務結果寫入 columns，或準備專案報告。	連接帳號可以存取目標 board，且工作流程具有有效 board 或 item identifiers。
Updates	讀取和發布 item updates。	總結近期活動、擷取 action items，或向 item 發布產生的狀態 update。	連接帳號可以存取目標 item 或 board，且工作流程具有目標 update 或 item 上下文。
Docs	讀取、建立或更新 monday.com docs。	將 board 活動整理成專案報告、會議記錄、brief 或可重複使用的文件。	連接帳號可以存取目標 doc 或位置，且工作流程具有所需 doc 內容。
Assets	讀取連接帳號可存取的文件和 asset metadata。	將附件作為擷取、摘要、報告或文件產生的工作流程輸入。	連接帳號可以存取目標 asset。
Users and teams	讀取 monday.com users 和 teams。	解析 assignees、owners、reviewers、mentions、team routing 和 escalation paths。	連接帳號可以存取相關 user 或 team 資訊。
Workspaces	讀取、建立、更新或整理 workspaces。	設定專案區域、整理 boards 或 folders，或支援 workspace 管理任務。	連接帳號擁有執行 workspace 動作所需的 monday.com 權限。
Departments	讀取、建立、更新、刪除、指派或清除 department 資訊。	透過明確的管理任務維護 department structure 和使用者 department assignments。	連接帳號是已啟用 departments 的 monday.com Enterprise 帳號，且連接使用者擁有 monday.com 對該動作要求的部門管理權限，例如相關 department 的 owner 權限，或帳號層級使用者管理權限。

讀取 account 資訊、boards、updates、docs、assets、users、teams 和 departments

使用情境：讓 Agent 在總結工作、產生報告、準備後續事項、路由任務或執行請求動作前，取得 monday.com 上下文。

前置條件：

已在 OOMOL 中連接 monday.com。
連接的 monday.com 帳號可以存取請求的 account 資訊、board、item、update、doc、asset、user、team、workspace 或 department。
Agent、Skill 或工作流程已經取得所需 identifier、搜尋輸入或已選擇的 monday.com object。

工具行為：

讀取連接帳號和已授予 OAuth scopes 可存取的 monday.com 資料。
傳回請求的 Agent 動作或工作流程所需的 monday.com 資料。
唯讀操作不會修改 monday.com。

寫入 boards、updates、docs 和 workspaces

使用情境：讓 Agent 把使用者請求或工作流程的結果寫回 monday.com，例如建立或更新 board 資料、發布狀態 update、產生 doc，或整理 workspace。

前置條件：

已在 OOMOL 中連接 monday.com。
連接的 monday.com 帳號有權限修改目標物件。
使用者、Skill 或工作流程提供了寫入目標和內容。
提供的值對 monday.com 有效，例如有效的 board IDs、item IDs、doc IDs、column values、workspace IDs 和必填欄位。

工具行為：

根據提供的輸入建立或更新支援的 monday.com 物件。
動作完成後，傳回 monday.com 提供的結果。
除非目前工作流程提供了目標，否則不會寫入無關的 monday.com 物件。

管理 departments

使用情境：讓授權使用者透過明確的 department 管理動作管理 monday.com departments，例如維護 department structure，或讓 monday.com departments 與內部組織工作流程保持一致。

Department 管理工具使用 departments:write，包括：

每個 account member 同一時間只能屬於一個 department。將使用者指派到某個 department 會取代該使用者既有的 department 歸屬；清除使用者 department 會移除該使用者目前唯一的 department 歸屬。

工具	支援的功能	必需輸入	結果
`create_department`	建立 department。	`data` 中必須包含 `name`；`reserved_seats` 可選。	傳回建立後的 department，包括 `id`、`name`、`reserved_seats`、`assigned_seats`、`members` 和 `owners`。
`update_department`	更新既有 department。	`department_id` 和 `data`，其中 `data` 至少包含 `name` 或 `reserved_seats` 之一。	傳回更新後的 department。
`delete_department`	刪除 department。	`department_id`。	傳回 monday.com 提供的已刪除 department 資訊。
`assign_department_members`	將使用者指派到一個 department，並取代這些使用者既有的 department 歸屬。	`department_id` 和 `user_ids`。	傳回 monday.com 提供的 `successfulUsers` 和 `failedUsers`。
`clear_users_department`	清除使用者目前唯一的 department 歸屬。	`user_ids`。	傳回 `clearedUsers`。

前置條件：

已在 OOMOL 中連接 monday.com。
連接的 monday.com 帳號是 Enterprise 方案，並已啟用 departments。
連接的 monday.com 使用者擁有 monday.com 對該動作要求的部門管理權限，例如相關 department 的 owner 權限，或帳號層級使用者管理權限。
使用者、Skill 或工作流程提供了所需 department ID、user IDs 和更新資料。

工具行為：

只有當使用者、Skill、Agent 動作或工作流程明確請求 department 管理時才會執行。
根據提供的輸入建立、更新、刪除、指派或清除 department 資料。
將使用者指派到新 department 時，會取代該使用者目前的 department 歸屬。
傳回 monday.com 結果，包括 monday.com 提供的成功和失敗使用者指派結果。

delete_department 和 clear_users_department 會影響組織層級結構和使用者歸屬。執行這些動作前，請檢查目標 department 和 user IDs；測試時請使用 demo departments。

測試應用

你可以使用一個允許授權 app 的 monday.com 帳號測試 monday.com 應用。建議使用 demo boards、demo docs、demo updates、demo assets 和 demo departments，這樣可以安全測試讀取和寫入動作。

Customer onboarding demo 流程

這個流程會先建立本次測試專用的 demo item，再重複使用傳回的 ID。它不依賴某個已存在的 item、doc 或 asset 名稱。

開始前：

選擇一個連接帳號有權限建立 items 的 demo board。
準備一個小的 demo 檔案，例如 acme-demo-requirements.txt。
只使用 demo data，不要使用真實客戶、員工、專案或機密內容。

確認目前連接的 monday.com 上下文，並找到 demo board：

Use Monday to confirm the connected user and account, then list available workspaces and boards. Keep the output concise and include ids.

在目標 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，將 demo 檔案上傳到該 item 的 Files tab。繼續下一步前，先確認檔案已經顯示在 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：

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.

這個流程會涵蓋 Agent 使用 connector 時的核心行為：確認 account 上下文、讀取 boards 和 item 上下文、讀取 updates 和 assets、建立 docs，並將 updates 寫回 monday.com。Department 和 workspace 管理可在連接帳號啟用這些管理工具後，使用 demo data 單獨測試。

範例測試 prompts

Get the current connected monday.com user and account.
List monday.com boards visible to the connected account.
Summarize a demo board and post the summary as an item update.
Create a demo item in a test board.
Read recent updates from a demo item.
Create a monday.com doc from a demo project summary.
Read a demo asset attached to a test item.
Create a demo workspace named OOMOL Demo Workspace, then rename it to OOMOL Demo Workspace Archive.
List monday.com users and teams visible to the connected account.
List monday.com departments.
Create a demo department named OOMOL Demo Department.
Update the demo department’s reserved seats.
Assign a test user to the demo department, replacing any current department assignment for that user.
Clear the test user’s current department assignment.
Delete the demo department.

測試時請只使用 demo data，不要在測試 prompt 中使用真實客戶、員工、專案或機密 monday.com 內容。

常見問題排查

無法新增 monday.com 應用

確認你登入的是正確的 OOMOL 帳號。
確認你正在登入想要連接的 monday.com 帳號。
確認 monday.com 帳號允許第三方 app 和請求的 OAuth scopes。
如果你的 monday.com 帳號屬於某個組織，請讓 monday.com 管理員確認 OOMOL 應用是否需要審批。
如果 OOMOL 中已有失敗或不完整的 monday.com 連接，先中斷它，再重新連接。
如果問題仍然存在，請聯絡 OOMOL 支援，並附上 OOMOL 帳號電子郵件、monday.com 帳號或組織資訊、嘗試連接的時間、錯誤訊息或截圖。

monday.com 工具找不到 board、item、update、doc、asset、workspace、user、team 或 department

確認連接的 monday.com 帳號可以存取請求的物件。
確認工作流程使用了正確的 monday.com ID、搜尋輸入、board、item、doc、asset、workspace、user、team 或 department。
檢查物件是否存在於已連接到 OOMOL 的 monday.com 帳號中。
如果你最近調整過 monday.com 權限或 app scopes，請在 OOMOL 中重新連接 monday.com，以重新整理授權狀態。

monday.com 工具無法寫入資料

確認連接的 monday.com 帳號可以直接在 monday.com 中完成同樣的修改。
確認工具呼叫包含所有必需輸入。
檢查提供的值對 monday.com 是否有效，例如 column values、item IDs、board IDs、workspace IDs、doc content、department IDs 和 user IDs。
如果 monday.com 傳回 policy 或 permission error，請讓 monday.com 管理員檢查連接帳號權限和 app 授權。

Department 動作失敗

確認連接的 monday.com 帳號是 Enterprise 方案，並已啟用 departments。
確認連接使用者擁有 monday.com 對該動作要求的部門管理權限，例如相關 department 的 owner 權限，或帳號層級使用者管理權限。
確認 department ID 和 user IDs 有效。
注意每個使用者同一時間只能屬於一個 department。將使用者指派到某個 department 會取代該使用者既有的 department 歸屬。
對於 assign_department_members，查看 successfulUsers 和 failedUsers，確認 monday.com 接受或拒絕了哪些使用者。
對於 update_department，至少包含一個可編輯欄位：name 或 reserved_seats。
對於 delete_department 和 clear_users_department，確認目標是 demo 資料或你確實要操作的生產資料。

移除應用

你可以從 OOMOL 或 monday.com 任一側移除 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 設定。
找到 OOMOL。
開啟 app 詳細資料。
選擇 uninstall、disconnect 或 remove 等移除操作。
確認移除。

如果你無法在 monday.com 中移除 app，請讓 monday.com 管理員移除。

移除後會發生什麼

monday.com 連接被移除或取消授權後，OOMOL 無法繼續為你的帳號使用 monday.com 工具。
依賴 monday.com 的工作流程、Agent、Skills 或其他任務會失敗，直到你重新連接 monday.com。
移除前已建立或更新的 monday.com boards、items、updates、docs、assets、workspaces、departments 和 assignments 仍會保留在 monday.com 中，除非你在 monday.com 中修改或刪除它們。
移除應用不會刪除你的 OOMOL 帳號。

資料處理

OOMOL 只會在 monday.com 使用者授權應用，並且使用者、Skill、已批准的 Agent 動作或工作流程需要 monday.com 時存取 monday.com 資料。OOMOL 只會為提供 OOMOL 支援的 Agent、可重複使用的 Skills 和工作流程請求的 monday.com 工具而使用 monday.com 資料。

monday.com OAuth tokens 會加密儲存。
OOMOL 不會向 AI Agent、提示詞、瀏覽器用戶端、應用程式碼或終端使用者暴露 monday.com OAuth token。
呼叫 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 不會作為該 connector 的一部分在背景持續同步或複製 monday.com 帳號資料。只有當已授權使用者、Skill、已批准的 Agent 動作或工作流程呼叫 monday.com 工具時，才會存取 monday.com 資料。
當你移除或取消授權 monday.com 應用後，OOMOL 會停止使用已撤銷的 monday.com 授權。OOMOL 會按照正常連接移除流程刪除或失效已儲存的 monday.com 授權 tokens。
某些日誌、支援記錄、安全記錄或帳單相關記錄可能會按隱私權政策保留。

FAQ

我需要付費 monday.com 帳號嗎？

大多數 OOMOL monday.com 工具要求 monday.com 帳號可以授權請求的 scopes。某些 monday.com 功能、app 審批控制、department 管理工具、workspace 權限或帳號原則可能取決於你的 monday.com 方案和組織設定。

可以連接多個 monday.com 帳號嗎？

請在 OOMOL Console 中查看你的帳號或 workspace 目前可用的連接選項。如果你需要多個 monday.com 帳號相關協助，請聯絡支援。

連接後，Agent 會自動使用 monday.com 嗎？

連接 monday.com 會讓 monday.com 工具在 OOMOL 中可用，但是否使用工具仍取決於你選擇的 Agent、工作流程、Skill、權限和審批。基於帳號的服務仍然需要你的授權。

OOMOL 會持續同步 monday.com 資料嗎？

OOMOL 按需存取 monday.com 資料：已授權使用者、Skill、已批准的 Agent 動作或工作流程呼叫 monday.com 工具時，才會讀取或修改對應資料。

OOMOL 可以刪除 monday.com 資料嗎？

目前 monday.com connector 包含用於明確 department 管理動作的 delete_department。除非使用者、Skill、已批准的 Agent 動作或工作流程使用帶有所需目標資訊的受支援刪除工具，否則 OOMOL 不會刪除 monday.com 資料。

所有 monday.com 方案都支援 department 管理嗎？

monday.com department API 適用於支援 departments 的 Enterprise 帳號。寫入動作還要求目前連接使用者擁有 monday.com 對該動作要求的部門管理權限，例如相關 department 的 owner 權限，或帳號層級使用者管理權限。

聯絡支援

如果你在新增、使用、測試或移除 monday.com 應用時需要協助，請聯絡 OOMOL 支援：

電子郵件：support@oomol.com
支援頁面：https://oomol.com/zh-tw/support/

請附上你的 OOMOL 帳號電子郵件、相關 monday.com 帳號或組織資訊、你正在執行的操作，以及錯誤訊息或截圖。