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` は絶対に使わないでください。
ChatGPT Codex で dna をセットアップ
dna CLI (https://github.com/domainreseller/cli) をセットアップしてください。 1. 私の OS に合った公式インストールスクリプトでインストールし、その後 `dna version` と `dna doctor` を実行してください。 2. Codex の設定 (`~/.codex/config.toml`) に、名前 `dna`、コマンド `dna`、引数 `mcp serve --env ote` の MCP サーバーとして追加してください。 3. API キーをこのチャットに貼り付けるよう私に求めないでください。`dna auth login --env ote` は私が自分で実行するよう伝え、その後 `dna --ote account get` で接続を確認してください。 作業は OTE テスト環境だけで行い、私の承認なしに `--yes` は絶対に使わないでください。
ターミナルがない?ChatGPT や Claude のチャットで聞く
https://raw.githubusercontent.com/domainreseller/cli/main/llms.txt と、そこからリンクされている dna のドキュメントを読んでください。そのうえで、OTE テスト環境でドメインを登録するための正確な dna コマンドを、ステップごとに教えてください。インストール、ログイン、検索、`--dry-run` でのプレビュー、登録の順です。各コマンドが何をするのかも説明してください。
プロンプトをコピーして 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 transferbillableSSL 証明書を注文
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 クライアントは、ツールを呼び出すたびにあなたに確認も求めます。安全性のアノテーションは、危険な呼び出しをクライアントが目立たせるのに役立ちます。
エージェントがまず確認
confirm なしでツールを呼び出します。何も送信されず、実際に送るリクエストのプレビューが返ってきます。
あなたが決める
エージェントがドメイン、期間、操作内容を示します。あなたは「はい」か「いいえ」で答えます。
実行は 1 回だけ
あなたが承認して初めて、confirm=true を付けて呼び出しをやり直します。課金される呼び出しが、ネットワークエラーの後に再送されることはありません。
どこまで任せるかを決める
--env ote- テスト環境:本物の API で、本物のお金は動かない
--read-only- 見るだけで触らない。変更はすべてブロック
--no-billable- 購入以外はすべて
--groups domain,dns- 指定したコマンドグループだけ
--dry-run- API キーを伏せた状態で、送信する HTTP リクエストをそのまま表示
プロンプトから最初のドメインまで、すべてテスト環境で 4 ステップ
OTE は当社のテスト環境です。API は同じで、専用の API キーと専用の残高があります。そこで試してから、フラグひとつで本番環境に切り替えられます。
プロンプトをコピー
このページの上部で Claude Code、ChatGPT Codex、通常のチャットのいずれかを選び、プロンプトをコピーします。
アシスタントに貼り付け
アシスタントが dna をインストールし、MCP サーバーを追加して、dna doctor でセットアップを確認します。
dna doctorOTE へのログインは自分で
ログインコマンドは自分のターミナルで実行し、リセラー ID と OTE の API キーもそこで入力します。チャットには決して入力しないでください。
dna auth login --env oteふだんの言葉で依頼
検索、--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 | shPS> irm https://raw.githubusercontent.com/domainreseller/cli/main/scripts/install.ps1 | iex$ go install github.com/domainreseller/cli/cmd/dna@latest依存関係のないシングルバイナリです。すべてのリリースに 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 {
"mcpServers": {
"dna": {
"command": "dna",
"args": ["mcp", "serve", "--env", "ote"]
}
}
} {
"servers": {
"dna": {
"type": "stdio",
"command": "dna",
"args": ["mcp", "serve", "--env", "ote"]
}
}
} [mcp_servers.dna]
command = "dna"
args = ["mcp", "serve", "--env", "ote"] # Claude Code スキル:~/.claude/skills/dna/SKILL.md
$ dna agent skill --install
# どのエージェントの指示にも使えるコンパクトなガイド
$ dna agent guide 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
すべての操作、入力、コード値の機械可読な定義。エージェントやツール開発者向けです。
パイプ、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 | 確認が必要 |
| 5 | API が拒否 | 10 | 読み取り専用モード |
CLI、SDK、REST API、それとも既製モジュール?
どれも同じ認証情報で、同じリセラー API に接続します。作業する場所に合うものを選んでください。
CLI・MCP サーバー
人、スクリプト、AI エージェントが作業する場合に。日々の運用、自動化、CI、Claude や Cursor などのアシスタント。
SDK
自社のアプリケーションにドメイン機能を組み込む場合に。PHP、Node.js、Python、Ruby、Go に対応。
SDK を見るREST API
どの言語でも、すべてのリクエストを完全に制御したい場合に。HTTPS 上の JSON で、ヘッダーは 2 つだけ。
API ガイドを読む請求管理モジュール
WHMCS、Blesta、HostBill、WiseCP、Clientexec で販売していて、すべてを自動で回したい場合に。
連携を見る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 キーがチャットに入ることはありません。ターミナルがまったくない場合は、チャット用のプロンプトがすべての手順を案内します。

