Claude Code, Codex, Cursor를 MonstarX에 연결하기

핵심 요약MonstarX의 MCP 서버 주소는 https://monstarx.com/mcp입니다. Claude Code, Codex, Cursor, VS Code, Gemini CLI, Windsurf, ChatGPT, Claude 앱에 이 서버를 추가하고, 브라우저에서 한 번 로그인한 다음 “이 앱을 MonstarX에 푸시하고 링크를 알려 주세요”라고 말하세요. 그러면 에이전트가 새 버전을 푸시하고, MonstarX의 변경 사항을 가져오고, MonstarX에 만들기를 요청하고, 시크릿을 설정하고, 게시할 수 있습니다.

Claude Code, Codex, Cursor 같은 AI 코딩 에이전트는 앱 코드를 잘 작성하지만, 나머지는 직접 해결해야 합니다. 앱을 실행할 곳, 공유할 링크, 도메인, 데이터베이스, 테스트, 그리고 개발자가 아닌 사람도 계속 앱을 고칠 방법이 필요합니다. MonstarX가 바로 그 나머지를 맡습니다.

에이전트를 MonstarX에 한 번만 연결하면, “이 앱을 MonstarX에 푸시해 주세요”라는 말 한마디로 에이전트가 만든 앱이 MonstarX에 올라가 공유 링크와 함께 실시간 미리보기로 실행됩니다. 그 뒤로는 에이전트에서, MonstarX에서, 또는 양쪽 모두에서 계속 만들 수 있습니다. 작업이 양방향으로 오갑니다.

에이전트는 MCP(Model Context Protocol, AI 도구가 다른 서비스를 쓰는 표준 방식)로 연결됩니다. MonstarX의 MCP 서버 주소는 다음과 같습니다.

https://monstarx.com/mcp

MonstarX MCP 서버 페이지. 에이전트로 만들고, MonstarX에 게시하세요.라는 제목, URL 복사 버튼이 있는 https://monstarx.com/mcp 주소, 지원하는 에이전트, 에이전트용 설정 프롬프트 복사 버튼이 보입니다

개발자용 전체 가이드는 MonstarX MCP 페이지에 있습니다.

에이전트는 어떻게 연결하나요?

설정API & MCP를 여세요. 코딩 에이전트 연결에서 사용하는 에이전트를 고르세요.
브라우저 로그인을 선택한 상태로 두고, 화면에 나온 설정을 에이전트에 복사해 넣으세요. 아래 탭에서 많이 쓰는 에이전트의 설정을 똑같이 볼 수 있습니다.
에이전트가 요청하면 MonstarX에 로그인하세요. 브라우저에 MonstarX가 열리면 로그인하고 허용을 누르세요. 키는 필요 없습니다.
“이 앱을 MonstarX에 푸시하고 링크를 알려 주세요.”라고 말하세요.

Claude Code의 명령줄 도구, 데스크톱 앱의 Code 탭, IDE 확장 프로그램은 설정 하나를 함께 씁니다. 다음을 실행하세요.

claude mcp add --transport http --scope user monstarx https://monstarx.com/mcp

그다음 Claude Code에서 /mcp를 실행하고 monstarx를 고른 뒤 Authenticate를 선택하세요(또는 claude mcp login monstarx를 실행하세요). 브라우저에 MonstarX가 열리면 로그인하고 허용을 누르세요.

--scope user를 넣으면 모든 폴더에서 MonstarX를 쓸 수 있습니다. 빼면 현재 프로젝트에만 추가됩니다.

OpenAI Codex의 명령줄 도구와 IDE 확장 프로그램에서는 다음을 실행하세요.

codex mcp add monstarx --url https://monstarx.com/mcp
codex mcp login monstarx

로그인 명령을 실행하면 브라우저가 열립니다. MonstarX에 로그인하고 허용을 누르세요.

Codex는 기본적으로 네트워크 접근 없이 명령을 실행하는데, 앱을 푸시하려면 네트워크가 필요합니다. Codex가 물어보면 업로드 명령을 승인하거나, 해당 세션에 네트워크 접근을 허용하세요.

