Claudeでドメインを購入：Namefi MCPのステップ別ガイド

このガイドを最後まで読むと、ICANNに実在するドメインを登録し、構築中のサービスにDNSを向けるところまで、Claudeとの会話だけで完了できます。ブラウザーでの決済も、カートも、CAPTCHAも必要ありません。これはNamefi MCPサーバーに関するNamefiチーム公式のセットアップガイドです。namefi.io/llms.txtとdocs.namefi.ioでエージェント向けに公開している同じAPIを、人が読みやすい形で説明します。まだ確定または公開されていない詳細については、推測せず、その旨を明記します。

「AIエージェントでドメインを登録する」方法を解説する第三者のガイドも存在します。よく知られた一例では、Cloudflare Registrar API上にリセラーとして構築された別のMCPサーバーを使って、このパターンを紹介しています。MCP自体の仕組みはどのプロバイダーでも同じ発想に基づきますが、このガイドではNamefi独自のMCPサーバー、認証モデル、トークン化ドメインのオプションに絞り、第三者による説明ではなくNamefiのドキュメントに照らして検証しています。

MCPとは（簡単に）

Model Context Protocol（MCP）は、AIアプリケーション（ここではClaude）を外部ツールやデータソースに接続するためのオープン標準です。プロトコルの公式ドキュメントでは、AIアプリケーションのためのUSB-Cポートと説明されています。ツールごとに独自の連携を作る代わりに、単一の標準化されたコネクターを使うという考え方です。NamefiのMCPサーバーに接続すると、Claudeは、利用可否の確認、ドメイン登録、DNSレコードの読み書きといった、明確に定義された呼び出し可能な操作を利用できるようになります。チャットに貼り付けられたドキュメントからREST APIを推測する必要はありません。

前提条件

MCP対応のClaudeクライアント。 このガイドでは、具体的に検証済みのコマンドを使ってClaude Code（コマンドライン）を説明し、ドキュメントで示されている一般的な手順に沿ってClaude Desktop / claude.ai（Custom Connectors経由）も取り上げます。CursorやWindsurfなど、ほかのMCPクライアントも同じサーバーに接続できます。各エージェント向けの説明はNamefiでAIエージェントを使ってドメインを登録する方法を参照してください。接続コマンドだけが必要なら、要点をまとめたNamefi MCPクイックスタート：Claude Code、Cursor、Windsurfをご覧ください。
Namefi APIキー。 namefi.io/api-keyで生成します。APIキーを一切使わず取引ごとに支払いたい場合は、暗号資産ウォレットも利用できます（終盤のウォレットに関するセクションを参照）。
Namefiの本番環境で登録する場合は、入金済みのNFSC残高。 NFSC（Namefi Service Credits）はドメイン登録の支払いに使われる残高です。Namefiのドキュメントでは、本番環境ではNamefiダッシュボードから残高を追加し、開発環境ではfaucetエンドポイントから無料のテストクレジットを申請する方法が説明されています。

ステップ1：Namefi APIキーを取得する

APIキーは最も簡単な認証方法であり、このガイドでは一貫してこの方法を使います。単一のヘッダーで、登録、DNSレコードの作成、更新、削除のすべてを認証できます。キーを生成する前に理解しておきたい重要な点があります。キーは、生成元のウォレットが持つ権限を引き継ぎます。 すでに所有しているドメインのDNSを管理したい場合は、そのドメインのNFTを所有するウォレットからキーを生成してください。別のウォレットから生成したキーでは、登録者が他者であるドメインへの書き込み権限は得られません。

生成されたキーは、nfk_で始まる文字列です。書き込み操作のたびにx-api-keyヘッダーとして渡します。一方、利用可否の確認などの読み取り専用操作にはキーは一切必要ありません。

ステップ2：ClaudeをNamefi MCPサーバーに接続する

ICANN認定レジストラであるNamefiは、API全体に対応する単一のMCPサーバーをhttps://api.namefi.io/mcpで運用しており、Streamable HTTPトランスポートで接続できます。このサーバーは、検索、登録、DNS、ドメイン設定、アウトバウンドを含むすべての/v-next操作を型付きツールとして公開しています。サーバーの存在と接続情報自体も、namefi.io/.well-known/mcp/servers.jsonでディスカバリーディスクリプターとして公開されています。機械可読なので、人が最初にURLを貼り付けなくてもエージェントがサーバーを見つけられます。

