AIアシスタント — パネル内蔵のアシスタントと、Claude をパネルに接続する方法

Nimbopanel では、AI を 2 つの方法で使えます。どちらもオンにするまではオフのままで、どちらの場合も アシスタントが見られるのは、それを使う人が見てよい範囲だけです。

内蔵アシスタント

利用者は自分の言葉で質問します。たとえば「メールが届かないのはなぜ？」「ディスクはあとどれくらい残っている？」など。 アシスタントはパネルの情報を読み取って答えます。

オンにする方法（管理者）：

1. システム → セキュリティ → パネル内のAIアシスタント を開きます。
2. AI プロバイダー を選びます（下の一覧を参照）。選択肢の横のリンクから、そのプロバイダーでキーを 作成するページに移動できます。
3. そのプロバイダーの API キー を貼り付けます。キーはサーバー上の root だけが読めるファイルに保存され、 二度と表示されません。あなたにも、ほかの誰にも表示されません。プロバイダーを切り替えても、 以前のプロバイダーのキーは引き継がれません。
4. モデルを選びます。一覧にはそのプロバイダーの一般的な名前がいくつか表示され、プロバイダーが 一覧で示すとおりの任意のモデル名を入力することもできます。
5. 使える人を選びます：管理者、リセラー、顧客、チームユーザー。
6. 上限を設定します：1 人あたり 1 日の質問数と、サーバー全体の月間トークン予算です。 予算を使い切ると、アシスタントは翌月まで休止します。
7. アシスタントをオンにする にチェックを入れて保存します。

選べるプロバイダー。 名前付きが 10、それ以外のアドレス用が 2 つあります：

2 つの その他 を選んだ場合は、プロバイダーのドキュメントに記載されているとおりに、プロバイダーの API アドレスをご自身で入力します。アドレスは https:// で始まる必要があります。プレーンな http:// が 受け付けられるのは、このサーバー自身またはプライベートネットワーク（ご自身で動かすモデルサーバー）の 場合だけです。ユーザー名、クエリ、フラグメントを含むアドレスや、クラウドのメタデータ範囲のアドレスは 拒否されます。

正直な限界。 アシスタントは、各プロトコルと同じ動作をする代替のプロバイダーでテストしています。 すべてのベンダーの本番サービスに対してはまだテストしていないため、オンにしたあと、顧客に案内する前に、 1 つ 2 つ質問を試してください。モデル名は頻繁に変わります。プロバイダーがそのモデルを知らないと 答えた場合は、現在の名前を入力してください。

AI プロバイダーの選び方と請求を小さく保つ方法

• 料金は利用量に応じてプロバイダーへ — 費用は質問の数と回答の長さに応じて増えます。料金はよく変わるので、決める前にプロバイダーの料金ページを確認し、プロバイダー側のダッシュボードでも支出の上限を設定してください。Nimbopanel が追加料金を取ることはありません。
• どれを選ぶか — 手間をかけずによい回答を得るには、Anthropic、OpenAI、Google などのホスト型プロバイダーを選びます。1 つのキーで多くのモデルを使うなら OpenRouter。すべての質問を自分のサーバー内にとどめたいなら、そこで Ollama を動かします。質問ごとの料金はかかりませんが、十分なメモリが必要で、小さいモデルは回答が劣ります。プロバイダーは後からいつでも変えられます。
• 小さく始める — 初期の上限（1 人 1 日 30 件、サーバー全体で月 2,000,000 トークン）のまま、最初は管理者だけが使えるようにします。0 は無制限なので、後回しにしてください。
• AI が読めるものを決める — お客様のメッセージをプロバイダーに送りたくない場合は、「サポートチケットを AI サービスに渡さない」にチェックを入れます。最初の質問の前に、全員にプライバシーに関する通知が表示されます。
• お客様に知らせる前に試す — テスト用アカウントでいくつか質問し、提案された変更も 1 つ試してください。承認するときは、承認する人のパスワードが求められます。

できること・できないこと

