infomaniak-mcp-agent

infomaniak-mcp-agent

ClaudeからInfomaniakアカウント全体を操作できます。エージェント型、2フェーズコミット、オープンソースです。

infomaniak-mcp-agentは、スイスの主権クラウドであるInfomaniakの全機能を、LLMが直接呼び出せる78個のツールとして公開する、非公式のModel Context Protocolサーバーです。ウェブホスティング、メール（kSuite）、kDrive、ドメイン、DNS、DNSSEC、FTP/SSHユーザー、AI製品、アカウント監査などに対応しています。破壊的な操作はすべて厳格な2フェーズコミットを経由するため、エージェントがアカウント上のデータを気付かれないまま削除したり変更したりすることはありません。

You → Claude:  "audit the example.com hosting and tell me which mailboxes are over quota"
Claude → MCP:  infomaniak_audit_account → infomaniak_list_mail_hostings → infomaniak_list_mailboxes
Claude → You:  3 mailboxes >85% — paul@ (94%), notify@ (88%), team@ (87%). Want me to add an alert?

目次

• 概要 · できること · 他との違い
• インストール · 認証 · 使用例
• ツール（22分野にわたる78個） · 制限事項 · ロードマップ · FAQ
• コントリビューション · ライセンス

概要

Infomaniakは、ヨーロッパでも数少ない独立系でスイス資本の、オープンソースに親和的なクラウドプロバイダーの一つです。スイス国内の自社データセンターを水力と風力で稼働させ、米国や中国の親会社もありません。製品ラインナップは幅広く（ウェブホスティング、メール、kDrive、kChat、DNS、AIクラウド、Swiss Backupなど）、APIはドキュメント化された公開インターフェースと、マネージャー専用の非公開インターフェースに分かれています。そのため、実際のワークフローを自動化するには、通常ブラウザーのセッションや独自スクリプト、あるいはその両方が必要です。

このプロジェクトは、すべての機能を単一のMCPサーバーを通じて公開することで、その隔たりを埋めます。ClaudeなどのMCPクライアントは、自然言語を使って実際のアカウント操作を実行できます。チャットから離れたりスクリプトを書いたりすることなく、ホスティングの提供、DNSレコードの更新、メールボックスの作成、ドメインの有効期限が近いものの監査、kDriveの閲覧などが可能です。

🎒 バイブコーディングで、開発の様子をリアルタイムに公開しながら構築

このプロジェクトは、LLM がターミナルセッションを操作する「バイブコーディング」によって、実際の Infomaniak アカウントで各段階のライブテストを行いながら、短期間で構築されました。メンテナーのローカル環境では完璧に動作し、パイプライン全体（TypeScript strict、ESLint、Prettier、78 件のテスト、ビルド、CodeQL、gitleaks）もすべて成功しています。

とはいえ、開発方法に加え、ここで使用している複数のエンドポイントがリバースエンジニアリングされたものであること（REVERSE-ENGINEERING.md を参照）を踏まえると、アカウント構成、プランの種類、スコープ、または Infomaniak 側の変更によっては、（重大なものを含む）バグに遭遇する可能性が十分にあります。問題が発生したら修正します。ぜひご協力ください。

1. 使用したツール呼び出し、入力、レスポンス、環境（Node のバージョン、OS、MCP クライアント）を正確に記載して、Issue を作成してください。貼り付ける前にトークン／Cookie／顧客名を伏せてください。
2. さらに望ましいのは、失敗するテストを含む PR を送っていただくことです。そこから一緒に対応します。

迅速に開発し、頻繁にリリースしています。遠慮なくお知らせください。

⚠️ ステータス：非公式

このプロジェクトは、Infomaniak Network SA とは提携、承認、後援のいずれも受けていません。コミュニティ主導のツールで、次のものを組み合わせています。

1. Infomaniak の公開 API（api.infomaniak.com）。ご自身で生成した Bearer トークンを使います。
2. リバースエンジニアリングされた manager エンドポイント（manager.infomaniak.com/proxy/...）。公開 API が黙って無視する、ウェブホスティング上の書き込み操作に必要です。

詳細をすべて把握するには、REVERSE-ENGINEERING.md をお読みください。Infomaniak は予告なくこれらのエンドポイントを変更する可能性があります。可能な限り追従しますが、長期的な互換性は保証できません。

できること

