IONOS CLOUD MCP Server

IONOS CLOUD MCP サーバー

デフォルトで読み取り専用のModel Context Protocol（MCP）サーバーです。IONOS CLOUD アカウントを、MCP 互換の AI アシスタントまたは自律型 AI エージェント（Claude Desktop、Cursor、VS Code（GitHub Copilot）、Windsurf、Cline、Continue、OpenCode など 5 つ以上）に接続します。7 つの IONOS CLOUD 製品にわたる 118 個の読み取り専用ツールを備え、自然言語のプロンプトまたはプログラムによるエージェントループを通じて、インフラストラクチャの一覧表示、調査、監査を行えます。Compute（サーバー、ボリューム、ネットワーキング、ロードバランシング）、Managed Kubernetes（クラスター、ノードプール、ノード）、DNS（ゾーン、レコード、逆引きレコード、DNSSEC）、Certificate Manager（証明書、自動証明書、プロバイダー）に対する書き込み操作は、明示的に有効にした場合にのみ利用でき、実際に課金対象となるリソースを作成します。書き込み操作をご覧ください。

IONOS Cloud チームが開発・保守しています。サーバーは、ワークステーション、CI ランナー、またはコンテナー内でローカルバイナリとして実行されます。IONOS CLOUD API の呼び出しは HTTPS 経由で IONOS に直接送信され、データ経路にサードパーティの AI プロバイダーは介在しません。

互換性： MCP 仕様 2024-11-05 · ビルドには Go 1.25 以上 · OCI イメージは linux/amd64 および linux/arm64 向け。

📚 製品ドキュメント、クライアント別のセットアップガイド、FAQ、チュートリアル： docs.ionos.com/cloud/ai/mcp-server

60 秒で始める（macOS または Linux、Homebrew を使用）：

brew install ionos-cloud/ionos-cloud/ionoscloud-mcp

その他のインストール方法（Docker、ビルド済みバイナリ、go install、ソース）については、インストールをご覧ください。

選ばれる理由 • レジストリ • 製品 • インストール • 設定 • ツールの読み込み • トランスポート • 書き込み操作 • デモ • 開発 • 関連プロジェクト • 変更履歴

選ばれる理由

• デフォルトで読み取り専用、書き込みは明示的に有効化 — 初期状態ではすべてのツールが調査操作（list_*、get_*、head_*）なので、本番アカウントに安全に接続でき、CI ランナー上の無人エージェントループにもデプロイできます。書き込みツール（create_*、update_*、delete_*）は、IONOS_MCP_TOOL_SCOPE を設定した場合にのみ登録されます。その場合も、作成と削除にはすべて 2 段階の確認（プレビュー → 1 回限りのトークン → 実行）が必要です。書き込み操作をご覧ください。
• ローカルバイナリ、プロキシ不要 — IONOS CLOUD API の呼び出しは、お使いのマシンから IONOS Cloud に直接送信されます。データ経路にサードパーティの AI ベンダーは介在しません。
• EU 主権の選択肢 — サーバーをIONOS CLOUD AI Model Hubと組み合わせると、API 呼び出しと LLM 推論の両方が IONOS のドイツ国内のデータセンター内で完結します。完全主権型 AI ワークフローガイドをご覧ください。
• オープンソース — Apache 2.0。ソースを読み、動作を監査し、貢献したり、フォークしたりできます。

レジストリとディレクトリ

このサーバーは、複数の MCP レジストリおよび IDE マーケットプレイスで公開されています。

レジストリ	リンク
公式 MCP レジストリ	io.github.ionos-cloud/ionoscloud-mcp
Smithery	ionos-cloud/ionoscloud-mcp
mcp.so	ionos-cloud-mcp-server
Glama	ionoscloud-mcp
Cursor	ionoscloud-mcp
mcpservers.org	ionoscloud-mcp
PulseMCP	ionoscloud
MCPMarket	ionos-cloud
punkpeye/awesome-mcp-servers	ionos-cloud/ionoscloud-mcp

対応製品

