Let's Write

Posted on Jul 24 • Originally published at letswrite.tw

Outline Wiki 自架教學（二）：ClaudeCodex 串接 MCP

#outline #ai #claude #mcp

Outline Wiki 自架教學（二）：Claude 串接 MCP

本篇要解決的問題

上一篇我們自架了 Outline Wiki，接著我們就要發揮它的威力了，就是可以使用 MCP，讓 Claude、Codex 來幫我們新增、編輯、彙整……我們的文件。

本篇主要是寫 Outline + Claude，下一篇會是 Outline + Codex。

照著本篇實作，完成設定後，Claude Desktop 可以透過 MCP 呼叫 Outline 工具，例如：

搜尋或列出 Outline 文件
讀取、編輯文件集內的文件
建立文件集
移動文件
執行 MCP Server 已提供的其他 Outline 操作

前置準備

開始前，請先確認已具備以下環境：

安裝 Claude Desktop
安裝 Node.js
可正常連線的 Outline

建立 Outline API Token

進入喜好設定

登入 Outline 後，點擊左下角帳號旁的「⋯」，再選擇「喜好設定」。

從左下角選單進入喜好設定

開啟 API & Access

在左側設定選單中選擇「API & Access」，接著點擊右上角的「新 API 金鑰」。

進入 API & Access 並建立新 API 金鑰

設定金鑰名稱、範圍與到期日

建議輸入容易辨識用途的名稱，例如：「AI MCP」、「Claude MCP」等等。

原始流程中的設定為：

範圍： 留空
到期日： 沒有期限

設定 API 金鑰範圍與到期日

範圍留空通常代表不限制特定 API 權限。這種設定操作最簡單，但權限也較大。

複製 API Token

建立完成後，點擊「複製」，並先將 Token 暫存在安全的位置，因為 Token 只會出現一次。

複製 Outline API Token

注意：API Token 等同於帳號憑證，不要貼到 Git、公開文件、部落格文章、聊天群組或未加密的筆記中。

設定 Claude Desktop MCP

開啟 Claude Desktop 設定檔

Claude Desktop 在 Windows 與 macOS 使用相同的設定檔名稱，但存放路徑不同。

作業系統	設定檔路徑
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`

Windows

開啟任一個資料夾，檔案路徑列貼上：

%APPDATA%\Claude\claude_desktop_config.json

也可以按下 Win + R，貼上相同路徑後按 Enter。

macOS：使用 Finder 開啟

開啟 Finder。
點擊上方選單的「前往」。
選擇「前往檔案夾⋯」。
貼上下列路徑：

~/Library/Application Support/Claude/

找到並開啟：

claude_desktop_config.json

macOS：使用終端機開啟

也可以在終端機執行：

mkdir -p "$HOME/Library/Application Support/Claude"
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

這三個指令會依序建立設定資料夾、建立設定檔，並使用 macOS 文字編輯器開啟。

若檔案已存在，建議先複製一份備份，再進行修改。

加入 Outline MCP Server

請將下列設定加入 JSON 最外層物件中的 mcpServers：

{
  "mcpServers": {
    "outline": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://192.168.x.x:3023/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_OUTLINE_API_TOKEN",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

NODE_TLS_REJECT_UNAUTHORIZED=0 會停用 Node.js 的 TLS 憑證驗證。它只適合在可信任的內部網路中暫時測試，不建議用於公開網路或正式環境。較安全的做法是替 MCP Server 設定可被系統信任的有效憑證。

Windows 與 macOS 原則上可共用這份設定。如果 macOS 無法直接找到 npx，可以先在終端機執行：

which npx

假設回傳：

/opt/homebrew/bin/npx

便可將 command 改成完整路徑：

"command": "/opt/homebrew/bin/npx"

常見位置如下：

安裝方式	`npx` 可能的位置
Apple Silicon Mac 使用 Homebrew	`/opt/homebrew/bin/npx`
Intel Mac 使用 Homebrew	`/usr/local/bin/npx`
Node.js 官方 `.pkg`	以 `which npx` 的回傳結果為準

注意：不要直接照抄表格中的路徑。應先執行 which npx，再使用自己電腦實際回傳的結果。

請替換以下內容：

設定值	說明
`https://YOUR_MCP_HOST/mcp`	Outline MCP Server 的連線網址
`YOUR_OUTLINE_API_TOKEN`	前一步建立的 Outline API Token

例如 MCP Server 位於內部網路，可改成：

"https://192.168.x.x:3023/mcp"

合併既有設定時的注意事項

若 claude_desktop_config.json 已經有其他設定，不要直接覆蓋整份檔案，只需要把 mcpServers 合併進最外層物件。

Windows 設定範例

例如原本已有其他欄位：

{
  "coworkUserFilesPath": "C:\\Users\\Sean\\Claude",
  "preferences": {},
  "mcpServers": {
    "outline": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://YOUR_MCP_HOST/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_OUTLINE_API_TOKEN",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

macOS 設定範例

macOS 也使用相同的 JSON 結構。若 npx 可直接執行：

{
  "preferences": {},
  "mcpServers": {
    "outline": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://YOUR_MCP_HOST/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_OUTLINE_API_TOKEN",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

若 Claude Desktop 找不到 npx，將 command 改成 which npx 查到的完整路徑，例如：

"command": "/opt/homebrew/bin/npx"

JSON 常見錯誤包括：

欄位之間少了逗號
最後一個欄位多了逗號
大括號或中括號數量不一致
Windows 路徑中的反斜線沒有寫成 \\
macOS 路徑含有空白時，終端機指令沒有使用引號或跳脫字元
把 mcpServers 貼到最外層物件之外

重新啟動 Claude Desktop

修改設定檔後，必須完整關閉 Claude Desktop，再重新開啟。

只關閉視窗不一定代表程式已完全結束：

Windows： 從系統匣結束 Claude，或到工作管理員確認 Claude 是否仍在背景執行。
macOS： 按下 Command + Q，或從上方選單選擇「Claude」→「結束 Claude」。必要時可到「活動監視器」確認程式是否仍在執行。

重新啟動時，Claude Desktop 會：

讀取 claude_desktop_config.json
透過 npx 啟動 mcp-remote
使用 Authorization Header 連接 Outline MCP Server
載入 MCP Server 提供的工具

首次執行 npx -y mcp-remote 時，可能需要下載套件，因此等待時間會比後續啟動稍長。

測試 Outline MCP 是否連線成功

重新開啟 Claude Desktop 後，可以輸入：

可以接到 Outline MCP 嗎？請列出目前可使用的 Outline 工具。

接著再測試實際讀取：

請列出 Outline 中目前可以看到的文件與文件集。

也可以指定操作：

請搜尋 Outline 中包含「前端」關鍵字的文件。

連線成功時，Claude 會顯示已載入 Outline 工具，並能回傳工作區中的文件或 Collection 資訊。

DEV Community