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à chuẩn giúp mô hình AI tham chiếu an toàn dữ liệu của hệ thống bên ngoài. PJT AI tự vận hành máy chủ MCP từ xa qua HTTP — không cần cài đặt, không cần đăng nhập, chỉ cần đăng ký địa chỉ và token là Claude hay Cursor đọc trực tiếp dữ liệu không gian làm việc. Chỉ đọc.

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

Công cụ	Mô tả
`list_workspaces`	Danh sách không gian làm việc của tôi (bắt đầu từ đây khi chưa biết ID)
`get_project`	Thông tin cơ bản dự án (id hoặc publicId `p_xxx`)
`list_project_tasks`	Danh sách công việc (có thể lọc theo trạng thái)
`get_task`	Chi tiết công việc
`get_document`	Chi tiết tài liệu (bao gồm nội dung)
`list_workspace_documents`	Danh sách tài liệu không gian làm việc
`get_workspace_snapshot`	Gó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 để đọc dữ liệu và hoạt động độc lập với việc tự chạy công việc (pjt-agent start). Xác thực dùng lại token agent Claude Code hiện có (pjta_…) qua header Authorization: Bearer.

02Kết nối Claude Code#

Yêu cầu: chỉ cần CLI claude của Anthropic. Không cần cài npm của PJT.

1. Phát hành token

Vào Cài đặt → Agent Claude Code → “Thêm agent” trong không gian làm việc và cấp token (pjta_…). Ngay sau khi cấp, màn hình hiển thị đoạn mã đăng ký cho từng công cụ đã điền sẵn token (token chỉ hiện một lần).

2. Đăng ký — một dòng

Thay pjta_xxx bằng token của bạn rồi dán vào terminal.

bash

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

3. Kiểm tra

bash

$ claude mcp list
pjt-workspace  ✓ connected

$ claude
> cho tôi xem tài liệu gần đây trong không gian làm việc này

[pjt-workspace] get_workspace_snapshot → 8 tài liệu

✓

Kết nối thành công

Nếu claude mcp list hiện pjt-workspace và bạn thấy log gọi công cụ trong hội thoại thì đã kết nối thành công.

03Kết nối Cursor#

Thêm nội dung sau vào ~/.cursor/mcp.json. Dùng cùng token với Claude Code.

json

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

ⓘ

Cần khởi động lại

Lưu lại và khởi động lại Cursor — các công cụ pjt-workspace sẽ xuất hiện trong danh sách.

04Kết nối Codex#

Codex chưa hỗ trợ MCP từ xa trực tiếp nên dùng mcp-remote làm cầu nối. Hãy thêm vào ~/.codex/config.toml.

toml

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

ⓘ

Cần Node.js

Cầu nối chạy qua npx nên máy bạn cần Node.js 18+. Khi Codex hỗ trợ MCP từ xa chính thức, cấu hình sẽ đơn giản như Cursor.

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 vi	Mặc định	Cách kiểm soát
Theo từng dự án	Dựa trên tư cách thành viên	Cài đặt không gian làm việc > Quyền
Trường nhạy cảm	Bao gồm ngân sách & báo giá	Có thể loại trừ trong cài đặt
Ghi chú họp	Phơi bày toàn văn	Tù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ỉ hiện một lần khi cấp — mất thì cấp lại. Với cách từ xa, token chỉ nằm trong tệp cấu hình của ứng dụng, không cài gì từ PJT
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)

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ì?#

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

Công cụ	Mô tả
`list_workspaces`	Danh sách không gian làm việc của tôi (bắt đầu từ đây khi chưa biết ID)
`get_project`	Thông tin cơ bản dự án (id hoặc publicId `p_xxx`)
`list_project_tasks`	Danh sách công việc (có thể lọc theo trạng thái)
`get_task`	Chi tiết công việc
`get_document`	Chi tiết tài liệu (bao gồm nội dung)
`list_workspace_documents`	Danh sách tài liệu không gian làm việc
`get_workspace_snapshot`	Gó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ụ

02Kết nối Claude Code#

Yêu cầu: chỉ cần CLI claude của Anthropic. Không cần cài npm của PJT.

1. Phát hành token

2. Đăng ký — một dòng

Thay pjta_xxx bằng token của bạn rồi dán vào terminal.

bash

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

3. Kiểm tra

bash

$ claude mcp list
pjt-workspace  ✓ connected

$ claude
> cho tôi xem tài liệu gần đây trong không gian làm việc này

[pjt-workspace] get_workspace_snapshot → 8 tài liệu

✓

Kết nối thành công

Nếu claude mcp list hiện pjt-workspace và bạn thấy log gọi công cụ trong hội thoại thì đã kết nối thành công.

03Kết nối Cursor#

Thêm nội dung sau vào ~/.cursor/mcp.json. Dùng cùng token với Claude Code.

json

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

ⓘ

Cần khởi động lại

Lưu lại và khởi động lại Cursor — các công cụ pjt-workspace sẽ xuất hiện trong danh sách.

04Kết nối Codex#

Codex chưa hỗ trợ MCP từ xa trực tiếp nên dùng mcp-remote làm cầu nối. Hãy thêm vào ~/.codex/config.toml.

toml

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

ⓘ

Cần Node.js

Cầu nối chạy qua npx nên máy bạn cần Node.js 18+. Khi Codex hỗ trợ MCP từ xa chính thức, cấu hình sẽ đơn giản như Cursor.

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 vi	Mặc định	Cách kiểm soát
Theo từng dự án	Dựa trên tư cách thành viên	Cài đặt không gian làm việc > Quyền
Trường nhạy cảm	Bao gồm ngân sách & báo giá	Có thể loại trừ trong cài đặt
Ghi chú họp	Phơi bày toàn văn	Tù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ỉ hiện một lần khi cấp — mất thì cấp lại. Với cách từ xa, token chỉ nằm trong tệp cấu hình của ứng dụng, không cài gì từ PJT
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)