Claude Desktop 설정

Claude Desktop에서 Connect Base MCP를 사용하는 방법입니다.

1. 설정 파일 위치

macOS

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

Windows

%APPDATA%\Claude\claude_desktop_config.json

2. 설정 추가

설정 파일을 열고 다음 내용을 추가합니다:

json

{
  "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를 User Secret Key(cb_sk_*)로 교체하세요. 콘솔의 프로필 > 시크릿 키 탭에서 발급받을 수 있습니다. MCP 서버는 유저 레벨 권한(소유한 모든 앱)으로 동작하므로 앱 스코프인 Public Key(cb_pk_*)는 거부됩니다 (401 PUBLIC_KEY_NOT_ALLOWED).

3. Claude Desktop 재시작

설정 저장 후 Claude Desktop을 완전히 종료했다가 다시 시작합니다.

4. 연결 확인

Claude에게 다음과 같이 물어보세요:

"Connect Base에 연결되어 있나요? 데이터베이스 목록을 보여주세요."

사용 예시

데이터 조회

"users 테이블에서 오늘 가입한 사용자를 조회해줘"

테이블 생성

"products 테이블을 만들어줘. name, price, stock 필드가 필요해"

함수 생성

"Node.js로 이메일 발송 함수를 만들어줘"

웹사이트 배포

"이 HTML을 웹사이트로 배포해줘"

문제 해결

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

User Secret Key(cb_sk_*) 를 사용하고 있는지 확인 (Public Key cb_pk_* 는 401 PUBLIC_KEY_NOT_ALLOWED 로 거부됩니다)
인터넷 연결 확인
Claude Desktop 재시작

"권한이 없습니다"

키가 User Secret Key(cb_sk_*) 인지 확인 (앱 스코프 Public Key 는 사용 불가)
콘솔 프로필 > 시크릿 키 탭에서 새 Secret Key 발급 후 재설정

MCP 개요

Claude Code (CLI) 설정