NeoPress 원격 MCP 연결하기

원격 MCP로 할 수 있는 일

NeoPress 원격 MCP를 연결하면 지원하는 AI 클라이언트에서 사이트, 페이지, 컬렉션, 엔트리, 폼, 에셋, 분석 데이터를 조회할 수 있습니다. 권한이 있다면 드래프트 수정과 발행 작업도 요청할 수 있습니다.

1. MCP 서버를 추가하세요

원격 MCP 주소는 https://mcp.neopress.ai/mcp입니다. 사용하는 클라이언트의 MCP 설정에서 이 주소를 원격 서버로 추가하세요.

2. OAuth 인증을 완료하세요

연결 과정에서 브라우저 인증 화면이 열리면 NeoPress 계정으로 로그인하고 접근을 승인합니다. API 키를 복사해 넣을 필요는 없습니다.

3. 접근 가능한 사이트를 확인하세요

연결이 끝나면 먼저 사이트 목록을 조회하세요. 작업할 사이트의 숫자 ID를 확인하고 이후 요청에 siteId를 명시하면 다른 프로젝트를 잘못 수정할 가능성을 줄일 수 있습니다.

예시: 접근 가능한 사이트 목록을 보여주고, 사이트 420의 페이지를 읽기 전용으로 조회해줘.

4. 읽기와 수정을 구분하세요

처음에는 사이트 정보와 페이지 목록을 읽기 전용으로 확인하세요. 수정할 때는 프로덕션이 아니라 드래프트에 반영하도록 요청하고, 페이지 컴파일과 발행 미리보기 결과를 확인합니다.

5. 발행은 별도로 요청하세요

MCP 연결만으로 변경사항이 자동 발행되지는 않습니다. 페이지와 레이아웃은 사이트 발행, CMS 엔트리는 엔트리 발행이 필요합니다. 공개 작업은 변경 범위와 대상 사이트를 다시 확인한 뒤 실행하세요.

원격 MCP 서버는 사용자의 로컬 파일 경로를 직접 읽을 수 없습니다. 이미 공개된 파일은 URL 가져오기를 사용하고, 로컬 파일은 presigned 업로드 방식으로 전송할 수 있습니다.