PWS MCP сервер¶

PWS MCP сервер — это официальная реализация протокола MCP от PWS. Он позволяет ИИ-ассистентам и другим инструментам безопасно взаимодействовать с данными вашей платформы, используя для аутентификации статический API-ключ.

Практики безопасности

Никогда не храните ключ в открытом виде в коде или системе контроля версий. Используйте переменные окружения или системы управления секретами.
Всегда включайте подтверждение вручную в рабочие процессы, чтобы сохранять контроль и предотвращать несанкционированные изменения. Это позволяет вам просматривать и одобрять каждый шаг перед его выполнением и помогает избежать случайных или вредоносных изменений в ваших проектах.
Используйте только проверенные MCP-клиенты из надежных источников. Помните: при подключении к PWS MCP серверу выбранная вами система искусственного интеллекта получает те же права доступа, что и сервисный аккаунт, которому принадлежит ваш API-ключ.

Настройка¶

Процесс подключения состоит из двух шагов: сначала необходимо получить API-ключ, а затем настроить ваш ИИ-клиент.

Шаг 1: Получение API-ключа¶

Перед настройкой клиента убедитесь, что у вас есть API-ключ, полученный из сервисного аккаунта в PWS. Назначьте сервисному аккаунту роли в зависимости от нужных инструментов.

Шаг 2: Примеры настройки клиентов¶

Ниже приведены инструкции для добавления локальных (проектных) настроек в популярных ИИ-клиентах.

VS Code + CopilotCursor

Откройте Палитру Команд (Cmd+Shift+P на macOS или Ctrl+Shift+P на Windows/Linux).
Введите и выберите команду MCP: Add Server, далее HTTP.
Последовательно введите следующие данные в появившихся полях:
- URL: https://<DOMAIN>/mcp/
- ID: pws
На вопрос о месте сохранения настроек выберите Workspace — это создаст конфигурацию только для текущего проекта.
VS Code автоматически откроет файл .vscode/settings.json. Найдите созданную конфигурацию и добавьте в нее поля transport и headers, как показано ниже:
```
"servers": {
  "pws": {
    "url": "https://<DOMAIN>/mcp/",
    "transport": "sse",
    "headers": {
      "Authorization": "Bearer <YOUR_API_KEY>"
    }
  }
}
```

Не забудьте заменить <YOUR_API_KEY> и <DOMAIN> на реальные значения.

Откройте Палитру Команд (Cmd+Shift+P или Ctrl+Shift+P).
Введите mcp и выберите View: Open MCP Settings, чтобы открыть настройки инструментов.
В открывшемся окне Tools & Integrations вы увидите подсказку, предлагающую настроить инструменты в файле <project-root>/.cursor/mcp.json.
Следуя этой подсказке, создайте в корне вашего проекта папку .cursor (если она отсутствует), а в ней — файл mcp.json.

Вставьте в этот файл следующую конфигурацию, заменив <YOUR_API_KEY> и <DOMAIN>:

{
  "mcpServers": {
    "pws": {
      "url": "https://<DOMAIN>/mcp/",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

Не забудьте заменить <YOUR_API_KEY> и <DOMAIN> на реальные значения.

Подключение других клиентов

Для подключения других ИИ-клиентов, поддерживающих MCP, обратитесь к их официальной документации. Как правило, необходимо найти способ указать кастомные HTTP-заголовки (headers) для Authorization: Bearer <YOUR_API_KEY>, аналогично примерам выше.

Доступные инструменты¶

Набор инструментов зависит от роли сервисного аккаунта. Параметры передаются автоматически через MCP-протокол — ИИ-клиент запрашивает их у сервера при подключении.

Remote Config¶

get_configs — возвращает все включённые параметры для проекта в виде пар ключ-значение.

App Distribution¶

app_distribution_list_releases — список релизов, сгруппированных по версии. Поддерживает фильтрацию по статусу и версии.
app_distribution_get_release — полная информация о релизе: сборка, группы тестирования, ссылка на скачивание.
app_distribution_update_release — обновление описания (release notes) или версии релиза.