---
title: MCP 工具
description: Agent Lab MCP 伺服器上和部署有關的工具。AI 工具能做的事，不會超過你在主控台能做的。
url: https://agentlab.cresclab.com/docs/zh-tw/deploy/mcp-tools
language: zh-Hant-TW
updated: 2026-10-06
---

# MCP 工具

Agent Lab MCP 伺服器上和部署有關的工具。AI 工具能做的事，不會超過你在主控台能做的。

## 連線網址

```text
https://api.agentlab.cresclab.com/v1/mcp
```

連接方式見[用 AI 工具部署](https://agentlab.cresclab.com/docs/zh-tw/deploy/ai-agent.md#connect)。每個工具都要帶 `organization` 參數，值在連線時由伺服器告知。

## App 與版本

| 工具                    | 用途                                                 |
| ----------------------- | ---------------------------------------------------- |
| `sites_list`            | 列出 App，以及各自的網址和內網網址。                 |
| `sites_create`          | 建立 App。網址標籤不能重複使用。                     |
| `sites_deploy`          | 開始一個新版本，回傳上傳位址和權杖。                 |
| `sites_deploy_finalize` | 上傳完成後，送出這個版本開始建置。                   |
| `sites_deploy_status`   | 版本的階段、失敗原因、通訊埠和提示。                 |
| `sites_deploy_retry`    | 重試因平台出錯而失敗的版本，不用重新上傳。           |
| `sites_promote`         | 讓某個版本上線，也用來回到先前版本。                 |
| `sites_runtime_status`  | 正在服務的版本，以及就緒的執行個體數。               |
| `sites_restart`         | 不中斷服務，套用已儲存的設定。                       |
| `sites_files`           | 版本的檔案清單：路徑、大小和雜湊值，不回傳檔案內容。 |
| `sites_lifecycle`       | 暫停、恢復、移除或還原 App，所有分支一起生效。       |
| `sites_purge`           | 永久刪除 App，無法復原。                             |

## 排程工作

| 工具                                             | 用途                                       |
| ------------------------------------------------ | ------------------------------------------ |
| `scheduled_jobs_list`、`scheduled_jobs_get`      | 列出排程工作，或讀取一個。                 |
| `scheduled_jobs_create`、`scheduled_jobs_update` | 建立或修改。修改會取代整個設定，請先讀取。 |
| `scheduled_jobs_run`                             | 立即執行一次。                             |
| `scheduled_jobs_runs`                            | 執行紀錄，以及單次執行的記錄。             |
| `scheduled_jobs_lifecycle`                       | 暫停、恢復或刪除。                         |

## 分支與文件

| 工具                | 用途                                           |
| ------------------- | ---------------------------------------------- |
| `environments_list` | 列出組織的分支。                               |
| `docs_read`         | 以 Markdown 讀這份文件。不指定頁面時回傳目錄。 |

> [!NOTE] 有多個分支時要指定分支
> 組織有一個以上的分支時，每個呼叫都要指定分支，否則會以 `environmentRequired` 拒絕。

## 錯誤裡的文件連結

部署被拒收時，`sites_deploy_status` 的失敗原因會附上 `help`，指向[部署失敗排除](https://agentlab.cresclab.com/docs/zh-tw/deploy/troubleshooting.md)的英文 Markdown 版；映像檔提示會附上 `noticesHelp`，指向[容器執行合約](https://agentlab.cresclab.com/docs/zh-tw/deploy/runtime-contract.md#notices)。