MCP로 AI에게 ConnectBase 연결하기

MCP로 AI에게 ConnectBase 연결하기

**MCP(Model Context Protocol)**를 사용하면 Claude, Cursor, Windsurf 같은 AI 코딩 도구가 ConnectBase의 데이터베이스·스토리지·함수를 자연어 명령만으로 직접 조작할 수 있습니다.

이 가이드는 5분 안에 MCP 연결을 완료하고, 실제로 자연어로 첫 명령을 실행하는 것을 목표로 합니다.

MCP가 왜 필요한가?

기존 방식으로 AI에게 "users 테이블에서 오늘 가입한 사람 뽑아줘"라고 하면 AI는 코드만 생성하고, 그 코드를 여러분이 직접 실행해야 했습니다.

MCP를 연결하면 AI가 직접 ConnectBase에 요청을 보내고 결과를 가져옵니다:

• 🗄️ 데이터베이스: 테이블 생성, 데이터 CRUD, 스키마 조회
• 📁 스토리지: 파일 업로드/다운로드, 웹사이트 배포
• ⚡ 함수: 서버리스 함수 생성/배포, 로그 조회
• 🔄 워크플로우: 자동화 플로우 생성 및 실행
• 🔐 인증: OAuth 프로바이더 관리

1. 사전 준비

시작하기 전에 다음이 필요합니다:

1. ConnectBase 계정 + 앱 생성 완료 (콘솔 퀵스타트)
2. Public Key 발급 완료 (Public Key 발급과 관리)
3. 지원 AI 클라이언트 중 하나:
   • Claude Desktop
   • Cursor
   • Windsurf
   • Claude Code (CLI)

2. Claude Desktop에 MCP 등록

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

위 경로의 파일을 열고 아래 설정을 추가합니다. 파일이 없다면 새로 만드세요.

{
  "mcpServers": {
    "connect-base": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.connectbase.world/mcp",
        "--header",
        "Authorization: Bearer YOUR_SECRET_KEY",
        "--transport",
        "http-only"
      ]
    }
  }
}

⚠️ YOUR_SECRET_KEY 부분을 콘솔에서 발급받은 Secret Key (cb_sk_...) 로 교체하세요. MCP는 서버 권한으로 동작하므로 Public Key가 아닌 Secret Key가 필요합니다.

설정을 저장한 뒤 Claude Desktop을 완전히 종료했다가 다시 실행합니다.

3. Cursor에 MCP 등록

Cursor는 ~/.cursor/mcp.json 파일을 사용합니다. Claude Desktop과 동일한 JSON을 붙여넣으면 됩니다.

{
  "mcpServers": {
    "connect-base": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.connectbase.world/mcp",
        "--header",
        "Authorization: Bearer YOUR_SECRET_KEY",
        "--transport",
        "http-only"
      ]
    }
  }
}

저장 후 Cursor를 재시작합니다.

💡 콘솔의 설정 → MCP 메뉴에서 내 AI 클라이언트에 맞춘 설정 코드를 자동 생성해서 복사할 수도 있습니다.

4. 연결 확인

AI에게 자연어로 다음과 같이 물어보세요:

정상 연결되었다면 AI가 MCP를 통해 실제 데이터베이스 목록을 가져와 응답합니다.

5. 자연어로 첫 명령 실행

연결이 확인되면 이제 자연어로 ConnectBase를 조작할 수 있습니다. 몇 가지 예시:

테이블 만들기

products 테이블을 만들어줘. 필요한 컬럼:
- name (string, 필수)
- price (number, 필수)
- stock (number, 기본값 0)
- created_at (timestamp, 자동 생성)

데이터 조회

함수 생성

이메일 발송 서버리스 함수를 만들어줘.
POST 요청으로 { to, subject, body } 를 받으면
SendGrid로 메일을 보내는 함수야.

웹사이트 배포

보안 주의사항

MCP는 매우 강력한 권한을 AI에게 부여합니다. 다음 사항을 꼭 지켜주세요:

1. Secret Key를 공유 공간에 두지 마세요. Git에 절대 커밋 금지.
2. 개발용/프로덕션용 키를 분리하세요. MCP는 개발용 앱에만 연결하는 것을 권장합니다.
3. AI가 제안하는 파괴적 명령 (DROP TABLE, 대량 DELETE 등) 은 반드시 확인 후 실행하세요.
4. 키가 노출되었다면 즉시 콘솔에서 키 재발급을 진행하세요.

문제 해결

"MCP 서버에 연결할 수 없음"

• Public Key가 올바른지 (Secret Key인지) 확인
• 인터넷 연결 상태 확인
• 클라이언트를 완전히 종료 후 재시작

"권한이 없습니다"

• 콘솔에서 Public Key의 권한 범위를 확인
• 새 키를 발급받아 다시 설정

"도구(tool)가 보이지 않음"

• JSON 문법 오류 확인 (쉼표, 따옴표)
• mcp-remote 가 최신 버전인지 확인 (npx -y mcp-remote@latest)

다음 단계

MCP 연결이 끝났다면 이제 실제 앱을 만들어 볼 차례입니다:

• 데이터베이스 CRUD 5분 컷 — 첫 테이블과 데이터 다루기
• 웹 페이지 배포하기 — 완성한 앱을 실제 URL로 배포
• AI 챗봇 만들기 — LLM과 서버리스 함수를 결합