light-cloud

Light Cloud MCP サーバー

Claude が Light Cloud Platform 上でアプリケーションをデプロイおよび管理できるようにする MCP（Model Context Protocol） サーバーです。

まだアカウントをお持ちでない場合はこちら

Claude に 「[email protected] で Light Cloud に登録して」（または「Light Cloud に接続して」）と尋ねてください。connect ツールがアカウントを作成します。Free プラン、カード不要、パスワード不要、フォーム入力不要で、任意のデバイスから console.light-cloud.com/device で短いコードを承認するだけです。同じツールで既存のアカウントにもサインインできます。その後は「このプロジェクトをデプロイして」「データベースを追加して」「ワークスペースを Lite に移行して」と指示できます。ウェブコンソールを使う必要はありません。

機能

• ターミナルからの登録とサインイン - メールアドレスを指定して connect を実行します。任意のデバイスでコードを承認すると、アカウントが作成されるか、サインインできます。パスワードは不要です。
• 会話からの請求管理 - プラン、利用枠、Stripe Checkout を使ったワンステップのアップグレード（月払いまたは年払い）
• アプリケーション管理 - アプリケーションの作成、デプロイ、削除
• 環境管理 - ステージング、プロダクション、プレビュー環境の管理
• GitHub 統合 - GitHub リポジトリから直接デプロイ
• アップロードによるデプロイ - GitHub を使わずにローカルプロジェクトをデプロイ
• ログ、メトリクス、ロールバック - 実行時ログとビルドログ、環境のメトリクスとアクティビティ、ワンコールでのロールバック
• フレームワークの検出 - アップロードしたフォルダーは、コンソールがリポジトリに使用するものと同じ検出ツールで読み取られます
• パスワード保護されたサイト - デプロイ時に password を指定すると、最初のリクエストからエッジでサイトへのアクセスが制限されます
• コンソールとの同等性 - 設定、フォルダー、スタック、データベース管理（スキーマ、SQL、ダンプ、インポート）、請求書と利用状況アラート、ワークスペースメンバー、API キー（有料プラン）、Git プロバイダーのリンク、通知、サポート
• 制御可能な停止スイッチ - コンソールの「設定」→「セキュリティ」→「Agents & CLI」で、エージェントが実行できる操作を設定できます。バックエンドで適用されます

インストール

Claude Code

# Add the MCP server
claude mcp add light-cloud -- npx @light-cloud/mcp-server

次に、Claude Code 内でツールを繰り返し確認されずにすべて許可します。

/allowed add mcp__light-cloud__*

Claude Desktop（ワンクリック拡張機能）

最新リリースから light-cloud-<version>.mcpb をダウンロードして開くと、Claude Desktop にインストールダイアログが表示されます。バンドルにはサーバーとその依存関係が含まれています。Node は Claude Desktop に同梱されているため、ほかに必要なものはありません。設定（API エンドポイント、コンソール URL）は拡張機能のページで編集できます。

自分でビルドする場合：npm run bundle → release/light-cloud-<version>.mcpb（このリポジトリの manifest.json は生成されたマニフェストです）。

Claude Desktop（手動設定）

claude_desktop_config.json に追加します。

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "light-cloud": {
      "command": "npx",
      "args": ["@light-cloud/mcp-server"]
    }
  }
}

使い方

インストールしたら、Claude と自然にチャットするだけです。

You: Deploy my React app to Light Cloud
Claude: I'll help you deploy. First, let me check your authentication...
        [Opens browser for login]

You: Show me all my applications
Claude: [Lists your applications with status]

You: Check the logs for my-app
Claude: [Fetches and displays recent logs]

利用可能なツール

110 個のツールを利用できます。会話中にコンソールでできることはすべて実行できます。アカウントのパスワード、二要素認証の設定、Agents & CLI の切り替え（以下を参照）は、設計上コンソールでのみ変更できます。各ツールのプロンプトを含む完全なリファレンス：https://docs.light-cloud.com/deploy-with-ai/mcp-server#tool-reference

