연결하기

Cursor·Claude Desktop 등에 @qnector/mcp-server를 등록하고 OAuth Device Flow로 큐넥터에 연결합니다.

클라이언트 연결

원격 AI(ChatGPT·Claude·Cursor)는 https://qnector.kr/mcp + OAuth PKCE를 사용합니다. 로컬 stdio는 @qnector/mcp-server + Device Flow입니다.

서버 엔드포인트 (Hosted MCP)

https://qnector.kr/mcp

ChatGPT·Claude·Cursor 원격 연결은 위 URL을 사용합니다. OAuth(Authorization Code + PKCE, Dynamic Client Registration)를 지원합니다. 로컬 stdio는 @qnector/mcp-server + Device Flow입니다.

1. 클라이언트 선택

2. 설정 추가 · 연결

ChatGPT 커넥터 추가 열기

설정 › 커넥터(또는 고급 › 앱 만들기)를 엽니다(위 버튼).
원격 MCP 서버 URL에 https://qnector.kr/mcp 를 입력합니다.
OAuth 승인(Authorization Code + PKCE)으로 큐넥터 로그인·스코프를 허용합니다.

ChatGPT는 원격 MCP + OAuth만 지원합니다. 유료 플랜(api_access) 판매자 계정이 필요합니다.

3. OAuth 승인

브라우저에서 큐넥터에 로그인한 뒤 판매자·스코프를 허용합니다. 원격 클라이언트는 앱이 토큰을 보관하고, stdio는 ~/.qnector/credentials.json에 저장합니다. 도구 목록은 MCP 도구 목록에서 확인하세요.

엔드포인트·패키지

구분설명

Hosted MCP

https://qnector.kr/mcp

OAuth 메타데이터

/.well-known/oauth-authorization-server , oauth-protected-resource

패키지 (stdio)

npx -y @qnector/mcp-server

client_id (stdio)

qnector-mcp-cli (Device Flow)

자격 증명 경로 (stdio)

~/.qnector/credentials.json (Windows: %USERPROFILE%\.qnector\)

참고

Supabase JWT·세션 쿠키를 mcp.json env에 직접 넣는 방식은 지원하지 않습니다.
CI·헤드리스만 QNECTOR_API_KEY(v18 키)로 OAuth를 건너뛸 수 있습니다. 일반 사용자는 OAuth만 사용하세요.
연결 기기 목록·해제는 대시보드 API 연동 > MCP 연결에서 관리합니다(제공 시).