読み取りツールの名前は list_*、get_*、head_* です。オプトインの書き込みツールには、create_*、update_*、delete_* に加えて、start_* や attach_* などのドメイン固有の動詞が使われています。デフォルトの eager モードでは、起動時にすべてのツールが登録されます。lazy モードでは、Compute と Object Storage の読み込みをローダーツール経由にします。dynamic モードでは、厳しいツール数上限を設けているクライアント向けに、検索／説明／呼び出しを行う3つのメタツールのみを公開します。ツールの読み込みモードを参照してください。

製品	ツール	機能
Compute Engine	50 + 70 個の書き込みツール	データセンター、サーバー、ボリューム、NIC、LAN、ファイアウォールルール、IP ブロック、ロードバランサー（基本／ネットワーク／アプリケーション）、NAT ゲートウェイ、セキュリティグループ、プライベートクロスコネクト、スナップショット、イメージ、テンプレート、ロケーション、リクエスト、契約
Kubernetes	8 + 8 個の書き込みツール	クラスター、ノードプール、ノード、利用可能なバージョン
Object Storage	23	バケット、バケット設定（CORS、暗号化、ライフサイクル、ポリシー、パブリックアクセスブロック、レプリケーション、タグ付け、バージョニング、Object Lock）、オブジェクト、アクセスキー、リージョン
DNS	14 + 16 個の書き込みツール	ゾーン、ゾーンファイル（BIND インポートを含む）、レコード、逆引きレコード、セカンダリーゾーン（ゾーン転送を含む）、DNSSEC、クォータ
Billing	15	プロファイル、請求書、EVN（プロビジョニング間隔）、トラフィック、使用状況、利用率、製品価格カタログ、FOCUS v1.3 仕様
Certificate Manager	6 + 8 個の書き込みツール	証明書、自動証明書、プロバイダー
Activity Log	2	契約、イベント

読み取り専用ツールは118個、さらに Compute Engine、Kubernetes、DNS、Certificate Manager でオプトインの書き込みツールを102個利用できます。書き込み操作を参照してください。ツールごとの入出力スキーマについては、製品別ドキュメントまたは docs.ionos.com の完全版ツールリファレンスを参照してください。

インストール

ワークフローに合った方法を選んでください。

Homebrew（macOS、Linux）— 推奨

brew install ionos-cloud/ionos-cloud/ionoscloud-mcp

Docker（linux/amd64、linux/arm64）

docker pull ghcr.io/ionos-cloud/ionoscloud-mcp:latest

MCP stdio トランスポート（デフォルト）で実行します。

docker run -i --rm \
  -e IONOS_TOKEN="$IONOS_TOKEN" \
  ghcr.io/ionos-cloud/ionoscloud-mcp

または HTTP 経由で実行します（Wire トランスポートを参照）。

docker run --rm -p 8080:8080 \
  -e IONOS_TOKEN="$IONOS_TOKEN" \
  ghcr.io/ionos-cloud/ionoscloud-mcp --transport http --http-addr :8080

Smithery

npx -y @smithery/cli install @ionos-cloud/ionoscloud-mcp --client claude-desktop

対応する --client の値：claude-desktop、claude-code、cursor、vscode、windsurf、cline、continue、gemini-cli、kiro など。最新の一覧はSmithery の掲載ページを参照してください。

ビルド済みバイナリ

使用する OS／アーキテクチャに対応するアーカイブを最新リリースからダウンロードしてください。Linux、macOS、Windows の amd64 と arm64 向けに提供されています。

go install

go install github.com/ionos-cloud/ionoscloud-mcp@latest

ソースから

git clone https://github.com/ionos-cloud/ionoscloud-mcp.git
cd ionoscloud-mcp
make build

設定

API 認証情報を持つ IONOS CLOUD アカウントが必要です。

# Required: API token for control-plane APIs (Compute, DNS, Billing, Certificate Manager, Object Storage management)
export IONOS_TOKEN="your-api-token"

