ColorfulBox MCP (AI連携) ローカル版
AIに伝えるだけで、
サーバー操作が終わっている。
メールアドレスの作成、DNSの確認、データベースの作成――。
カラフルボックス公式MCPサーバー「colorfulbox-mcp」なら、Claude Code や Cursor などの AIエージェントに日本語で頼むだけ。日常的な確認や操作を、AIとの会話から行えます。
ローカル版の利用に追加料金なし・cPanel付きのご契約とPCへの設定が必要です
サーバー管理の定番作業を、AIとの会話から。
通常のローカル設定で利用する14カテゴリ・38ツールをご紹介。cPanelの日常的な確認から作成・削除まで、実行内容を確かめながら操作できます。
メール
メールアカウント・転送・自動応答の一覧確認から、新規作成・削除まで。「部署用のメールを3つ作って」が一言で。
ドメイン・DNS
契約サーバー内のドメインの確認、サブドメインの確認・追加、DNSゾーンやSSL証明書・AutoSSLの状態チェックに対応。
データベース
MySQLデータベースとユーザーの一覧・作成・削除。WordPressの引っ越しやテスト環境づくりの下準備が一瞬。
PHP・Cron
PHPバージョンの確認、Cronジョブの一覧・追加・削除。定期バッチの設定ミスもAIと一緒に点検できます。
WordPress・バックアップ
WordPressの設置状況の検出、JetBackupのバックアップ一覧確認に対応（SSH読み取り専用パス利用時）。
サーバー情報・FTP
接続アカウントの確認、ディスク使用量、FTPアカウント管理、アクセスログのあるドメインの確認まで。現状把握もAIにおまかせ。
| カテゴリ | ツール |
|---|---|
| サーバー情報 | server_whoami server_get_info server_get_usage server_list_api_tokens |
| ドメイン | domain_list domain_list_details domain_get |
| サブドメイン | subdomain_list subdomain_add* subdomain_delete† |
| DNS | dns_get_zone dns_lookup |
| SSL | ssl_list_certs ssl_list_installed ssl_autossl_status |
| メール | mail_list_accounts mail_list_forwarders mail_list_autoresponders mail_add_account* mail_delete_account† mail_add_forwarder* |
| FTP | ftp_list ftp_add* ftp_delete† |
| MySQL | mysql_list_databases mysql_list_users mysql_create_database* mysql_delete_database† mysql_create_user* mysql_delete_user† |
| PHP | php_get_versions |
| Cron | cron_list cron_add* cron_remove† |
| SSH | ssh_list_keys |
| ログ | logs_last_visitors（アクセスログのあるドメイン一覧） |
| WordPress | wordpress_list（設置検出・SSH読み取り専用パス利用時） |
| バックアップ | backup_list（JetBackup一覧・SSH読み取り専用パス利用時） |
* 書き込み系（プレビュー → 発行された単回使用の確認コードを添えて再実行で初めて実行） / † 削除系（同・取り消し不可のため明示確認必須）
WordPress検出・バックアップ一覧はSSH読み取り専用パスの設定時に利用できます（未設定時は「利用不可」と安全に案内）。
たとえば、こんな頼み方。
難しいコマンドや管理画面の場所を覚える必要はありません。やりたいことを、そのまま伝えるだけ。
メールアカウント作成と転送設定を連続で実行。作成前に対象アドレスがプレビュー表示されるので安心です。
DNSゾーンを取得して見やすく整理。移転前の現状把握やトラブル調査が数秒で終わります。
DB作成→ユーザー作成までAIが段取り。ステージング環境の準備がチャット1往復に。
スケジュール書式（cron式）はAIが組み立て。設定後は一覧で反映を確認してくれます。
「AIに任せて大丈夫？」に、設計で答える。
colorfulbox-mcp は安全設計を最優先に開発されています。変更内容のプレビューと確認の仕組みで、誤った操作を防ぎやすくします。
🛡️ 二段階ガード＋人による最終確認（高リスクはフェイルクローズ）
作成・削除などの変更系操作は、AIがまず実行内容のプレビューを提示し、単回使用の確認コードを添えて再実行しない限り実行されません（サーバー側で強制。confirm=trueだけでは実行不可）。これは「AIが1回の呼び出しで即座に変更してしまう」誤実行を防ぐ仕組みです。さらに削除・Cron追加・認証情報やメール転送の作成などの高リスク操作では、対応クライアント（Claude Code / Claude Desktop 等）で実行直前に確認ダイアログを表示。確認ダイアログ非対応のクライアントでは、これら高リスク操作は既定で実行されません（確認・読み取りは可能）。「自動承認（auto-approve）」モードは使用しないでください。
🔒 APIトークンはログに残さない
APIトークンは認証に使用し、ログ・エラー・応答に含まれる秘密情報を伏せる仕組みを備えています。
💻 ローカル動作・接続用ソフトの追加不要
お使いのPC上で動作し、サーバーへの追加インストールは一切不要。通常はcPanelの標準API（HTTPS）を利用します。WordPress・バックアップ一覧には、任意のSSH読み取り専用接続を利用します。
🎯 1接続 = 1アカウント
接続は1つのサーバー・1つのcPanelアカウントに限定。意図しない別アカウントへの操作は構造上できません。接続先は「接続中のアカウントを教えて」でいつでも確認できます。
※ お使いのAIツールの「自動承認（auto-approve）」モードは使用しないでください。実行前にあなた自身が内容を確認する機会がなくなります。
導入は、3ステップ。
必要なものは、cPanel付きのカラフルボックスのご契約、APIトークン、Node.js 20以上とローカルMCP対応クライアントを利用できるPCです。
cPanel で APIトークンを発行
cPanel にログインし、「セキュリティ」カテゴリの「APIトークンの管理」から作成します。トークンの値はこの画面でしか表示されません。必ず控えてください。
AIクライアントに接続設定を追加
お使いのAIクライアントの設定ファイル（mcp.json など）に、以下の形式で追加します。サーバー名・ユーザー名・APIトークンは、ご自身の契約の値に置き換えてください。
{
"mcpServers": {
"colorfulbox": {
"command": "npx",
"args": ["-y", "colorfulbox-mcp"],
"env": {
"COLORFULBOX_SERVER": "tky006.cbsv.jp",
"COLORFULBOX_CPANEL_USER": "あなたのcPanelユーザー名",
"COLORFULBOX_API_TOKEN": "発行したAPIトークン"
}
}
}
}
接続を確認して、あとは頼むだけ
AIに「接続中のcPanelアカウントを教えて」と聞いてください。接続先のユーザー名・サーバー・主ドメインが表示されたら準備完了。意図したアカウントであることを確認してから操作を始めましょう。
主要なAIエージェントに、幅広く対応。
ローカルMCP（stdio）に対応したAIクライアントから接続します。設定方法や高リスク操作の確認への対応は、クライアント・バージョンによって異なります。
動作環境: Node.js 20以上。クライアント別の設定手順はnpmのドキュメントをご覧ください。
よくある質問
追加料金はかかりますか？
サーバーに何かインストールされますか？
認証エラー（403 / Access denied）になります。
/home/ 配下のディレクトリ名と同じ）をご指定ください。あわせてサーバー名とトークンの値もご確認ください。AIが勝手にデータを消してしまう心配はありませんか？
トークンが漏れたかもしれません。どうすれば？
提供: カラフルボックス（株式会社カラフルラボ）
※ 本サービスはオープンソースソフトウェア（MITライセンス）として提供されます。ご利用はお客様の責任において行っていただき、本ソフトウェアの利用により生じた損害について、当社は法令で認められる範囲で責任を負いません。操作の実行前には必ず対象・内容をご確認ください。
※ cPanel は cPanel, L.L.C. の登録商標です。WordPress は WordPress Foundation の登録商標です。Claude は Anthropic PBC、Cursor は Anysphere, Inc.、Gemini は Google LLC の商標または登録商標です。記載されているその他の会社名・製品名は、各社の商標または登録商標です。