mcpField
C
connect-domain

connect-domain

github.com/hostingerクラウド・DevOps16573 回インストール今日更新
リポジトリ

connect-domain について

connect-domainは、ドメインをHostingerのウェブサイトに接続し、HTTPSを有効にする手順スキルです。ウェブサイトやDNSの管理者向けで、既存DNSを確認し、メールや検証レコードを保護するため書き込み前に確認を求めます。

主な機能

  1. 01サイト、登録情報、現在のDNSを確認
  2. 02ドメイン、エイリアス、サブドメインを接続
  3. 03既存レコードを保ちながらDNSを更新
  4. 04SSLを設定してHTTPSリダイレクトを有効化
  5. 05名前解決、HTTPS、メールレコードを検証

活用シーン

  1. 01新しいドメインをHostingerのサイトに向ける
  2. 02サイトの移行やエイリアス・サブドメインの追加
  3. 03ネームサーバーやDNSの変更時にメールレコードを維持

MCP 対応

Hostinger Connectorを通じて、hosting、agency-hosting、domains、dnsの各MCPサーバーを操作します。各操作のinputSchemaを確認し、書き込みの前に変更内容を説明してユーザーの確認を得る手順です。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hostinger/api-mcp-server --skill connect-domain

インストール後、Claude Code で/connect-domainを入力して読み込まれたか確認します。

詳細

ドメインを接続する

HTTPS 経由で Hostinger のウェブサイトを表示できるドメインを取得します。最も重要なルールは、すでに機能しているレコード（メールの MX、SPF、DKIM、確認用の TXT レコード）を、DNS を変更するたびに必ず維持することです。

操作の呼び出し

  • 各操作を初めて呼び出す前に、search が返す inputSchema を確認します。以下の名前が不明なものとして拒否された場合は、その手順で行うこと（例：「dns records」）を search で検索してください。
  • 読み取りを multi-execute でまとめます。ステップ間では $steps.<i>.<path> として値を渡します。バッチで連鎖できる操作は、1 つのサーバーのものに限られます。Hostinger Connector は hosting、agency-hosting、domains、dns をそれぞれ別のサーバーとして実行します。search で操作が見つからない場合は、Connector で該当する製品グループを有効にするようユーザーに依頼してください。
  • ここでの書き込み操作はすべて、公開される内容を変更します。変更内容を伝え、実行する前に毎回ユーザーの承認を得てください。

1. 情報を集める（読み取り専用）

  • ウェブサイト。 hosting_websites_list では domain を指定します（Shared と Cloud。部分一致のため、完全に一致するエントリを選びます）。agency-hosting_websites_list-plan では domain を指定します（Agency）。username と order_id、または details.uid と details.ipv4 を控えておきます。ドメインにウェブサイトがまだない場合は、ユーザーが指しているサイト（多くの場合は *.hostingersite.com）か、そのサイトを作成する注文を探します（hosting_orders_list、agency-hosting_orders_list）。
  • 登録。 domains_portfolio_get が成功するのは、Hostinger で登録されたドメインのみです。name_servers から DNS の運用元がわかります。Hostinger 独自のネームサーバーは dns-parking.com で終わります。
  • 現在の DNS（維持すべきレコードを把握するため）：
dig +short NS DOMAIN; dig +short A DOMAIN; dig +short CNAME www.DOMAIN
dig +short MX DOMAIN; dig +short TXT DOMAIN; dig +short CAA DOMAIN

2. ドメインをホスティングに接続する

Shared と Cloud：

  • ドメインに新しいウェブサイトを作成する。 このアカウント以外のドメインでは、まず hosting_domains_verify-ownership を実行します。is_accessible が false の場合は、既存のレコードに追加する TXT レコードをユーザーに伝え、その後もう一度確認します（反映には最大で約 10 分かかります）。hosting_websites_create を使って作成します（domain には www. を付けず、order_id も指定します）。次に、hosting_websites_list-setups を domain 指定で 10～15 秒ごとに実行し、status: completed になるまで確認します。
  • 無料サブドメインからサイトを移行する。 Shared と Cloud のウェブサイトは API 経由では名前を変更できません。実際のドメインにウェブサイトを作成し、プロジェクトをそこに再デプロイする（deploy-to-hosting スキル）か、静的サイトの場合は hosting_domains_create-website-parked を使って既存サイトにドメインをパーキングします。WordPress は URL がデータベースに保存されているため、前者が必須です。
  • エイリアス（同じサイトを表示する 2 つ目のドメイン）：hosting_domains_create-website-parked。
  • サブドメイン（shop.example.com）：hosting_domains_create-website-subdomain。www はメインドメインに属するため、サブドメインとして作成しないでください。