# Optional: only required if you use Object Storage data-plane tools
# (listing objects, reading bucket configuration, checking access keys).
export IONOS_S3_ACCESS_KEY="your-s3-access-key"
export IONOS_S3_SECRET_KEY="your-s3-secret-key"

# Optional: opt in to write operations (default: read-only). Values are hierarchical,
# so a single level suffices: "write" allows create/update; "destructive" also allows
# delete (it implies "write"). See "Write operations".
# export IONOS_MCP_TOOL_SCOPE="write"

IONOS CLOUD DCD の Management → Token Management でトークンを生成します。Object Storage の認証情報は Storage & Backup → IONOS CLOUD Object Storage → Key management で作成します。

最小権限のトークンスコープ設定については、docs.ionos.com の認証を参照してください。

MCP クライアントとの連携（手動）

AI クライアントの MCP 設定にサーバーを追加します。

{
  "mcpServers": {
    "ionoscloud": {
      "command": "/path/to/ionoscloud-mcp",
      "env": {
        "IONOS_TOKEN": "your-api-token",
        "IONOS_S3_ACCESS_KEY": "your-s3-access-key",
        "IONOS_S3_SECRET_KEY": "your-s3-secret-key"
      }
    }
  }
}

Object Storage の認証情報が必要なのは、Object Storage ツールを使用する場合のみです。

対応する 12 の AI クライアントそれぞれの設定ガイドについては、docs.ionos.com のAI クライアントへの接続を参照してください。

ツールの読み込みモード

読み込みモードでは、ツールの公開方法を選択します。--load-mode フラグまたは IONOS_MCP_LOAD_MODE 環境変数で設定します。両方が設定されている場合はフラグが優先され、それ以外の場合のデフォルトは eager です。大文字と小文字は区別されません。

• eager（デフォルト）：起動時にすべてのツールを登録します。Claude Code（ToolSearch を介してクライアント側で完全なスキーマの読み込みを遅延し、名前のみで約 1～3k トークンを消費します）に推奨されます。また、notifications/tools/list_changed を無視するクライアント（Claude Desktop、claude.ai connectors、Claude in Chrome、Smithery scanner）で動作する唯一のモードです。

• lazy：Compute と Object Storage は、必要に応じてのみ登録されます。起動時に 2 つのセンチネルツール（ionos_load_compute_tools、ionos_load_objectstorage_tools）が表示され、どちらかを呼び出すと製品の全ツールセットが登録され、notifications/tools/list_changed が送信されます。この通知に対応し、かつクライアント側でスキーマの読み込みを遅延しない MCP クライアントでのみ使用してください。それ以外の場合は eager モードのほうが効率的です。

• dynamic（別名：search）：サーバーが公開するのは、ionos_search_tools、ionos_describe_tools、ionos_call_tool の3 つのメタツールのみです。モデルは実行時にこれらを通じて全カタログを見つけ、呼び出します。実際のツールリストは変更されないため、lazy とは異なり、notifications/tools/list_changed への対応は不要です。ツール数の上限が厳しく、独自のツール検索機能がないクライアント（例：Cursor の約 40 ツールという上限、Windsurf の 100 ツールという上限）を対象としています。トレードオフとして、モデルはツールを直接確認するのではなく、search → describe → call の順に実行する必要があり、追加のラウンドトリップが発生するため、Claude Code では eager を推奨します。

サーバーは起動時に、有効なモードとその設定元（フラグ／環境変数／デフォルト）を stderr に記録します。例：load mode: dynamic (source: --load-mode flag)。

{
  "mcpServers": {
    "ionoscloud": {
      "command": "/path/to/ionoscloud-mcp",
      "args": ["--load-mode", "dynamic"],
      "env": {
        "IONOS_TOKEN": "your-api-token"
      }
    }
  }
}