설정의 Cursor 설정 화면에서 Add to Cursor를 클릭하거나, ~/.cursor/mcp.json에 MonstarX를 추가하세요.

{
  "mcpServers": {
    "monstarx": {
      "url": "https://monstarx.com/mcp"
    }
  }
}

Cursor의 Settings → MCP에 로그인 버튼과 함께 MonstarX가 표시됩니다. 로그인하고 허용을 누르세요. Cursor의 명령줄 에이전트에서는 agent mcp login monstarx를 실행하세요.

GitHub Copilot의 에이전트 모드에서는 설정의 VS Code 설정 화면에서 Install in VS Code를 클릭하거나, 다음을 실행하세요.

code --add-mcp '{"name":"monstarx","type":"http","url":"https://monstarx.com/mcp"}'

MonstarX 도구가 처음 실행될 때 VS Code가 로그인을 요청합니다. 로그인하고 허용을 누르세요.

다음을 실행하세요.

gemini mcp add --transport http monstarx https://monstarx.com/mcp

그다음 Gemini CLI에서 /mcp auth monstarx를 실행하고, 브라우저에서 허용을 누르세요.

~/.codeium/windsurf/mcp_config.json에 MonstarX를 추가하세요. 처음 쓸 때 Cascade가 로그인을 요청합니다.

{
  "mcpServers": {
    "monstarx": {
      "serverUrl": "https://monstarx.com/mcp"
    }
  }
}

Free, Pro, Max 요금제에서는 Customize → Connectors → Add custom connector로 가서 https://monstarx.com/mcp를 붙여 넣은 다음 Connect를 누르세요. MonstarX에 로그인하고 허용을 누르면 됩니다. Team과 Enterprise 요금제에서는 Owner가 Organization settings → Connectors에서 추가하고, 멤버는 Connect를 누르면 됩니다.

커넥터 하나로 웹, 데스크톱 앱, 모바일에서 모두 쓸 수 있습니다. Claude 채팅에는 명령줄이 없으므로, 앱 전체는 업로드하는 대신 GitHub에서 가져옵니다.

ChatGPT 설정에서 Developer mode를 켜세요(Business와 Enterprise에서는 관리자가 먼저 허용해야 합니다). 그다음 주소를 https://monstarx.com/mcp로 해서 새 앱이나 커넥터를 만들고 OAuth를 선택하세요. ChatGPT는 무언가를 바꾸는 도구를 실행하기 전마다 먼저 물어봅니다.

설정 페이지에는 Grok, Lovable, Bolt & v0, Replit, Figma, 기타 도구(MCP를 지원하는 모든 도구)의 설정도 있습니다. 더 많은 클라이언트를 다룬 개발자용 전체 가이드는 설정API & MCP 맨 위의 문서에서 볼 수 있습니다.

에이전트에 키가 필요하면 어떻게 하나요?

Windsurf, Gemini CLI, 스크립트, CI는 브라우저 로그인 대신 API 키를 씁니다. 설정API & MCP의 API 키에서 키를 만든 다음, 에이전트 설정을 API 키로 바꾸면 키가 들어간 설정이 나옵니다. 키를 만들고, 쓰고, 폐기하는 방법은 API & MCP를 참고하세요. 키는 코드나 대화에 넣지 마세요. 키 하나로 모든 프로젝트에서 내 이름으로 작업할 수 있습니다.

에이전트에게 무엇을 시킬 수 있나요?

연결하고 나면 에이전트에게 평소 말투로 이야기하세요. 이렇게 해 보세요.

“이 앱을 MonstarX에 푸시하고 링크를 알려 주세요.”
“내 변경 사항을 MonstarX에 푸시해 주세요.”
“MonstarX에서 최신 버전을 가져와 내 변경 사항과 병합해 주세요.”
“MonstarX에 Stripe 결제를 추가해 달라고 요청한 다음, 변경 사항을 가져와 주세요.”
“MonstarX에 게시해 주세요.”