Claude Code

Claude Codeへのサーバー追加は、次のコマンド一つで完了します。

claude mcp add --transport http namefi https://api.namefi.io/mcp --header "x-api-key: YOUR_KEY"

これは、カスタム認証ヘッダー付きのリモートHTTP MCPサーバーを追加するためのClaude Code公式の構文と一致します。一般形はclaude mcp add --transport http <name> <url> --header "<Header-Name>: <value>"です。ターミナルから一度実行し（YOUR_KEYをステップ1で取得したキーに置き換えてください）、Claude CodeがサーバーをプロジェクトまたはユーザーのMCP設定に書き込みます。デフォルトでは、現在のプロジェクトだけにサーバーが登録されます。すべてのプロジェクトで使えるようにするには--scope userを追加してください。まず利用可否検索のような読み取り専用ツールだけを使う場合は、キーを省略し、後から追加することもできます。

接続を確認するにはclaude mcp listを実行します。namefiが接続済みとして表示されるはずです。また、Claude Codeセッション内で/mcpを実行すると、Namefiサーバーが公開しているツール数を確認できます。

Claude Desktopとclaude.ai

Claude Desktopとclaude.aiは、modelcontextprotocol.ioで説明されているCustom Connectorsを使ってリモートMCPサーバーに接続します。Settingsを開き、Connectorsに移動して「Add custom connector」を選び、サーバーURLのhttps://api.namefi.io/mcpを入力します。Addをクリックすると、認証を完了するよう案内されます。Anthropicのドキュメントによると、サーバーの要件に応じて、この手順には「通常、OAuth、APIキー、またはユーザー名とパスワードの組み合わせが使用され」、Claudeがそのサーバーに必要な入力画面を表示します。

ステップ3：NFSC残高に入金する

ドメイン登録は有料の操作であり、支払いに使うウォレットにNFSC（Namefi Service Credits）が必要です。開発環境またはテスト環境では、faucet（POST /v-next/user/faucet、SDKではclient.user.requestNfscFaucet()）から、ウォレットごとのレート制限付きで無料のテストクレジットを受け取れます。本番環境では、NamefiダッシュボードからNFSCを追加します。現在の残高はいつでも確認できます。接続後にClaudeへ「Namefiの残高は？」と尋ねるか、GET /v-next/balanceを直接呼び出してください。

ステップ4：購入の会話

MCPサーバーに接続し、残高への入金が完了すれば、その後の手順は自然言語で進みます。以下は、その会話がどのようになるかを注釈付きで示した例です。各ステップを、NamefiのAPIドキュメントに記載された内部操作に対応付けています。

1. Claudeにドメイン名の確認を依頼します。

「example.comは登録できますか？」

Claudeは利用可否チェック（checkAvailability操作。認証不要でGET /v-next/search/availability?domain=example.comから直接利用可能）を呼び出します。そのドメイン名が空いているかを報告し、比較したい候補を複数与えれば、一括利用可否チェックを通じてまとめて確認することもできます。

2. 確認して登録します。

「一年間登録して、@が203.0.113.10を指すようにDNSを設定してください。」

Claudeは登録注文（registerDomain、POST /v-next/orders/register-domain）を送信します。DNSレコードの設定も依頼した場合は、register-domain/recordsの統合版を使い、注文完了後すぐに指定したAレコードを適用します。リクエストボディには、normalizedDomainName（小文字、末尾のドットなし、search/availabilityが登録可能と報告した任意のTLD）とdurationInYears（0〜10、デフォルトは1）を指定します。任意のnftReceivingWalletでトークン化を制御できます。省略すると、APIキーに紐づくウォレット宛てに、Base上のNFTとしてドメインが登録されます。domainSetupOptionsオブジェクトには、autoRenew、dnssec、keepExistingNameserversなど、ドメインごとの追加の上書き設定が定義されています。最後の設定を使えば、現在の委任先からネームサーバーを変更せずに、Claudeがドメインを登録できます。

3. 注文が完了するまでClaudeがポーリングします。