インストールすると、Claude に次のようなことを尋ねられます。

• 「アカウント内で60日以内に有効期限を迎えるドメインをすべて、有効期限順に一覧表示して。」
• 「ホスティング WP1234567 に、PHP 8.3 を使用し、ルートを /sites/staging に設定した新しいサイト staging.example.com を作成して。」
• 「example.com に新しい Postmark DKIM 用の TXT レコードを追加して、名前解決を確認して。」
• 「データベース myprefix_wp123456 のディスク使用量と、接続されているアプリケーションを教えて。」
• 「16文字のランダムなパスワードでメールボックス [email protected] を作成し、自分の Gmail に転送して。」
• 「自分が管理者になっている kDrive と、その使用状況を表示して。」
• 「アカウント全体を監査して。ロックされた製品、有効期限が近い SSL、壊れた DNSSEC、進行中の操作はある？」
• 「このセッションで最後に行った DNS の変更を取り消して。」

破壊的な変更が黙って行われることはありません。すべての変更は、計画＋確認トークンの往復を経て実行されます。モデルが独創的な動きをしても、主導権はあなたにあります。

「ラッパー」ではなく「エージェント型」である理由

多くの MCP サーバーは、HTTP エンドポイントごとにツールを1つ公開して、それで完了です。このプロジェクトは異なる設計を採用しています。

• ガイド付きの対話 — サイトの作成では、あらかじめ適切なツール呼び出しを把握しておく必要はなく、「どの組織ですか？」「どのホスティングですか？」「ルートドメインですか、サブドメインですか？」「種類は？」「内容を確認しますか？」と順に案内します。
• 二段階コミット — 破壊的な操作はすべて、使い捨ての確認トークン（有効期間60秒）を含む計画を返します。トークンを指定して呼び出し直すまで、変更は行われません。
• 事前チェック — API を呼び出す前に、競合（既存の FQDN、使用中のホスティング、期限切れのドメイン）がないかサーバーが確認します。
• 実行可能なエラー情報 — エラーには、何が起きたのか、なぜ起きたのか、次に何をすればよいのかが示されます。
• イントロスペクション — infomaniak_overview、infomaniak_help、infomaniak_explain によって、ツールのカタログを暗記させることなく、必要に応じてエージェントにコンテキストを提供します。
• セッションメモリ — infomaniak_history は現在のセッションで行った破壊的な操作をすべて一覧表示し、infomaniak_undo は取り消し可能な操作を元に戻します。

設計の根拠については、ARCHITECTURE.md を参照してください。

インストール

npm で利用できます。推奨される方法は、npx に必要なときに最新リリースを取得させることです。

npx infomaniak-mcp-agent

（インストール手順は不要です。初回の実行時に npx が最新バージョンを解決してキャッシュします）。

または、$PATH に安定したバイナリを配置したい場合は、グローバルにインストールします。

npm install -g infomaniak-mcp-agent

特定のコミットに固定する場合（またはソースを変更する場合）は、このリポジトリからインストールします。

git clone https://github.com/Mogacode-ma/infomaniak-mcp-agent.git
cd infomaniak-mcp-agent
npm ci
npm run build
# resulting binary: ./dist/server.js

Claude Desktop の設定

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %AppData%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "infomaniak": {
      "command": "npx",
      "args": ["-y", "infomaniak-mcp-agent"],
      "env": {
        "INFOMANIAK_API_TOKEN": "paste-your-token-here",
        "INFOMANIAK_AUTH_MODE": "auto"
      }
    }
  }
}

変更を反映するため、Claude Desktop を再起動します。

Claude Code の設定

claude mcp add infomaniak \
  -e INFOMANIAK_API_TOKEN=paste-your-token-here \
  -e INFOMANIAK_AUTH_MODE=auto \
  -- npx -y infomaniak-mcp-agent

認証

Infomaniak は 2 つの API を並行して提供しているため、別々の認証情報が必要です。

API	認証	用途
api.infomaniak.com/{1,2}/...	Bearer トークン	主に読み取り：プロフィール、製品、メール、ドライブ、DNS、ドメイン、請求
manager.infomaniak.com/proxy/...	SASESSION Cookie + CSRF トークン	Web ホスティング（サイト、データベース、アプリケーション）への書き込み

1. Bearer トークン（必須）

