로컬 MCP 설정

핵심 요약

신뢰할 수 있는 프로젝트를 stdio 기반 **yp-mcp**에 연결합니다. 6개 도구는 기존 yp CLI를 호출하며, 샌드박스를 제공하지는 않습니다.

아래 설정의 절대 경로를 바꾸고 먼저 조회·분석 도구를 시험한 뒤 적용 작업을 승인하세요.

로컬 yp-mcp는 보호 파이프라인을 AI 코딩 에이전트에 연결하는 stdio MCP 서버입니다. 실제 분석·적용·검증은 기존 devpay CLI를 호출합니다.

서버 시작

node tools/devpay-mcp/server.mjs --workspace /absolute/path/to/project

--workspace는 접근 가능한 프로젝트 경계입니다. 상대 경로나 임의 외부 파일을 자유롭게 열 수 있도록 허용하지 않습니다.

에이전트 설정

MCP 클라이언트에서 일반적으로 사용하는 설정 예시는 다음과 같습니다. 클라이언트에 따라 설정 파일의 위치가 다를 수 있습니다.

{
  "mcpServers": {
    "devpay": {
      "command": "node",
      "args": [
        "/absolute/path/to/nougat-devpay/tools/devpay-mcp/server.mjs",
        "--workspace",
        "/absolute/path/to/project"
      ]
    }
  }
}

yp-mcp 실행 파일이 이미 PATH에 있다면 "command": "devpay-mcp"로 대체할 수 있습니다.

사용 가능한 주요 도구

• yetdapay_project_analyze — 프로젝트 분석
• yetdapay_protection_plan — 보호 계획
• yetdapay_protection_review — 계획 검토
• yetdapay_protection_apply — 승인된 적용 작업
• yetdapay_protection_verify — 검증 실행
• yetdapay_environment_doctor — 환경 진단

apply는 approved:true가 없으면 CLI 실행 전에 거부합니다. 실제 사용자 승인과 Plan SHA 일치 여부도 반드시 확인하세요.

안전한 운영

• 파일 경로는 워크스페이스 내부로 제한합니다.
• 자식 프로세스는 Shell 대신 인자 배열로 실행합니다.
• 인증정보와 비밀 변수를 자식 실행 환경에 전달하지 않도록 필터링합니다.
• 분석과 검증은 코드를 실행할 수 있으므로 신뢰된 워크스페이스에서만 사용합니다.
• 보안 검증 상태를 에이전트 응답만으로 확정하지 않습니다.

도구 상세 스키마 · 전체 설정과 한계