架設一個了解公司系統的AI機器人-用 Claude（MCP）讀取 Azure DevOps Wiki
========================================================

目的
----
讓 Claude Desktop 透過 MCP Server 讀取 Azure DevOps Wiki，達到：
- 快速摘要 / SOP 梳理
- 跨頁比對矛盾（Architecture vs Runbook）
- 找缺漏、整理待補文件清單

會用到的值
----------------------
Organization URL： https://dev.azure.com/{公司網址}
Project： 專案名稱

一、推薦的做法
------------------------------------------------
優先用 Azure CLI 認證（互動登入），避免在設定檔存 PAT：
1) 安裝 Azure CLI
2) 在終端機執行：az login
3) 設定 Claude Desktop 的 MCP server
4) 重啟 Claude Desktop

二、Claude Desktop 設定檔位置
----------------------------
Claude Desktop → Settings → Developer → Edit Config
會開啟 claude_desktop_config.json


常見路徑：
- macOS：~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：%APPDATA%\Claude\claude_desktop_config.json

【注意】設定檔最外層要有 "mcpServers"

三、MCP Server（azure-devops-wiki-mcp）建議設定
------------------------------------------------------------
以下它貼到 claude_desktop_config.json，然後重啟 Claude Desktop。

{
  "mcpServers": {
    "azure-devops-wiki": {
      "command": "npx",
      "args": ["-y", "azure-devops-wiki-mcp"],
      "env": {
        "AZURE_DEVOPS_URL": "https://dev.azure.com/{網址路徑}",
        "AZURE_DEVOPS_PROJECT": "{專案名稱}",
        "AZURE_DEVOPS_ORGANIZATION": "{公司名稱}"
      }
    }
  }
}

說明：
- AZURE_DEVOPS_URL：organization 的 URL（不要加專案路徑）
- AZURE_DEVOPS_PROJECT：專案名稱
- AZURE_DEVOPS_ORGANIZATION：org 名稱（通常就是 URL 最後那段）

完成後：
1) 完整退出 Claude Desktop
2) 重新開啟 Claude Desktop

四、如果你一定要用 PAT（建議只給 Wiki Read）
---------------------------------------------
若你公司環境或需求一定要用 PAT：

1) PAT Scope 建議（最小化）
- 必選：Wiki：Read
- 建議：Code：Read（部分 wiki 可能是 repo wiki）
- 其他一律先不要開（Build/Release/Test/Packaging/Work Items…）

2) 設定方式（可行，但不建議分享設定檔）
【警告】以下方式會把 PAT 寫進 claude_desktop_config.json，請勿外傳。

{
  "mcpServers": {
    "azure-devops-wiki": {
      "command": "npx",
      "args": ["-y", "azure-devops-wiki-mcp"],
      "env": {
        "AZURE_DEVOPS_URL": "https://dev.azure.com/{公司網址}",
        "AZURE_DEVOPS_PROJECT": "NBS",
        "AZURE_DEVOPS_ORGANIZATION": "chaileaseholding",
        "AZURE_DEVOPS_PAT": "<PASTE_YOUR_PAT_HERE>"
      }
    }
  }
}

建議替代（更安全）：
- 盡量用 Azure CLI 認證，不要把 PAT 寫在檔案裡

五、在 Claude 裡怎麼問（直接複製即可）
------------------------------------
（1）讀某頁並摘要
- 「請讀取 xx系統 Wiki 的 /Onboarding/EnvironmentSetup，整理成 10 點 checklist」

（2）跨頁比對矛盾（非常好用）
- 「比對 /Architecture 與 /Runbook 是否有矛盾，列出矛盾點與建議修正」

（3）找缺漏（補洞）
- 「讀完 /Runbook/Incident，指出缺少哪些必要資訊，並給我補寫大綱」

（4）整理索引
- 「列出 /Runbook 底下所有頁面，並把每頁用一句話描述」

此時Claude 已變成專屬公司的AI系統了，可以查：
> 我準備接手xxx系統，建議我要先了解那些?

AI回覆如下：


六、常見問題排除
----------------
1) 工具沒出現
- 改完設定檔後要「完整退出」Claude Desktop 再開

2. npx 失敗 / 找不到指令
- 確認已安裝 Node.js
- 公司網路若擋 npm，需走代理或白名單

3 . 401 / 403
- Azure CLI 模式：確認 az login 成功（可能要重新登入）
- PAT 模式：確認 PAT 沒過期、scope 有 Wiki: Read（必要時加 Code: Read）

4. log 檢查（最快）
- macOS：~/Library/Logs/Claude
- Windows：%APPDATA%\Claude\logs
看 mcp.log 或 mcp-server-azure-devops-wiki.log 的錯誤訊息

七、專案 Wiki 內容結構建議（讓 AI 更好整理）
-------------------------------------------
建議固定大分類：
- /Onboarding：新人上手
- /Runbook：維運 SOP / 告警處理
- /Architecture：系統邊界 / 資料流 / 依賴
- /API：端點、驗證方式、錯誤碼
- /DecisionRecords：ADR（重大決策記錄）

每頁建議固定段落：
1) 目的 / 適用範圍
2) 步驟（條列）
3) 例外情境與排除
4) 參考連結（互相連結到相關頁）

附錄：貼文版（可貼在 Wiki 首頁的簡短宣導）
-------------------------------------------
我們已提供 Claude + MCP 讀取 NBS 專案 Wiki 的方式。
建議只開必要工具，權限採最小化（Wiki Read）。
用這套你可以把 Runbook 直接變成 checklist、比對 Architecture 與 Runbook 的矛盾、快速整理新人 Onboarding 必讀清單。

###### tags: `Claude` `MCP` `Azure-DevOps` `ADO-Wiki` `DevOps` `Knowledge-Base` `AI-Tools` `Security` `PAT` `Azure-CLI` `Node.js`