你是否也覺得每次寫完文章,還要登入 WordPress 後台、複製貼上、調整格式很繁瑣?

現在,透過 Claude Desktop 搭配 WordPress MCP (Model Context Protocol) Server,你就能直接用「自然語言」指令,讓 Claude 幫你發佈、編輯、管理 WordPress 文章,完全不需要進後台操作!

這篇文章將帶你一步步完成完整設定,並整理了我在實作時遇到的坑,幫你無痛打造 AI 自動化寫作工作流。

🛠 準備工具

在開始之前,請確保你已安裝或準備好以下工具:

  • Claude Desktop(已安裝並可正常運行)
  • Node.js(v18 以上版本)
  • WordPress 網站(需支援 REST API,建議 WordPress 5.6+)
  • wordpress-mcp 開源專案GitHub 傳送門

🚀 實戰設定 6 步驟

步驟一:Clone 並安裝 wordpress-mcp

首先,開啟你的終端機(Terminal),執行以下指令來下載並編譯專案:

Bash

git clone https://github.com/wolffcatskyy/wordpress-mcp.git
cd wordpress-mcp
npm install
npm run build

步驟二:複製範例設定檔

wordpress-mcp 資料夾內,複製範例環境變數檔案(這步驟可以幫我們備份設定欄位):

Bash

# Windows 系統
copy .env.example .env

# Mac / Linux 系統
cp .env.example .env

(💡 提示:雖然 Claude 主要讀取的是後面步驟四的 JSON 設定檔,但建議在此保留一份 .env 方便未來查看。)

步驟三:取得 WordPress 應用程式密碼

為了讓 Claude 有權限幫你發文,我們需要一組專門的 API 密碼:

  1. 登入 WordPress 後台。
  2. 前往 「使用者」「你的個人資料」
  3. 往下捲動找到 「應用程式密碼」 區塊。
  4. 輸入一個辨識名稱(例如:Claude MCP),點擊 「新增應用程式密碼」
  5. 「複製」 畫面上產生的 24 位元密碼(格式如:xxxx xxxx xxxx xxxx xxxx xxxx)。(⚠️ 注意:此密碼只會顯示一次,請先記在記事本中。)

步驟四:設定 Claude Desktop Config

接下來要告訴 Claude 如何連接到你的網站。請開啟 Claude Desktop 的設定檔 claude_desktop_config.json

  • Windows 路徑: 在檔案總管輸入 %APPDATA%\Claude\claude_desktop_config.json
  • Mac 路徑: ~/Library/Application Support/Claude/claude_desktop_config.json

mcpServers 區塊中,填入以下設定(記得將大括號內的資訊替換成你自己的):

JSON

{
  "mcpServers": {
    "wordpress": {
      "command": "node",
      "args": ["C:\\Users\\你的電腦使用者名稱\\wordpress-mcp\\dist\\index.js"],
      "env": {
        "WORDPRESS_URL": "https://www.你的網域.com",
        "WORDPRESS_USERNAME": "你的WordPress帳號",
        "WORDPRESS_PASSWORD": "你的應用程式密碼"
      }
    }
  }
}

🛑 重要避坑指南: > 1. args 請務必填寫你電腦中 index.js絕對路徑(Mac 讀者請調整為 /Users/... 格式)。

2. WORDPRESS_URL 請填入網站實際連線的完整網址。如果你的網站有強迫導向 www,就一定要加上 www,否則會因為 301 Redirect 導致後面發文失敗。

步驟五:重啟 Claude Desktop

將 Claude Desktop 完全關閉(記得從系統工具列或 Dock 右鍵結束),然後重新開啟。

連線成功後,你會在 Claude 對話框的右下角(或側邊欄)看到一個 WordPress 的小工具圖示 🛠️,這代表連線成功囉!

步驟六:開始用自然語言控網頁!

現在,你可以直接在對話框裡用平常說話的方式對 Claude 下指令了。試試看以下咒語:

  • 📝 「幫我發一篇標題為『AI 寫作新趨勢』的草稿文章,內容要有前言與三個重點。」
  • 「幫我把文章 ID 4807 的狀態改為正式發佈。」
  • 📋 「列出我網站最近 5 篇已發佈的文章。」
  • 🏷️ 「幫我網站新增一個文章分類,名稱叫作『技術教學』。」

🔍 常見問題與 Debug 指南(踩坑紀錄)

在設定過程中,我遇到了一些小問題,如果你也遇到了,可以這樣解決:

Q1:發文失敗,出現 Cannot read properties of undefined (reading 'rendered')

  • 原因: 這是目前 wordpress-mcp 原始碼中的一個小 Bug。
  • 解法: 請用程式碼編輯器開啟專案中的 src/wordpress.ts,尋找所有的 response.data.title.rendered,將其修改為:TypeScriptresponse.data.title?.rendered ?? response.data.title ?? "" 修改完畢後,記得在終端機重新執行一次 npm run build 即可修復。

Q2:顯示發送成功,但 WordPress 後台完全沒看到文章?

  • 原因: 通常是 WORDPRESS_URL 的網址對齊問題。
  • 解法: 當網站有 301 轉址(例如非 www 轉 www,或 http 轉 https)時,POST 請求的資料會在轉址過程中遺失。請確認你 claude_desktop_config.json 裡的網址與你網站後台「設定 → 一般」裡的版本完全一致。

Q3:修改了 .env 檔案,為什麼設定一直沒有生效?

  • 原因: Claude Desktop MCP 的環境變數是直接從 claude_desktop_config.json 裡的 env 欄位注入的,它並不會去讀取 wordpress-mcp 資料夾底下的 .env
  • 解法: 請直接修改 claude_desktop_config.json,修改完後重啟 Claude 即可。

💡 總結

設定好 WordPress MCP 之後,Claude 就不再只是個聊天機器人,而是變成你專屬的「網站虛擬助理」。從發文、修文、管理留言到建立分類,都能一氣呵成。

如果你平時習慣用 Notion 控管內容,未來甚至還能搭配 Notion MCP,實現「Notion 寫完、Claude 潤飾、直接同步到 WordPress」的全自動化極速工作流!有興趣的朋友趕快動手試試看吧!