Domeneshop

MCP（Model Context Protocol）は、AI アプリが外部ツールを呼び出せるようにするオープン 標準です。このパッケージは MCP サーバー です。AI アプリがバックグラウンドで起動し、通信する小さなプログラムです。登録すると、普段の言葉で「blog.example.no を 203.0.113.10 に向けて」と頼むだけで、アシスタントが適切なツールを選び、実行しようとしている内容を示し、変更を行う前に確認を求めます。

サーバーを自分で起動する必要はなく、ツール名を知っている必要もありません。必要なものは次のとおりです。

• Domeneshop API トークンとシークレット。プログラムがお客様のアカウントで操作するためのキーのペアです。パスワードと同じように扱ってください。
• MCP クライアント。チャットに使うアプリです。以下では Claude Code を使用しますが、ほかのクライアントも利用できます（クライアントの設定を参照）。
• Node.js 20.3+（LTS をダウンロード）または Homebrew。Claude Desktop バンドルでは必要ありません。

アシスタントに本番環境の DNS を変更させることに不安がある場合は、読み取り専用モードから始めてください。すべて確認できますが、変更はできません。

クイックスタートの CLI コマンドを使用してください。デフォルトでは --scope local が指定され、自分とこのプロジェクトだけに適用されます。代わりに --scope project を指定すると、バージョン管理を通じて共有される <your-project>/.mcp.json に書き込みます。または、アカウント内のすべてのプロジェクトに適用する場合は --scope user を指定してください。

標準設定を生の JSON として渡すこともできます。

claude mcp add-json domeneshop '{"command":"npx","args":["-y","domeneshop-mcp"],"env":{"DOMENESHOP_API_TOKEN":"<your-api-token>","DOMENESHOP_API_SECRET":"<your-api-secret>"}}'

または、標準設定を <your-project>/.mcp.json に直接書き込むこともできます。 claude mcp list を実行すると、登録済みのサーバーと接続状況を確認できます。

最も簡単な方法は、Node.js が不要なワンクリックバンドルを使うことです。

1. 最新リリースから domeneshop-mcp-<version>.mcpb をダウンロードします。
2. ファイルを開きます（ダブルクリックするか、Claude Desktop にドラッグします）。
3. トークンとシークレットを貼り付け、必要に応じて読み取り専用モードを有効にして、インストールします。

Claude Desktop は認証情報を安全に保存します。

代わりに手動で設定するには、標準設定を claude_desktop_config.json に追加します。このファイルは「設定」→「開発者」→「設定を編集」から開けます。 その後、Claude Desktop を再起動してください。

このボタンを使うと、プレースホルダーの認証情報でサーバーをインストールします。Cursor では認証情報の入力を求められないため、インストール後に 設定 → MCP を開き、domeneshop の項目を編集して、<your-api-token> と <your-api-secret> を自分の値に置き換えてください。

代わりに手動で設定するには、標準設定を mcp.json ファイルに追加します。

ボタンを押すと、サーバーがユーザー設定にインストールされます。VS Code はトークンとシークレットの入力を求め、安全に保存するため、設定ファイルに平文で書き込まれることはありません。

手動で設定する場合、VS Code では mcpServers ではなく servers キーを使い、type を明示する必要があります。このプロジェクトだけに設定する場合は、<your-project>/.vscode/mcp.json に追加してください。

{
  "servers": {
    "domeneshop": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "domeneshop-mcp"],
      "env": {
        "DOMENESHOP_API_TOKEN": "<your-api-token>",
        "DOMENESHOP_API_SECRET": "<your-api-secret>"
      }
    }
  }
}

すべてのプロジェクトで使うには、コマンドパレットから MCP: Open User Configuration を実行して同じブロックを追加するか、次のように1行で登録してください。

code --add-mcp '{"name":"domeneshop","command":"npx","args":["-y","domeneshop-mcp"],"env":{"DOMENESHOP_API_TOKEN":"<your-api-token>","DOMENESHOP_API_SECRET":"<your-api-secret>"}}'

Codex CLI は、設定ファイルの mcp_servers から MCP サーバーを読み込みます。

[mcp_servers.domeneshop]
command = "npx"
args = ["-y", "domeneshop-mcp"]
env = { DOMENESHOP_API_TOKEN = "<your-api-token>", DOMENESHOP_API_SECRET = "<your-api-secret>" }

codex mcp add domeneshop -- npx -y domeneshop-mcp を実行するとコマンドラインから登録できますが、環境変数のフラグは指定できません。そのため、作成された [mcp_servers.domeneshop] ブロックに2つの変数を設定してください。

Windsurf、Cline、Continue、LM Studio など、stdio 経由で MCP サーバーを実行するものなら何でも使えます。ほとんどの場合、標準設定と同じ形式です。クライアントのドキュメントで設定ファイルとキー名を確認し、次のように指定してください。

• command: npx
• args: ["-y", "domeneshop-mcp"]
• env: DOMENESHOP_API_TOKEN と DOMENESHOP_API_SECRET

起動のたびにパッケージを解決するのを避けるには、一度インストールし、引数なしでコマンドに domeneshop-mcp を指定してください。npm の場合：

npm install -g domeneshop-mcp

macOS または Linux では、Homebrew を使う方法もあります。Node.js がインストールされていない場合は、Homebrew があわせてインストールします。

brew install martinzachariassen/tap/domeneshop-mcp

brew upgrade domeneshop-mcp を実行すると、新しいリリースを取得できます。Claude Desktop などの GUI アプリでは通常、Homebrew の PATH が認識されないため、フルパスを指定してください（brew --prefix でプレフィックスを確認できます。Apple silicon では /opt/homebrew、Intel Mac では /usr/local、Linux では /home/linuxbrew/.linuxbrew です）。

{
  "mcpServers": {
    "domeneshop": {
      "command": "/opt/homebrew/bin/domeneshop-mcp",
      "env": {
        "DOMENESHOP_API_TOKEN": "<your-api-token>",
        "DOMENESHOP_API_SECRET": "<your-api-secret>"
      }
    }
  }
}

Domeneshop が受け付ける 11 種類すべてのレコードタイプと、それぞれのタイプ固有のフィールドをサポートしています。

tag フィールドの型は意図的に指定していません。DS では数値のキータグ、CAA では issue などのプロパティタグとなりますが、Domeneshop はどちらについてもドキュメントに記載していません。

このサーバーが依存している動作の中には、Domeneshop が公開している OpenAPI 仕様には記載されていないものの、サポートされており、同社のクライアントライブラリでも使用されているものがあります。

• 仕様では 7 種類のレコードタイプが文書化されていますが、domeneshop.js と python-domeneshop のレコード検証で示されているように、ANAME、CAA、DS、NS も動作します。
• GET /invoices は status フィルターを受け付けます。これは domeneshop.js で使用されています。
• POST /forwards/ は空の本文で 201 を返し、新しい転送先の名前は Location ヘッダーにのみ記載します。
• GET /dyndns/update は JSON ではなく、本文なしで 204 を返すため、クライアントは応答をデコードしようとしません。

• npm パッケージ
• Homebrew tap
• MCP レジストリ
• Claude Desktop バンドル（各リリースに .mcpb を含みます）

src/
  domeneshop/       Domeneshop API client (HTTP transport + one resource per endpoint group)
  mcp/              MCP server: tool registration, schemas, result/error helpers
  index.ts          CLI entry point
test/
  domeneshop/       Client tests, against a local HTTP server
  mcp/              End-to-end tool tests, against an in-memory MCP transport