Claude Code 연결
2026년 9월 28일 테스트 완료
Claude Code 2.1.283에서 엔드투엔드 테스트를 마쳤습니다. OAuth로 서버에 연결되었고 다섯 가지 도구 모두 결과를 반환했습니다.
시작하기 전에
- Claude Code
- NameBeta 계정. 계정이 없으면 설정 중에 로그인 페이지에서 만들 수 있습니다.
서버 추가
claude mcp add --transport http namebeta https://namebeta.com/api/mcp
namebeta는 Claude Code에서 서버를 표시할 때 쓰는 로컬 이름이며, 원하는 이름으로 정해도 됩니다. 기본적으로 서버는 사용자 컴퓨터의 현재 프로젝트에만 추가됩니다. 적용 범위를 바꾸려면 --scope를 사용합니다.
| 적용 범위 | 저장 위치 | 사용 가능한 사람 |
|---|---|---|
local(기본값) | 사용자 설정(현재 프로젝트 단위) | 본인, 이 프로젝트에서만 |
user | 사용자 설정 | 본인, 모든 프로젝트에서 |
project | 프로젝트 루트의 .mcp.json(커밋하는 것을 전제로 함) | 프로젝트를 여는 모든 사람 |
예를 들어 모든 프로젝트에서 NameBeta를 사용하려면 다음과 같이 합니다.
claude mcp add --transport http --scope user namebeta https://namebeta.com/api/mcp
구성에는 URL만 저장됩니다. 토큰은 Claude Code가 컴퓨터마다 따로 보관하므로, 커밋한 .mcp.json에 자격 증명이 들어갈 일은 없습니다. 팀원은 각자 자신의 NameBeta 계정으로 로그인합니다.
로그인
- Claude Code를 시작하고
/mcp를 실행합니다. namebeta를 선택하고 Authenticate를 고릅니다. 브라우저에서 NameBeta 로그인 페이지가 열립니다.- 로그인하고 액세스를 승인합니다. 터미널로 돌아가도 된다는 안내가 브라우저에 표시됩니다.
이제 claude mcp list를 실행하면 서버가 연결된 것으로 표시됩니다.
namebeta: https://namebeta.com/api/mcp (HTTP) - ✔ Connected
사용해 보기
> brewlab으로 아직 등록할 수 있는 TLD는 어떤 것이 있나요? 이미 등록된 것 중에서 판매 중인 것은요?
Claude Code가 check_availability를 실행합니다. 답변에는 등록됨, 판매 중, 등록 가능 상태의 도메인이 섞여 있어야 합니다. 2026년 9월 29일 기준으로 brewlab.com은 등록됨, brewlab.co는 판매 중, brewlab.info는 등록 가능이었습니다. 이처럼 결과가 섞여 나온다면 실시간 조회가 이루어졌다는 뜻입니다. 전체 결과는 도구 예시에서 볼 수 있습니다.
연결 해제 및 계정 전환
claude mcp remove namebeta로 서버를 제거합니다. 해당 적용 범위로 추가했다면-s user또는-s project를 덧붙입니다.- 서버는 그대로 두고 로그아웃만 하려면
/mcp를 열고namebeta를 선택한 다음 인증 정보를 지웁니다. 그 후 다른 NameBeta 계정으로 로그인하려면 계정 전환을 참조하세요.
연결되지 않을 때
인증에 실패하면 문제 해결을 참조하세요.