Claude Code (CLI) 설정

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

1. Claude Code 설치

먼저 Claude Code가 설치되어 있어야 합니다.

bash

npm install -g @anthropic-ai/claude-code

2. MCP 서버 추가

터미널에서 다음 명령어로 Connect Base MCP 서버를 추가합니다:

bash

# 전역 추가 (모든 프로젝트에서 사용) - 기본값
claude mcp add --transport http connect-base https://mcp.connectbase.world/mcp \
  --header "Authorization: Bearer YOUR_SECRET_KEY"

# 현재 프로젝트에만 추가
claude mcp add -s project --transport http connect-base https://mcp.connectbase.world/mcp \
  --header "Authorization: Bearer YOUR_SECRET_KEY"

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

Scope 옵션:

옵션	설명
`-s user`	전역 추가 (기본값) - 모든 프로젝트에서 사용
`-s project`	현재 프로젝트에만 추가

3. 추가된 서버 확인

bash

claude mcp list

4. 서버 제거 (필요 시)

bash

claude mcp remove connect-base

5. 연결 확인

Claude Code를 시작하고 다음과 같이 물어보세요:

"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 Code 재시작: claude 명령어로 다시 실행

서버 다시 추가하기

설정이 꼬인 경우 제거 후 다시 추가:

bash

claude mcp remove connect-base
claude mcp add --transport http connect-base https://mcp.connectbase.world/mcp \
  --header "Authorization: Bearer YOUR_SECRET_KEY"

Claude Desktop 설정

Cursor 설정