# MCP Client 安裝指南
> 元心建材內部系統 AI 助理安裝說明
---
## 前置需求
1. **Claude Desktop** - 下載並安裝
- Windows: https://claude.ai/download
- Mac: https://claude.ai/download
2. **Node.js 20+** - 下載並安裝
- https://nodejs.org/
---
## 安裝步驟
### Step 1: 取得你的 FSUID
請向管理員索取你的 FSUID，格式如下：
```
FSUID_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
```
### Step 2: 設定 Claude Desktop
1. 開啟 Claude Desktop
2. 點擊右上角 **設定** (齒輪圖示)
3. 選擇 **Developer** → **Edit Config**
4. 在設定檔中加入以下內容：
```json
{
"mcpServers": {
"yes-ceramics": {
"command": "npx",
"args": ["-y", "github:jameslai-sparkofy/mcp-internal#thin-client"],
"env": {
"FSUID": "你的FSUID",
"CLOUD_RUN_URL": "https://mcp-internal-backend-43pfffyjia-de.a.run.app"
}
}
}
}
```
5. 將 `你的FSUID` 替換成你實際的 FSUID
6. 儲存檔案
7. **重新啟動 Claude Desktop**
### Step 3: 驗證安裝
重新開啟 Claude Desktop 後，在對話框輸入：
```
查詢最近的商機
```
如果能看到商機列表，表示安裝成功！
---
## 設定檔位置
| 系統 | 設定檔路徑 |
|------|-----------|
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
| Mac | `~/Library/Application Support/Claude/claude_desktop_config.json` |
---
## 你可以做什麼？
安裝完成後，你可以用自然語言請 Claude 幫你：
### 商機管理
- 「查詢今年贏單的商機」
- 「找出我負責的商機」
- 「這個商機的採購單有哪些？」
### 工程管理
- 「查詢 SPC 工單」
- 「這個案場的施工進度」
- 「新增一個維修單」
### 產品查詢
- 「搜尋磁磚產品」
- 「這個 SKU 的價格是多少？」
### 獎金查詢（僅限自己的）
- 「查詢我的獎金」
---
## 權限說明
| 角色 | 權限範圍 |
|------|---------|
| **業務** | 自己參與的商機相關資料 |
| **工務** | 工程/統包物件 + 自己參與的商機 |
| **助理** | 所有物件（獎金除外） |
| **管理員** | 完整權限 |
> 獎金資料只能查看自己是負責人的記錄
---
## 常見問題
### Q: 看不到 MCP Server？
重新啟動 Claude Desktop，確認設定檔格式正確（JSON 語法）
### Q: 出現「權限不足」？
確認你的 FSUID 是否正確，或聯繫管理員確認權限設定
### Q: 查不到資料？
可能你不是該商機的成員，請確認資料權限
---
## 技術支援
如有問題請聯繫：
- IT 部門
- 或在 Teams 群組發問
