建立 MCP 工具

MCP ( Model Context Protocol ) 工具用於整合多雲平台服務或執行本地客戶端應用程式。

快速建立 MCP 工具

1. 進入工具管理介面

首先，請從左側導航欄進入「 AI 功能」區塊，然後點擊「🔧 工具」。進入工具列表頁面後，點選右上角的「➕ 新增工具」按鈕。

2. 選擇工具類型

工具類型請選擇 MCP。

3. 設定顯示名稱

為工具設定清晰的顯示名稱，這邊設為 Composio mcp for google calendar。

• 用途：此名稱將會顯示在平台介面中，供所有用戶查看。

• 建議：選擇一個能清晰表達工具主要功能的名稱，方便用戶理解。此名稱沒有嚴格的格式限制。

4. 填寫 MCP 配置

a. 🔗MCP 伺服器網址

• 用途：MaiAgent 目前接受外部的 MCP 伺服器，透過提供 MCP 伺服器的服務位址(URL)， AI 助理就可以調用 MCP 服務連結外部應用。

• 格式：

  • 請填寫完整的 URL (例如：https://mcp.dev/maiagent/mcp_service)。

• 注意：此欄位為必填。

在此處貼上您的 MCP server 網址，系統將會自動抓取該 server 內已連結的工具列表：

b. 🎛️ MCP 命令參數 (mcp_args)

• 用途：定義在執行 MCP 命令或呼叫 MCP 服務時需要傳遞的參數名稱，內容由 AI 助理自動產生。

• 格式：建議使用 JSON 陣列 (Array) 的格式，其中每個元素都是一個字串代表一個參數。

  • 範例 (JSON 陣列)：

    复制

    [
        "--user",
        "admin",
        "--config",
        "/path/to/config.yaml"
    ]

  • 實際執行時：AI 助理會將這些參數按順序傳遞給 MCP 工具

  • 如果您輸入的是一個以逗號分隔的字串 (例如：arg1,arg2,arg3)，系統會嘗試將其解析為參數列表。為避免歧義，推薦使用 JSON 陣列。

c. 🌳 MCP 環境變數 (mcp_env)

• 用途：為 MCP 命令的執行環境設定必要的環境變數。

• 格式：必須是有效的 JSON 物件，其中鍵 (Key) 是環境變數的名稱，值 (Value) 是環境變數的內容 (字串)。

  • 範例：

    复制

    {
      "API_KEY": "{{SECRET_MCP_API_KEY}}",
      "REGION": "us-west-1",
      "DEBUG_MODE": "true"
    } 

5. 找到「允許的工具(JSON 數組)」，點按重新取得

• 用途：指定在此 MCP 客戶端下，AI 助理被授權可以使用的具體子工具列表。一個 MCP 客戶端可能提供多個不同的功能或子工具。

• 自動偵測/留空：如果此欄位留空或未提供，系統在初次連接 MCP 客戶端時，會嘗試自動偵測所有可用的子工具，並預設允許所有偵測到的子工具。若您希望限制 AI 助理只能使用特定的子工具，請在此明確列出。

點按後，系統會自動抓取與該 server 連結的工具內容，並顯示在列表中：

6. 💾 儲存工具

確認所有設定無誤後，捲動到頁面底部，點擊「確認」按鈕。您的新工具就建立完成了！

⚠️ 重要提醒

連線測試

• 建立工具後，建議先測試 MCP 連線是否正常

• 可在測試環境中驗證工具功能

權限管理

• 謹慎選擇允許的工具，避免授權過多不必要的功能

• 定期檢查工具使用狀況

故障排除

• 如果連線失敗，請檢查 MCP 伺服器網址是否正確

• 確認環境變數和參數格式符合要求