MCP-сервер Light Cloud

MCP (Model Context Protocol) сервер, который позволяет Claude развертывать приложения на Light Cloud Platform и управлять ими.

Ещё нет аккаунта? Начните отсюда

Скажите Claude: «Зарегистрируй меня в Light Cloud под адресом you@example.com» (или «Подключи меня к Light Cloud»). Инструмент connect создаст аккаунт на бесплатном тарифе: без карты, пароля и заполнения формы. Для этого достаточно подтвердить короткий код на console.light-cloud.com/device с любого устройства. Этот же инструмент позволяет войти в существующий аккаунт. После этого можно попросить: «Разверни этот проект», «Добавь базу данных» или «Перенеси рабочую область на Lite». Веб-консоль для этого не понадобится.

Возможности

Регистрация и вход из терминала — вызовите connect и укажите электронную почту. Подтверждение кода с любого устройства создаст аккаунт или выполнит вход. Пароль не нужен.
Управление оплатой в чате — просмотр тарифов и включённого в них объёма использования, переход на другой тариф за один шаг через Stripe Checkout с ежемесячной или годовой оплатой.
Управление приложениями — создание, развертывание и удаление приложений.
Управление окружениями — управление окружениями для тестирования, production и предварительного просмотра.
Интеграция с GitHub — развертывание непосредственно из репозиториев GitHub.
Развертывание загрузкой — развертывание локальных проектов без GitHub.
Журналы, метрики и откаты — журналы выполнения и сборки, метрики и активность окружений, откат одним вызовом.
Определение фреймворка — загруженная папка проверяется тем же детектором, который консоль использует для репозитория.
Сайты с защитой паролем — параметр password при развертывании включает защиту сайта на edge с самого первого запроса.
Возможности на уровне консоли — настройки, папки, стеки, администрирование баз данных (схема, SQL, дамп, импорт), счета и уведомления об использовании, участники рабочей области, API-ключи (платные тарифы), подключения к Git-провайдерам, уведомления и поддержка.
Переключатель доступа агентов — в консоли в разделе Settings → Security → 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-.mcpb из раздела последнего релиза и откройте файл — Claude Desktop покажет окно установки. Архив включает сервер и его зависимости. Node поставляется вместе с Claude Desktop, поэтому больше ничего устанавливать не нужно. Настройки (конечная точка API и URL консоли) можно изменить на странице расширения.

Чтобы собрать расширение самостоятельно, выполните npm run bundle → release/light-cloud-.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, одно подключение), `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 задаёт два вопроса, на которые невозможно ответить по содержимому папки: какую рабочую область использовать и сделать сайт публичным или защитить его паролем. Затем он выполняет развертывание и возвращает URL.

Отключение доступа агентов

В консоли в разделе Settings → Security → Agents & CLI можно настроить, какие действия на аккаунте разрешены этому серверу, CLI и расширению VS Code. Есть главный переключатель, а также отдельные группы разрешений: развертывание, удаление, настройки, базы данных, оплата, рабочая область и API-ключи. Операции чтения всегда разрешены. Ограничения проверяются на стороне сервера по собственному утверждению клиента в сессии, зафиксированному при её создании, поэтому обойти их с помощью заголовка запроса нельзя. Изменить настройки можно только в консоли. При отказе возвращается ошибка AGENT_ACCESS_DISABLED или AGENT_ACTION_BLOCKED с указанием, где изменить настройку; инструкции сервера предписывают ассистенту не повторять запрос.

Аутентификация

Доступны два способа входа; в обоих случаях учётные данные сохраняются в ~/.lightcloud/credentials.json.

connect (по умолчанию, работает везде). Попросите Claude подключить вас, указав адрес электронной почты. Инструмент выведет 8-значный код и адрес console.light-cloud.com/device. Откройте его на любом устройстве и войдите в существующий аккаунт. Если аккаунта ещё нет, перейдите по ссылке в отправленном письме: подтверждение кода создаст аккаунт. Введите код и подтвердите вход. Claude будет вызывать connect-status, пока подтверждение не будет получено. Пароль никогда не вводится в Claude.

login (открывает браузер на этом устройстве). Открывает страницу входа в консоль с обратным вызовом на loopback-адрес, как и раньше.

Тарифы и переход на платный план

Каждая рабочая область начинает работу на тарифе Free: $1 на использование в месяц, неограниченное количество статических сайтов, 3 серверных приложения и отсутствие необходимости привязывать карту. Когда лимит $1 на Free исчерпан, серверные приложения и развертывания приостанавливаются до начала следующего расчётного периода, а статические сайты продолжают работать. За рабочую область на бесплатном тарифе плата не взимается. Платные тарифы (Lite, Starter, Pro, Business; цены и ограничения доступны через list-plans) включают объём использования стоимостью, равной цене тарифа. Дополнительное использование включается в следующий счёт, а при оформлении можно установить лимит использования. При годовой оплате два месяца предоставляются бесплатно.

Перейти на другой тариф можно за один шаг. 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` списание с сохранённой карты отклонено; тариф не изменён	Сообщает об этом пользователю. Вызов `add-payment-method` с `plan_id` сохраняет другую карту и переключает тариф после её сохранения

Пользовательские домены доступны на платных тарифах. При использовании тарифа Free запрос add-custom-domain отклоняется с кодом PLAN_ENTITLEMENT, в котором указан тариф с поддержкой пользовательских доменов. Если домен уже подключён к рабочей области на тарифе Free, через 14 дней после отправки письма владельцу он будет приостановлен; сайт при этом продолжит работать по адресу light-cloud.io. В тот же срок приостанавливается и база данных, если она не будет удалена; её данные сохраняются. Переход на платный тариф восстановит работу и домена, и базы данных. Переход на Free при наличии базы данных отклоняется с кодом DATABASES_ON_FREE, пока база не будет удалена. На страницах тарифа Free в нижней части страницы отображается небольшая ссылка «by Light Cloud», добавленная на уровне edge. Вызов 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 через stdin.

Лицензия

MIT — см. LICENSE

Ссылки

Подача заявки в каталог Anthropic

Требования политики Software Directory и сведения о том, где их найти:

Пакет: файл .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
Примеры запросов: «Подключи меня к Light Cloud как you@example.com», «Разверни этот проект в Light Cloud», «Добавь базу данных Postgres и задай DATABASE_URL для production», «Почему не удалось выполнить последнее развёртывание? Проверь журналы».
Тестовая учётная запись с примерами данных: предоставляется в форме заявки.