Skip to Content

Local MCP Proxy

Local MCP Proxy는 AI Hub 외부의 다양한 애플리케이션에서도 MCP Preset을 안전하게 사용할 수 있도록 해주는 기능입니다. Cursor IDE, Claude Desktop, Windsurf 등의 도구에서 AI Hub의 Preset을 직접 활용하여 더욱 효율적인 작업 환경을 구축할 수 있습니다.


주요 기능

  • 보안성 강화 → 단순한 URL 공유 방식이 아닌 암호화된 인증 시스템을 통해 사용자의 리소스를 안전하게 보호합니다. AWS Signature V4와 유사한 서명 기반 인증으로 무단 접근을 차단합니다.

  • 다양한 도구 지원 → Cursor IDE, Claude Desktop, Windsurf 등 인기 있는 도구에서 바로 사용 가능합니다. 익숙한 도구에서 AI Hub의 Preset을 자연스럽게 활용할 수 있습니다.

  • 간편한 설치 과정원클릭 설치 명령어로 복잡한 설정 없이 빠르게 연동할 수 있습니다. 10분간 유효한 일회용 설치 키로 안전하고 편리한 설정이 가능합니다.


기능 개요

Local MCP Proxy는 다음과 같은 핵심 구성 요소로 동작합니다:

  • Local MCP Proxy: 사용자 로컬 환경에서 실행되어 MCP 호스트 앱과 AI Hub 서버 간의 안전한 통신을 중계합니다.
  • 암호화된 인증: 모든 요청에 대해 시간 기반 서명을 생성하여 보안을 보장합니다.

작동 흐름


설치 방법

1단계: 설치 명령어 발급

  1. QueryPie AI Hub의 MCP Presets 페이지로 이동합니다.
  2. 사용하고자 하는 클라이언트 탭(Cursor, Windsurf, Claude Desktop)을 선택합니다.
  3. 설치 명령어 생성 버튼을 클릭하여 일회용 설치 명령어를 발급받습니다.

2단계: 명령어 실행

터미널에서 발급받은 명령어를 실행합니다:

npx -y @querypie/mcp@latest install "preset-name" "preset-id" --client "cursor" --key "installation-key"

주의사항:

  • 설치 명령어는 10분간만 유효합니다.
  • 명령어는 일회용이므로 재사용할 수 없습니다.

지원 클라이언트

클라이언트설정 파일 경로
Cursor~/.cursor/mcp.json (macOS/Linux)
%UserProfile%\.cursor\mcp.json (Windows)
Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
%AppData%\Roaming\Claude\claude_desktop_config.json (Windows)
Windsurf~/.codeium/windsurf/mcp_config.json (macOS/Linux)
%UserProfile%\.codeium\windsurf\mcp_config.json (Windows)

보안 특징

  • 시간 기반 서명: 모든 요청에 현재 시간 정보를 포함하여 재사용 공격을 방지합니다.
  • 기기별 고유 인증: 각 기기마다 고유한 Device ID를 생성하여 무단 복제를 차단합니다.
  • 자동 키 만료: 설치 키는 10분 후 자동으로 만료되어 보안 위험을 최소화합니다.
  • 암호화된 설정: 모든 설정 정보는 AES-256-CBC로 암호화되어 저장됩니다.

활용 시나리오

업무 도구 통합 환경

Cursor IDE에서 작업하면서 동시에 QueryPie의 데이터베이스 도구, GitHub 연동, Slack 알림 등을 자연스럽게 활용할 수 있습니다.

데이터 분석 작업

Claude Desktop에서 데이터 분석 작업을 진행하면서 QueryPie의 다양한 데이터 소스에 직접 접근하여 실시간 인사이트를 얻을 수 있습니다.

협업 도구 통합

Windsurf에서 업무를 진행하면서 Jira, Confluence, Notion 등의 협업 도구들을 하나의 인터페이스에서 통합 관리할 수 있습니다.


요약

  • 안전한 외부 연동: 강력한 암호화와 인증으로 보안을 보장하면서 서드파티 앱 연동
  • 사용자 친화적: 인기 있는 도구에서 바로 사용 가능한 원활한 통합
  • 간편한 설정: 원클릭 설치로 복잡한 설정 과정 없이 빠른 연동

Local MCP Proxy는 AI Hub의 Preset → 안전한 인증 → 외부 도구의 연결고리를 제공하여 사용자가 어디서든 AI Hub의 Preset을 자유롭게 활용할 수 있게 해줍니다.

Last updated on