Claude Code 및 Codex용 PandaNpc MCP 서버 구성

업데이트 2026-08-18

PandaNpc MCP 서버는 MCP 호환 코딩 에이전트를 PandaNote 지식 베이스, 작업 로그, 예약 작업, 모델 구성 및 Agent Service Center에 연결합니다. 에이전트가 매번 빈 대화로 시작하는 대신 지속적인 프로젝트 컨텍스트가 필요할 때 유용합니다.

서버는 MCP의 표준 입력/출력 전송을 통해 로컬에서 실행됩니다. MCP 클라이언트는 세션이 열릴 때 pandanpc-mcp 프로세스를 시작합니다. 포트를 노출하거나 별도의 웹 서버를 실행할 필요가 없습니다.

설치 전에

필요한 것:

Node.js 및 npm이 MCP 클라이언트가 실행되는 동일한 환경에서 사용 가능해야 합니다.
인증에 사용되는 이메일 주소에 접근할 수 있는 PandaNpc 계정.
Claude Code, OpenAI Codex, Cursor 또는 로컬 stdio MCP 서버를 지원하는 다른 클라이언트.

에이전트가 자신의 컴퓨터 중 하나에서 작업을 예약하도록 하려면 PandaPaw를 먼저 설치하고 연결하세요. 메모 및 작업 공간 도구는 온라인 상태의 PandaPaw 장치를 요구하지 않습니다.

MCP 서버 설치 또는 업데이트

macOS, Linux 또는 Windows에서 패키지를 전역으로 설치합니다:

bash

npm install -g @pandanpc/mcp-server

실행 파일이 셸에 표시되는지 확인합니다:

bash

pandanpc-mcp --help

업데이트하려면 동일한 npm 명령을 실행하세요. 업데이트 후 MCP 클라이언트를 다시 시작하세요. 이미 실행 중인 클라이언트는 원래 시작한 프로세스 버전을 유지하기 때문입니다.

도구나 그 동작이 이전 스크린샷이나 튜토리얼과 다른 경우 MCP 서버 버전 기록을 확인하세요.

Claude Code에 PandaNpc 추가

가장 신뢰할 수 있는 방법은 Claude Code 자체의 구성 명령입니다. PandaNpc를 모든 프로젝트에서 사용하려면 사용자 범위를 사용하세요:

bash

claude mcp add --scope user pandanpc -- pandanpc-mcp

구성을 현재 저장소를 통해 공유해야 하는 경우 --scope project를 대신 사용하고, 현재 프로젝트에서만 자신에게 적용해야 하는 경우 --scope local을 사용하세요.

등록된 서버 확인:

bash

claude mcp get pandanpc
claude mcp list

Claude Code 설치에서 사용하는 MCP 구성에 stdio 서버를 수동으로 구성할 수도 있습니다:

json

{
  "mcpServers": {
    "pandanpc": {
      "command": "pandanpc-mcp"
    }
  }
}

OpenAI Codex에 PandaNpc 추가

Codex는 명령줄에서 동일한 로컬 프로세스를 등록할 수 있습니다:

bash

codex mcp add pandanpc -- pandanpc-mcp

저장된 구성 확인:

bash

codex mcp get pandanpc
codex mcp list

~/.codex/config.toml의 해당 항목은 다음과 같습니다:

toml

[mcp_servers.pandanpc]
command = "pandanpc-mcp"

서버를 추가한 후 Codex를 다시 시작하거나 새 세션을 여세요. 사용자 지정 Codex 구성 파일을 유지 관리하는 경우 MCP 테이블을 해당 파일에 넣고 여러 파일에 중복하지 마세요.

Cursor 및 기타 MCP 클라이언트 구성

Cursor의 경우 Claude Code에 표시된 것과 동일한 JSON 형식을 사용하여 ~/.cursor/mcp.json에 로컬 서버를 추가하세요. Windsurf 및 기타 클라이언트의 경우 명령이 pandanpc-mcp이고 인수 목록이 비어 있는 stdio MCP 서버를 만드세요.

실행 파일은 그래픽 애플리케이션이 상속하는 PATH에 있어야 합니다. 터미널에서는 작동하지만 데스크톱 클라이언트에서 “명령을 찾을 수 없음”이 보고되면 다음 명령이 반환하는 절대 실행 파일 경로를 사용하세요:

bash

command -v pandanpc-mcp

Windows PowerShell에서는 다음을 사용하세요:

powershell

Get-Command pandanpc-mcp

에이전트에서 로그인

PandaNpc는 2단계 이메일 인증 흐름을 사용합니다. 에이전트에게 다음 작업을 순서대로 수행하도록 요청하세요:

이메일 주소로 note_login을 호출하세요. PandaNpc가 인증 코드를 보냅니다.
동일한 이메일 주소와 코드로 note_login을 다시 호출하세요.

로컬 자격 증명이 캐시되므로 매 세션마다 로그인할 필요가 없습니다. 인증 코드를 공개 대화록이나 공유 프롬프트에 붙여넣지 마세요.

MCP 연결 확인

