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`	文档详情（包含 content）
`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
> 给我看看这个工作区最近的文档

[pjt-workspace] get_workspace_snapshot → 8 份文档
[Claude] 这是最近的 8 份文档：
1. 春季活动企划书 (06/07)
2. ...

✓

连接成功

若 claude mcp list 中出现 pjt-workspace，并且对话中出现上述工具调用日志，即表示正常。

03Cursor（即将推出）#

ⓘ

预计 6 月发布

我们将配合 Cursor IDE 正式支持 MCP 同步发布指南。如需 Beta 访问权限，请联系 [email protected]。

04Codex（即将推出）#

ⓘ

预计 7 月发布

OpenAI Codex 集成预计在 7 月第一周发布。

05上下文范围#

默认情况下，MCP 仅公开用户作为成员所属项目的上下文。可进行如下精细化控制：

范围	默认	控制方式
按项目	基于成员身份	工作区设置 > 权限
敏感字段	包含预算与报价	可在设置中排除
会议记录	公开全文	可选仅公开摘要

06安全 · 权限#

只读 — 通过 MCP 无法修改/删除数据（仅查询）
复用 Claude Code 代理令牌（pjta_）— 无需单独的密钥，按代理吊销/重签
令牌仅在签发时显示一次 — 丢失需重签。本地存放于 ~/.pjt/agent.json（权限 0600）
传输与存储均加密（TLS 1.3 + AES-256），所有访问均记入审计日志
不用于 AI 训练 — 数据所有权归工作区
Enterprise 可选择 SSO/SAML 与数据驻留（US · EU · KR）

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`	文档详情（包含 content）
`list_workspace_documents`	工作区文档列表
`get_workspace_snapshot`	工作区捆绑包（最近文档等）

ⓘ

与执行工作相互独立

MCP 仅用于数据查询。它与任务自动执行（pjt-agent start）相互独立，无需 start 也可使用。认证直接复用现有的 Claude Code 代理令牌（pjta_…）。

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
> 给我看看这个工作区最近的文档

[pjt-workspace] get_workspace_snapshot → 8 份文档
[Claude] 这是最近的 8 份文档：
1. 春季活动企划书 (06/07)
2. ...

✓

连接成功

若 claude mcp list 中出现 pjt-workspace，并且对话中出现上述工具调用日志，即表示正常。

03Cursor（即将推出）#

ⓘ

预计 6 月发布

我们将配合 Cursor IDE 正式支持 MCP 同步发布指南。如需 Beta 访问权限，请联系 [email protected]。

04Codex（即将推出）#

ⓘ

预计 7 月发布

OpenAI Codex 集成预计在 7 月第一周发布。

05上下文范围#

默认情况下，MCP 仅公开用户作为成员所属项目的上下文。可进行如下精细化控制：

范围	默认	控制方式
按项目	基于成员身份	工作区设置 > 权限
敏感字段	包含预算与报价	可在设置中排除
会议记录	公开全文	可选仅公开摘要

06安全 · 权限#

只读 — 通过 MCP 无法修改/删除数据（仅查询）
复用 Claude Code 代理令牌（pjta_）— 无需单独的密钥，按代理吊销/重签
令牌仅在签发时显示一次 — 丢失需重签。本地存放于 ~/.pjt/agent.json（权限 0600）
传输与存储均加密（TLS 1.3 + AES-256），所有访问均记入审计日志
不用于 AI 训练 — 数据所有权归工作区
Enterprise 可选择 SSO/SAML 与数据驻留（US · EU · KR）