1. Infomaniak アカウントにサインインします。
2. manager.infomaniak.com/v3/ng/profile/user/token/list に移動します。
3. **「Create a token」**をクリックし、有効期間を長めに設定して、値をコピーします。
4. INFOMANIAK_API_TOKEN に設定します。

2. Manager セッション（自動、推奨）

Manager のプライベート API は Bearer トークンや OAuth を受け付けません（Infomaniak はサードパーティアプリに openid profile email phone スコープのみを公開しており、web、mail などは対象外です）。代わりに、manager.infomaniak.com にログインしたときにローカルの Chrome がすでに保持している SASESSION Cookie と MANAGER-XSRF-TOKEN Cookie を読み取ります。

INFOMANIAK_AUTH_MODE=auto（デフォルト）の場合、MCP は chrome-cookies-secure を使用して、必要に応じてこれらの Cookie を読み取ります。ディスクに書き込まれることはありません。Cookie は 1 回の操作の間だけメモリ上に保持されます。

セッションの有効期限が切れたら、Chrome で manager.infomaniak.com を再読み込みしてください。次回の呼び出し時に、MCP が新しい Cookie を取得します。

3. Manager セッション（手動での代替方法）

ヘッドレス環境での使用やトラブルシューティングの場合：

INFOMANIAK_AUTH_MODE=manual
INFOMANIAK_SASESSION=...
INFOMANIAK_XSRF_TOKEN=...

コピーするには、manager.infomaniak.com で Chrome DevTools を開き、Application → Cookies に移動して、SASESSION と MANAGER-XSRF-TOKEN をコピーします（URL エンコードされた値をそのまま貼り付けてください。MCP がデコードします）。

簡単な使用例

一般的な最初の会話の一連の流れ：

You:    What's on my account?
Claude: [calls infomaniak_overview]
        You have 16 organizations, 311 products: 47 web hostings, 73 domains,
        12 mail hostings, 3 kDrives, 2 AI Tools subscriptions.

You:    Any domain expiring soon?
Claude: [calls infomaniak_audit_account on each org]
        2 domains expire in <30 days: example.com (April 22), demo.org (May 04).
        4 SSL certificates were auto-renewed in the last 7 days. No locked products.

You:    Create a TXT record on example.com saying "v=spf1 include:spf.example.net ~all".
Claude: [calls infomaniak_dns_create_record → returns plan + token]
        Plan: CREATE TXT record on example.com → "v=spf1 include:spf.example.net ~all", TTL 3600.
        Confirm with token abc-123 within 60 s.

You:    Confirm.
Claude: [calls infomaniak_dns_create_record again with the token]
        Done. Record id 84219113. Logged in session history (undoable).

ツール

22 の分野にわたる 78 個のツールがあります。infomaniak_help で目的に合ったツールをあいまい検索するか、infomaniak_explain でツールの完全な JSON スキーマを出力します。

内省（まずはこちら）

ツール	注釈	用途
infomaniak_overview	読み取り専用	組織と製品の概要です。最初に呼び出すのに最適です。
infomaniak_help	読み取り専用	自由形式の目的（「サイトを作成」「メールボックスを一覧表示」など）に合うツールを提案します。
infomaniak_explain	読み取り専用	指定したツールの定義全体（説明とスキーマ）を返します。
infomaniak_audit_account	読み取り専用	組織をスキャンし、有効期限切れ、ロックされた製品、進行中の操作を確認します。
infomaniak_history	読み取り専用	このセッションで実行された破壊的な操作を一覧表示します。
infomaniak_undo	破壊的	取り消し可能なセッション内の操作を元に戻します（二段階コミット）。

組織と製品

ツール	注釈	用途
infomaniak_list_organizations	読み取り専用	技術的なアクセス権を持つアカウントです。
infomaniak_list_hostings	読み取り専用	1 つの組織の Web ホスティング（標準および Node.js）です。
infomaniak_list_domains	読み取り専用	1 つの組織のドメインと、その作成日および有効期限です。
infomaniak_get_domain	読み取り専用	1 つのドメインの詳細（DNS 管理の有無、DNSSEC、エラー）です。

ウェブホスティングサイト

