PJT AIPJT AI/MCP
Bắt đầuAPI
Tích hợp MCP
MCP là gì?Kết nối Claude CodeCursor (sắp ra mắt)Codex (sắp ra mắt)Phạm vi ngữ cảnhBảo mật · quyền
Hướng dẫn tích hợp MCP

Truyền ngữ cảnh của bạn vào các công cụ phát triển AI

Tham chiếu trực tiếp ngữ cảnh dự án của PJT AI từ Claude Code · Cursor · Codex.

01MCP là gì?#

MCP (Model Context Protocol) là một chuẩn cho phép các mô hình AI tham chiếu dữ liệu trong các hệ thống bên ngoài một cách an toàn. PJT AI cung cấp một máy chủ MCP stdio (pjt-agent-mcp) trong gói @apexstack/agent. Claude Code trên máy của bạn có thể truy vấn dữ liệu không gian làm việc trực tiếp, và nó chỉ đọc.

Truy vấn dữ liệu từ Claude Code với các công cụ sau:

Công cụMô tả
get_projectThông tin cơ bản dự án (id hoặc publicId p_xxx)
list_project_tasksDanh sách công việc (có thể lọc theo trạng thái)
get_taskChi tiết công việc
get_documentChi tiết tài liệu (bao gồm nội dung)
list_workspace_documentsDanh sách tài liệu không gian làm việc
get_workspace_snapshotGói không gian làm việc (tài liệu gần đây, v.v.)
ⓘ
Tách biệt với việc chạy tác vụ
MCP chỉ dùng để truy vấn dữ liệu. Nó hoạt động độc lập với việc thực thi tác vụ tự động (pjt-agent start) và hoạt động mà không cần start. Xác thực tái sử dụng token tác nhân Claude Code hiện có của bạn (pjta_…) y nguyên.

02Kết nối Claude Code#

Điều kiện tiên quyết: Node.js 18+ và CLI claude của Anthropic phải được cài đặt cục bộ.

1. Phát hành token

Phát hành token (pjta_…) từ không gian làm việc Cài đặt → Tác nhân Claude Code → "Thêm tác nhân". Ngay sau khi phát hành, lệnh đăng ký được hiển thị với token đã được điền sẵn (token chỉ được hiển thị một lần). Nó dùng cùng token với tác nhân thực thi công việc.

2. Cài đặt

bash
npm install -g @apexstack/agent

3. Đăng ký — một dòng (khuyến nghị)

Tiêm token và URL qua --env mà không cần đăng nhập, và chỉ một dòng.

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

Hoặc đăng ký ngắn gọn hơn sau khi login (lưu một tệp token):

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

4. Xác minh hoạt động

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. ...
✓
Kết nối thành công
Nếu pjt-workspace xuất hiện trong claude mcp list và nhật ký gọi công cụ ở trên hiển thị trong cuộc trò chuyện, thì nó đang hoạt động.

03Cursor (sắp ra mắt)#

ⓘ
Ra mắt vào tháng 6
Chúng tôi sẽ công bố hướng dẫn trùng với thời điểm Cursor IDE hỗ trợ MCP chính thức. Để truy cập bản beta, hãy liên hệ [email protected].

04Codex (sắp ra mắt)#

ⓘ
Ra mắt vào tháng 7
Tích hợp OpenAI Codex dự kiến ra mắt trong tuần đầu tiên của tháng 7.

05Phạm vi ngữ cảnh#

Theo mặc định, MCP chỉ phơi bày ngữ cảnh của các dự án mà người dùng là thành viên. Có thể kiểm soát chi tiết hơn như sau:

Phạm viMặc địnhCách kiểm soát
Theo từng dự ánDựa trên tư cách thành viênCài đặt không gian làm việc > Quyền
Trường nhạy cảmBao gồm ngân sách & báo giáCó thể loại trừ trong cài đặt
Ghi chú họpPhơi bày toàn vănTùy chọn chỉ phơi bày tóm tắt

06Bảo mật · quyền#

  • Chỉ đọc — MCP không thể thay đổi hay xóa dữ liệu (chỉ truy vấn)
  • Tái sử dụng token tác nhân Claude Code (pjta_) — không cần khóa riêng; thu hồi/phát hành lại theo từng tác nhân
  • Token chỉ được hiển thị một lần khi phát hành — phát hành lại nếu mất. Lưu cục bộ tại ~/.pjt/agent.json (chế độ 0600)
  • Mã hóa khi truyền và khi lưu trữ (TLS 1.3 + AES-256); mọi truy cập đều được ghi vào nhật ký kiểm toán
  • Không dùng để huấn luyện AI — quyền sở hữu dữ liệu thuộc về không gian làm việc
  • Enterprise có thể chọn SSO/SAML và lưu trữ dữ liệu theo khu vực (US · EU · KR)