연동 가이드

외부 서비스를 WithMe와 연결하는 상세 가이드입니다.

GitHub

Standard+

GitHub 리포지토리와 연결하여 커밋, PR을 티켓에 자동으로 연결합니다.

GitHub App 생성

GitHub 설정(Settings > Developer settings > GitHub Apps)에서 새 App을 생성합니다.

권한 설정

Repository contents(Read), Pull requests(Read & Write), Issues(Read) 권한을 부여합니다.

Webhook URL 입력

GitHub App 설정에서 Webhook URL에 WithMe의 /api/github/webhook 주소를 입력합니다.

App 정보 입력

워크스페이스 설정 > GitHub에서 App Slug, App ID, Private Key를 입력하고 저장합니다.

리포지토리 연결

GitHub App을 설치하고 연결할 리포지토리를 선택합니다.

연동 팁

커밋 메시지에 WM-123 패턴을 포함하면 해당 티켓에 자동 연결됩니다.
PR 제목에 WM-123을 포함하면 PR이 티켓에 표시됩니다.
PR이 머지되면 연결된 티켓의 상태가 자동으로 완료로 변경됩니다.

Slack

Standard+

Slack과 연결하여 워크스페이스 이벤트 알림을 실시간으로 받습니다.

Slack App 생성

Slack API(api.slack.com/apps)에서 새 앱을 만들거나 Incoming Webhook을 활성화합니다.

Webhook URL 복사

Slack App의 Incoming Webhooks에서 Webhook URL을 복사합니다.

WithMe에 등록

워크스페이스 설정 > Slack에서 Webhook URL을 입력하고 채널 이름을 설정합니다.

알림 이벤트 설정

알림을 받을 이벤트 유형을 선택합니다.

지원하는 알림 이벤트

새 티켓 생성
티켓 상태 변경
스프린트 상태 변경
릴리즈 배포

Jira

Standard+

Jira에서 데이터를 가져와 WithMe로 마이그레이션합니다.

Jira 인증 정보 준비

Jira Cloud의 도메인, 이메일, API 토큰을 준비합니다. API 토큰은 Atlassian 계정 설정에서 생성합니다.

Jira 연결

워크스페이스 설정 > Jira에서 도메인과 인증 정보를 입력하고 연결합니다.

프로젝트 선택

가져올 Jira 프로젝트를 선택합니다.

사용자 매핑

Jira 사용자를 WithMe 멤버에 매핑합니다.

데이터 임포트

임포트를 시작합니다. 이슈, 상태, 우선순위, 라벨 등이 자동으로 변환됩니다.

Google Calendar

Google Calendar와 양방향 동기화로 일정을 통합 관리합니다.

Google 계정 연결

캘린더 페이지에서 Google Calendar 연결 버튼을 클릭하고 Google 계정으로 로그인합니다.

캘린더 선택

동기화할 Google Calendar를 선택합니다.

양방향 동기화

WithMe의 티켓 일정과 Google Calendar 이벤트가 양방향으로 동기화됩니다.

Figma

Standard+

Figma 디자인 파일을 티켓에 연결하여 개발과 디자인을 연동합니다.

Personal Access Token 생성

Figma > Settings > Personal Access Tokens에서 새 토큰을 생성합니다.

WithMe에 등록

워크스페이스 설정 > Figma에서 Access Token을 입력하고, 필요 시 팀 ID와 팀 이름을 설정합니다.

디자인 파일 연동

연결 완료 후 티켓에 Figma 파일 링크를 첨부하면 디자인 미리보기가 자동으로 표시됩니다.

연동 팁

팀 ID는 Figma 팀 페이지 URL에서 확인할 수 있습니다.
Personal Access Token은 안전하게 암호화되어 저장됩니다.

Bitbucket

Standard+

Bitbucket 리포지토리를 연결하여 커밋, PR을 티켓에 연동합니다.

App Password 생성

Bitbucket > Personal Settings > App passwords에서 새 앱 비밀번호를 생성합니다. 리포지토리 읽기 권한이 필요합니다.

WithMe에 등록

워크스페이스 설정 > Bitbucket에서 워크스페이스 슬러그, 사용자 이름, 앱 비밀번호를 입력합니다.

Webhook 설정

Bitbucket 리포지토리 설정 > Webhooks에서 WithMe Webhook URL을 등록합니다. Push와 Pull Request 이벤트를 선택하세요.

티켓 자동 연결

커밋 메시지나 PR 제목에 티켓 번호(예: WM-42)를 포함하면 해당 티켓에 자동으로 연결됩니다.

연동 팁

커밋 메시지에 WM-123 패턴을 포함하면 해당 티켓에 자동 연결됩니다.
PR 제목에 WM-123을 포함하면 PR이 티켓에 표시됩니다.
PR이 머지되면 연결된 티켓의 상태가 자동으로 완료로 변경됩니다.

MCP (Model Context Protocol)

MCP를 통해 Cursor, Claude Code 등 AI 코딩 도구에서 WithMe 워크스페이스를 직접 관리합니다.

API 키 생성

프로필 > API 키에서 새 API 키를 생성합니다. 연동할 워크스페이스를 선택하세요.

MCP 설정 파일 추가

사용하는 AI 도구에 맞는 설정 파일에 아래 내용을 추가합니다.

Cursor - .cursor/mcp.json

{
  "mcpServers": {
    "withme": {
      "command": "npx",
      "args": ["-y", "@withme/mcp-server"],
      "env": {
        "WITHME_API_KEY": "YOUR_API_KEY",
        "WITHME_URL": "https://app.withme.com"
      }
    }
  }
}

Claude Code - .mcp.json

{
  "mcpServers": {
    "withme": {
      "command": "npx",
      "args": ["-y", "@withme/mcp-server"],
      "env": {
        "WITHME_API_KEY": "YOUR_API_KEY",
        "WITHME_URL": "https://app.withme.com"
      }
    }
  }
}

도구에서 확인

AI 도구를 재시작하면 WithMe MCP 서버가 연결됩니다.

MCP로 할 수 있는 것

티켓 조회, 생성, 수정 (제목, 설명, 우선순위, 타입, 담당자)
티켓 상태 변경 (워크플로우 상태 전환)
티켓에 댓글 추가 (작업 내역, 메모)
스프린트 및 릴리즈 조회
문서 조회, 생성, 수정
통합 검색 (티켓, 문서, 스프린트, 멤버)
OKR 목표 관리
워크스페이스 멤버 조회

하네스 기반 협업 (Claude Code)

Claude Code

하네스 초기화 한 번으로 Claude Code에서 자동화된 협업 워크플로우를 사용할 수 있습니다.

하네스 설정 생성

프로필 > API & MCP에서 API 키를 생성한 후 '하네스 설정 파일 생성' 버튼을 클릭하거나, API를 호출하세요.

API

GET /api/v1/harness
Authorization: Bearer <your-api-key>

생성된 설정 파일(.claude/settings.json, CLAUDE.md, skills)을 프로젝트 루트에 복사합니다.

하네스가 제공하는 기능

코드 작업 시 티켓 상태 자동 동기화
커밋 시 관련 티켓에 자동 코멘트
스프린트 계획 워크플로우 (백로그 정리, 포인트 배분)
코드 리뷰 시 티켓 연결 자동 확인