グループ	ツール
アカウント	connect、connect-status、login、logout、whoami、get-profile、update-profile、list-connected-devices、sign-out-device、get-agent-access
デプロイ	upload-and-deploy（省略可能な password を指定可能）、create-application、create-stack、wait-for-deployment、deploy-application、deploy-environment、rollback-deployment、set-password-protection、detect-local-framework、detect-framework、detect-local-git、list-repo-directories、read-project-config、write-project-config
アプリと環境	list-applications、get-application、get-application-status、get-formatted-list、get-formatted-status、update-application、rename-application、move-application、delete-application、list-environments、get-environment、create-environment、update-environment、delete-environment、set-scaling、get-environment-metrics、get-environment-activity、get-environment-runtime、list-folders、create-folder、delete-folder
ログとデプロイ	get-environment-logs、list-deployments、get-deployment、get-build-logs
変数、ドメイン	set-environment-variables、get-environment-variables、add-custom-domain、get-custom-domain-status、retry-custom-domain、remove-custom-domain
データベース	list-databases、get-database、create-database、update-database、delete-database、get-database-connection-string、rotate-database-password、get-database-schema、query-database、get-database-metrics、dump-database、import-database
プランと請求	get-billing、list-plans、choose-plan、add-payment-method、payment-method-status、remove-payment-method、get-usage、get-usage-history、list-invoices、get-invoice、retry-invoice、get-outstanding-invoices、get-usage-alerts、set-usage-alerts、get-billing-details、set-billing-details
ワークスペースとメンバー	create-workspace、list-members、invite-member、remove-member、set-member-role、list-roles、list-api-keys、create-api-key（有料プラン）、revoke-api-key
Git プロバイダー	get-github-installation-status、get-github-install-url、list-github-installations、list-repositories、list-branches、check-repo-access、connect-git-provider（GitLab / Bitbucket、リンクは 1 つ）、list-provider-repositories
その他	list-notifications、mark-notifications-read、contact-support、ping、get-platform-config、get-cloudrun-config、および低レベルのアップロード手順（package-source、request-upload-url、complete-upload、create-application-from-upload）

プロンプト：deploy-from-scratch — フォルダーからは分からない 2 つのこと（ワークスペース、公開するかパスワード保護するか）を確認してから、デプロイし、URL を返します。

エージェントを無効にする

コンソールの「Settings → Security → Agents & CLI」では、このサーバー、CLI、VS Code 拡張機能がアカウントで実行できる操作を設定できます。マスタースイッチに加えて、デプロイ、削除、設定、データベース、請求、ワークスペース、API キーのグループごとに制御できます。読み取り操作は常に許可されます。バックエンドはセッション自体のクライアントクレームに基づいて制御します。このクレームはセッション発行時に固定されるため、ヘッダーで回避することはできません。また、このスイッチはコンソールからのみ変更できます。拒否された場合は、変更場所とともに AGENT_ACCESS_DISABLED または AGENT_ACTION_BLOCKED が返されます。サーバーの指示により、アシスタントは再試行しません。

認証

認証方法は2つあり、どちらも認証情報を ~/.lightcloud/credentials.json に保存します。

connect（デフォルト。どこでも利用できます）。 Claude にメールアドレスを使って接続するよう依頼します。ツールが8文字のコードとアドレス console.light-cloud.com/device を表示します。任意のデバイスで開き、すでにアカウントがある場合はサインインします（ない場合は、送信されたメール内のリンクに従ってください。承認するとアカウントが作成されます）。コードを入力して承認します。承認が完了するまで、Claude は connect-status を呼び出します。Claude にパスワードを入力する必要は一切ありません。

login（このマシンのブラウザーを使用）。 これまでと同様に、ループバックコールバックを使ってコンソールのサインインページを開きます。

プランとアップグレード

すべてのワークスペースは Free で開始します。月額1ドル分の使用量、静的サイト数は無制限、サーバーアプリは3つまで、カードは不要です。Free の1ドル分を使い切ると、次のサイクルまでサーバーアプリとデプロイは一時停止しますが、静的サイトの配信は継続されます。Free のワークスペースに料金が請求されることはありません。有料プラン（Lite、Starter、Pro、Business。料金と上限は list-plans で確認できます）には、プラン料金相当の使用量が含まれます。超過分は次回の請求に加算され、チェックアウト時に使用量の上限を設定できます。年払いは2か月分無料です。

アップグレードは1ステップで完了します。choose-plan（年払いの場合は interval: "year" を指定）は、保存済みのカードに請求するか、カード情報と初回の支払いをまとめて入力できる Stripe Checkout のリンクを返します。アシスタントはリンクを案内し（「カードを追加するにはこのリンクを開いてください。Stripe の確認が完了するとプランが切り替わります」）、プランが切り替わるまで payment-method-status で待機します。add-payment-method はカードの保存または変更のみを行います。カード番号がサーバーを経由することはありません。