登録は非同期です。Claude（またはステータスを監視するユーザー）は、注文がSUCCEEDED、FAILED、CANCELLED、PARTIALLY_COMPLETEDのいずれかの終了ステータスになるまで、getOrder（GET /v-next/orders/{orderId}）をポーリングします。一般的な登録は数回のポーリングで完了します。Claudeは完了時に結果を報告するため、ユーザーがスピナーを見続ける必要はありません。

4. 最初にすべて設定しなかった場合は、追加のDNSレコードを依頼します。

「さらに、wwwがcname.vercel-dns.com.を指すCNAMEと、_verify配下にこのトークンを持つTXTレコードを追加してください。」

Claudeはそれぞれに対してcreateDnsRecord（POST /v-next/dns/records）を呼び出します。依頼する前に知っておきたい書式上のルールが二つあります。CNAMEなどのレコードタイプでは、rdataの末尾にドットが必要です（cname.vercel-dns.com.）。一方、ドメイン自体を表すzoneNameには末尾のドットを付けてはいけません。この二つを逆にすることが、この手順で検証エラーが発生する最も一般的な原因です。

5. 任意：自動更新を有効にします。

「このドメインの自動更新を有効にしてください。」

ClaudeはPUT /v-next/domain-config/auto-renewを使って自動更新を切り替えます。有効にすると、所有者のウォレットで利用可能な支払い方法を使い、有効期限前にドメインが自動更新されます。これは一度限りの確認ではなく継続的な承認なので、有効にする前に理解しておくことが重要です。

ステップ5：名前解決を確認する

DNS伝播は即時ではないため、レコードを確認するまで数分待ってください。DNSの読み取りには認証が不要なので、GET /v-next/dns/records?zoneName=example.comまたは公開DNS検索ツールを使って、反映内容をユーザー自身（またはClaude）が確認できます。ドメインをデプロイプラットフォームに向けた場合は、そのプラットフォーム独自のドメイン検証手順（指定されたTXTレコードの確認）も、別途行う価値があります。

APIキーの代わりにウォレットで支払う

ここまでの手順ではAPIキーを使いました。Namefiでは、x402プロトコルを通じて、Namefiアカウントを一切使わず、暗号資産ウォレットでドメインを登録することもできます。購入者のウォレットがEIP-3009認可に署名し、支払いが添付されていなければAPIが価格を含む402 Payment Requiredを返し、有効な支払いを受信すると登録を決済します。この手順は脚注ではなく独立したガイドに値します。詳しくは暗号資産ウォレットでドメインを支払う：アカウント不要、またはNamefiでAIエージェントを使ってドメインを登録する方法の支払いセクションをご覧ください。

トラブルシューティング

症状	考えられる原因	対処方法
書き込み呼び出しで`401 UNAUTHORIZED`が返る	APIキーが無効、期限切れ、またはドメインを所有していないウォレットから生成されている	ドメインを所有している（または所有する予定の）ウォレットを使い、namefi.io/api-keyで新しいキーを生成する
`403 FORBIDDEN`	キーは有効だが、紐づくウォレットがこの特定のドメインを所有していない	再試行する前にNamefiアカウントで所有権を確認する
登録注文が終了前のステータスで止まっている	正常な挙動 — 登録は非同期	`getOrder`のポーリングを続ける。Namefi公式の例では5秒ごとにポーリングする。`SUCCEEDED`、`FAILED`、`CANCELLED`、`PARTIALLY_COMPLETED`のいずれにも到達しない場合にのみ、停止していると判断する
DNSレコードの作成または更新が検証エラーで拒否される	`zoneName`に末尾のドットがある、またはCNAME/MX/NSの`rdata`値に末尾のドットがない	`zoneName` = 末尾のドットなし。FQDN形式の`rdata`値 = 末尾のドットが必要
登録が完全に失敗する	支払いに使うウォレットのNFSC残高が不足している	残高を確認し（`GET /v-next/balance`）、faucet（テスト）またはNamefiダッシュボード（本番）から追加する
Claudeが利用可能なドメインツールがないと表示する	MCPサーバーが未接続、または書き込み操作に必要なヘッダーなしで接続されている	`--header`フラグ付きで`claude mcp add`を再実行するか、`/mcp` / `claude mcp list`で接続状態を確認する