ツール	注釈	目的
infomaniak_find_site	読み取り専用	ドメイン優先の検索。 公開ドメイン（例：example.com）を {account_id, hosting_id, hosting_label, site_id, full site object} に解決します。hosting_id + site_id が必要なツールを使う前に必ず実行してください。実際のホスティング環境では、すべてのホスティングに対して list_sites を順に呼び出す方法（API 呼び出しが 46 回以上必要）に代わるものです。
infomaniak_list_sites	読み取り専用	指定したウェブホスティング上のサイト（アプリケーションを含む）を一覧表示します。
infomaniak_create_site	破壊的	2 段階方式です。プランとトークンを返し、トークンを指定した 2 回目の呼び出しで実際に作成します。
infomaniak_delete_site	破壊的	2 段階方式で削除します（削除対象サイトの全情報をプレビュー表示します）。

サイトエイリアス

既存サイトの Apache 仮想ホスト／DocumentRoot に紐付ける追加の FQDN です。新しいサイトを用意せず、1 つのインストール環境から複数のドメインを提供できます。

ツール	注釈	目的
infomaniak_list_site_aliases	読み取り専用	サイトに紐付けられた FQDN（メインとエイリアス）を一覧表示します。
infomaniak_add_site_aliases	破壊的	1 つ以上の FQDN を紐付けます（*.example.com のようなワイルドカードを使用できます）。2 段階方式です。非同期で実行され、progress_id を返します。数秒後にエイリアスが list_site_aliases に表示されます。
infomaniak_delete_site_alias	破壊的	エイリアス FQDN を 1 つ紐付け解除します（メイン FQDN は削除できません）。2 段階方式です。

SSL 証明書

ツール	注釈	目的
infomaniak_get_certificate	読み取り専用	現在の証明書の状態（updating／ok／error）、発行者、有効期限、ACME 識別子のエラーを取得します。
infomaniak_request_certificate	破壊的	2 段階方式です。証明書を発行または更新します。type は free（Let's Encrypt）、paid（Sectigo、certificate_id が必要）、custom（持ち込み PEM、certificate と private_key が必要）の 3 種類です。
infomaniak_delete_certificate	破壊的	2 段階方式です。サイトから証明書を削除します。type: "free" を指定して request_certificate を実行すると元に戻せます。

データベース

ツール	注釈	目的
infomaniak_list_databases	読み取り専用	ホスティングに紐付けられた MariaDB データベース（ディスク使用量を含む）を一覧表示します。
infomaniak_get_database	読み取り専用	1 つのデータベースの詳細を取得します。
infomaniak_create_database	破壊的	2 段階方式で作成します。
infomaniak_delete_database	破壊的	2 段階方式で削除します（プランにディスク使用量と紐付けられたアプリケーションが表示されます）。
infomaniak_list_database_users	読み取り専用	ホスティングに紐付けられた MariaDB レベルのユーザーアカウント（applications、permissions、phpMyAdmin リンク）を一覧表示します。
infomaniak_get_database_user	読み取り専用	1 人の MariaDB ユーザーの詳細を取得します。
infomaniak_change_database_user_password	破壊的	MariaDB ユーザーのパスワードをローテーションし、権限をアトミックに再宣言します。2 段階方式です。
infomaniak_change_database_user_permissions	破壊的	ユーザーがアクセスできるデータベースを変更します（データベースごとに読み取り／書き込み／管理を設定）。パスワードは変更しません。2 段階方式です。

⚠️ どちらのツールも grants 配列を受け取り、ユーザーがアクセスできるすべてのデータベースを宣言します。指定されていないものはすべてアクセス不可に設定されます。最初に infomaniak_get_database_user を呼び出して現在の permissions をコピーしてください。そうしないと、アクセス権が通知なく取り消されます。これは意図的な仕様であり、権限を取り消す正規の方法でもあります。

これらのツールは、意図的に公開 API ではなくマネージャー専用エンドポイントを使用します。公開 API の PATCH /1/web_hostings/{id}/database_users/{user} はパスワードを受け取り、変更したうえで、permissions と applications を通知なく消去します。詳細は REVERSE-ENGINEERING.md §Database users を参照してください。

SSH 経由で MariaDB の ALTER USER／SET PASSWORD を直接実行するより、これらのツールを優先してください。ホスティングのデータベース認証情報の正はマネージャーです。MariaDB だけで設定したパスワードは、マネージャーの値と通知なく食い違い、次回の Infomaniak メンテナンス時にマネージャーの値へ戻されます。次回のメンテナンスは数か月後になる場合もあり、変更との関連が分からないこともあります。

