---
title: "MCP Server"
description: "將 ARX 的能力以 MCP tools 開放、為 agent 用戶端發放憑證，並限定各憑證的存取範圍"
canonical_url: "https://docs.ardge.com/zh-tw/guide/advanced/mcp-server"
---
# MCP Server

> 將 ARX 的能力以 MCP tools 開放、為 agent 用戶端發放憑證，並限定各憑證的存取範圍

<note>

**進階功能 / AI Agent 整合。** 如果沒有要讓外部 Agent 操作 ARX，這一頁可以跳過。

</note>

## 概觀

MCP Server 讓外部 AI Agent 在你授權後，安全地使用 ARX 的部分功能。

例如 Claude Desktop、Cursor 或其他支援 MCP 的 AI 工具，可以透過 MCP 連上 ARX。你可以為每個工具建立獨立憑證，並限制它只能查看或操作特定功能。

**AI Agent → 憑證驗證 → 指定權限 → 使用 ARX Tools**

此服務預設為關閉。

![控制台的 MCP 伺服器](https://docs.ardge.com/screenshots/guide/zh-tw/mcp-server.webp)

## 步驟 1：啟用 MCP Server

開啟後，支援 MCP 的用戶端才能連到 ARX。

關閉服務會中斷所有連線，但憑證會保留，重新開啟後即可恢復存取。

## 步驟 2：為用戶端建立憑證

**Credentials** 為每個用戶端建立一組具名憑證。建立時會發放一組 PAT token 供該用戶端連線使用。

<tip>

建議每一個 AI 用戶端 / 使用情境建立獨立憑證，不要多人共用同一組。

</tip>

![建立憑證](https://docs.ardge.com/screenshots/guide/zh-tw/mcp-02.webp)

## 步驟 3：設定權限

逐一憑證設定：對 Control Panel、AI Model Center、App Market 與 Log Center 各自給予 **None**、**Read** 或 **R/W**。

權限變更立即生效，用戶端不需要重新連線。

![憑證的權限範圍](https://docs.ardge.com/screenshots/guide/zh-tw/mcp-03.webp)

## 步驟 4：把連線設定加入 AI 用戶端

複製系統產生的 config 片段，貼進你的 agent 用戶端。

![MCP 用戶端設定](https://docs.ardge.com/screenshots/guide/zh-tw/mcp-04.webp)

## 安全建議

- 每個用戶端使用獨立憑證
- 只給完成任務所需的最小權限
- 不再使用的憑證直接刪除 —— 刪除會立即切斷使用它的用戶端
- 若懷疑 token 外洩，立即撤銷並重新建立


## Sitemap

See the full [sitemap](https://docs.ardge.com/sitemap.md) for all pages.
