MCP로 AI 도구 연결하기
Neopress 계정을 AI 도구에 연결하고, 대상 사이트를 확인한 뒤 안전하게 첫 작업을 시작하는 방법을 알아봅니다.
Neopress MCP를 연결하면 AI 도구에서 사이트를 조회하고 관리할 수 있습니다. 페이지와 레이아웃, CMS 컬렉션과 콘텐츠, 폼, 에셋, 발행, 분석 도구를 제공합니다. AI 도구가 요청을 해석하고 페이지 코드를 작성하면, MCP가 Neopress에서 지원하는 작업을 실행합니다.
연결 전에 확인할 사항
OAuth 인증을 지원하는 원격 MCP 연결 기능이 있는 AI 도구를 사용하세요. 대상 사이트는 Launch 또는 Growth 이용 권한이 필요하며, 유효한 무료 체험 기간에는 Launch 권한이 적용됩니다. AI 도구는 로그인한 계정의 사이트 권한을 그대로 사용합니다. 연결만으로 편집이나 발행 권한이 추가되지는 않습니다.
원격 서버 주소는 https://mcp.neopress.ai/mcp입니다. 브라우저에서 Neopress 계정으로 로그인하는 방식이며, 연결 설정에 넣을 Neopress API 키를 별도로 발급하는 절차는 없습니다.
AI 도구 연결 메뉴에서 시작하기
Neopress 대시보드에서 연결할 사이트를 연 뒤 설정의 AI 도구 연결로 이동합니다.
원격 MCP 설정을 열고 설정 프롬프트를 복사합니다. 서버 주소와 현재 사이트 정보가 포함되어 있습니다.
AI 도구에 프롬프트를 붙여넣습니다. AI가 연결 설정을 직접 바꿀 수 없다면, 해당 도구의 원격 MCP 설정에 서버 주소를 추가합니다.
인증을 시작하고 사용할 Neopress 계정으로 로그인합니다. 연결 요청을 확인한 뒤 승인합니다.
AI에게 접근 가능한 사이트 목록을 조회하고 대상 사이트를 선택하도록 요청합니다. 변경을 시작하기 전에 반환된 사이트 이름과 ID가 맞는지 확인합니다.
AI 도구마다 연결 메뉴의 이름은 다를 수 있습니다. 첫 확인에는 다음 요청을 사용하세요. 예시의 사이트 ID는 실제 사이트 ID로 바꿔야 합니다.
내 Neopress 사이트 목록을 보여줘. 사이트 123을 선택하고 이름을 확인해줘.
Neopress 런타임 규칙을 읽은 뒤 이 사이트의 페이지 목록을 보여줘.
아직 변경하지는 마.작업 범위를 구체적으로 요청하기
사이트와 페이지, 바꿀 내용, 초안까지만 작업할지 발행까지 할지를 함께 알려주세요. 예를 들어 “사이트 123의 소개 페이지 첫 문단을 수정해줘. 구조와 이미지는 유지하고, 컴파일한 뒤 발행 예정 변경 사항을 보여줘”라고 요청할 수 있습니다. 공개 사이트에 반영하려면 발행까지 요청하세요.
MCP의 수정과 발행은 별도 작업입니다. 사이트 발행은 레이아웃, 페이지, 컬렉션 스키마, 폼을 반영하며 CMS 콘텐츠는 각각 발행해야 합니다. 현재 MCP를 통한 사이트 발행에는 소유자 또는 관리자 계정이 필요합니다.
로컬 MCP와 파일 업로드
컴퓨터에서 실행하는 AI 도구에는 로컬 stdio MCP도 연결할 수 있습니다. Node.js 24 이상을 준비한 뒤 CLI와 MCP 패키지를 설치하고 로그인합니다.
pnpm add -g @neopress/cli@latest @neopress/mcp@latest
neopress loginAI 도구가 neopress-mcp를 stdio 서버로 실행하도록 설정하세요. 로컬 CLI 로그인 세션을 재사용하며 컴퓨터의 파일을 읽어 업로드할 수 있습니다. 원격 서버는 내 컴퓨터의 파일 경로를 직접 읽을 수 없으므로, 공개 URL 가져오기나 임시 업로드 주소를 이용하는 방식으로 에셋을 전달합니다.
발행을 요청했다면 실제 사이트 주소를 열어 변경한 페이지를 확인하세요. 연결 성공, 초안 저장, 컴파일 완료는 각각 다른 상태이며 방문자에게 공개되었다는 뜻은 아닙니다.