@sota-io/mcp

MCP-сервер для sota.io — развёртывайте веб-приложения с помощью AI-агентов.

Два транспорта

Начиная с версии v1.4.0, этот пакет включает два транспорта:

• sota-mcp (stdio, по умолчанию) — для Claude Code, Cursor, Windsurf и любого MCP-клиента, который запускает локальный процесс. Передайте SOTA_API_KEY через переменную окружения.

• sota-mcp-http (Streamable HTTP) — для самостоятельного хостинга удалённой конечной точки, которая работает на mcp.sota.io (используется Claude Desktop и веб-версией Claude.ai). Читает SUPABASE_JWT_SECRET, DATABASE_URL и т.д. — большинству пользователей это не нужно; это тот же код, который работает на mcp.sota.io, если вы хотите разместить свой собственный.

Большинству пользователей нужен stdio-транспорт.

Related MCP server: AppsAI MCP Server

Установка в один клик для Claude Desktop / Claude.ai web

Если вы используете Claude Desktop или Claude.ai (план Pro / Max / Team / Enterprise), самый простой способ установки — не этот npm-пакет, а размещённая удалённая конечная точка на mcp.sota.io. Нажмите здесь:

Добавить в Claude →

OAuth обрабатывает аутентификацию. Новые пользователи могут зарегистрироваться целиком внутри Claude через инструмент create_account — не нужно переключать вкладки браузера.

См. https://sota.io/docs/integrations/claude.

Быстрый старт (stdio — Claude Code, Cursor, Windsurf, …)

1. Получите API-ключ на sota.io/dashboard/settings

2. Настройте вашу IDE

3. Спросите своего AI: "Разверни моё приложение на sota.io"

Установка

Установка не требуется — запускайте напрямую через npx:

npx -y @sota-io/mcp

Или установите глобально:

npm install -g @sota-io/mcp
sota-mcp

Конфигурация

Claude Code

Метод через CLI:

claude mcp add sota -- npx -y @sota-io/mcp

Затем установите API-ключ в окружении оболочки:

export SOTA_API_KEY=sota_your_api_key_here

Ручной JSON (.claude/settings.json):

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Claude Desktop

Отредактируйте claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Cursor

Создайте .cursor/mcp.json в корне проекта:

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Windsurf

Отредактируйте ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Инструменты

deploy

Развёртывает приложение на sota.io. Создаёт tar.gz-архив указанной директории и загружает его.

"Deploy my app in the current directory to sota.io"

get-logs

Получить логи сборки и выполнения для развёртывания. Если deployment_id не указан, возвращает логи последнего развёртывания.

"Show me the build logs for my sota.io project"

set-env

Установить переменную окружения для проекта.

"Set DATABASE_URL on my project to postgres://localhost/mydb"

get-env

Список переменных окружения для проекта.

"Show all environment variables for my project"

rollback

Откатить проект к предыдущему развёртыванию. Это заменяет образ контейнера без пересборки.

"Roll back my app to the previous version"

get-status

Получить текущий статус развёртывания проекта, включая URL и историю развёртываний.

"What's the status of my sota.io deployment?"

list-projects

Список всех проектов в вашей учётной записи sota.io.

Параметры не требуются.

"List my sota.io projects"

create-project

Создать новый проект на sota.io. Слаг проекта генерируется автоматически из имени (строчные буквы, дефисы, макс. 63 символа) и используется как поддомен ({slug}.sota.io). Например, "My API" становится my-api.sota.io.

"Create a new sota.io project called my-api"

delete-project

Удалить проект и все его развёртывания с sota.io. Это действие необратимо.

"Delete my sota.io project abc123"

add-domain

Добавить пользовательский домен к проекту. Возвращает инструкции DNS для настройки домена.

"Add example.com as a custom domain to my project"

list-domains

Список всех пользовательских доменов для проекта.

"Show all custom domains for my project"

get-domain

Получить детали домена, включая статус проверки DNS и состояние SSL.

"Check the DNS status of my custom domain"

remove-domain

Удалить пользовательский домен из проекта.

"Remove the custom domain from my project"

Переменные окружения

Устранение неполадок

"npx: команда не найдена"

Проблема: Ваша IDE не наследует PATH оболочки, где загружен nvm/fnm.

Решение: Используйте абсолютный путь к npx. Найдите его с помощью:

which npx
# Example output: /Users/you/.nvm/versions/node/v22.0.0/bin/npx

Затем обновите конфигурацию MCP, указав абсолютный путь:

{
  "mcpServers": {
    "sota": {
      "command": "/Users/you/.nvm/versions/node/v22.0.0/bin/npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

"Требуется переменная окружения SOTA_API_KEY"

Проблема: API-ключ не установлен в конфигурации MCP.

Решение: Добавьте блок env в конфигурацию MCP-сервера. Переменные окружения оболочки не передаются автоматически MCP-серверам — требуется блок env в конфигурации:

{
  "env": {
    "SOTA_API_KEY": "sota_your_api_key_here"
  }
}

Ошибки "Connection refused" или тайм-аут

Проблема: Проблема с сетью или неверный URL API.

Решение: Проверьте подключение к интернету. Если вы используете собственный URL API, убедитесь, что SOTA_API_URL установлен правильно. По умолчанию используется https://api.sota.io.

Лицензия

MIT

Ссылки

• Веб-сайт

• Документация

• Панель управления

• Вопросы