Muumuu Domain

MCP 서버 설정 및 사용 방법

무무도메인의 MCP 서버를 사용하면 Claude나 Claude Code 등 대응 AI 도구에서 도메인 검색·취득이나 DNS 설정 등의 작업을 직접 수행할 수 있습니다.

이런 분께 추천

• Claude Desktop이나 Claude Code 등의 AI 도구를 업무에 활용하고 계신 분
• 도메인 취득이나 DNS 설정을 빠르게 처리하고 싶은 분
• 여러 도메인 관리를 효율화하고 싶은 분
• AI를 활용한 사이트 구축 과정에서 도메인 취득부터 DNS 설정까지 일관되게 처리하고 싶은 분

가능한 작업

사용 예시

• 「example으로 사용 가능한 도메인을 찾아줘」→ 취득 가능한 도메인과 가격을 목록으로 표시
• 「example.jp를 취득해줘」→ 금액 확인 → 구매 (신용카드 등록 완료된 분)
• 「example.jp의 A 레코드를 203.0.113.1로 변경해줘」→ DNS 레코드를 즉시 업데이트
• 「계약 정보를 알려줘」→ 유효기간이나 자동 갱신 상태를 목록으로 표시

조작 가능 범위

■도메인 검색·취득

• 사용 가능 여부 검색·가격 확인 / 구매 견적 / 도메인 취득 (체크아웃 URL 발행)

■도메인 관리

• 보유 도메인 목록 취득 / 도메인 상세 정보 확인 / 계약 목록·상세 확인

■DNS 설정

• 레코드 목록 취득 / 레코드 신규 생성·업데이트·삭제 (A, AAAA, CNAME, MX, TXT 등)

필요 스코프 목록

기능 카테고리	필요 스코프
도메인·계약 정보 열람	domains:read / contracts:read
DNS 레코드 조작 (열람·편집)	dns:read / dns:write
도메인 검색·구매	domains:search / domains:purchase

요금: MCP 서버 이용은 무료입니다. 도메인 취득 시에는 일반 요금이 부과됩니다.

사용 방법

사전 준비

• 무무도메인 계정 (계정이 없으신 분은 여기에서 무료로 생성 가능)
• 대응 AI 도구 (Claude, Claude Code, Cursor, OpenAI Codex CLI, Gemini CLI 등)

설정 절차

■Claude

claude.ai 및 Claude Desktop 앱에서 이용할 수 있습니다.

1. 커스텀 커넥터 추가하기

claude.ai의 「설정」→「커넥터」에서 「커스텀 커넥터 추가」로 다음 URL을 추가합니다.
https://mcp.muumuu-domain.com/mcp

Claude Desktop을 사용 중이신 경우, 「설정」→「커넥터」에서 「커스텀 커넥터 추가」로 동일한 URL을 추가해 주세요.

2. 브라우저에서 로그인하기

브라우저가 자동으로 열립니다. 무무도메인에 로그인하고 액세스를 허용해 주세요. AI 도구에 인증 정보를 직접 입력할 필요는 없습니다. 인가가 완료되면 OAuth 토큰이 사용 중인 PC에 안전하게 저장됩니다.

3. 동작 확인하기

「무무도메인에서 관리 중인 도메인 목록을 보여줘」라고 전송하여 도메인 목록이 표시되면 완료입니다.

참고: Claude MCP 문서

■Claude Code

1. MCP 서버 추가하기

터미널에서 다음 명령어를 실행합니다.

claude mcp add muumuu-domain --transport http https://mcp.muumuu-domain.com/mcp

프로젝트 단위로 설정하는 경우 -s project를 추가합니다.

claude mcp add muumuu-domain --transport http -s project https://mcp.muumuu-domain.com/mcp

2. Claude Code 실행하기

터미널에서 claude 명령어를 실행하여 Claude Code를 실행합니다.

3. MCP 서버 인가하기

실행 후, 다음을 실행하여 muumuu-domain을 Authorize 합니다.

/mcp

4. 브라우저에서 로그인하기