FTP / SSH ユーザー

ツール	注釈	目的
infomaniak_list_hosting_users	読み取り専用	ウェブホスティング上の FTP / SSH ユーザーです。
infomaniak_create_hosting_user	破壊的	connection_type に ftp（SFTP のみ）または ssh（フルシェル + FTP）を指定して、2 段階で作成します。
infomaniak_change_hosting_user_password	破壊的	FTP/SSH ユーザーのパスワードを変更します。2 段階で実行します。現在の connection_type を渡すと、その設定を変更せずに維持できます。
infomaniak_change_hosting_user_connection_type	破壊的	ユーザーを ftp と ssh の間で昇格／降格します。パスワードは変更されません。2 段階で実行します。
infomaniak_delete_hosting_user	破壊的	2 段階でアクセス権を取り消します（ファイルは保持されます）。

DNS と DNSSEC

ツール	注釈	目的
infomaniak_dns_list_records	読み取り専用	Infomaniak が管理するゾーンのすべての DNS レコードです。
infomaniak_dns_create_record	破壊的	2 段階でレコード（A、AAAA、CNAME、MX、TXT、SRV、NS、CAA、PTR、SPF）を作成します。
infomaniak_dns_update_record	破壊的	2 段階で更新します（計画に現在の値と提案値の差分を表示します）。
infomaniak_dns_delete_record	破壊的	2 段階でレコードを削除します（確定前に全内容をプレビューできます）。
infomaniak_manage_dnssec	混合	DNSSEC を一元管理します。action: check（読み取り専用、KSK/DS レコードの確認）、action: enable または action: disable（2 段階の確定を伴う破壊的操作）を指定します。v0.9 の dnssec_check / dnssec_enable / dnssec_disable の 3 つのツールを置き換えます。

メール

ツール	注釈	目的
infomaniak_list_mail_hostings	読み取り専用	1 つの組織のメールホスティングです。
infomaniak_list_mailboxes	読み取り専用	指定したメールホスティング上のメールボックスです。
infomaniak_get_mailbox_info	読み取り専用	メールボックス情報を一元的に取得します。fields: ["aliases" | "signatures" | "backups"]（一部またはすべて）を渡します。並列で取得し、セクションごとのエラーを個別に返します。v0.9 の get_mailbox_aliases / get_mailbox_signatures / get_mailbox_backups の 3 つのツールを置き換えます。
infomaniak_create_mailbox	破壊的	パスワードポリシーを適用して、2 段階で作成します。
infomaniak_delete_mailbox	破壊的	2 段階で削除します（保存されているメールも消去されます）。
infomaniak_create_mailbox_alias	破壊的	2 段階でメールボックスにエイリアスを追加します。
infomaniak_list_redirections	読み取り専用	サーバー側のメール転送ルールです。
infomaniak_create_redirection	破壊的	name@… を N 個の宛先に転送するルールを、2 段階で作成します。
infomaniak_delete_redirection	破壊的	2 段階でルールを削除します。

ID（「自分は誰ですか？」）

ツール	注釈	目的
infomaniak_get_my_profile	読み取り専用	氏名、メールアドレス、言語、国、タイムゾーン、現在のアカウント、セキュリティ状況（2FA、デバイス、最終ログイン）です。
infomaniak_get_my_security	読み取り専用	セキュリティに特化したレポートです。2FA の方式とステータス、復旧用メールアドレス、確認済みの電話番号、Yubikey、緊急用コード、パスワードの使用期間、IP アドレス／時刻付きの信頼済みデバイスを確認できます。

アカウント / 組織（詳細）

ツール	注釈	目的
infomaniak_get_account_full	読み取り専用	組織の詳細情報です。法人、請求先住所、VAT、ロケール、サポートレベル、2FA 必須ポリシー、自分の役割、タグを確認できます。
infomaniak_list_teams_and_tags	読み取り専用	チーム（オーナーと件数）とタグ（各タグが付与された製品）を 1 回の呼び出しで取得します。

メール（詳細）

