Composio 串接 | MaiAgent

本指南將引導您完成從 Composio 獲取並設定 MCP (Model Context Protocol) 伺服器 URL 的步驟，以便您在 MaiAgent 的 AI 助理能夠利用 Composio 提供的 MCP Server 服務。

✅ 前提條件

您擁有一個 Composio 帳戶。
您希望將 Composio 的工具整合到 MaiAgent 的 AI 助理中使用。

🌐 步驟 1：訪問 Composio MCP 目錄

開啟您的網頁瀏覽器，直接訪問連結進入：
- 這個頁面展示了所有可以與您的 AI 代理人整合的 Composio 工具和應用程式。

🔑 步驟 2：進行帳號登入

在 Composio MCP 目錄頁面的右上角，找到並點擊 "Sign in" 按鈕。
使用您的 Composio 帳號進行登入。
- 如果您尚未擁有 Composio 帳號，可能需要先完成註冊程序。

登入成功後，頁面將更新為個人化的 MCP Dashboard，顯示您可以使用的所有工具和應用程式。

👆 步驟 3：選擇您需要的工具/應用程式

在 Composio MCP Dashboard中，瀏覽或搜尋您希望 AI 代理人使用的工具或應用程式 (例如 Google Drive, Slack, Jira, GitHub 等)。

🔐 步驟 4：進行身份驗證

找到工具後，若工具右上角狀態顯示 "Inactive" 需要先進行身份驗證才能啟用工具。

系統會彈出該服務的授權視窗，請您確認授予 Composio 訪問權限。
- 例如，如果是 Google 服務，您需要選擇要授權的 Google 帳號，並確認授權範圍。
- 這一步是必要的，因為 Composio 需要獲得您的授權才能代表您執行操作。

點選 "Connect" 授權完成後，您會被重定向回 Composio 平台。

🔗 步驟 5：生成並複製 MCP 伺服器 URL

在所選工具的頁面中，點選 "Create Server" 的按鈕。

點擊該按鈕後，系統將為您生成一個專屬的 MCP 伺服器。
- 重要提示：Configure Actions 可以根據用戶實際會用到的功能進行選取，若沒有特別需求全選即可。

完成設定步驟後，系統會提供一組 MCP 伺服器 URL。

💻 步驟 6：在 MaiAgent 建置 MCP 工具

開啟 MaiAgent 工具頁面。
新增一個 MCP 工具。
填寫工具配置：
- 伺服器 URL: 將您在步驟 5 中複製的 Composio MCP 伺服器 URL 貼到此處。
- 參數 / 環境變數 / 允許的工具: 這些欄位保持空白即可，保存工具設置的時候 MaiAgent 會自動跟 MCP Server 取得。
儲存設定。

⚠️ 注意事項

URL 的私密性：再次強調，生成的 MCP Server URL 是私密的，請勿洩露。
多個工具：如果您需要整合多個不同的應用程式 (例如同時使用 Google Drive 和 Slack)，您可能需要為每個應用程式在 Composio MCP 目錄中重複上述步驟 3 到 5，以獲取它們各自的 MCP 伺服器 URL，並在 MaiAgent 中分別設定不同的工具再分配給 AI 助理。