무무도메인의 OAuth 인가 화면이 표시됩니다. 로그인하고 액세스를 허용해 주세요. AI 도구에 인증 정보를 직접 입력할 필요는 없습니다. 인가가 완료되면 OAuth 토큰이 사용 중인 PC에 안전하게 저장됩니다.

5. 동작 확인하기

「무무도메인에서 관리 중인 도메인 목록을 보여줘」라고 전송하여 도메인 목록이 표시되면 완료입니다.

설정 확인·삭제:

claude mcp list
claude mcp remove muumuu-domain

참고: Claude Code MCP 문서

■Gemini CLI

1. 설정 파일에 MCP 서버 추가하기

프로젝트의 .gemini/settings.json (또는 글로벌 설정 ~/.gemini/settings.json)에 다음을 추가합니다.

{ "mcpServers": { "muumuu-domain": { "httpUrl": "https://mcp.muumuu-domain.com/mcp", "timeout": 30000 } } }

2. Gemini CLI 실행하기

터미널에서 gemini 명령어를 실행하여 Gemini CLI를 실행합니다.

3. MCP 서버 인가하기

실행 후, 다음을 실행하여 Authorize 합니다.

/mcp auth muumuu-domain

4. 브라우저에서 로그인하기

5. 동작 확인하기

참고: Gemini CLI MCP 문서

■Cursor

Cursor는 .cursor/mcp.json (프로젝트 단위) 또는 ~/.cursor/mcp.json (글로벌)로 설정합니다.
Cursor의 Settings → Tools & MCP → 「Add a Custom MCP Server」에서도 추가할 수 있습니다.

.cursor/mcp.json 을(를) 생성하고 다음을 추가합니다.

{ "mcpServers": { "muumuu-domain": { "url": "https://mcp.muumuu-domain.com/mcp" } } }

2. 브라우저에서 로그인하기

MCP 서버 연결 시 브라우저가 열립니다. 무무도메인에 로그인하고 액세스를 허용해 주세요.

3. 동작 확인하기

참고: Cursor MCP 문서

■OpenAI Codex CLI

Codex CLI는 ~/.codex/config.toml 로 MCP 서버를 설정합니다.

~/.codex/config.toml 에 다음을 추가합니다.

[mcp_servers.muumuu-domain] url = "https://mcp.muumuu-domain.com/mcp" scopes = ["domains:read", "dns:read", "dns:write", "contracts:read", "domains:search", "domains:purchase"]

특정 도구의 승인 모드를 변경하는 경우:

[mcp_servers.muumuu-domain.tools.domain_purchase]
approval_mode = "approve"

2. MCP 서버에 연결하기

codex mcp login muumuu-domain

3. 브라우저에서 로그인하기

브라우저가 열립니다. 무무도메인에 로그인하고 액세스를 허용해 주세요.

4. 동작 확인하기

주의사항

⚠️ 가장 중요: 도메인 구매·DNS 변경에 관하여

도메인 구매 시에는 반드시 금액을 확인해 주세요. 일단 완료된 구매는 취소할 수 없습니다.
DNS 레코드 변경은 사이트 동작에 영향을 미치므로, 내용을 잘 확인한 후 실행해 주세요.

보안에 관하여

• OAuth 2.0 채택. AI 도구에 비밀번호 입력은 불필요합니다.
• 액세스 토큰은 수명이 짧으며(2시간) 자동 갱신됩니다.
• 인가는 컨트롤 패널에서 언제든지 취소할 수 있습니다.

문제 해결

■설정이 완료되지 않음

• 대응 AI 도구인지, 브라우저의 팝업 차단이 활성화되어 있지 않은지 확인해 주세요.

■오류 발생·응답 없음

• 재연결을 시도하거나, 설정을 한 번 삭제하고 처음부터 다시 진행해 주세요.

■조작 불가/반영되지 않음

• 대상 도메인이 관리 하에 있는지, 인가 시 필요한 권한(스코프)을 모두 허용했는지 확인해 주세요.
• DNS 변경 반영에는 최대 72시간이 소요될 수 있습니다.