개요

CollabOps MCP 서버를 연결하면 Claude, Cursor 같은 AI 클라이언트가 CollabOps의 이슈·변경요청(CR)·저장소·문서·스프린트를 직접 읽고 다룰 수 있습니다. IDE나 대화창을 벗어나지 않고 "내 이슈 정리해줘", "이 CR 리뷰 포인트 짚어줘" 같은 요청을 그대로 처리합니다.

시작하기 전에

두 가지만 준비하면 됩니다:

로그인 가능한 CollabOps 계정 — 연결 시 이 계정으로 인증합니다.

Node.js (LTS) — mcp-remote 브리지로 연결하는 클라이언트(Claude Desktop·Windsurf·Zed 등)에만 필요합니다. 원격 MCP를 네이티브로 지원하는 클라이언트(Claude Code·Cursor·VS Code)는 불필요.

서버 주소

모든 클라이언트가 아래 단일 주소를 사용합니다. 이 값만 등록하면 됩니다.

https://mcp.collabops.ai/mcp

클라이언트별 설정

Claude Code

터미널에서 서버를 추가합니다.

claude mcp add --transport http collabops https://mcp.collabops.ai/mcp

Claude Code 안에서 /mcp 를 실행하면 등록된 MCP 서버 목록이 뜹니다. 방금 추가한 collabops 서버는 아직 인증 전이라 상태가 needs authentication 으로 표시됩니다.

Collabops MCP Server

Status:            △ needs authentication
Auth:              ✗ not authenticated
URL:               https://mcp.collabops.ai/mcp
Config location:   ~/.claude.json

❯ 1. Authenticate
  2. Disable

목록에서 collabops 를 선택한 뒤 1. Authenticate 를 고릅니다. 기본 브라우저가 열리며 CollabOps 로그인·동의 화면으로 이동합니다.

로그인·승인 후 브라우저 창을 닫으면 Claude Code로 돌아옵니다. /mcp 를 다시 열어 상태가 connected (연결됨)으로 바뀌었으면 완료입니다.

Claude Desktop

설정 파일 claude_desktop_config.json (Settings → Developer → Edit Config) 에 아래를 추가한 뒤 앱을 재시작합니다. 첫 사용 시 인증 창이 뜹니다.

{
  "mcpServers": {
    "collabops": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.collabops.ai/mcp"]
    }
  }
}

Cursor

Settings → MCP → Add new global MCP server 를 열고 ~/.cursor/mcp.json 에 아래를 추가합니다. 저장하면 인증 창이 뜨고, 연결되면 MCP 설정 화면에 도구 목록이 나타납니다.

{
  "mcpServers": {
    "collabops": {
      "url": "https://mcp.collabops.ai/mcp"
    }
  }
}

VS Code

워크스페이스에 .vscode/mcp.json 을 만들고 아래를 넣습니다. Copilot Chat 의 Agent 모드에서 서버가 뜨면 Start 로 인증합니다.

{
  "servers": {
    "collabops": {
      "type": "http",
      "url": "https://mcp.collabops.ai/mcp"
    }
  }
}

Windsurf · Zed · 기타 (mcp-remote)

원격 MCP를 네이티브로 지원하지 않는 클라이언트는 mcp-remote 브리지로 연결합니다. Windsurf 는 ~/.codeium/windsurf/mcp_config.json 에 아래 형식(mcpServers)을 넣습니다.

{
  "mcpServers": {
    "collabops": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.collabops.ai/mcp"]
    }
  }
}

Zed 는 키 이름이 다릅니다 — settings.json 의 context_servers 아래에 둡니다.

{
  "context_servers": {
    "collabops": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.collabops.ai/mcp"],
      "env": {}
    }
  }
}

Codex CLI

터미널에서 원격 서버를 추가합니다 (원격 MCP는 실험적 기능일 수 있음).

codex mcp add collabops --url https://mcp.collabops.ai/mcp

인증은 어떻게 되나

클라이언트를 처음 연결하면 브라우저가 열리며 표준 OAuth 흐름으로 진행됩니다:

CollabOps 로그인 화면 — 이미 로그인돼 있으면 자동으로 건너뜁니다.

동의 화면 — 어떤 클라이언트가 어떤 권한을 요청하는지 확인하고 승인합니다.

승인하면 클라이언트로 돌아와 연결이 완료됩니다. 이후에는 재로그인 없이 바로 쓸 수 있습니다.

무엇을 할 수 있나

연결하면 AI 클라이언트가 다음 영역의 도구를 사용합니다:

이렇게 물어보세요

"내가 담당한 열린 이슈를 우선순위 순으로 보여줘"

"CR #1234의 변경점을 요약하고 리뷰에서 짚을 포인트를 정리해줘"

"이번 스프린트에 남은 작업과 지연 위험이 있는 이슈를 알려줘"

"이 에러 로그로 버그 이슈 초안을 만들어줘 — 재현 절차 포함"

연결 확인

연결이 잘 됐는지 두 가지로 확인합니다: (1) 클라이언트의 MCP 설정 화면에서 collabops 서버가 "연결됨" 상태이고 도구 목록이 보이는지, (2) "내 정보 보여줘" 라고 물었을 때 본인 계정 정보가 돌아오는지. 두 가지가 되면 정상입니다.

자주 묻는 질문

API 키가 필요한가요?

아니요. 브라우저 OAuth로 CollabOps 계정에 로그인하면 되고, 키를 따로 발급·관리할 필요가 없습니다.

AI가 제 데이터에 얼마나 접근하나요?

로그인한 계정의 권한 범위 안에서만 접근합니다. 계정이 볼 수 없는 워크스페이스·이슈·저장소는 AI도 볼 수 없습니다.

여러 워크스페이스를 쓸 수 있나요?

네. 계정이 속한 워크스페이스를 다룰 수 있고, 도구가 워크스페이스 지정을 지원합니다. 특정 워크스페이스를 원하면 요청에 이름을 함께 적어주세요.

연결을 해제하려면?

클라이언트 설정에서 collabops 서버를 제거하고, 저장된 인증을 지우려면 rm -rf ~/.mcp-auth 를 실행하세요.

문제 해결