よくある質問

利用するにはNamefiのREST APIを理解する必要がありますか。それともClaudeに自然言語で話しかけるだけでよいですか？

上記の手順はすべて自然言語だけで実行できます。「このドメインは空いていますか」「登録してください」「このIPアドレスを向き先にしてください」といった依頼をそのまま伝えられます。このガイドにエンドポイントとリクエストフィールドを記載しているのは、Claudeが内部で何をしているかを確認したり、チャットではなくスクリプトから直接呼び出したりできるようにするためです。

Claude経由で登録すると、Namefiのウェブサイトから登録するより高くなりますか？

このガイドでは、どちらが安いか高いかを断定しません。いずれの場合も、ブラウザー、スクリプト、MCPツール呼び出しのどれからリクエストしたかにかかわらず、登録料金は同じNFSC残高から引き落とされます。

この方法で登録すると、ドメインは自動的にNFTとしてトークン化されますか？

はい、デフォルトでトークン化されます。登録リクエストでnftReceivingWalletを指定しない場合、APIキーに紐づくウォレット宛てに、Base上のNFTとしてドメインが登録されます。登録時に別のウォレットまたはチェーンへ変更できます。

ClaudeのDNSレコード要求に入力ミスがあると、気付かないうちにドメインが壊れる可能性はありますか？

DNSへの書き込みは適用前にNamefiの検証を通過します。不正なrdata（たとえばCNAMEの向き先に末尾のドットがない場合）は、黙って受け入れられるのではなくエラーで拒否されます。上のトラブルシューティング表を参照してください。それでも、本番ドメインのDNS変更は、ほかのインフラ変更と同様に扱ってください。確定する前に、Claudeが送信しようとしている内容を確認しましょう。

Claudeの代わりにCursorやWindsurfから同じMCPサーバーを使えますか？

はい。Namefiのサーバーは、接続するクライアントにかかわらず同じオープンなMCPプロトコルを使用するため、サーバー側は変わりません。クライアント側の接続コマンドはエディターによって異なります。クライアント別の設定についてはNamefiでAIエージェントを使ってドメインを登録する方法、短い手順についてはNamefi MCPクイックスタート：Claude Code、Cursor、Windsurfをご覧ください。

次のドメインを会話から購入する

これは仮定の話ではなく、Namefiが現在実際に対応しているセットアップです。MCPサーバーに接続すると、ドメイン名の検索から登録、DNS設定、さらに任意でウォレットに保有するトークンへの変換まで、チャットを離れずに実行できます。MCPサーバーが公開する機能は登録だけではありません。アウトバウンドの見込み顧客探索、DNSの一括操作、ドメイン設定なども、セットアップ完了後は同じ接続からすべて検出できます。ツールの全一覧についてはNamefi MCPサーバー：AIエージェント向けドメインツールをご覧ください。

Namefi APIキーを生成してClaudeを接続する。

出典と関連資料

Namefi — namefi.io/llms.txt（MCPサーバーURL、トランスポート、認証、登録およびDNSエンドポイント — このガイドの一次情報）
Namefi — docs.namefi.io：認証（APIキー、EIP-712、SIWEの認証方式と、操作ごとの認証要件）
Namefi — docs.namefi.io：ドメインを登録する（SDK、fetch、cURL、Pythonによる登録とポーリングの実例）
Namefi — docs.namefi.io：残高を管理する（NFSC faucetおよび残高確認エンドポイント）
Namefi — namefi.io/.well-known/mcp/servers.json（MCPディスカバリーディスクリプター）
Anthropic / Claude Code — MCP経由でClaude Codeをツールに接続する（claude mcp add --transport httpの構文、ヘッダー認証、スコープフラグ）
Model Context Protocol — リモートMCPサーバーに接続する（Claude Desktopおよびclaude.aiでのCustom Connectorsの手順）
Model Context Protocol — Model Context Protocolとは？（プロトコルの概要）
llmstxt.org — /llms.txtファイル（namefi.io/llms.txtが準拠するディスカバリーファイルの仕様と目的）
dev.to — 人の操作なしでAIエージェントを使ってドメイン名を登録する方法（Cloudflareを基盤とする別のレジストラリセラーを使った、第三者によるMCPチュートリアル）