명령줄이 없는 채팅 앱(Claude 앱, ChatGPT)에서는 “MonstarX에서 내 미용실 예약 앱을 만들어 주세요”, “github.com/me/my-app 저장소를 MonstarX로 가져와 주세요”, “내 Harbour Watch 프로젝트에서 MonstarX는 무엇을 하고 있나요?”처럼 말해 보세요.

에이전트가 앱을 푸시하면 어떻게 되나요?

에이전트가 MonstarX에 일회용 업로드 링크를 요청한 다음, 명령 하나로 앱 폴더를 보냅니다. node_modules, 빌드 결과물, .env 파일은 내 컴퓨터에 그대로 남습니다. 파일이 AI 모델을 거치지 않으므로, 큰 앱이라고 토큰이 더 들지 않습니다.
MonstarX가 앱 가져오기와 똑같은 방식으로 앱이 어떤 종류인지 확인하고, 앱의 패키지로 실시간 미리보기를 실행합니다.
에이전트는 프로젝트 링크, MonstarX가 확인한 내용, 앱에 아직 필요한 키 목록을 돌려받습니다.

그다음부터 푸시할 때마다 버전에 에이전트 이름이 붙은 새 버전(“Claude Code에서 푸시됨”)이 생기고, 나와 MonstarX 에이전트가 무엇이 바뀌었는지 알 수 있도록 대화에도 메모가 남습니다. 에이전트가 마지막으로 사본을 받은 뒤 누군가 MonstarX에서 작업했다면, 그 작업을 덮어쓰지 않도록 푸시가 거부됩니다. 그러면 에이전트가 MonstarX의 버전을 내려받아 병합한 뒤 다시 푸시합니다.

MonstarX는 에이전트에게 어떤 도구를 제공하나요?

도구	하는 일
`get_account`	내 계정, 요금제, 남은 사용 한도
`list_projects`	내 프로젝트 목록(최근에 바뀐 순서)
`get_project`	프로젝트 하나를 한눈에: MonstarX가 하고 있는 일, 미리보기, 게시 상태, 빠진 시크릿
`prepare_upload`	현재 폴더를 새 프로젝트나 새 버전으로 푸시하는 일회용 업로드 링크와 명령
`import_from_github`	GitHub 저장소에서 앱 가져오기
`push_files`	작은 수정이나 명령줄이 없는 에이전트를 위해 파일 몇 개를 직접 쓰기
`create_project`	설명, 그림, 문서로 MonstarX가 새 앱을 만들게 하기
`read_files`	프로젝트 파일 목록 보기 또는 읽기
`download_project`	프로젝트를 풀 수 있는 일회용 다운로드 링크와 명령
`send_message`	작업 공간에서 입력한 것처럼 MonstarX 에이전트에게 만들기, 답변, 계획을 요청
`get_messages`	프로젝트 대화 읽기(MonstarX가 답변을 마칠 때까지 기다리는 옵션 포함)
`stop`	프로젝트에서 MonstarX가 실행 중인 작업 중지
`publish_project`	현재 버전을 공개
`set_secrets`	앱이 읽는 키를 암호화해 백엔드 → 시크릿에 저장
`get_logs`	미리보기 상태와 출력. 중지된 미리보기를 시작할 수도 있습니다

모든 도구는 내가 소유한 프로젝트에서만 작동합니다. 읽기만 하는 도구에는 읽기 전용 표시가 있어 에이전트가 묻지 않고 실행할 수 있고, 게시는 항상 먼저 물어봅니다.

한도

업로드: .tar.gz(푸시 명령이 만드는 형식)는 최대 100 MB, .zip은 최대 50 MB입니다. 10 MB가 넘는 파일은 제외되고 목록으로 알려 줍니다.
push_files: 한 번 호출할 때 파일 200개, 파일당 400 KB, 전체 2 MB까지입니다.
업로드와 다운로드 링크는 15분 동안 한 번만 쓸 수 있습니다.
프로젝트 대부분을 지우게 되는 푸시(파일이 원래의 4분의 1 미만으로 줄어드는 경우)는 거부됩니다. 거의 항상 잘못된 폴더에서 실행한 경우입니다.
해당 프로젝트에서 MonstarX가 만드는 중이면 푸시가 거부됩니다.
사용 한도: MonstarX에 만들기를 요청하면(send_message, create_project) 요금제의 사용 한도를 씁니다. 푸시, 가져오기, 다운로드, 읽기, 게시는 쓰지 않습니다.
API 키: 계정당 최대 20개입니다. 브라우저 로그인은 사용하는 동안 90일간 유지됩니다.