ツール	注釈	目的
infomaniak_get_mail_hosting_full	読み取り専用	DNS の健全性診断（MX/SPF/DKIM/DMARC）、クォータ、管理者、親 kSuite へのリンク、FQDN、チームのアクセス権を確認できます。
infomaniak_get_mailbox_full	読み取り専用	自動応答、エイリアス、IMAP/POP3 の最終ログイン、パスワードの使用期間、メールボックスのサイズ、デバイス、DKIM、SMTP の禁止設定、メールフィルタリング（広告／ソーシャル）、許可／ブロックした送信者を確認できます。

ドメイン（詳細）

ツール	注釈	目的
infomaniak_get_domain_full	読み取り専用	auth_code（EPP）、移管／取引ステータス、グルーレコード、TLD／レジストリ、関連付けられたサービス、DNS の詳細とヘルス状態、関連製品、DNS ログの URL。ID または FQDN を指定できます。

kDrive（詳細、マネージャー専用）

ツール	注釈	目的
infomaniak_get_drive_full	読み取り専用	ドライブ名、合計サイズ、使用済みサイズ、メンテナンス。
infomaniak_list_drive_users	読み取り専用	kDrive へのアクセス権を持つユーザー（アクセス監査用）。
infomaniak_list_drive_trash	読み取り専用	削除日時付きのゴミ箱内のアイテム。

VPS／Cloud Server

ツール	注釈	目的
infomaniak_list_vps	読み取り専用	組織の Cloud Server（Jelastic）製品の一覧。
infomaniak_get_vps_full	読み取り専用	データセンター、IP、CPU／RAM、帯域幅とトラフィック、ディスク使用量、MySQL／PHP のバージョン、ファイアウォール、プレミアムサポートの連絡先、移行履歴。

Node.js アプリ（Cloud Server hosting_3）

ツール	注釈	目的
infomaniak_list_nodejs_apps	読み取り専用	Node.js ホスティング上のアプリを検出します。各アプリの vhost_route_id（ほかのすべての Node.js ツールで使用する識別子）と、サービスを提供する FQDN を返します。
infomaniak_get_nodejs_app	読み取り専用	アプリの全設定：Node のバージョン、リッスンポート、start_command、build_command、パブリック IP（v4 + v6）、SSL の状態、ディレクトリ、ストレージのクォータ。
infomaniak_nodejs_app_status	読み取り専用	現在のステータス（Running または Stopped）。負荷が低く、安全にポーリングできます。
infomaniak_nodejs_app_aliases	読み取り専用	アプリを提供するすべての FQDN（プライマリ + 自動生成される xxx.preview.hosting-ik.com）。
infomaniak_nodejs_app_jobs	読み取り専用	最近のジョブ（ビルド／再起動／…）と、ジョブごとの log_stream JWT。
infomaniak_nodejs_app_logs	読み取り専用	実行中のアプリのライブ stdout/stderr ストリームを取得するための、有効期間の短い JWT と SSE エンドポイント URL を返します。
infomaniak_nodejs_app_thumbnail	読み取り専用	ライブページのスクリーンショットを base64 JPEG として返します。HTTP プローブを使わずに視覚的なスモークテストを実行できます。
infomaniak_nodejs_app_action	破壊的	2 段階方式です。起動／停止／再起動／ビルドを実行します。stop は start による取り消し操作を記録します。build は、起動されたジョブの resource_id と、出力を追跡するためのライブ log_stream を返します。

すべての Node.js ツールはマネージャー専用です（公開 Bearer API が公開するのは、Node.js ホスティングの状態確認のみです）。INFOMANIAK_AUTH_MODE=auto（Chrome の Cookie）または manual（SASESSION + MANAGER-XSRF-TOKEN 環境変数）が必要です。REVERSE-ENGINEERING.md §Node.js DevOps を参照してください。

kDrive

ツール	注釈	目的
infomaniak_list_drives	読み取り専用	アカウントがアクセスできるすべての kDrive（クォータ付き）。
infomaniak_list_drive_files	読み取り専用	ドライブのルートまたは任意のフォルダーにあるファイル／サブフォルダーをページ分割して一覧表示します。

URL 短縮サービス

ツール	注釈	目的
infomaniak_list_short_urls	読み取り専用	ドメインに設定された短縮 URL。
infomaniak_short_urls_quota	読み取り専用	ドメインで使用済み／利用可能な短縮 URL のクォータ。
infomaniak_create_short_url	破壊的	2 段階方式で作成します。

Swiss Backup

ツール	注釈	目的
infomaniak_list_swiss_backups	読み取り専用	アカウントの Swiss Backup スロット。