에이전트가 데이터를 생성하거나 편집하도록 허용하기 전에 작은 읽기 전용 테스트를 실행하세요:

list_workspaces를 호출하도록 요청하세요.
하나의 작업 공간에 대해 list_notes를 호출하도록 요청하세요.
search_notes로 무해한 키워드를 검색하도록 요청하세요.

성공적인 응답은 MCP 클라이언트가 프로세스를 시작했고, 인증이 완료되었으며, 계정 API에 접근할 수 있음을 증명합니다. 쓰기 테스트의 경우 임시 메모를 만든 다음 소프트 삭제하세요.

MCP 클라이언트에 표시되는 정확한 도구 목록이 설치된 버전의 기준입니다. 도구는 다음 워크플로를 중심으로 그룹화됩니다:

워크플로	일반적인 도구	중요한 동작
메모	`list_notes`, `create_note`, `read_note`, `update_note`, `search_notes`	`update_note`는 전체 본문을 대체합니다. 편집하기 전에 읽으세요.
작업 로그	`save_done`	완료된 작업을 오늘의 프로젝트 폴더에 자동으로 저장합니다.
작업 공간	`list_workspaces`, `create_workspace`, `update_workspace`	바인딩된 프로젝트 경로를 통해 서버가 올바른 작업 공간을 찾을 수 있습니다.
예약 작업	`list_scheduled_bridges`, `create_scheduled_task`, `list_scheduled_task_runs`	PandaPaw 머신이 온라인 상태여야 합니다. cron 표현식은 6개 필드를 사용합니다.
공급자 및 모델	`list_providers`, `list_models`, 생성/업데이트/삭제 도구	먼저 목록을 확인해야 현재 ID와 유효한 모델 유형을 사용할 수 있습니다.
규칙 및 기술	`sync_rules`	지원되는 프로젝트 지침을 동기화하고 변경되지 않은 파일은 건너뜁니다.

공급자 및 모델 필드 정의에 대해서는 사용자 지정 AI 공급자 및 API 키를 참조하세요. 계정 및 청구 경계에 대해서는 PandaNpc 계정, 플랜 및 API 비용을 참조하세요.

안전한 운영 방법

생성, 업데이트, 삭제 또는 예약 작업 전에 먼저 목록, 읽기 또는 검색 도구부터 사용하세요.
메모 업데이트는 패치를 적용하는 대신 전체 Markdown 문서를 대체하므로 업데이트하기 전에 메모를 읽으세요.
예약 프롬프트는 코드 실행 요청으로 취급하세요. 대상 머신, 작업 디렉터리, 시간대 및 6개 필드 cron 표현식을 확인하세요.
공급자 API 키를 프롬프트와 메모에 넣지 마세요. 비밀은 의도된 공급자 구성 흐름을 통해서만 입력하세요.
파괴적이거나 외부 작업을 허용하기 전에 MCP 도구 승인 카드를 검토하세요.
작업 로그에는 수동으로 올바른 작업 공간과 날짜 폴더를 추측하는 대신 save_done을 사용하세요.

문제 해결

클라이언트가 `pandanpc-mcp`를 찾을 수 없다고 표시

설치 후 새 터미널을 열고 실행 파일 경로를 확인하세요. 데스크톱 애플리케이션은 때때로 이전 PATH를 상속합니다. 절대 경로를 구성하거나 애플리케이션을 다시 시작하세요. npm이 버전 관리자를 통해 설치된 경우 MCP 클라이언트가 동일한 사용자 및 환경에서 시작되는지 확인하세요.

서버가 등록되었지만 도구가 표시되지 않음

클라이언트를 다시 시작한 다음 claude mcp get pandanpc 또는 codex mcp get pandanpc를 확인하세요. 명령이 잘못된 경우 항목을 제거하고 다시 추가하세요. 또한 로컬 stdio 프로세스를 HTTP URL로 구성하지 않았는지 확인하세요.

도구가 인증되지 않았다고 표시

두 note_login 호출을 반복하세요. 가장 최신 인증 코드를 사용하고 스팸 폴더를 확인하며 두 호출이 동일한 이메일 주소를 사용하는지 확인하세요.

예약 작업이 머신을 찾을 수 없음

먼저 list_scheduled_bridges를 호출하세요. 사용 가능한 장치가 반환되지 않으면 대상 머신에서 PandaPaw 상태 및 장치 연결을 확인하세요. 전원이 꺼져 있거나, 절전 중이거나, 로그아웃되었거나, 연결이 끊어진 머신은 예약 실행을 시작할 수 없습니다.

메모 업데이트로 기존 텍스트가 삭제됨

update_note는 전체 대체 본문을 허용합니다. 가능한 경우 메모의 기록 또는 휴지통에서 메모를 복원한 다음 현재 콘텐츠를 읽고 결합된 문서를 제출하세요.

계정별 도움이 필요하세요? support@pandanpc.com에 문의하고 MCP 클라이언트 이름, 운영 체제, 패키지 버전 및 정확한 오류 메시지를 비밀 없이 포함하세요.