문제 해결

MonstarX 도구가 보이지 않습니다. 대부분의 에이전트는 세션을 시작할 때 서버를 불러옵니다. 새 세션을 시작하세요. Claude Code에서는 /mcp로 MonstarX가 연결되었는지 확인할 수 있습니다.
로그인 요청이나 권한 없음(unauthorised) 오류가 나옵니다. 로그인이 만료되었거나 키가 폐기된 것입니다. 다시 로그인하거나(Claude Code에서는 /mcp, Codex에서는 codex mcp login monstarx) 새 키를 만드세요.
Codex에서 업로드가 안 됩니다. 샌드박스가 네트워크를 막고 있습니다. 명령을 승인하거나 네트워크 접근을 허용하세요.
“This upload has 3 files and the project has 214” 오류가 나옵니다. 명령을 잘못된 폴더에서 실행했습니다. package.json이 있는 폴더에서 실행하세요.
“The files in MonstarX changed since your copy was taken” 오류가 나옵니다. 마지막으로 푸시한 뒤 누군가 MonstarX에서 작업했습니다. 에이전트에게 내려받아 병합한 뒤 다시 푸시하라고 하세요.
비공개 GitHub 저장소를 찾지 못합니다. 먼저 MonstarX에서 GitHub을 연결하세요. GitHub을 참고하세요.
앱이 시작되지 않습니다. 에이전트에게 로그를 확인하라고 하세요. 빠진 키는 set_secrets로 설정할 수 있습니다.

에이전트 연결은 어떻게 해제하나요?

설정API & MCP를 열고 연결된 에이전트에서 해당 에이전트 옆의 연결 해제를 클릭하세요. 즉시 로그아웃됩니다. 키를 쓰는 에이전트는 키를 폐기하면 작동을 멈춥니다. API & MCP를 참고하세요.

자주 묻는 질문

API 키가 필요한가요?

대개는 필요 없습니다. 대부분의 에이전트는 브라우저로 로그인합니다. MonstarX에 로그인하고 허용을 누르기만 하면 됩니다. 키는 브라우저를 열 수 없는 에이전트, 스크립트, CI를 위한 것입니다.

.env 파일도 업로드되나요?

아니요. 푸시 명령은 .env 파일을 제외하고, 혹시 올라오더라도 MonstarX는 저장하지 않습니다. 키는 백엔드 → 시크릿에 보관하거나, 에이전트에게 set_secrets를 쓰라고 하세요.

에이전트와 MonstarX 양쪽에서 계속 만들 수 있나요?

네. 에이전트에서 푸시하고, MonstarX에서 만들고, 에이전트에게 최신 버전을 가져오라고 하면 됩니다. 리비전 확인 기능이 있어 어느 쪽도 상대의 작업을 덮어쓰지 않습니다.

어떤 앱이 MonstarX에서 실행되나요?

MonstarX 앱과 Vite 앱(React, Vue, Svelte, 그리고 Lovable, Bolt, v0에서 내보낸 모든 앱)은 MonstarX에서 실행하고 게시할 수 있습니다. Next.js, Remix, Astro, Nuxt, SvelteKit은 미리보기에서 실행되지만 게시는 각자의 호스팅에서 합니다. 그 밖의 앱은 웹 앱으로 다시 만들 수 있습니다.

MCP 커넥터와 같은 건가요?

아니요. 방향이 반대입니다. 여기서는 에이전트가 MonstarX를 사용합니다. MCP 커넥터는 MonstarX가 다른 MCP 서버를 사용하게 합니다.