Model Context Protocol (MCP)

AI가 JustDeploy와 직접 대화하게 하세요. 가이드를 채팅창에 매번 복사할 필요 없이 JustDeploy를 MCP 서버로 한 번만 추가하면, 평소 쓰는 AI 도구 안에서 앱 배포, 로그 확인, DB 쿼리, 계정 관리를 바로 할 수 있습니다.

필요한 것

MCP를 지원하는 AI 도구. 아래 목록을 참고하세요.
JustDeploy 계정. 아직 없다면 연결할 때 무료로 만들어집니다 — 따로 설정할 API 키가 없습니다.

MCP 서버 URL

아래 URL을 AI 도구에 추가하세요:

https://mcp.justdeploy.net

추가하면 브라우저에 JustDeploy 로그인 화면이 열립니다. Google 또는 이메일로 로그인하고 연결을 승인하면 됩니다 — 붙여넣을 키가 없습니다. 한 번 연결하면 모든 조직에 적용되며, 배포할 때 AI가 어느 조직에 배포할지 물어봅니다. 연결은 계정 설정에서 언제든 해제할 수 있습니다.

클라이언트별 설정

최신 AI 클라이언트는 remote MCP로 native 연결됩니다 — 위 URL 하나만 등록하면 OAuth 로그인은 알아서 처리됩니다(키·수동 client ID 불필요). 아래에서 사용하는 도구를 설정하세요.

Claude Code

터미널에서 서버를 추가한 뒤 Claude Code 안에서 /mcp를 실행하고 JustDeploy를 선택해 로그인하세요. -s user를 붙이면 모든 프로젝트에서 쓸 수 있습니다.

Terminal

claude mcp add --transport http justdeploy https://mcp.justdeploy.net

Claude Desktop

Settings → Connectors에서 "Add custom connector"를 누르고 위 서버 URL을 붙여넣은 뒤 Add를 클릭하세요. 브라우저 창이 열려 로그인합니다.

Cursor

~/.cursor/mcp.json(모든 프로젝트) 또는 .cursor/mcp.json(특정 프로젝트)에 아래를 추가하세요. AI가 처음 사용할 때 Cursor가 브라우저를 열어 로그인합니다.

~/.cursor/mcp.json

{
  "mcpServers": {
    "justdeploy": {
      "url": "https://mcp.justdeploy.net"
    }
  }
}

VS Code

워크스페이스의 .vscode/mcp.json에 아래를 추가하세요(모든 워크스페이스에 적용하려면 "MCP: Open User Configuration" 실행). VS Code가 브라우저를 열어 로그인합니다.

.vscode/mcp.json

{
  "servers": {
    "justdeploy": {
      "type": "http",
      "url": "https://mcp.justdeploy.net"
    }
  }
}

Codex

~/.codex/config.toml에 아래를 추가하세요. 서버를 처음 시작할 때 Codex가 브라우저를 열어 로그인합니다.

~/.codex/config.toml

[mcp_servers.justdeploy]
url = "https://mcp.justdeploy.net"
auth = "oauth"
startup_timeout_sec = 120.0

도구별 공식 문서

위에 없는 도구를 쓰거나 전체 옵션이 궁금하다면, 사용하는 도구의 공식 MCP 문서를 여세요:

연결 확인

로그인했다고 연결이 끝난 게 아닙니다. 실제로 됐는지 확인하세요:

클라이언트에 JustDeploy가 "connected"로 표시되고 도구 목록이 나타납니다.
AI에게 list_organizations를 실행하게 하세요 — 접근 가능한 조직 목록이 나오면 정상 연결입니다.

브라우저에 "Authorization successful"이 떠도 연결 완료가 아닙니다 — 그 메시지는 로그인 단계가 끝났다는 뜻일 뿐이고, JustDeploy가 아니라 클라이언트가 표시하는 것입니다. 실제 연결은 클라이언트에 도구가 로드됐는지 + list_organizations가 응답하는지로 확인하세요.

연결이 안 되나요?

로그인 페이지가 계속 다시 열리면(연결을 반복해서 요청하면) 클라이언트가 토큰을 저장하지 못한 것입니다. 위에 안내한 도구별 native remote MCP + OAuth 방식으로 설정하세요.

일부 구형 클라이언트는 native remote MCP 대신 프록시(npx -y mcp-remote …)로 연결합니다. 클라이언트가 native remote MCP를 지원한다면 프록시는 피하세요 — OAuth 토큰을 저장하지 못해 로그인 루프에 빠질 수 있습니다. 위 native 방식을 쓰세요.

할 수 있는 일

JustDeploy MCP는 모든 조직에 걸쳐 사용할 수 있는 다양한 도구를 AI에 제공합니다:

Organizations: 조직 목록 조회, 배포할 조직 선택
Projects: 생성, 조회, 배포, 상태 확인
Builds: 배포 시작, 빌드 상태 조회
환경 변수: 설정, 조회, 삭제
Firewall: IP 규칙 추가 및 삭제
Databases: 테이블 목록 조회, SQL 쿼리 실행
Storage: 파일 목록 조회, 다운로드, 삭제
Logs: 앱 로그 조회