• アシスタントは質問した本人の権限で読み取ります。顧客のアシスタントにはその顧客のアカウントしか見えず、 リセラーのアシスタントはリセラーの権限の範囲内にとどまります。
• アシスタントは自分では何も変更できません。いくつかの変更（DNS レコードの追加や削除、アカウントの停止や再開）については、 回答の下にカードを用意します。このカードは AI ではなくパネルが作成するもので、何が起きるかを正確に示します。 利用者が 承認… を押し、続けて はい、今すぐ実行 を押すまで、何も起きません。却下 を押すこともできます。 変更を依頼したのはアシスタントのため、パネルはまずパスワード（2 段階認証を使っている場合は確認コードも）でご本人であることの確認を求めます。その後、数分間は再度求められません。
• 提案の前にアシスタントがほかの人の書いたメッセージ（サポートチケットなど）を読んでいた場合は、 カードにその旨が表示されます。ご自身が実際に頼んだものだけを承認してください。
• リクエストは 30 分待機したあと、期限切れになります。アシスタントをオフにすると、未処理の提案はすべて取り消されます。
• API トークン経由や「○○としてログイン」で開いたタブでは使えません。利用者本人のセッションでのみ使えます。

プライバシー。 最初の質問の前に、すべての利用者にお知らせが表示されます：質問と、それに答えるために アシスタントが読み取ったパネルのデータは、あなたのアカウントで、選んだプロバイダーに送信されます。パネルが識別できる パスワードやキーは送信内容から取り除かれますが、利用者はアシスタントにパスワードを絶対に入力しないでください。 管理者やリセラーのアシスタントは、その人が閲覧を許されているほかの顧客のデータを読み取ることがあります。

AIアシスタントを接続する（MCP）

これにより、利用者は Model Context Protocol を通じて、自分のアシスタント（たとえば Claude）をパネルと組み合わせて使えます。

1. 管理者： システム → セキュリティ → AIアシスタント接続（MCP） を開き、 AIアシスタントの接続を許可 にチェックを入れ、接続を許す役割を選んで保存します。

2. 利用者（管理者、リセラー、顧客、チームユーザー）は APIトークン → AIアシスタントを接続（Claudeなど） を開きます。 パネルの部分ごとに アクセスなし、読み取り、読み取りと変更 のいずれかを選び（アシスタントに見るだけを させたい場合は 読み取り を選びます）、アシスタント用トークンを作成 を押します。トークンは、 使えなくなるまで（日） に別の数を入れない限り 90 日で使えなくなります。

3. パネルに貼り付け用のコマンドが表示されます。Claude Code の場合：

   claude mcp add --transport http nimbopanel https://panel.yourdomain.com/mcp --header "Authorization: Bearer <token>"
   

   ほかの MCP クライアントでも同じアドレスを使い、トークンを Authorization: Bearer ヘッダーに入れます。

接続されたアシスタントにできること： トークンで指定された部分の読み取りと、新しい通常の名前に対するアドレスレコードまたは テキストレコードの追加です。それ以外のすべて（レコードの削除、アカウントの停止や再開、メール関連のレコード、ドメインそのもの、 CNAME/SRV/CAA レコード、ワイルドカード、メールソフトが参照する名前（autodiscover、autoconfig、mail など））はリクエストになります。 トークンの所有者は APIトークン → アシスタントからのリクエスト でそれを確認し、承認または却下します。 アシスタントが自分のリクエストを承認することは決してできません。

まだ対応していないもの： OAuth によるサインインでしか接続できないクライアント（このエンドポイントはヘッダーに入れたトークンを受け付けます）。 トークンは APIトークン でいつでも無効にできます。その場合、未処理のリクエストも取り消されます。

よい習慣

• アシスタント用トークンには必要な部分だけを与え、読み取りと変更 よりも 読み取り を選びましょう。
• 承認カードは毎回よく読みましょう。何が起きるかを示すのは、アシスタントのメッセージではなくカードです。
• 1 日の質問数の上限と月間予算は設定したままにしておきましょう。今月の使用量は同じカードで確認できます。