JustDeploy/Docs

MCP (Model Context Protocol)

MCP는 AI를 JustDeploy와 직접 연결해 매번 가이드를 복사해 붙여 넣을 필요가 없게 합니다. 연결하면 평소 사용하는 채팅에서 AI가 프로젝트를 생성하고, 앱을 온라인에 올리고, 로그를 읽고, 데이터베이스를 쿼리하는 등 일반적인 JustDeploy 작업을 처리할 수 있습니다.

필요한 것

  • MCP를 지원하는 AI 도구. 아래 목록을 확인하세요.
  • JustDeploy 계정. 아직 없다면 연결할 때 무료로 만들 수 있으며 API 키를 설정할 필요는 없습니다.

MCP 서버 URL

이 URL을 AI 도구에 추가하세요.

https://mcp.justdeploy.ai

추가하면 브라우저에 JustDeploy 로그인 페이지가 열립니다. 키를 붙여 넣을 필요 없이 Google 또는 이메일로 로그인하고 연결을 승인하세요. 한 번의 연결로 속한 모든 조직을 사용할 수 있으며 배포할 때 AI가 어느 조직을 쓸지 묻습니다. Account 설정에서 각 연결의 마지막 사용 시간과 IP를 확인하거나 즉시 연결을 해제할 수 있습니다.

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

공식 MCP Registry에서 찾기

JustDeploy는 공식 MCP Registry에 등록되어 있습니다. 이 공식 등록 목록을 지원하는 AI 도구에서는 서버 URL을 직접 붙여 넣지 않고 JustDeploy를 추가할 수 있습니다. 다음 이름을 찾으세요.

ai.justdeploy/mcp

사용 중인 AI 도구의 커넥터 목록에서 검색하거나 registry.modelcontextprotocol.io에서 찾으세요. 공식 목록 검색을 아직 지원하지 않는 도구라면 위 서버 URL을 직접 추가하면 됩니다. 두 방법 모두 같은 서버에 연결됩니다.

클라이언트 설정

가장 간단한 설정 방법은 AI에게 대신 해달라고 요청하는 것입니다. AI가 명령어를 실행하고 자신의 설정을 수정할 수 있으므로 터미널을 열거나 설정 파일을 찾을 필요가 없습니다. 아래 메시지를 붙여 넣고 AI가 작업하게 하세요.

로그인은 브라우저에서 직접 해야 합니다. JustDeploy 페이지가 열리면 로그인하고 연결을 승인하세요. 이 단계는 AI가 대신할 수 없습니다.

직접 설정하기

직접 설정하고 싶다면 아래에서 도구별 방법을 확인하세요. 최신 AI 도구는 원격 MCP를 직접 지원하므로 위 URL 하나만 등록하면 됩니다. API 키나 별도 client ID 없이 OAuth 로그인이 이어집니다.

MCP는 선택 사항입니다. 이 과정을 생략하려면 빠른 시작의 복사·붙여넣기 방법을 사용하세요. 별도 설정 없이 같은 결과를 얻을 수 있습니다.

Codex

~/.codex/config.toml에 다음을 추가하세요. Codex가 서버를 처음 시작할 때 로그인용 브라우저를 엽니다.

~/.codex/config.toml
[mcp_servers.justdeploy]
url = "https://mcp.justdeploy.ai"
auth = "oauth"
startup_timeout_sec = 120.0

Claude Code

터미널에서 서버를 추가한 뒤 Claude Code 안에서 /mcp를 실행하고 JustDeploy를 선택해 로그인하세요. 모든 프로젝트에서 사용하려면 -s user를 추가하세요.

Terminal
claude mcp add --transport http justdeploy https://mcp.justdeploy.ai

Antigravity

모든 프로젝트에서 사용하려면 ~/.gemini/config/mcp_config.json, 하나의 작업 공간에서만 사용하려면 .agents/mcp_config.json에 다음을 추가하세요. Settings → Customizations로 돌아가 MCP 서버 목록을 새로고침한 뒤 JustDeploy를 인증하세요.

~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "justdeploy": {
      "serverUrl": "https://mcp.justdeploy.ai"
    }
  }
}

Claude Desktop

Settings → Connectors를 열고 “Add custom connector”를 누른 뒤 위 서버 URL을 붙여 넣고 Add를 누르세요. 로그인용 브라우저 창이 열립니다.

도구별 공식 문서

위에 없는 도구를 사용하거나 전체 옵션이 필요한가요? 해당 도구의 공식 MCP 문서를 여세요.

연결 확인

로그인과 연결은 다릅니다. 실제로 연결되었는지 확인하세요.

  • 클라이언트에 JustDeploy가 연결된 상태로 표시되고 도구 목록이 보입니다.
  • AI에게 list_organizations를 실행하라고 요청하세요. 속한 조직이 반환되면 연결된 것입니다.
브라우저에 “Authorization successful”이 보이는 것은 연결 완료와 다릅니다. 해당 메시지는 로그인 단계가 끝났다는 뜻일 뿐이며 JustDeploy가 아닌 클라이언트가 표시합니다. 클라이언트가 도구를 불러왔고 list_organizations가 응답하는지로 실제 연결을 확인하세요.

연결이 안 되나요?

로그인 페이지가 계속 다시 열린다면 AI 도구가 인증 토큰을 저장하지 못한 것입니다. 위에서 설명한, 해당 도구가 직접 지원하는 원격 MCP + OAuth 방식으로 다시 설정하세요.

일부 오래된 도구는 원격 MCP에 직접 연결하지 않고 프록시(npx -y mcp-remote …)를 사용합니다. 사용 중인 도구가 원격 MCP를 직접 지원한다면 프록시는 피하세요. 인증 토큰을 저장하지 못해 로그인이 반복될 수 있습니다. 위의 직접 연결 방식을 사용하세요.

할 수 있는 일

JustDeploy MCP는 모든 조직에서 일반적인 작업을 처리할 AI 도구를 제공합니다.

  • 조직: 속한 조직 목록을 확인하고 배포할 곳 선택
  • 프로젝트: 생성, 조회, 배포, 상태 확인
  • 빌드: 배포 실행, 빌드 상태 확인
  • 스케줄러: 예약 프로젝트의 실행 시간 설정, 일시 중지·재개, 즉시 실행
  • 환경 변수: 설정, 목록 확인, 삭제
  • 방화벽: IP 규칙 추가 또는 제거
  • 데이터베이스: 테이블 목록 확인, 쿼리 실행
  • 스토리지: 파일 목록 확인, 다운로드, 삭제
  • 앱 키: 앱이 전용 데이터베이스와 스토리지에 접근할 때 필요한 키 발급, 목록 확인, 폐기
  • 로그: 앱 로그 읽기