신규 · v1.0 · 오픈소스

AI 에이전트를 위한 도메인 CLI와 MCP 서버

dna는 Domain Name API의 공식 명령줄 도구이자 MCP 서버입니다. 준비된 프롬프트를 Claude나 ChatGPT에 붙여 넣으면 어시스턴트가 dna를 설치하고 연결한 뒤 도메인, DNS, SSL, 호스팅 작업을 시작합니다. 비용이 드는 작업은 모두 귀하의 승인을 기다립니다.

Claude Code에서 dna 설정하기

dna CLI(https://github.com/domainreseller/cli)를 설정해 주세요.
1. 제 운영체제에 맞는 공식 설치 스크립트로 설치한 다음 `dna version`과 `dna doctor`를 실행해 주세요.
2. `dna agent skill --install`로 Claude Code 스킬을 설치하고, `claude mcp add dna -- dna mcp serve --env ote`로 MCP 서버를 추가해 주세요.
3. 제 API 키를 이 채팅에 붙여 넣으라고 하지 마세요. `dna auth login --env ote`는 제가 직접 실행하도록 안내하고, 그다음 `dna --ote account get`으로 연결을 확인해 주세요.
OTE 테스트 환경에서만 작업하고, 제 승인 없이는 절대 `--yes`를 쓰지 마세요.

프롬프트를 복사해 AI 어시스턴트에 붙여 넣고 나머지는 맡기세요. 모든 프롬프트는 OTE 테스트 환경에서 시작하며, 과금 작업 전에는 멈추고 귀하의 승인을 기다립니다.

  • 64API 작업
  • 65MCP 도구
  • 4안전 등급
  • 6플랫폼, 하나의 바이너리
  • Apache-2.0오픈소스 라이선스
쉬운 말로

Claude와 ChatGPT에서 바로 쓰는 프롬프트

도메인 이름을 바꿔 어시스턴트에 붙여 넣고, 작업하는 모습을 지켜보세요. 프롬프트마다 어디서 멈출지 적혀 있어서, 귀하의 승인 없이는 아무것도 과금되지 않습니다.

도메인 찾아 등록하기

dna로 brandname.com, brandname.net, brandname.io를 등록할 수 있는지 확인해 주세요. 결과를 가격과 함께 표로 보여 주고, 등록 가능한 것 중 가장 저렴한 도메인의 등록을 `--dry-run`으로 미리 보여 주세요. 제가 좋다고 하기 전에는 아무것도 등록하지 마세요.
domain bulk-search · domain registerbillable

다가오는 갱신

dna로 앞으로 60일 안에 만료되는 제 도메인을 갱신 가격과 함께 만료일 순으로 나열해 주세요. 아무것도 갱신하지 마세요.
domain list · domain renew-checkread

도메인을 서버에 연결하기

dna로 example.com을 203.0.113.10으로 연결해 주세요. `@` 및 `www`용 A 레코드를 추가한 다음 최종 DNS 존을 보여 주세요. 기존 레코드를 변경하거나 삭제하기 전에는 먼저 저에게 물어봐 주세요.
dns add · dns listwrite

도메인 이전해 오기

dna로 example.org 도메인을 제 계정으로 이전할 수 있는지 확인하고, 아직 필요한 것(인증 코드, 잠금 해제)을 알려 주세요. 그리고 `--dry-run`으로 이전을 미리 보여 주세요.
domain transfer-check · domain transferbillable

SSL 인증서 주문하기

dna로 example.com에 쓸 가장 저렴한 DV SSL 인증서를 찾고, CSR을 생성한 다음 주문을 미리 보여 주세요. 구매하기 전에 제 승인을 기다려 주세요.
product ssls · ssl generate-csr · ssl initializebillable

필요한 걸 말하세요. 맞는 명령은 에이전트가 찾습니다.

모든 API 작업은 명확한 설명과 JSON 스키마를 갖춘 도구입니다. 그래서 어시스턴트는 처음부터 올바른 호출을 고르고 값을 정확히 채웁니다. 말씀만 하세요. 정확한 작업은 dna가 처리합니다.

안전장치

귀하의 허락 없이는 에이전트가 단 한 푼도 쓸 수 없습니다

모든 명령에는 안전 등급이 있고, 무슨 일이 일어날지는 그 등급이 정합니다. 조회 작업과 무료이면서 되돌릴 수 있는 변경은 바로 실행됩니다. 잔액이 차감되거나 되돌릴 수 없는 작업은 멈추고 먼저 묻습니다.

  • read

    읽기

    검색, 목록, 도메인 정보, 가격, 확장자 규칙.

    바로 실행
  • write

    쓰기

    DNS 레코드, 이전 잠금, WHOIS 정보 보호, 연락처. 무료이며 되돌릴 수 있습니다.

    바로 실행
  • destructive

    파괴적 작업

    레코드 삭제, SSL 폐기, DNSSEC 비활성화.

    승인을 기다림
  • billable

    과금

    등록, 갱신, 이전, 복원, SSL 및 호스팅 주문.

    승인을 기다림

승인은 이렇게 작동합니다

승인이 필요한 도구에는 confirm 필드가 하나 더 있습니다. 대부분의 MCP 클라이언트도 도구를 호출할 때마다 먼저 묻습니다. 안전 주석은 클라이언트가 위험한 호출을 표시하도록 돕습니다.

  1. 에이전트가 먼저 묻습니다

    confirm 없이 도구를 호출합니다. 아무것도 전송되지 않고, 보낼 요청을 그대로 담은 미리보기가 돌아옵니다.

  2. 귀하가 결정합니다

    에이전트가 도메인, 기간, 작업을 보여 줍니다. 예 또는 아니요로 답하시면 됩니다.

  3. 딱 한 번 실행됩니다

    귀하가 승인한 뒤에야 confirm=true를 붙여 호출을 다시 보냅니다. 과금 호출은 네트워크 오류가 나도 절대 재전송되지 않습니다.

어디까지 허용할지 정하세요

--env ote
테스트 환경: 실제 API, 실제 돈은 나가지 않음
--read-only
보기만 하고 건드리지 않음. 모든 변경 차단
--no-billable
구매를 제외한 모든 것
--groups domain,dns
지정한 명령 그룹만
--dry-run
API 키를 가린 채 보낼 HTTP 요청을 그대로 출력
시작하기

프롬프트부터 첫 도메인까지 네 단계, 모두 테스트 환경에서

OTE는 저희 테스트 환경입니다. 같은 API에 별도의 API 키와 별도의 잔액이 있습니다. 여기서 연습한 뒤 플래그 하나로 운영 환경으로 전환하세요.

  1. 프롬프트 복사

    이 페이지 상단에서 Claude Code, ChatGPT Codex 또는 일반 채팅을 골라 프롬프트를 복사하세요.

  2. 어시스턴트에 붙여 넣기

    어시스턴트가 dna를 설치하고 MCP 서버를 추가한 뒤 dna doctor로 설정을 확인합니다.

    dna doctor
  3. OTE 로그인은 직접

    로그인 명령은 본인 터미널에서 직접 실행하고, 리셀러 ID와 OTE API 키도 거기서 입력하세요. 채팅에는 절대 입력하지 마세요.

    dna auth login --env ote
  4. 쉬운 말로 요청

    검색하고, --dry-run으로 미리 보고, 등록하세요. 테스트 잔액이 차감되는 작업은 모두 귀하의 승인을 기다립니다.

    --dry-run
직접 설정

터미널이 더 편하다면, 명령 두 개로 연결 완료

바이너리를 설치한 다음 dna mcp serve를 MCP 클라이언트에 추가하세요. 모든 API 작업이 Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex CLI 또는 Gemini CLI에서 쓸 수 있는 도구가 됩니다.

$ curl -fsSL https://raw.githubusercontent.com/domainreseller/cli/main/scripts/install.sh | sh

의존성 없는 단일 바이너리입니다. 모든 릴리스에 SHA-256 체크섬이 함께 제공됩니다.

  • API 작업마다 도구 하나, 각 도구에는 API 명세로 만든 JSON 스키마
  • dna_context는 모델이 무언가를 건드리기 전에 지금이 운영 환경인지 테스트 환경인지 알려 줍니다
  • --groups나 --read-only로 필요한 것만 노출하세요. 도구 목록이 짧을수록 컨텍스트 토큰도 절약됩니다.
  • 셸만 있는 에이전트는 한 번의 호출로 Claude Code 스킬과 사용 가이드를 받습니다
# 먼저 테스트 환경에 연결
$ claude mcp add dna -- dna mcp serve --env ote

# 읽기 전용, .mcp.json으로 팀과 공유
$ claude mcp add dna --scope project -- dna mcp serve --env ote --read-only

dna mcp config를 실행하면 클라이언트별로 바로 쓸 수 있는 설정 스니펫이 출력됩니다.

지원 범위

64개 API 작업 전부, 생각하는 방식대로 묶었습니다

리셀러 API로 할 수 있는 일은 dna로도 할 수 있습니다. 각 명령의 --help는 안전 등급, API 경로, 예시를 보여 줍니다.

  • dna domain

    단일 및 일괄 검색, 등록, 갱신, 이전, 복원. 이전 잠금, WHOIS 정보 보호, 인증 코드(auth code), 네임서버, 차일드 호스트, 포워딩.

  • dna dns · dna dnssec

    플랫폼 네임서버의 존 레코드와 레지스트리의 DS 레코드.

  • dna ssl

    CSR 생성, 구매, 설정, 상태 확인, 다운로드, 재발급, 인증서 폐기.

  • dna hosting

    호스팅 플랜과 패키지, 신규 주문과 주문 상태.

  • dna contact

    재사용 가능한 연락처 핸들과 이메일·전화 인증.

  • dna account · product · order

    잔액과 거래 내역, 가격이 포함된 확장자 카탈로그, 주문 상태.

  • dna api

    어떤 엔드포인트로든 인증된 원시 요청을 보냅니다. 안전 규칙은 동일합니다.

  • dna schema · enums · agent

    모든 작업, 입력, 코드 값을 기계가 읽을 수 있게 기술한 설명입니다. 에이전트와 도구 개발자를 위한 것입니다.

전체 명령 레퍼런스 보기

스크립트 및 CI

파이프, cron 작업, 파이프라인을 위해 만들었습니다

터미널에서는 읽기 쉬운 표를, 파이프에서는 JSON을 받습니다. 오류도 JSON이고 종료 코드의 의미는 절대 바뀌지 않으므로, 스크립트는 무엇이 잘못됐는지 항상 알 수 있습니다.

  • 파이프로 넘기면 JSON, 스트림에는 JSON Lines, 출력을 줄이는 내장 --jq
  • 자격 증명은 CI에서는 DNA_RESELLER_ID와 DNA_API_KEY로, 내 컴퓨터에서는 프로필로
  • 터미널 밖에서는 숨은 프롬프트가 없습니다. 승인이 필요한 명령은 코드 9로 종료하고 아무것도 보내지 않습니다
  • 보내기 전에 입력을 검사하고, 속도 제한에 걸리면 자동으로 재시도합니다
# 앞으로 30일 안에 만료되는 도메인, CSV로
$ dna domain list --all \
    --jq '.items[] | select(.remainingDay <= 30) | [.domainName, .expirationDate] | @csv'

# 여러 이름을 한 번에 확인
$ dna domain bulk-search brand.com brand.net brand.io \
    --jq '.infos[] | "\(.domainName)\t\(.status)\t\(.price)"'

# 스크립트에서 --yes 없는 구매는 여기서 멈춤
$ dna domain renew example.com --period 1
exit 9  confirmation required · nothing sent
종료 코드
0성공6속도 제한
2잘못된 입력, 전송 안 함7서버 오류
3인증 오류8네트워크
4찾을 수 없음9확인 필요
5API가 거부10읽기 전용 모드
도구 선택

CLI, SDK, REST API, 아니면 기성 모듈?

모두 같은 자격 증명으로 같은 리셀러 API와 통신합니다. 작업이 이루어지는 곳에 맞는 것을 고르세요.

자주 묻는 질문

에이전트를 연결하기 전에 자주 묻는 질문

짧고 솔직하게 답합니다. 자세한 내용은 모두 GitHub의 README에 있습니다.

전체 문서 읽기
Domain Name API CLI란 무엇인가요?

dna는 Domain Name API 리셀러 플랫폼의 공식 명령줄 클라이언트이자 MCP 서버입니다. 도메인 검색, 등록, 갱신, 이전부터 DNS, DNSSEC, 연락처, SSL, 호스팅까지 리셀러 REST API의 64개 작업을 모두 지원하며, macOS, Linux, Windows용 단일 오픈소스 바이너리로 Apache-2.0 라이선스에 따라 제공됩니다.

AI 에이전트에게 도메인 등록을 맡겨도 안전한가요?

네. 에이전트는 혼자서 아무것도 구매할 수 없기 때문입니다. 과금 작업과 파괴적 작업은 실행되는 대신 미리보기를 반환합니다. 귀하가 승인하고 호출에 confirm=true(CLI에서는 --yes)가 붙은 뒤에만 실행됩니다. 에이전트는 OTE 테스트 환경에서 시작하고, --read-only나 --no-billable로 범위를 더 좁히세요.

돈을 쓰지 않고 써 볼 수 있나요?

네. --env ote를 쓰면 dna가 저희 테스트 환경인 OTE에 연결됩니다. OTE에는 별도의 API 키와 별도의 잔액이 있고, 그곳에서 무엇을 하든 실제 도메인이나 실제 계정에는 영향이 없습니다.

dna와 함께 쓸 수 있는 AI 어시스턴트는 무엇인가요?

모든 MCP 클라이언트입니다: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, OpenAI Codex CLI, Gemini CLI 등. 셸만 있는 에이전트는 CLI를 직접 호출할 수 있고, dna agent guide와 Claude Code 스킬이 사용법을 알려 줍니다.

Domain Name API 계정이 있어야 하나요?

네. dna는 리셀러 계정과 그 API 자격 증명으로 작동합니다. 리셀러 ID와 API 키가 필요하며, 둘 다 리셀러 패널의 API 설정에 있습니다. 운영 환경과 OTE는 키가 다르고, 패널 이메일과 비밀번호는 여기서 쓸 수 없습니다.

dna는 무료인가요?

네. 이 도구는 무료이며 Apache-2.0 라이선스의 오픈소스입니다. 도메인, 갱신, SSL, 호스팅처럼 이 도구로 구매한 것에 대해서만 리셀러 가격으로 계정 잔액에서 지불합니다.

자격 증명은 어디에 저장되나요?

dna auth login은 자격 증명을 사용자 설정 폴더의 프로필 파일에 저장하며, Linux와 macOS에서는 본인만 읽을 수 있습니다. 위치는 dna config path로 확인하세요. 환경 변수가 항상 우선하며, API 키는 --dry-run을 포함한 모든 출력에서 가려집니다.

스크립트와 CI에서 dna를 쓸 수 있나요?

네. 파이프로 넘기면 출력은 JSON이고, 오류는 안정적인 종료 코드와 함께 JSON으로 나오며, 대화형 터미널 밖에서는 아무것도 묻지 않습니다. 자격 증명은 DNA_RESELLER_ID와 DNA_API_KEY로 전달하세요. --yes 없는 과금 명령은 코드 9로 종료하고 아무것도 보내지 않습니다.

CLI와 SDK 중 무엇을 써야 하나요?

사람, 스크립트, AI 에이전트가 일을 한다면 dna를 쓰세요. 자체 애플리케이션에 도메인 기능을 넣는다면 PHP, Node.js, Python, Ruby, Go용 SDK나 REST API 자체를 쓰세요. 모두 같은 API와 같은 자격 증명을 사용합니다.

꼭 터미널을 써야 하나요?

아니요. 준비된 프롬프트를 Claude 데스크톱 앱에서도 실행되는 Claude Code나 ChatGPT Codex에 붙여 넣으면 어시스턴트가 dna를 설치하고 연결해 줍니다. 직접 입력하는 명령은 dna auth login 하나뿐이라 API 키가 채팅에 들어갈 일이 없습니다. 터미널이 아예 없다면 채팅용 프롬프트가 모든 단계를 안내합니다.