ツール数の上限： Windsurf では接続された MCP サーバー全体で 100 ツール、Cursor では全サーバーで約 40 ツールに制限されています。デフォルトの eager モードでは、サーバーのツール数がどちらの上限も超えます。Windsurf では lazy を使うと起動時に公開されるツール数を抑えられます。Cursor（または独自のツール検索機能がない、ツール数に上限のあるクライアント）では、ツールを 3 つだけ公開する dynamic を使用してください。詳しくは、ツールの選択的読み込みを参照してください。

通信方式

サーバーはデフォルトで stdio を使用します。これは、サブプロセスを起動するすべての MCP クライアント（Claude Desktop、Claude Code、Cursor、Windsurf など）が想定するモードです。リモート環境やネットワーク経由でのデプロイ（例：サーバーを一元的に実行し、複数のクライアントから接続する場合）では、--transport http または IONOS_MCP_TRANSPORT=http を指定して、Streamable HTTP transport に切り替えてください。両方が設定されている場合は、フラグが優先されます。

./ionoscloud-mcp --transport http --http-addr :8080

• --transport <stdio|http>（または IONOS_MCP_TRANSPORT）— 通信方式を選択します。認識されない値が指定された場合は、警告を出して stdio にフォールバックします。
• --http-addr <addr>（または IONOS_MCP_HTTP_ADDR）— HTTP 通信方式のリッスンアドレスです。デフォルトは 127.0.0.1:8080（ローカルのみ）です。すべてのインターフェースでリッスンするには、:8080 を使用します。stdio では無視されます。

サーバーは起動時に、適用される通信方式とその設定元を stderr に記録します（例：transport: http (source: --transport flag)）。

HTTP モードでは、MCP クライアントの接続先として、Streamable HTTP サーバーの http://<host>:<port>/ を指定します。HTTP エンドポイント自体には TLS や認証機能が組み込まれていません。信頼できるネットワークの外部からアクセス可能にする必要がある場合は、リバースプロキシ（nginx、Caddy など）の背後に配置してください。通信方式にかかわらず、IONOS_TOKEN およびその他の IONOS CLOUD 認証情報は、サーバーから IONOS API への呼び出しを引き続き認証します。

書き込み操作

オプトインするまでは、サーバーは読み取り専用です。 IONOS_MCP_TOOL_SCOPE 環境変数を設定しない限り、書き込みツールは登録されず、tools/list にも表示されません。この制限は dynamic ディスパッチャーを含むすべてのロードモードに適用され、回避する方法はありません。

スコープは、カンマ区切りの階層的な機能セットです（read は常に有効です）。

IONOS_MCP_TOOL_SCOPE	有効になる機能
未設定 / read（デフォルト）	読み取り専用（list_*、get_*、head_*）
write	上記 に加えて、create_*、update_*、および中断を伴わない操作 start_、resume_、attach_、assign_
destructive	上記 に加えて、delete_* および中断を伴う操作 stop_、reboot_、suspend_、upgrade_、restore_、detach_、recreate_、import_（write を含みます）

認識されない値が指定された場合は読み取り専用にフォールバックし、適用されるスコープは起動時に stderr に記録されます。階層構造のため、値は1つで十分です。destructive だけで write と read もすでに有効になります。すべてを列挙する必要はありません（ただし、read,write のようなカンマ区切りのリストも使用できます）。

書き込み可能な内容

分野	リソース
コンピューティング	データセンター、サーバー（起動／停止／再起動／サスペンド／再開／アップグレード）、ボリューム（スナップショットと復元、接続／切断）、NIC、LAN
ネットワーク	IP ブロック（予約、名前の変更、解放）、セキュリティグループとルール、ファイアウォールルール、プライベートクロスコネクト
ロードバランシング	クラシック、ネットワーク、アプリケーションロードバランサーと転送ルール、ターゲットグループ、NAT ゲートウェイとルール
イメージ	スナップショットとイメージの更新／削除
Kubernetes	クラスター、ノードプール（スケール、アップグレード、自動スケーリング、LAN、ラベル、アノテーション、テイント）、個別ノード（再作成、削除）
DNS	プライマリゾーン（BIND ゾーンファイルのインポートを含む）、レコード、セカンダリゾーン（ゾーン転送を含む）、逆引きレコード、DNSSEC の有効化／無効化
Certificate Manager	自動証明書、ACME プロバイダー、証明書の名前変更／削除。名前の変更で変わるのは名前だけで、それ以外は変更できません。証明書データのアップロードは意図的に提供していません。ツールの引数として秘密鍵を渡す必要が生じるためです。

