MCP 整合指南

將您的情境串流至 AI 開發工具

直接從 Claude Code · Cursor · Codex 參照 PJT AI 的專案情境。

01什麼是 MCP？#

MCP（Model Context Protocol）是一項標準，讓 AI 模型能安全地參照外部系統中的資料。PJT AI 在 @apexstack/agent 套件中提供一個 stdio MCP 伺服器（pjt-agent-mcp）。您機器上的 Claude Code 可以直接查詢工作區資料，且為唯讀。

可使用以下工具從 Claude Code 查詢資料：

工具	說明
`get_project`	專案基本資訊（id 或 publicId `p_xxx`）
`list_project_tasks`	任務清單（可使用狀態篩選）
`get_task`	任務詳細資料
`get_document`	文件詳細資料（包含內容）
`list_workspace_documents`	工作區文件清單
`get_workspace_snapshot`	工作區彙整（近期文件等）

ⓘ

與執行工作分離

MCP 僅用於資料查詢。它獨立於自動任務執行（pjt-agent start）運作，且無需 start 即可運作。驗證會直接重複使用您現有的 Claude Code 代理權杖（pjta_…）。

02連接 Claude Code#

前置條件：本機必須安裝 Node.js 18+ 與 Anthropic 的 claude CLI。

1. 核發權杖

從工作區的設定 → Claude Code 代理 → 「新增代理」核發權杖（pjta_…）。核發後立即會顯示已填入權杖的註冊指令（權杖只會顯示一次）。它使用與工作執行代理相同的權杖。

2. 安裝

bash

npm install -g @apexstack/agent

3. 註冊 — 一行（建議）

透過 --env 注入權杖與網址，無需登入，一行即可完成。

bash

claude mcp add pjt-workspace \
  --env PJT_AGENT_TOKEN=pjta_xxx \
  --env PJT_API_URL=https://api.pjt.ai \
  -- pjt-agent-mcp

或在 login 後更簡短地註冊（會儲存權杖檔案）：

bash

pjt-agent login --token pjta_xxx
claude mcp add pjt-workspace -- pjt-agent-mcp

4. 驗證是否運作

bash

$ claude
> Show me the recent documents in this workspace

[pjt-workspace] get_workspace_snapshot → 8 documents
[Claude] Here are the 8 most recent documents:
1. Spring Campaign Brief (06/07)
2. ...

✓

連接成功

若 pjt-workspace 出現在 claude mcp list 中，且對話中顯示上述的工具呼叫記錄，即表示運作正常。

03Cursor（即將推出）#

ⓘ

六月推出

我們將配合 Cursor IDE 的正式 MCP 支援同步發佈指南。若需搶先體驗，請聯絡 [email protected]。

04Codex（即將推出）#

ⓘ

七月推出

OpenAI Codex 整合預計於七月第一週推出。

05情境範圍#

預設情況下，MCP 僅公開使用者所屬專案的情境。可進行更細緻的控制，如下所示：

範圍	預設	控制方式
依專案	依成員身分	工作區設定 > 權限
敏感欄位	包含預算與報價	可於設定中排除
會議記錄	公開全文	可選擇僅公開摘要

06安全性 · 權限#

唯讀 — MCP 無法變更或刪除資料（僅供查詢）
重複使用 Claude Code 代理權杖（pjta_）— 無需另設金鑰；可依代理撤銷／重新核發
權杖僅於核發時顯示一次 — 遺失請重新核發。本機儲存於 ~/.pjt/agent.json（權限 0600）
傳輸與靜態均加密（TLS 1.3 + AES-256）；所有存取皆記錄於稽核日誌
不用於 AI 訓練 — 資料所有權歸屬於工作區
Enterprise 可選擇 SSO/SAML 與資料落地（美國 · 歐盟 · 韓國）

MCP 整合指南

將您的情境串流至 AI 開發工具

直接從 Claude Code · Cursor · Codex 參照 PJT AI 的專案情境。

01什麼是 MCP？#

可使用以下工具從 Claude Code 查詢資料：

工具	說明
`get_project`	專案基本資訊（id 或 publicId `p_xxx`）
`list_project_tasks`	任務清單（可使用狀態篩選）
`get_task`	任務詳細資料
`get_document`	文件詳細資料（包含內容）
`list_workspace_documents`	工作區文件清單
`get_workspace_snapshot`	工作區彙整（近期文件等）

ⓘ

與執行工作分離

02連接 Claude Code#

前置條件：本機必須安裝 Node.js 18+ 與 Anthropic 的 claude CLI。

1. 核發權杖

2. 安裝

bash

npm install -g @apexstack/agent

3. 註冊 — 一行（建議）

透過 --env 注入權杖與網址，無需登入，一行即可完成。

bash

claude mcp add pjt-workspace \
  --env PJT_AGENT_TOKEN=pjta_xxx \
  --env PJT_API_URL=https://api.pjt.ai \
  -- pjt-agent-mcp

或在 login 後更簡短地註冊（會儲存權杖檔案）：

bash

pjt-agent login --token pjta_xxx
claude mcp add pjt-workspace -- pjt-agent-mcp

4. 驗證是否運作

bash

$ claude
> Show me the recent documents in this workspace

[pjt-workspace] get_workspace_snapshot → 8 documents
[Claude] Here are the 8 most recent documents:
1. Spring Campaign Brief (06/07)
2. ...

✓

連接成功

若 pjt-workspace 出現在 claude mcp list 中，且對話中顯示上述的工具呼叫記錄，即表示運作正常。

03Cursor（即將推出）#

ⓘ

六月推出

我們將配合 Cursor IDE 的正式 MCP 支援同步發佈指南。若需搶先體驗，請聯絡 [email protected]。

04Codex（即將推出）#

ⓘ

七月推出

OpenAI Codex 整合預計於七月第一週推出。

05情境範圍#

預設情況下，MCP 僅公開使用者所屬專案的情境。可進行更細緻的控制，如下所示：

範圍	預設	控制方式
依專案	依成員身分	工作區設定 > 權限
敏感欄位	包含預算與報價	可於設定中排除
會議記錄	公開全文	可選擇僅公開摘要

06安全性 · 權限#

唯讀 — MCP 無法變更或刪除資料（僅供查詢）
重複使用 Claude Code 代理權杖（pjta_）— 無需另設金鑰；可依代理撤銷／重新核發
權杖僅於核發時顯示一次 — 遺失請重新核發。本機儲存於 ~/.pjt/agent.json（權限 0600）
傳輸與靜態均加密（TLS 1.3 + AES-256）；所有存取皆記錄於稽核日誌
不用於 AI 訓練 — 資料所有權歸屬於工作區
Enterprise 可選擇 SSO/SAML 與資料落地（美國 · 歐盟 · 韓國）