Composio 串接

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

✅ 前提條件

• 您擁有一個 Composio 帳戶。

• 您希望將 Composio 的工具整合到 MaiAgent 的 AI 助理中使用。

🌐 步驟 1：訪問 Composio MCP 目錄

1. 開啟您的網頁瀏覽器，直接訪問連結進入 Composio MCP 工具目錄：

   • 這個頁面展示了所有可以與您的 AI 代理人整合的 Composio 工具和應用程式。

🔑 步驟 2：進行帳號登入

1. 在 Composio MCP 目錄頁面的右上角，找到並點擊 "Sign in" 按鈕。

2. 使用您的 Composio 帳號進行登入。

   • 如果您尚未擁有 Composio 帳號，可能需要先完成註冊程序。

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

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

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

🔐 步驟 4：進行身份驗證

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

1. 系統會彈出該服務的授權視窗，請您確認授予 Composio 訪問權限。

   • 例如，如果是 Google 服務，您需要選擇要授權的 Google 帳號，並確認授權範圍。

   • 這一步是必要的，因為 Composio 需要獲得您的授權才能代表您執行操作。

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

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

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

1. 點擊該按鈕後，系統將為您生成一個專屬的 MCP 伺服器。

   • 重要提示：Configure Actions 可以根據用戶實際會用到的功能進行選取，若沒有特別需求全選即可。

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

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

1. 開啟 MaiAgent 工具頁面。

2. 新增一個 MCP 工具。

3. 填寫工具配置：

   • 基礎設定: 根據使用者手冊建立工具完成基礎設定，並且工具類型選擇 MCP。

   • 伺服器 URL: 將您在步驟 5 中複製的 Composio MCP 伺服器 URL 貼到此處。

   • 參數 / 環境變數 / 允許的工具: 這些欄位保持空白即可，保存工具設置的時候 MaiAgent 會自動跟 MCP Server 取得。

4. 儲存設定。

⚠️ 注意事項

• URL 的私密性：再次強調，生成的 MCP Server URL 是私密的，請勿洩露。

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

• Composio 文件：Composio 的介面或流程可能會更新，建議隨時參考 Composio 官方最新的說明文件以獲取最準確的資訊。