ツールは合計102個です。サーバーはデフォルトの読み取り専用スコープで118個、write で181個、destructive で220個のツールを公開します。読み取り操作への影響はなく、常に利用できます。

2段階確認。 すべての create_* および delete_* と、破壊的な操作（stop_、reboot_、suspend_、upgrade_、restore_、detach_、recreate_）、さらにDNSゾーンファイルのインポートには確認が必要です。最初の呼び出しでは変更は行われず、プレビューが返されます。削除の場合は、破棄される対象の範囲の概要も表示されます。さらに、1回限りの confirmation_token（有効期間5分、対象と操作に紐付け）も返されます。このトークンを付けた2回目の呼び出しでのみ実行されます。これにより、人間が確認に関与し、エージェントが1回の呼び出しで操作できるリソースを1つに制限できます。元に戻せる単一フィールドの変更（update_*、start_、attach_、assign_）は1回の呼び出しで実行できます。

アノテーション。 書き込みツールにはMCPアノテーション（readOnlyHint、destructiveHint、idempotentHint）が付与されており、クライアントは独自の承認UXを構築できます。ただし、強制適用は常にサーバー側で行われます。操作の分類はHTTPメソッドではなく操作自体に基づく点に注意してください。stop_server は破壊的な操作を行う POST であり、import_dns_zone_file はゾーン内のすべてのレコードを置き換える PUT です。

---

⚠️ 書き込み操作は実際のリソースを作成し、実際の料金が発生します

IONOS_MCP_TOOL_SCOPE を有効にすると、AIモデルが稼働中のIONOS CLOUDアカウントに、課金対象となるインフラストラクチャをプロビジョニングできるようになります。 作成されるリソースはすべて実在するもので、実際の請求に直ちに反映されます。

何にも使用されていなくても料金が発生するリソースもあります。予約済みのIPブロック、スナップショット、サーバー削除後も残されたボリュームなどがその例です。削除も同様に現実の操作です。スナップショットがなければ破棄されたデータは復元できず、解放したIPアドレスを再び要求できるとは限りません。

これらのツールをいつ、どのくらいの頻度で呼び出すかは、AIモデルが判断します。 モデルが意図を読み違えたり、予想以上に再試行したり、想定より大きなリソースを選択したりする可能性があります。2段階確認は人間が確認に関与できるようにするものですが、ツール呼び出しを自動承認するよう設定されたクライアントを止めることはできません。その設定では、モデルが単独で両方の段階を完了できます。

これらのツールを通じてアカウント内で作成、変更、削除されたすべてのものと、それに伴う料金については、お客様が責任を負います。 IONOSは、モデルがこれらのツールをどのように呼び出すかを制御せず、その呼び出しによって生じる費用、データ損失、停止についても責任を負いません。

リスクを軽減するには、書き込みが必要な場合を除きサーバーを読み取り専用にし、削除が不要なら destructive ではなく write を付与し、クライアントでツール呼び出しの手動承認を必須にし、確認トークンを返す前にプレビューを読み、実験には本番環境以外のアカウントを使用してください。

---

書き込みを有効にするには、次のようにMCPクライアントの設定を変更してください。

{
  "mcpServers": {
    "ionoscloud": {
      "command": "/path/to/ionoscloud-mcp",
      "env": {
        "IONOS_TOKEN": "your-api-token",
        "IONOS_MCP_TOOL_SCOPE": "destructive"
      }
    }
  }
}

デモ

Claude Desktop またはその他の対応クライアントで、サーバーを設定した後、次のプロンプトのいずれかを試してください。自然言語なら簡単に行えますが、スクリプトで書くのは面倒な複数ステップの調査ワークフローを紹介しています。