Agency Plan：

  • agency-hosting_domains_link-to-website は、サイトにドメインを追加します。
  • agency-hosting_domains_change-website は、無料サブドメインなどのプライマリドメインを置き換えます。古い名前ではすぐにサイトが表示されなくなるため、事前に確認してください。

3. DNSをHostingerに向ける

DNSがすでにHostingerにある場合（ネームサーバーがdns-parking.comで終わる場合）：通常、ウェブサイトを作成するとレコードも書き込まれます。dns_records_listでゾーンを確認し、@とwwwがすでにサイトを指している場合は、変更しないでください。編集する前に、最新のdns_snapshots_listエントリーを記録してください。dns_snapshots_restoreを使うと、そこまでロールバックできます。

dns_records_updateはデフォルトでoverwrite: trueとなっており、同じ名前とタイプの既存レコードをすべて削除します。この方法で@にTXTを追加すると、SPFレコードと認証レコードが消去されます。追加する場合はoverwrite: falseを指定してください。trueを使うのは、意図的に1つのレコードセットを置き換える場合に限り、先に同じペイロードに対してdns_records_validateを実行してください。

DNSが別の場所にある場合（Hostingerに登録されているがネームサーバーが別、または他社に登録されている場合）。方法は2つあります。ユーザーに選んでもらってください。

  • ネームサーバーをHostingerに切り替える。 その後、Hostingerがすべてのレコードを管理します。まず、現在のDNSがウェブサイト以外に提供している各レコード（MX、TXT、サービスのCNAME）をdns_records_update（overwrite: false）でHostingerのゾーンにコピーしてください。コピーしないと、ネームサーバーの切り替え時にメールが使えなくなります。Hostingerのネームサーバーの組み合わせはドメインによって異なります（ns1／ns2.dns-parking.com、solar／lunar.dns-parking.comなど）。必ずこのドメインについてhPanelに表示されている組み合わせを使い、推測したものは使わないでください。Hostingerに登録されたドメインの場合はdomains_portfolio_update-nameserversで適用し、それ以外の場合はユーザーが登録事業者の管理画面で変更します。
  • 現在のDNSプロバイダーを使い続け、ウェブ関連のレコードだけを変更する。@にはA、wwwにはCNAME（またはA）を設定します。Agencyのサイトはdetails.ipv4を指します。SharedおよびCloudのサイトは、ドメインのHostingerゾーンにあるターゲット（dns_records_list）、またはそのゾーンが存在しない場合は、ウェブサイトについてhPanelに表示されているIPアドレスを指します。ユーザーはDNSプロバイダーの管理画面で変更します。

4. SSLとHTTPS

digでドメインがHostingerに解決されることを確認してから開始してください。認証局は、ドメインとサーバーが一致するかを確認します。

  • SharedおよびCloud：hosting_ssl_statusを実行します。ステータスがactiveでない場合は、hosting_ssl_installを呼び出し、ステータスがactiveになるまで（またはlast_errorを伴ってfailedになるまで）ポーリングします。その後、is_enabled: trueを指定してhosting_ssl_toggle-https-redirectを実行します（証明書が存在するまでは422を返します）。
  • Agency：ドメインごとにagency-hosting_ssl_install-websiteを実行し、その後agency-hosting_ssl_website-statusをポーリングします。1つのドメインにつき、7日間に3回までセットアップでき、リクエストは1分に1回までです。DNSが正しくなってから1回だけインストールし、繰り返し実行しないでください。
  • apexにあるCAAレコードでletsencrypt.orgが許可されていない場合、証明書を発行できません。ユーザーは既存のレコードに加えて0 issue "letsencrypt.org"を追加します。

5. 確認

dig +short A DOMAIN; dig +short A www.DOMAIN
curl -sSI https://DOMAIN/ | grep -i -E "^(HTTP|platform|location)"
curl -sSI http://DOMAIN/ | grep -i -E "^(HTTP|location)"
dig +short MX DOMAIN

両方の名前がHostingerに解決され、HTTPSがplatform: hostingerを返し、HTTPがHTTPSにリダイレクトされ、MXがステップ1の内容と一致すれば完了です。ネームサーバーの変更がすべてのリゾルバーに反映されるまで、最大24〜48時間かかることがあります。レコードがまだ古い場合は、何が保留中かと再確認に使うコマンドを伝え、何時間もポーリングし続けないでください。

コメント

Markdown 対応