新登場 · 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. 私の OS に合った公式インストールスクリプトでインストールし、その後 `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 Schema を備えたツールになっています。だからアシスタントは最初から正しい呼び出しを選び、正しく入力できます。あなたは話すだけ。正確な作業は dna が行います。

セーフティゲート

エージェントは、あなたに無断で一銭も使えません

すべてのコマンドには安全クラスがあり、何が起きるかはそのクラスで決まります。参照や、無料で元に戻せる変更はすぐに実行されます。残高から引き落とされる操作や元に戻せない操作は、いったん止まって先に確認を求めます。

  • read

    読み取り

    検索、一覧、ドメイン情報、価格、拡張子ごとのルール。

    すぐに実行
  • write

    書き込み

    DNS レコード、移管ロック、WHOIS 情報公開代行、連絡先。無料で元に戻せます。

    すぐに実行
  • destructive

    破壊的操作

    レコードの削除、SSL の失効、DNSSEC の無効化。

    あなたの承認を待つ
  • billable

    課金

    登録、更新、移管、復旧、SSL とホスティングの注文。

    あなたの承認を待つ

承認のしくみ

承認が必要なツールには、confirm フィールドがひとつ追加されています。多くの MCP クライアントは、ツールを呼び出すたびにあなたに確認も求めます。安全性のアノテーションは、危険な呼び出しをクライアントが目立たせるのに役立ちます。

  1. エージェントがまず確認

    confirm なしでツールを呼び出します。何も送信されず、実際に送るリクエストのプレビューが返ってきます。

  2. あなたが決める

    エージェントがドメイン、期間、操作内容を示します。あなたは「はい」か「いいえ」で答えます。

  3. 実行は 1 回だけ

    あなたが承認して初めて、confirm=true を付けて呼び出しをやり直します。課金される呼び出しが、ネットワークエラーの後に再送されることはありません。

どこまで任せるかを決める

--env ote
テスト環境:本物の API で、本物のお金は動かない
--read-only
見るだけで触らない。変更はすべてブロック
--no-billable
購入以外はすべて
--groups domain,dns
指定したコマンドグループだけ
--dry-run
API キーを伏せた状態で、送信する HTTP リクエストをそのまま表示
はじめに

プロンプトから最初のドメインまで、すべてテスト環境で 4 ステップ

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
手動セットアップ

ターミナル派なら、コマンド 2 つで接続完了

バイナリをインストールしたら、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 Schema が付いています
  • dna_context が、何かに触れる前に、本番環境かテスト環境かをモデルに伝えます
  • --groups や --read-only で、必要なものだけを公開できます。ツール一覧が短くなれば、コンテキストのトークンも節約できます。
  • シェルしか使えないエージェントには、1 回の呼び出しで 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 を通じて購入したものだけで、リセラー価格でアカウント残高から支払われます。

認証情報はどこに保存されますか?

dna auth login は、ユーザー設定フォルダ内のプロファイルファイルに保存します。Linux と macOS では、このファイルはあなただけが読み取れます。保存場所は dna config path で確認できます。環境変数が常に優先され、API キーは --dry-run を含むすべての出力で伏せ字になります。

dna はスクリプトや CI で使えますか?

はい。パイプでは 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 Code(Claude のデスクトップアプリでも動きます)か ChatGPT Codex に貼り付ければ、アシスタントが dna をインストールして接続します。あなたが自分で入力するコマンドは dna auth login だけなので、API キーがチャットに入ることはありません。ターミナルがまったくない場合は、チャット用のプロンプトがすべての手順を案内します。