MCP 集成指南

将上下文流入 AI 开发工具

在 Claude Code · Cursor · Codex 中直接引用 PJT AI 的项目上下文。

01什么是 MCP？#

MCP（Model Context Protocol）是让 AI 模型安全引用外部系统数据的标准。PJT AI 自行运行远程 HTTP MCP 服务器 — 无需安装、无需登录，只要注册地址和令牌，Claude、Cursor 就能直接查询工作区数据。只读。

在 Claude Code 中可用以下工具查询数据：

工具	说明
`list_workspaces`	我的工作区列表（不知道 ID 时从这里开始）
`get_project`	项目基本信息（id 或 publicId `p_xxx`）
`list_project_tasks`	任务列表（可按状态筛选）
`get_task`	任务详情
`get_document`	文档详情（包含 content）
`list_workspace_documents`	工作区文档列表
`get_workspace_snapshot`	工作区捆绑包（最近文档等）

ⓘ

与执行工作相互独立

MCP 仅用于查询数据，与任务自动执行（pjt-agent start）互相独立。认证直接复用现有的 Claude Code 代理令牌（pjta_…），以 Authorization: Bearer 请求头传递。

02连接 Claude Code#

前提：只需 Anthropic 的 claude CLI。无需安装 PJT 的 npm 包。

1. 签发令牌

在工作区设置 → Claude Code 代理 → “添加代理”中签发令牌（pjta_…）。签发后页面会直接填入令牌显示各工具的注册代码（令牌仅显示一次）。

2. 注册 — 一行搞定

把 pjta_xxx 换成你的令牌，粘贴到终端即可。

bash

claude mcp add --transport http pjt-workspace https://mcp.pjt.ai \
  --header "Authorization: Bearer pjta_xxx"

3. 验证

bash

$ claude mcp list
pjt-workspace  ✓ connected

$ claude
> 显示这个工作区最近的文档

[pjt-workspace] get_workspace_snapshot → 8 份文档

✓

连接成功

若 claude mcp list 中出现 pjt-workspace，且对话中能看到上述工具的调用日志，即为正常。

03连接 Cursor#

在 ~/.cursor/mcp.json 中添加以下内容。与 Claude Code 使用同一个令牌。

json

{
  "mcpServers": {
    "pjt-workspace": {
      "url": "https://mcp.pjt.ai",
      "headers": {
        "Authorization": "Bearer pjta_xxx"
      }
    }
  }
}

ⓘ

需要重启

保存后重启 Cursor，pjt-workspace 工具便会出现在列表中。

04连接 Codex#

Codex 尚未原生支持远程 MCP，需通过 mcp-remote 中转。请添加到 ~/.codex/config.toml。

toml

[mcp_servers.pjt-workspace]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.pjt.ai", "--header", "Authorization: Bearer pjta_xxx"]

ⓘ

需要 Node.js

桥接通过 npx 运行，因此本机需要 Node.js 18+。待 Codex 正式支持远程 MCP 后，配置会简化为与 Cursor 相同的形式。

05上下文范围#

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

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

06安全 · 权限#

只读 — 通过 MCP 无法修改/删除数据（仅查询）
复用 Claude Code 代理令牌（pjta_）— 无需单独的密钥，按代理吊销/重签
令牌仅在签发时显示一次 — 丢失请重新签发。远程方式下令牌只保存在客户端配置文件中，本机没有 PJT 的安装文件
传输与存储均加密（TLS 1.3 + AES-256），所有访问均记入审计日志
不用于 AI 训练 — 数据所有权归工作区
Enterprise 可选择 SSO/SAML 与数据驻留（US · EU · KR）

MCP 集成指南

将上下文流入 AI 开发工具

在 Claude Code · Cursor · Codex 中直接引用 PJT AI 的项目上下文。

01什么是 MCP？#

在 Claude Code 中可用以下工具查询数据：

工具	说明
`list_workspaces`	我的工作区列表（不知道 ID 时从这里开始）
`get_project`	项目基本信息（id 或 publicId `p_xxx`）
`list_project_tasks`	任务列表（可按状态筛选）
`get_task`	任务详情
`get_document`	文档详情（包含 content）
`list_workspace_documents`	工作区文档列表
`get_workspace_snapshot`	工作区捆绑包（最近文档等）

ⓘ

与执行工作相互独立

02连接 Claude Code#

前提：只需 Anthropic 的 claude CLI。无需安装 PJT 的 npm 包。

1. 签发令牌

2. 注册 — 一行搞定

把 pjta_xxx 换成你的令牌，粘贴到终端即可。

bash

claude mcp add --transport http pjt-workspace https://mcp.pjt.ai \
  --header "Authorization: Bearer pjta_xxx"

3. 验证

bash

$ claude mcp list
pjt-workspace  ✓ connected

$ claude
> 显示这个工作区最近的文档

[pjt-workspace] get_workspace_snapshot → 8 份文档

✓

连接成功

若 claude mcp list 中出现 pjt-workspace，且对话中能看到上述工具的调用日志，即为正常。

03连接 Cursor#

在 ~/.cursor/mcp.json 中添加以下内容。与 Claude Code 使用同一个令牌。

json

{
  "mcpServers": {
    "pjt-workspace": {
      "url": "https://mcp.pjt.ai",
      "headers": {
        "Authorization": "Bearer pjta_xxx"
      }
    }
  }
}

ⓘ

需要重启

保存后重启 Cursor，pjt-workspace 工具便会出现在列表中。

04连接 Codex#

Codex 尚未原生支持远程 MCP，需通过 mcp-remote 中转。请添加到 ~/.codex/config.toml。

toml

[mcp_servers.pjt-workspace]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.pjt.ai", "--header", "Authorization: Bearer pjta_xxx"]

ⓘ

需要 Node.js

桥接通过 npx 运行，因此本机需要 Node.js 18+。待 Codex 正式支持远程 MCP 后，配置会简化为与 Cursor 相同的形式。

05上下文范围#

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

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

06安全 · 权限#

只读 — 通过 MCP 无法修改/删除数据（仅查询）
复用 Claude Code 代理令牌（pjta_）— 无需单独的密钥，按代理吊销/重签
令牌仅在签发时显示一次 — 丢失请重新签发。远程方式下令牌只保存在客户端配置文件中，本机没有 PJT 的安装文件
传输与存储均加密（TLS 1.3 + AES-256），所有访问均记入审计日志
不用于 AI 训练 — 数据所有权归工作区
Enterprise 可选择 SSO/SAML 与数据驻留（US · EU · KR）