AI ツール

ツール	注釈	目的
infomaniak_list_ai_products	読み取り専用	アカウントが所有する AI サブスクリプション。
infomaniak_list_ai_models	読み取り専用	スイス主権型 LLM／STT モデルの公開カタログ。

ワークフロー（複数ステップ）

ツール	注釈	目的
infomaniak_provision_site_full	破壊的	計画してから適用する、オーケストレーションされた一連のフローで、サイト + DB + DNS を構成します。
infomaniak_audit_dns_zones	読み取り専用	ゾーン横断監査：SPF／DMARC の欠落、参照先のないレコード、…。

エスケープハッチ（その他すべて）

ツール	注釈	目的
infomaniak_api_call	破壊的	api.infomaniak.com の任意のエンドポイントに直接アクセスします。GET は即座に実行され、POST／PUT／PATCH／DELETE は2段階コミットに従います。ドキュメントに記載されている /{1,2,3}/... 名前空間の範囲外のパスと、マネージャー専用の /proxy/... は拒否します（型指定されたツールを使用してください）。

制限事項

• api.infomaniak.com には1分あたり60リクエストの厳格なレート制限があります。MCP はトークンバケット方式で自動的にスロットリングします。短時間に大量のリクエストを送ると、短いキュー待ちが発生します。これは意図的な動作であり、トークンがブラックリストに登録されないよう保護します。
• サイトの作成時、/sites/ 以外では directory を指定できません。マネージャーのバックエンドで必須です（指定しても無視されます。詳しくは REVERSE-ENGINEERING.md を参照してください）。
• マネージャーのセッション Cookie は期限切れになります（通常は数時間ごと、または Chrome からサインアウトしたとき）。manager.infomaniak.com を再度開いて更新してください。
• ホスティングごとに同時に実行できる操作は1つです。Infomaniak は、同じホスティングに対する同時 POST を 400 operation_in_progress で拒否します。MCP はホスティングごとに書き込み呼び出しを順番に処理します。
• WordPress のインストールは意図的に対象外です。 この MCP で空のサイトを作成し、マネージャーのウィザードから WP をインストールしてください（applications/add のフローはステップごとに未公開のウィザードを使用しており、現時点では安定した自動化が困難です）。

ロードマップ

v0.7 でリリース済み（現行）

• ✅ Web ホスティング：サイト、データベース、FTP／SSH ユーザーの一覧表示・作成・削除
• ✅ DNS：レコードの完全な CRUD、DNSSEC の有効化・無効化・確認
• ✅ メール：メールボックス、エイリアス、署名、バックアップ、転送の CRUD
• ✅ kDrive：ドライブの一覧表示とファイルの閲覧
• ✅ Swiss Backup：スロットの一覧表示
• ✅ AI Tools：製品と公開モデルカタログの一覧表示
• ✅ URL 短縮：完全な CRUD
• ✅ アカウント監査：有効期限が近いドメイン、ロックされた製品、進行中の操作
• ✅ ワークフローツール：provision_site_full、audit_dns_zones
• ✅ undo／history セッションツール
• ✅ ドキュメントに記載された任意のエンドポイント用の汎用 API エスケープハッチ

次期（v0.8 以降）

• ⬜ kDrive の書き込み：アップロード、ダウンロード、移動、共有、アーカイブ
• ⬜ ニュースレター：キャンペーン、連絡先（現時点では未対応）
• ⬜ kChat：チャンネル、スレッド、投稿（公開 API がまだないため、リバースエンジニアリングが必要）
• ⬜ ワークフロー：provision_wordpress_site（不安定なマネージャーのウィザードに依存しない WP インストール方法が必要）
• ⬜ Swiss Backup の書き込み：スロットの作成、スケジュール、復元
• ⬜ ツールごとの正常系テストを追加し、カバレッジを35%から70%に引き上げる
• ⬜ Claude Desktop へのワンクリックインストール用 MCPB パッケージング

FAQ

Infomaniak の公式製品ですか？

いいえ。コミュニティ主導の MIT ライセンス製品であり、Infomaniak Network SA とは提携関係になく、同社からの承認やスポンサーも受けていません。免責事項については NOTICE と REVERSE-ENGINEERING.md を参照してください。

Claude 以外のクライアントでも動作しますか？

