U-Office Force X - MCP Server 與 OpenAPI 使用情境指南¶

U-Office Force X 系統因應企業數位轉型需求，提供了 MCP Server 與 OpenAPI 服務，讓企業能夠將 AI Agent 或外部應用與 U-Office Force X 系統進行整合，擴展系統間的對接服務應用，以實現自動化辦公流程與智慧化應用場景。本指南將說明有關於 MCP Server、OpenAPI 與OAuth Server 的使用情境說明。

U-Office Force X - OAuth Server¶

U-Office Force X OAuth Server 提供了完整的 OAuth 2.0 身份驗證與授權服務，讓外部應用程式（如 AI Agent）能夠安全的存取 U-Office Force X 系統的資源。透過 OAuth 2.0 流程，外部應用程式可以取得使用者個人在 U-Office Force X 的身份存取權杖 (Access Token)，以便在與 U-Office Force X 的互動中進行身份驗證和授權。

U-Office Force X - OpenAPI 服務¶

U-Office Force X 提供一組 RESTful API，讓外部系統能以程式方式與平台進行整合與互動。這些 API 涵蓋多種核心功能模組，例如：文件管理、組織/部門/員工管理、個人 BPM 表單、表單管理等。

透過 OpenAPI 服務，外部應用程式可以直接呼叫系統、執行相關操作。OpenAPI 支援兩種身份驗證與授權方式：

方式一：使用 Open API 金鑰¶

透過 U-Office Force X 管理者介面申請 Open API 金鑰，並在 API 請求中使用該金鑰進行身份驗證與授權。

適用情境

主要提供給系統管理或後端整合情境，例如：

同步組織、部門、員工資料
外部系統發起 U-Office Force X 表單（起單）
使用文件管理等相關功能

常見使用情境

系統整合：將 U-Office Force X 與其他企業系統（如 ERP、CRM）進行整合，以實現資料同步與流程自動化
自動化流程：利用 OpenAPI 服務自動化 U-Office Force X 中的工作流程，例如自動化文件審核與批准流程
資料存取與管理：開發自定義應用程式以存取和管理 U-Office Force X 中的資料，如文件、表單和使用者資訊

方式二：使用 OAuth¶

透過 U-Office Force X 管理者介面申請 開放授權金鑰(OAuth)，並在 API 請求中使用經由 U-Office Force X OAuth Server 所核發的 Access Token 進行身份驗證與授權。

適用情境

主要提供給以使用者個人情境由外部系統功能操作 U-Office Force X，例如：

取得個人在 U-Office Force X 的資料
查詢或操作個人待辦事項
核准或拒絕個人待簽表單

常見使用情境

個人化應用程式：開發個人化應用程式，讓使用者能夠透過第三方應用程式存取和管理其 U-Office Force X 資料

U-Office Force X - MCP Server 服務¶

U-Office Force X MCP Server 提供了 MCP (Model-Client Protocol) 服務，面向 AI Agent 應用的整合，讓 AI Agent 能夠透過標準化的協議與 U-Office Force X 系統進行互動。MCP Server 充當 AI Agent 與 U-Office Force X 之間的橋樑，將內部的資料和功能轉換成 MCP 標準格式，使 AI Agent 能夠以統一的方式存取和操作 U-Office Force X 的資源。

U-Office Force X MCP Server　內部整合了 U-Office Force X 的 OpenAPI 服務，並透過 MCP 協議將這些功能暴露給 AI Agent。這使得 AI Agent 能夠利用自然語言指令來觸發各種業務操作，例如查詢待辦事項、審核表單、檢視文件等，而無需深入了解底層的 API 細節。因此，我們建議開發者採用 U-Office Force X MCP Server 來實現 AI Agent 與 U-Office Force X 系統的整合應用，而非直接呼叫底層的 U-Office Force X　OpenAPI　服務。並且　U-Office Force X MCP Server　在身份驗證方面，一律採用 U-Office Force X　OAuth Server 機制，確保只有經過授權的 AI Agent 能夠存取 U-Office Force X 的資源和功能。