• コスト監査： 「IONOS CLOUD アカウントを監査し、今月コストが最も高いリソースを上位 5 件見つけて、コスト効率を高めるためのヒントを提案してください。」
• セキュリティチェック： 「パブリックアクセスブロックがオフ、またはポリシーがパブリックになっているバケットをすべて一覧表示し、意図しない設定と思われるものにフラグを付けてください。」
• 監査証跡： 「過去 30 日間にコントラクトで発生した API リクエストの失敗をすべて、ユーザーごとにまとめて表示してください。」
• 忘れられたリソース： 「すべてのデータセンターから、接続されていないボリューム、未使用の IP ブロック、停止中のサーバーを見つけてください。」
• DNS の健全性チェック： 「アカウント内のすべてのゾーンを一覧表示し、DNSSEC が有効になっていないものや、所有していない IP を参照しているレコードがあるものにフラグを付けてください。」
• 証明書の有効期限： 「アカウント内で、今後 60 日以内に有効期限が切れる証明書はどれですか？」
• トラフィック急増の調査： 「前回の請求額がいつもより高くなっていました。前回の請求期間の日ごとのトラフィックと利用状況を表示し、何が変わったのか教えてください。」
• オンボーディングツアー： 「新しいチームメイトに説明するように、IONOS CLOUD で稼働中のもの、つまりデータセンター、サーバー、ストレージ、DNS を案内してください。」

各プロンプトは複数の list_* および get_* 呼び出しを連鎖させ、チケット、ダッシュボード、ドキュメントに貼り付けられる要約を生成します。最初から最後までの手順については、次をご覧ください。

• IONOS CLOUD Object Storage バケットのセキュリティ態勢監査を実施する
• FOCUS 準拠のコストレポートを生成する

開発

MCP プロトコルをローカルでテストする

標準入力／標準出力を使用して、サーバーの MCP プロトコル実装をテストできます。

# Initialize and list tools
{
  echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1.0"}}}'
  echo '{"jsonrpc":"2.0","method":"notifications/initialized"}'
  echo '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
  sleep 1
} | ./ionoscloud-mcp

# Call a tool (requires a valid IONOS_TOKEN)
{
  echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1.0"}}}'
  echo '{"jsonrpc":"2.0","method":"notifications/initialized"}'
  echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_datacenters","arguments":{}}}'
  sleep 1
} | ./ionoscloud-mcp

ソースからビルドする

make build
# or
go build -o ionoscloud-mcp .

引数なしで make を実行すると、利用可能なターゲットが表示されます。

関連プロジェクト

• IONOS CLOUD MCP Server 製品ドキュメント — 製品の完全なドキュメント
• IONOS CLOUD AI Model Hub — ドイツでホストされるオープンウェイト LLM。このサーバーと組み合わせることで、完全に EU の主権下にある AI ループを実現できます
• IONOS CLOUD Documentation MCP — AI アシスタントに IONOS のドキュメントサイトを公開する、無料のパブリック MCP サーバー

貢献

Issue とプルリクエストを歓迎します。開発環境のセットアップ、コードスタイル、テスト手順については、CONTRIBUTING.md をご覧ください。質問やディスカッションには、GitHub Discussionsをご利用ください。

セキュリティ

セキュリティ上の脆弱性を発見したと思われる場合は、公開 Issue を作成しないでください。非公開の脆弱性報告を通じて GitHub に非公開で報告するか、[email protected] までメールでご連絡ください。ポリシー全文：SECURITY.md。

変更履歴

リリースごとの主な変更点は CHANGELOG.md に記載されています。各タグとともに公開される成果物（Linux／macOS／Windows バイナリ、マルチアーキテクチャ OCI イメージ）については、GitHub Releases ページをご覧ください。

API ドキュメント

IONOS CLOUD API の詳細については、次をご覧ください。

• IONOS CLOUD API ドキュメント
• API 仕様
• SDK ドキュメント

ライセンス

Apache License 2.0 — LICENSE をご覧ください。