본문으로 건너뛰기

Cursor 연결

2026년 9월 29일 공급업체 문서와 대조함, 엔드투엔드 테스트 전

아래 mcp.json 형식은 Cursor의 MCP 문서를 따릅니다. 저희가 Cursor에서 NameBeta 로그인까지 직접 해 보지는 않았습니다. 파일 형식은 안정적이지만 설정 화면은 자주 바뀌므로, 아래 레이블이 화면과 다르면 Cursor Settings의 MCP 섹션을 찾아보세요.

시작하기 전에​

  • Cursor
  • NameBeta 계정. 계정이 없으면 설정 중에 로그인 페이지에서 만들 수 있습니다.
  • 사전 등록된 클라이언트 ID. Cursor는 동적 클라이언트 등록(DCR) 또는 정적 클라이언트 자격 증명으로 MCP 서버에 로그인하는데, NameBeta는 DCR을 제공하지 않습니다. Cursor 문서에는 Client ID Metadata Documents가 언급되어 있지 않으며, 2026년 5월 13일 기능 요청에 Cursor 직원이 지원 일정은 정해지지 않았다고 답했습니다. 사전 등록된 클라이언트 ID에 설명된 방법으로 클라이언트 ID를 요청하세요. 이때 클라이언트 이름으로 Cursor를, 리디렉션 URI로 http://localhost:8787/callback(데스크톱 앱)과 https://www.cursor.com/agents/mcp/oauth/callback(웹 및 Cursor Agents)을 알려 주세요.

서버 추가​

Cursor는 mcp.json에서 MCP 서버를 읽습니다. 모든 프로젝트에서 NameBeta를 쓰려면 홈 디렉터리의 파일을, 저장소를 통해 팀과 공유하려면 프로젝트 안의 파일을 사용합니다.

파일적용 범위
~/.cursor/mcp.json모든 프로젝트
.cursor/mcp.json현재 프로젝트

namebeta 항목을 추가하고 URL을 입력한 다음, auth 블록에 발급받은 클라이언트 ID를 넣습니다.

{
    "mcpServers": {
        "namebeta": {
            "url": "https://namebeta.com/api/mcp",
            "auth": {
                "CLIENT_ID": "<client ID>",
                "scopes": ["profile", "email"]
            }
        }
    }
}

파일에 이미 다른 서버가 있다면 mcpServers 안에 namebeta를 나란히 추가합니다.

  • scopes는 위와 같이 그대로 둡니다. 이 값이 없으면 Cursor는 권한 부여 서버의 메타데이터에서 스코프를 가져오는데, 그 목록에는 NameBeta가 MCP 클라이언트에 부여하지 않는 스코프도 들어 있습니다.
  • CLIENT_SECRET은 추가하지 마세요. 이 클라이언트 ID는 공개 클라이언트용이므로 시크릿이 없습니다.
  • 토큰을 넣은 headers도 추가하지 마세요. Cursor는 OAuth로 자체 토큰을 받으며, 직접 적어 넣은 토큰은 곧 만료됩니다.

로그인​

  1. Cursor Settings를 열고 MCP 섹션(Tools & MCP)으로 이동합니다. namebeta 서버가 인증이 필요한 상태로 표시됩니다.
  2. 서버의 로그인 버튼을 클릭합니다. 브라우저에서 NameBeta 로그인 페이지가 열립니다.
  3. 로그인하고 액세스를 승인한 다음 Cursor로 돌아갑니다. 서버가 연결됨으로 표시되고 도구 다섯 개가 나열되어야 합니다.

사용해 보기​

Agent 채팅에서 다음과 같이 질문합니다.

github.com의 MX 레코드를 조회해 주세요.

Cursor가 lookup_dns를 실행하고 github-com.mail.protection.outlook.com이라고 답해야 합니다. dig MX github.com으로 조회해도 같은 레코드가 나옵니다.

연결 해제 및 계정 전환​

  • NameBeta 사용을 중단하려면 mcp.json에서 namebeta 항목을 삭제합니다.
  • 다른 NameBeta 계정을 사용하려면 계정 전환을 참조하세요.

연결되지 않을 때​

로그인이 끝나지 않으면 문제 해결을 참조하세요.

최종 수정: 에