AI 에디터 MCP 연결 가이드 (Cursor·Claude Code·Codex)

Claude Code — 터미널 한 줄:

claude mcp add --transport http dashcloud https://mcp.dashcloud.kr/mcp

이후 Claude Code에서 /mcp → DashCloud → 승인을 누르면 브라우저 OAuth로 연결됩니다. API 키가 필요 없습니다.

Codex — 터미널 두 줄:

codex mcp add dashcloud --url https://mcp.dashcloud.kr/mcp
codex mcp login dashcloud

login 명령이 브라우저 승인 창을 엽니다. API 키가 필요 없습니다.

Cursor — 대시보드 API 인증 키 페이지의 MCP 카드에서 [Cursor에 추가] 버튼을 누르면 설치 창이 뜹니다. (Cursor를 한 번 실행해 cursor:// 핸들러가 등록돼 있어야 합니다)

딥링크가 안 열리면 Cursor Settings ➔ Tools & MCP ➔ Add remote server에 아래를 입력하세요. URL만 넣으면 브라우저 OAuth로 인증됩니다.

{ "url": "https://mcp.dashcloud.kr/mcp" }

ChatGPT — ChatGPT 설정 ➔ 커넥터 ➔ 고급 설정에서 개발자 모드를 켜고 새 커넥터를 만듭니다:

• 이름: DashCloud
• MCP 서버 URL: https://mcp.dashcloud.kr/mcp (경로 /mcp까지 정확히 입력)
• 인증: OAuth

만들기 후 연결을 누르면 브라우저에서 승인하고 끝납니다. 대화에서 도구를 켜면 사용할 수 있습니다. ChatGPT는 원격 연결이라 로컬 폴더 배포는 지원하지 않습니다 — GitHub 저장소 배포와 운영(로그·재시작·백업·환경변수)에 사용하세요.

키 기반 연결이 필요한 환경(폐쇄망·키 관리 정책 등)에서는 아래 방식을 사용하세요. 대시보드 환경 변수 및 키 ➔ API 인증 키에서 토큰(dc_live_...)을 발급합니다. 평문 키는 발급 직후 한 번만 표시되며, 발급 직후 뜨는 MCP 연결 카드에서 설정이 자동으로 채워집니다.

npx stdio (설치형) — macOS/Linux는 ~/.cursor/mcp.json, Windows는 %USERPROFILE%\.cursor\mcp.json:

{
  "mcpServers": {
    "dashcloud": {
      "command": "npx",
      "args": ["-y", "@dashcloud/mcp"],
      "env": {
        "DASHCLOUD_API_KEY": "dc_live_여기에_토큰_입력",
        "DASHCLOUD_API_URL": "https://api.dashcloud.kr"
      }
    }
  }
}

Claude Desktop은 같은 블록을 claude_desktop_config.json에 넣으면 됩니다.

원격 HTTP + 키 헤더:

{
  "url": "https://mcp.dashcloud.kr/mcp",
  "headers": { "x-api-key": "dc_live_여기에_토큰_입력" }
}

1. 에디터를 완전히 종료한 뒤 다시 실행합니다.
2. 채팅에서 아래와 같이 질문합니다:

   > DashCloud 도구가 정상 연결되었는지 확인하고 내 프로젝트 목록 보여줘.

3. AI 모델이 list_projects 도구를 호출해 프로젝트 목록을 보고하면 연동 완료입니다. (Claude Code·Codex는 /mcp로 연결 상태를 확인할 수 있습니다)