@nseed/capman-feed-mcp

Claude Code 및 GitHub Copilot에서 Capman Feed API를 통해 피드백을 조회/관리할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다.

빠른 시작

Claude Code

claude mcp add capman-feed npx @nseed/capman-feed-mcp -e CAPMAN_API_KEY=cf_your_api_key

VS Code + GitHub Copilot

.vscode/mcp.json 파일 생성:

{
  "servers": {
    "capman-feed": {
      "command": "npx",
      "args": ["-y", "@nseed/capman-feed-mcp"],
      "env": {
        "CAPMAN_API_KEY": "cf_your_api_key"
      }
    }
  }
}

VS Code 1.102 이상 + Copilot 필요

API 키 발급

1. capman.kr 로그인
2. 팀 설정 → 피드백 프로젝트 선택
3. API Key 복사 (cf_ 로 시작)

자세한 내용: API 문서

환경 변수

| 변수 | 필수 | 설명 | |------|------|------| | CAPMAN_API_KEY | ✅ | Capman Feed API 키 | | CAPMAN_BASE_URL | ❌ | API URL (기본: https://capman.kr/api/v1/feedback) |

사용 가능한 도구

get_feedbacks

피드백 목록을 조회합니다.

| 파라미터 | 설명 | |----------|------| | status | open, in_progress, resolved, closed | | type | bug, feature, improvement, question | | priority | low, medium, high, critical | | search | 검색어 | | limit | 조회 개수 (기본 10) |

get_feedback_detail

피드백 상세 정보를 조회합니다. 콘솔 로그, 네트워크 에러, 환경 정보 포함.

| 파라미터 | 설명 | |----------|------| | id | 피드백 ID (필수) |

update_feedback

피드백의 상태, 우선순위, 유형을 변경합니다.

| 파라미터 | 설명 | |----------|------| | id | 피드백 ID (필수) | | status | 상태 (open, in_progress, resolved, closed) | | priority | 우선순위 (low, medium, high, critical) | | type | 유형 (bug, feature, improvement, question) |

add_comment

피드백에 댓글을 추가합니다.

| 파라미터 | 설명 | |----------|------| | id | 피드백 ID (필수) | | content | 댓글 내용 (필수) |

get_stats

피드백 통계를 조회합니다.

analyze_feedback

피드백의 콘솔 로그와 네트워크 에러를 분석하여 문제 원인을 파악합니다.

| 파라미터 | 설명 | |----------|------| | id | 분석할 피드백 ID (필수) |

사용 예시

Claude Code / Copilot Chat

사용자: 미해결 버그 확인해줘

AI: [get_feedbacks 호출]
    3개의 미해결 버그가 있습니다:
    1. [bug] 결제 버튼 클릭 안됨 (high)
    2. [bug] 로그인 후 리다이렉트 오류 (medium)
    3. [bug] 이미지 업로드 실패 (low)

사용자: 첫 번째 버그 분석해줘

AI: [analyze_feedback 호출]
    ## 에러 분석
    TypeError: Cannot read property 'type' of undefined
    → 파일: src/pages/checkout.js:142

    ## 권장 조치
    paymentMethod가 undefined인 경우 처리 필요

사용자: 코드 수정하고 resolved로 변경해줘

AI: [코드 수정 후]
    [update_feedback 호출 - status: resolved]
    [add_comment 호출 - "paymentMethod null 체크 추가"]

사용자: 이 버그 우선순위 critical로 올려줘

AI: [update_feedback 호출 - priority: critical]
    피드백 우선순위가 critical로 변경되었습니다.

수동 설정 (대안)

Claude Code (JSON)

~/.claude.json 또는 프로젝트 설정에 추가:

{
  "mcpServers": {
    "capman-feed": {
      "command": "npx",
      "args": ["-y", "@nseed/capman-feed-mcp"],
      "env": {
        "CAPMAN_API_KEY": "cf_your_api_key"
      }
    }
  }
}

Windows

{
  "servers": {
    "capman-feed": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@nseed/capman-feed-mcp"],
      "env": {
        "CAPMAN_API_KEY": "cf_your_api_key"
      }
    }
  }
}

개발

# 로컬 테스트
CAPMAN_API_KEY=cf_xxx node index.js

관련 링크

• Capman - 매뉴얼 & 피드백 관리 서비스
• API 문서 - REST API 문서 및 Sandbox
• MCP 공식 문서 - Model Context Protocol

라이센스

MIT