MCP 연동 가이드

AI 개발 도구로 컨텍스트를 흘려보내세요

Claude Code · Cursor · Codex에서 PJT AI의 프로젝트 컨텍스트를 직접 참조합니다.

01MCP란?#

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 헤더로 그대로 재사용합니다.

02Claude Code 연결#

전제: Anthropic claude CLI 만 있으면 됩니다. PJT 쪽 npm 설치는 필요 없습니다.

1. 토큰 발급

워크스페이스 설정 → Claude Code 에이전트 → “에이전트 추가” 에서 토큰(pjta_…)을 발급합니다. 발급 직후 화면에 도구별 등록 스니펫이 토큰이 채워진 채 표시됩니다(토큰은 그때 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 가 보이고, 대화에서 위 도구 호출 로그가 뜨면 정상입니다.

03Cursor 연결#

~/.cursor/mcp.json 에 아래를 추가하세요. Claude Code 와 같은 토큰을 씁니다.

json

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

ⓘ

재시작 필요

저장 후 Cursor 를 재시작하면 pjt-workspace 도구가 목록에 나타납니다.

04Codex 연결#

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 로는 데이터를 변경/삭제할 수 없습니다 (조회 only)
Claude Code 에이전트 토큰(pjta_) 재사용 — 별도 키 없음, 에이전트 단위로 폐기·재발급
토큰은 발급 시 1회만 노출 — 분실 시 재발급. 원격 방식은 클라이언트 설정 파일에만 저장되고 PJT 쪽 설치 파일이 없습니다
전송·저장 시 모두 암호화 (TLS 1.3 + AES-256), 모든 액세스는 감사 로그에 기록
AI 학습에 사용되지 않음 — 데이터 소유권은 워크스페이스에
Enterprise는 SSO/SAML과 데이터 거주지 선택 (US · EU · KR)

MCP 연동 가이드

AI 개발 도구로 컨텍스트를 흘려보내세요

Claude Code · Cursor · Codex에서 PJT AI의 프로젝트 컨텍스트를 직접 참조합니다.

01MCP란?#

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`	워크스페이스 번들 (최근 문서 등)

ⓘ

작업 실행과는 별개

02Claude 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 가 보이고, 대화에서 위 도구 호출 로그가 뜨면 정상입니다.

03Cursor 연결#

~/.cursor/mcp.json 에 아래를 추가하세요. Claude Code 와 같은 토큰을 씁니다.

json

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

ⓘ

재시작 필요

저장 후 Cursor 를 재시작하면 pjt-workspace 도구가 목록에 나타납니다.

04Codex 연결#

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 로는 데이터를 변경/삭제할 수 없습니다 (조회 only)
Claude Code 에이전트 토큰(pjta_) 재사용 — 별도 키 없음, 에이전트 단위로 폐기·재발급
토큰은 발급 시 1회만 노출 — 분실 시 재발급. 원격 방식은 클라이언트 설정 파일에만 저장되고 PJT 쪽 설치 파일이 없습니다
전송·저장 시 모두 암호화 (TLS 1.3 + AES-256), 모든 액세스는 감사 로그에 기록
AI 학습에 사용되지 않음 — 데이터 소유권은 워크스페이스에
Enterprise는 SSO/SAML과 데이터 거주지 선택 (US · EU · KR)