concierge-mcp

Concierge를 위한 로컬 MCP 서버 — Discord 기반 고객 지원 플랫폼입니다.

AI 에이전트(Claude Desktop, Cursor, Cline 또는 기타 MCP 호환 클라이언트)를 Concierge 지원 서버에 연결하여 자연어로 전체 지원 스택을 운영하세요. 200개 이상의 도구가 티켓 수명 주기, AI 구성, 지식 베이스, 패널, 자동화, 분석, 결제, Discord 통신 등을 지원합니다.

주요 기능

"내 SaaS를 위해 Concierge를 설정해 줘. #support 채널에 패널을 배포하고, @Mod와 @Admin에게 에이전트 권한을 부여하며, 우선순위가 높은 티켓에 대한 SLA를 30분으로 설정해 줘."

"지난 30일간의 CSAT 보고서를 보여주고, 티켓 #142에 대한 답변을 제안해 줘."

"에이전트 응답이 없는 7일 이상 된 모든 티켓을 일괄 종료하고, 고객에게 DM으로 대화 내용을 전송해 줘."

"티켓 #88을 내일 오전 9시(ET)까지 알림을 끄고, 해당 고객을 VIP로 표시해 줘."

설치

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows)에 추가하세요:

{
  "mcpServers": {
    "concierge": {
      "command": "npx",
      "args": ["-y", "concierge-mcp"],
      "env": {
        "CONCIERGE_GUILD_ID": "YOUR_DISCORD_GUILD_ID",
        "CONCIERGE_MCP_KEY": "YOUR_MCP_API_KEY"
      }
    }
  }
}

Claude Desktop을 재시작하세요. MCP 서버 목록에 "concierge"가 표시되며 200개 이상의 모든 도구를 사용할 수 있습니다.

Cursor

~/.cursor/mcp.json에 추가하세요:

{
  "mcpServers": {
    "concierge": {
      "command": "npx",
      "args": ["-y", "concierge-mcp"],
      "env": {
        "CONCIERGE_GUILD_ID": "YOUR_DISCORD_GUILD_ID",
        "CONCIERGE_MCP_KEY": "YOUR_MCP_API_KEY"
      }
    }
  }
}

Cline / 기타 MCP 클라이언트

동일한 command/args/env 형식을 사용하세요. 모든 MCP 클라이언트는 stdio 서버를 지원합니다.

자격 증명 얻기

1. conciergetickets.net/dashboard에서 Concierge 대시보드를 엽니다.

2. 아무 패널이나 열고 → Advanced → MCP Settings로 이동합니다.

3. MCP Enabled를 ON으로 전환하면 API 키가 생성됩니다.

4. API 키를 복사합니다(CONCIERGE_MCP_KEY로 설정).

5. Guild ID는 Discord 서버 ID입니다. URL에서 찾거나 우클릭 → 서버 ID 복사(개발자 모드 필요)를 통해 확인할 수 있습니다.

작동 방식

이 패키지는 경량 stdio 프록시입니다. MCP 클라이언트가 이를 실행하면 다음과 같이 작동합니다:

1. https://api.conciergetickets.net/api/v1/guilds/{GUILD_ID}/mcp에 있는 Concierge MCP 서버에 연결합니다.

2. API 키로 인증합니다.

3. 실시간 도구 카탈로그를 가져옵니다(Concierge에서 새로 출시된 도구는 재설치 없이 자동으로 나타납니다).

4. 모든 도구 호출을 원격 서버로 전달합니다.

로컬 바이너리는 작고 상태를 저장하지 않습니다. 길드 데이터는 Concierge 인프라에 유지됩니다.

도구 카테고리

• 티켓 — 전체 수명 주기(접수, 알림 끄기, 재개, 완료, 전송, 잠금, 병합, 분할 등) 및 일괄 작업

• AI — 티켓 요약, 감정 분석, 답변 제안, 응답 재생성, 번역

• 지식 베이스 — 전체 CRUD + 검색 + GitBook 가져오기

• 고객 — 프로필, 메모, VIP 토글, 만료일 설정이 가능한 블랙리스트

• 패널 — 전체 임베드 사용자 정의를 통한 생성/배포/재배포

• 구성 — update_panel_config / update_guild_config를 통한 TicketPanel 및 Guild의 모든 설정

• Discord — 메시지 전송, DM, 반응, 공지사항 게시, 채널/역할/멤버 조회

• 웹훅 — 전체 CRUD + 테스트, 재전송, 통계

• 분석 — 개요, 피크 시간대, 에이전트 리더보드, CSV 내보내기

• CRM — 테스트, 동기화, Salesforce/HubSpot/Zendesk/Freshdesk에서 가져오기

• Cron 트리거 — SLA 스캔, 자동 종료, 에스컬레이션 확인을 요청 시 실행

• 팀 — 초대, 제거, 업무량/일정/상태/기술 설정

npx -y concierge-mcp를 실행하고 tools/list를 호출하여 전체 실시간 카탈로그를 확인하세요.

검색 엔드포인트 (비 MCP 통합용)

• GET https://api.conciergetickets.net/api/v1/public/openapi.json — REST API를 위한 전체 OpenAPI 3.1 사양

• GET https://api.conciergetickets.net/api/v1/public/schema.json — 파싱된 Prisma 스키마(모든 모델, 필드, enum)

링크

• Concierge: https://conciergetickets.net

• 문서: https://conciergetickets.net/docs

• Model Context Protocol: https://modelcontextprotocol.io

라이선스

MIT