MCP 개요
**Model Context Protocol (MCP)**를 사용하면 AI 어시스턴트가 Connect Base와 직접 상호작용할 수 있습니다.
MCP란?
MCP는 AI 모델이 외부 시스템과 안전하게 상호작용할 수 있게 해주는 프로토콜입니다. Connect Base MCP 서버를 설정하면 Claude, Cursor 등의 AI 도구가 데이터베이스 조회, 파일 업로드, 함수 실행 등을 직접 수행할 수 있습니다.
주요 기능
ConnectBase MCP 서버는 약 269개의 도구를 노출합니다. 카테고리별 대표 영역:
🗄️ 데이터 & 스토리지
- JSON DB CRUD / 인덱스 / 관계 / 트리거 / 데이터 라이프사이클
- 파일 / 웹 / 비디오 스토리지 관리, 정적 사이트 배포, page meta(SEO)
⚡ 함수 / 워크플로우 / 큐
- 함수 CRUD · 배포 · 시크릿 · 스케줄 · 로그
- 워크플로우 CRUD · 수동 트리거 · 실행 이력
- 큐 · 백업 / 복원
🔗 실시간 / 웹훅 / Push
- 실시간 카테고리 · 함수/워크플로우 연결 · 연결/통계 조회
- 웹훅 CRUD · 시크릿 재생성 · 로그
- 푸시 알림 / 디바이스 / 캠페인
🔐 인증 / OAuth
- 소셜 로그인 토글 (Google / Naver / Kakao / Apple / GitHub / Discord)
- 앱간 OAuth 연동 6 intent 도구 (
oauth_provision_capability,oauth_list_capabilities,oauth_authorize_consumer,oauth_list_consumer_clients,oauth_revoke_consumer_access,oauth_provider_usage_summary)
🎮 게임 서버 / 비디오
- 게임 룸 / 매치큐 / 리더보드 / 스크립트 primitive
- 비디오 업로드 / 채널 / 댓글 / DM / 분석
📚 KB / SDK / 분석 / 진단
- Knowledge Base (OpenSearch + nori)
- SDK 문서 검색 · 코드 분석 · 사용량 / 분석 / 진단
👥 멤버 / 역할 / 도메인 / 빌링
- 앱 멤버 · 역할 · 도메인 · 빌링 / 플랜
📌 도구 정의의 단일 출처(SoT)는
backend/cmd/core-server/embedded/sections/11-mcp-tools.md와backend/cmd/mcp-server/app/handler/mcp_handler.go의 등록 코드입니다. 새 도구를 추가하면scripts/docs-audit/mcp-tools-gen가 11-mcp-tools.md 의 마커 사이를 재생성합니다.
지원 클라이언트
| 클라이언트 | 상태 | 설정 가이드 |
|---|---|---|
| Claude Desktop | ✅ 지원 | 설정하기 |
| Claude Code (CLI) | ✅ 지원 | 설정하기 |
| Cursor | ✅ 지원 | 설정하기 |
| Windsurf | ✅ 지원 | 설정하기 |
| Cline | ✅ 지원 | 설정하기 |
빠른 시작
- 콘솔의 설정 > MCP 메뉴로 이동
- 사용하는 AI 클라이언트 선택
- 설정 코드 복사
- 클라이언트 설정 파일에 붙여넣기
- 클라이언트 재시작
사용 예시
MCP 설정 후 AI에게 자연어로 요청할 수 있습니다:
"users 테이블에서 최근 가입한 10명을 조회해줘"
"새 함수를 만들어서 이메일 발송 로직을 구현해줘"
"웹사이트를 배포해줘"
"주문 데이터를 분석해서 차트로 보여줘"