はい。標準の Model Context Protocol を stdio 経由で使用するため、MCP 対応クライアントであれば動作します。Claude Desktop、Claude Code、Cursor、Cline、Continue、Zed AI のほか、デバッグ用の MCP Inspector にも対応しています。

Infomaniak のトークン／セッションがマシンの外部に送信されることはありますか？

いいえ。サーバーはローカルで stdio 経由で動作します。Bearer トークンは INFOMANIAK_API_TOKEN（環境変数または .env）から読み込まれ、api.infomaniak.com の呼び出しにのみ使用されます。Chrome の Cookie（SASESSION、MANAGER-XSRF-TOKEN）は1回のツール呼び出しの間だけメモリ上に保持され、永続化されることはありません。ログでは、トークン、Cookie、パスワードなど、すべての機密情報がマスクされます。

セルフホストや macOS 以外での実行に対応していますか？

はい。INFOMANIAK_AUTH_MODE=manual を設定すると、Cookie を環境変数に直接貼り付けられます。Linux サーバー、Docker コンテナ、CI ではこの方法を使用してください。Chrome からの自動抽出は、Chrome がローカルにインストールされていれば macOS、Windows、Linux で動作します。

サイトの作成に公開 API ではなく、マネージャー専用のエンドポイントを使用するのはなぜですか？

公開 POST /1/products/{id}/web_hostings/{hid}/sites エンドポイントは、実際には何も作成せずに成功レスポンスを返すためです。マネージャーのバンドルをリバースエンジニアリングしたところ、マネージャー専用のエンドポイントでは force_fqdn: true、directory: /sites/...、environment: apache_php が必要だとわかりました。これらはいずれもドキュメントに記載されていません。詳しくは REVERSE-ENGINEERING.md をご覧ください。

WordPress を自動でインストールできますか？

現時点ではできません。マネージャーの applications/add フローは、各ステップでトークンを必要とする複数ステップのウィザードで、スクリプト化が困難です。推奨する方法は、この MCP で空のサイトを作成してから、マネージャーのウィザードを使うか、FTP／SSH 経由でアップロードして WordPress（またはほかの CMS）をインストールすることです。

ホスト型／SaaS 版はありますか？

ありません。これは設計上の仕様です。このサーバーは、お使いのマシン上でお客様自身の認証情報を使用して動作します。ホスト型 SaaS も、ホスト型プロキシも、テレメトリーもありません。

バグの報告やツールのリクエストはどうすればよいですか？

GitHub の Issue を作成してください。正確なツール呼び出し、入力、レスポンス（トークン、Cookie、顧客名を削除してサニタイズしたもの）、お使いの環境（Node のバージョン、OS、MCP クライアント、プランの種類）を記載してください。失敗するテストを含む PR は特に歓迎します。

Infomaniak 独自の AI ツールについて教えてください

Infomaniak は、Llama、Mixtral、Whisper などのオープンウェイトモデルをホストするスイス主権型 AI クラウドを運営しています。この MCP は infomaniak_list_ai_products と infomaniak_list_ai_models を公開しているため、エージェントは利用可能なものや、お客様のアカウントで公開されているモデルを確認できます。推論エンドポイントは意図的にラップしていません（その用途には OpenAI 互換 API を直接ご利用ください）。

コントリビューション

コントリビューションを歓迎します。CONTRIBUTING.md を読み、CODE_OF_CONDUCT.md に従ってください。セキュリティ上の問題は、SECURITY.md に従って非公開で報告してください。

これで時間を節約できたら

プロジェクトを支援する最も手早い方法は、GitHub で ⭐ を付けることです。他の Infomaniak ユーザーがこのプロジェクトを見つけやすくなり、今後何を作るべきかの参考になります。

ほかにも、次の方法があります。

• バグ、エッジケース、不足しているツールについて、Issue を作成する
• 設計や API に関する質問について、ディスカッションを開始する
• これを使って作ったものを共有する — ぜひお聞かせください

ライセンス

MIT — 商標に関する免責事項については NOTICE をご覧ください。

このプロジェクトは Infomaniak Network SA とは提携していません。「Infomaniak」、「kDrive」、「kChat」、「kMeet」、「kSuite」、「Swiss Backup」は Infomaniak Network SA の商標です。

---

サブスクリプション型 SEO エージェンシー Mogacode が開発：当社の技術。