エージェントが対処できる拒否

プランの上限に達した書き込みツールは、code と Next step: の行を返します。プランによる拒否（PLAN_ENTITLEMENT）では、拒否された機能を利用できるプラン名と料金が示されます。たとえば Next step: call the choose-plan tool with plan_id lite (Lite, $5/month) once the user agrees のように表示されます。choose-plan は支払いを伴うため、アップグレードの前にアシスタントがユーザーに確認します。その他のコードは次のとおりです。PAYMENT_METHOD_REQUIRED → add-payment-method、POOL_EXHAUSTED → choose-plan（Free に含まれる使用量を使い切った場合）、ORGANISATION_SUSPENDED → add-payment-method。deploy-from-scratch プロンプトは、接続、請求の確認、検出、作成、データベースと環境変数の設定、デプロイまでの一連の手順を案内します。

一部の拒否には、ユーザーとの会話で対処します。

コード	発生条件	エージェントの対応
DOMAIN_NOT_POINTING_HERE	add-custom-domain が、訪問者にコンテンツを配信しているドメインを、DNS が別の場所を指しているドメインに置き換えようとした場合	追加するレコードをユーザーに伝えます。ユーザーがそれでも切り替えるよう求めた場合のみ、force: true を指定して再試行します
USE_DOMAIN_ROUTES	update-application／update-environment に別のカスタムドメインが指定された場合	add-custom-domain または remove-custom-domain を使用します
PAYMENT_FAILED	choose-plan が保存済みカードに請求しようとしたものの、決済が拒否され、プランが変更されなかった場合	ユーザーに伝えます。plan_id を指定して add-payment-method を実行すると、別のカードを保存し、保存後にプランが切り替わります

カスタムドメインは有料プランで利用できます。Free で add-custom-domain を実行すると PLAN_ENTITLEMENT で拒否され、利用できるプランが示されます。Free のワークスペースに登録済みのドメインは、所有者にメールが送信されてから14日後に保留状態になります（サイトには引き続き light-cloud.io のアドレスでアクセスできます）。Free のままのデータベースも同じ時点で停止しますが、データは保持されます。有料プランにすると、ドメインとデータベースの両方が再び利用可能になります。データベースがある状態で Free にダウングレードしようとすると、データベースを削除するまで DATABASES_ON_FREE で拒否されます。Free のページには、小さな「by Light Cloud」リンクがエッジで追加されます。表示されるプランは list-plans で確認できます。

設定

設定は不要です。サーバーはデフォルトで次のアドレスにある Light Cloud と通信します。

変数	デフォルト
LIGHT_CLOUD_API_URL	https://api.light-cloud.com
LIGHT_CLOUD_CONSOLE_URL	https://console.light-cloud.com

別のエンドポイントを指定された場合にのみ、これらを設定してください。

開発

# Clone the repository
git clone https://github.com/light-cloud-com/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

テスト

サーバーを手動でテストします。

npm run build
node dist/index.js

その後、標準入力経由で JSON-RPC メッセージを送信します。

ライセンス

MIT - LICENSE を参照してください。

リンク

• Light Cloud プラットフォーム
• MCP ドキュメント
• 問題を報告

Anthropic ディレクトリへの提出

ソフトウェアディレクトリのポリシーで求められている内容とその場所は次のとおりです。

• バンドル：最新リリースの .mcpb。ソースはこのリポジトリにあります。
• すべてのツールにツールのアノテーション（title、readOnlyHint、destructiveHint）を設定し、説明を実際の動作に一致させます。隠された指示は含めません。
• プライバシーポリシー：https://www.light-cloud.com/legal/privacy-policy · サポート：https://www.light-cloud.com/contact · ドキュメント：https://docs.light-cloud.com/deploy-with-ai/mcp-server
• プロンプトの例：「[email protected] として Light Cloud に接続してください」、「このプロジェクトを Light Cloud にデプロイしてください」、「Postgres データベースを追加して、本番環境に DATABASE_URL を設定してください」、「直近のデプロイが失敗した理由は何ですか？ログを確認してください」。
• サンプルデータを含むテストアカウント：提出フォームで提供されます。