npm package: @nseed/capman-feed-mcp
Description: MCP server for Capman Feed API - enables Claude Code and GitHub Copilot to access feedback data
Author: nseed
Latest version: 1.0.2

# @nseed/capman-feed-mcp

[![npm version](https://badge.fury.io/js/@nseed%2Fcapman-feed-mcp.svg)](https://www.npmjs.com/package/@nseed/capman-feed-mcp)

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

## 빠른 시작

### Claude Code

```bash
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` 파일 생성:

```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](https://capman.kr) 로그인
2. 팀 설정 → 피드백 프로젝트 선택
3. API Key 복사 (`cf_` 로 시작)

자세한 내용: [API 문서](https://capman.kr/developers)

## 환경 변수

| 변수 | 필수 | 설명 |
|------|------|------|
| `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` 또는 프로젝트 설정에 추가:

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

### Windows

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

## 개발

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

## 관련 링크

- [Capman](https://capman.kr) - 매뉴얼 & 피드백 관리 서비스
- [API 문서](https://capman.kr/developers) - REST API 문서 및 Sandbox
- [MCP 공식 문서](https://modelcontextprotocol.io) - Model Context Protocol

## 라이센스

MIT