MCP (Model Context Protocol)

MCP로 AI를 JustDeploy에 연결하면 매번 가이드를 복사하지 않고 앱을 배포하고 관리할 수 있습니다.

필요한 것

JustDeploy 계정과 컴퓨터에서 실행되는 Codex 또는 Claude Code가 필요합니다. 브라우저 채팅은 로컬 MCP 설정을 바꿀 수 없습니다. MCP는 선택 사항이며 Quickstart의 복사·붙여넣기 배포도 계속 사용할 수 있습니다.

MCP 설정 복사

  1. 사이드바의 계정 메뉴 위에 있는 MCP를 여세요. 조직이 없다면 조직 생성 화면의 Connect your AI with MCP를 눌러 같은 페이지로 이동하세요.
  2. Copy MCP setup을 누르면 계정이 접근할 수 있는 모든 조직에 90일 동안 사용할 연결을 만듭니다.
  3. Codex 또는 Claude Code에 직접 붙여 넣으세요. AI가 토큰을 확인하고 사용자 설정에 저장한 뒤 연결을 확인합니다. 추가 JustDeploy 로그인, 키 입력, CLI 설치는 필요 없습니다.
복사한 설정에는 계정의 권한을 가진 비밀값이 포함됩니다. 해당 AI 대화와 비공개 클라이언트 설정에 남습니다. 프로젝트, 배포 환경변수, 공유 문서에 저장하지 마세요. 노출되면 MCP 페이지에서 연결을 해제하세요.

다시 복사하면 기존 연결을 해제하지 않고 새 연결을 만듭니다. 복사에 실패했다면 페이지를 떠나지 말고 Copy same MCP setup을 누르세요. 페이지를 떠난 뒤에는 원래 비밀값을 다시 조회할 수 없습니다. 연결 목록의 앞부분 식별값, 생성 시각, 만료일로 불필요한 연결을 찾아 해제할 수 있습니다.

연결 확인

설정 저장과 연결 완료는 다릅니다. 클라이언트가 보안 승인이나 재시작을 요청할 수 있습니다. 설정을 불러온 뒤 AI에게 MCP로 list_organizations를 실행해 달라고 하세요. 빈 목록이 정상 반환돼도 연결 성공이며, 시험만을 위해 조직을 만들 필요는 없습니다.

직접 HTTP 호출은 토큰만 확인합니다. 클라이언트에서 실제 MCP 도구가 성공하기 전에는 연결 완료로 판단하지 마세요. 클라이언트의 보안 승인 기능은 유지하세요.

다른 MCP 클라이언트

로컬 설정을 바꿀 수 없는 클라이언트는 기존 OAuth 연결을 사용합니다. 클라이언트의 원격 MCP 기능으로 이 서버 URL을 추가하고 JustDeploy에 로그인한 뒤 연결을 승인하세요. 기존 OAuth 연결도 계속 동작합니다.

https://mcp.justdeploy.ai/mcp
이 주소를 브라우저에서 직접 열면 “Method Not Allowed”(405)가 표시될 수 있습니다. 정상 동작입니다. 웹페이지 주소가 아니라 MCP 서버 주소이므로 AI 도구에 추가해서 사용하세요.

공식 MCP Registry에서 찾기

JustDeploy는 공식 MCP Registry에 등록되어 있습니다. 목록 검색을 지원하는 클라이언트는 다음 이름으로 같은 원격 서버를 찾을 수 있습니다.

ai.justdeploy/mcp

연결이 안 되나요?

  • 설정 토큰이 거절되거나 만료된 경우 Console에서 새 MCP 설정을 복사하세요. 직접 토큰 연결을 고치려고 OAuth로 전환하지 마세요. 사용해도 90일 만료가 연장되지 않습니다.
  • 검증할 수 없는 경우 기존 연결을 유지하세요. 응답의 대기 시간을 따르고, 일시적인 네트워크 문제 때문에 토큰을 새로 만들지 마세요.
  • 설정 충돌이나 쓰기 거절이 발생하면 다른 서버와 보안 설정을 유지하세요. 클라이언트 권한을 느슨하게 바꾸지 말고 AI가 설명하는 다음 행동을 따르세요.
  • OAuth 로그인 후 도구가 보이지 않으면 클라이언트를 다시 불러오고 list_organizations를 확인하세요. 브라우저의 성공 화면은 로그인 완료이며 MCP 연결을 확인한 것은 아닙니다.

할 수 있는 일

AI에게 앱 배포, 로그 확인, 데이터베이스·파일 작업, 프로젝트 설정·환경변수·앱 키 관리를 요청하세요. AI는 계정에 허용된 권한 안에서 작업합니다.

환경변수 값과 새로 발급한 앱 키는 AI 대화 기록에 남을 수 있습니다. AI에게 비밀값을 전달하고 싶지 않다면 콘솔이나 비공개 로컬 설정을 이용하세요.