Quality QR MCP 서버

Claude, Cursor 및 모든 MCP 호환 도구와 같은 AI 어시스턴트를 통해 추적 가능한 QR 코드를 생성하고 관리하세요.

일반적인 QR 코드 생성기와 달리, Quality QR 코드는 사용자 계정에 저장되며 스캔 추적, 분석 기능을 제공하고 인쇄물을 다시 만들지 않고도 목적지를 업데이트할 수 있습니다.

엔드포인트: https://quality-qr.app/api/mcp

설정

1. API 키 발급

quality-qr.app에 가입하고 대시보드 > 설정 > API 키에서 API 키를 생성하세요.

2. MCP 클라이언트 구성

Smithery 사용자: Smithery를 통해 설치하는 경우 apiKey를 직접 입력하라는 메시지가 표시됩니다. Smithery가 Authorization 헤더를 자동으로 처리합니다. 아래 설정은 수동 설치를 위한 것입니다.

Claude Desktop

Claude Desktop 설정(~/Library/Application Support/Claude/claude_desktop_config.json, Mac 기준)에 추가하세요:

{
  "mcpServers": {
    "quality-qr": {
      "url": "https://quality-qr.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

Cursor MCP 설정에 추가하세요:

{
  "mcpServers": {
    "quality-qr": {
      "url": "https://quality-qr.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add quality-qr --transport http https://quality-qr.app/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

3. 사용 시작하기

AI 어시스턴트에게 다음과 같이 요청하세요:

• "Create a QR code for https://example.com"

• "Make a WiFi QR code for network MyWiFi with password guest123"

• "Show me the analytics for my QR codes"

• "List all my QR codes"

• "Disable QR code abc123"

사용 가능한 도구

QR 코드 유형

동적 (인쇄 후 URL 변경 가능): URL, PDF, 메뉴, 앱 스토어, 소셜

정적 (데이터가 직접 인코딩됨): WiFi, vCard, 이메일, 전화, SMS, 텍스트, 이벤트

사용량 제한

MCP 도구 호출은 API 사용량 제한에 포함됩니다. 프로토콜 메시지(initialize, tools/list)는 무료입니다.

사용량 제한 응답 헤더

모든 응답에는 사용량 관리를 돕기 위한 헤더가 포함되어 있습니다:

429 Too Many Requests 응답을 받으면 Retry-After에 지정된 시간(초)만큼 기다린 후 재시도하세요.

보안

• 모든 요청은 API 키(Bearer 토큰)를 통해 인증됨

• 키는 대시보드에서 즉시 취소 가능

• QR 코드는 사용자 계정으로 범위가 제한됨 (사용자 간 접근 불가)

• 관리, 결제 또는 팀 관리 작업은 노출되지 않음

• GDPR 및 CCPA 준수, Cloudflare의 글로벌 엣지 네트워크에서 호스팅

API 키 관리

API 키는 QR 코드 및 분석 데이터에 대한 전체 접근 권한을 부여합니다. 비밀번호처럼 취급하세요.

• 정기적으로 교체하세요. 대시보드 > 설정 > API 키에서 새 키를 생성하고 MCP 클라이언트 설정을 업데이트한 후 이전 키를 취소하세요. 무중단 교체를 위해 여러 개의 활성 키를 가질 수 있습니다.

• 유출된 키는 즉시 취소하세요. 취소는 즉시 적용되며, 이전 키를 사용하는 진행 중인 요청은 실패합니다.

• 설정 파일에 대한 접근을 제한하세요. MCP 클라이언트 설정은 키를 일반 텍스트로 저장합니다. macOS/Linux에서는 사용자만 읽을 수 있도록 설정하세요(예: chmod 600). 실제 키가 포함된 설정 파일을 버전 관리 시스템에 커밋하지 마세요.

링크

• Quality QR

• 에이전트 온보딩 (SKILL.md) — AI 에이전트가 Quality QR을 자율적으로 사용하기 위한 단계별 지침 (소스)

• MCP 문서

• API 문서

• 가격 정책

프로토콜

이 서버는 Streamable HTTP 전송(HTTP POST를 통한 JSON-RPC 2.0)을 사용하는 원격 MCP 서버입니다. 로컬 설치가 필요하지 않습니다. MCP 프로토콜 버전 2025-03-26과 호환됩니다.