# add-server-logic

Скилл add-server-logic для Claude Code, который создаёт и редактирует файлы серверной JavaScript-логики в Power Pages. Ведёт весь цикл: от сбора требований и получения документации до написания кода, настройки параметров сайта и деплоя.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1167 у репозитория
- Автор: Microsoft
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/microsoft/power-platform-skills/tree/HEAD/plugins/power-pages/skills/add-server-logic/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/add-server-logic

## Что делает

Скилл работает на Claude Code и управляет файлами Server Logic — серверным JavaScript, который выполняется в изолированной среде Power Pages. Код скрыт от браузера и защищён веб-ролями и табличными разрешениями, поэтому через него можно безопасно интегрировать внешние API, работать с Dataverse и выносить бизнес-логику с клиента на сервер.

Перед написанием кода скилл запрашивает актуальную документацию Microsoft Learn — функция Server Logic находится в preview, и SDK меняется. Среда выполнения поддерживает ECMAScript 2023, но без `fetch`, DOM-API и npm-пакетов. Файл может экспортировать только пять функций: `get`, `post`, `put`, `patch` и `del`; каждая обязана вернуть строку. Файлы размещаются в `.powerpages-site/server-logic/<name>/` — эта папка появляется только после первого деплоя сайта, поэтому без него скилл не запустится.

Работа разбита на 11 фаз: проверка проекта, уточнение требований, получение документации, согласование плана, реализация `.js` и `.serverlogic.yml`, настройка табличных разрешений (если используется Dataverse), управление секретами через Azure Key Vault или переменные среды, настройка Site Settings, интеграция с фронтендом, проверка кода и деплой. Прогресс отслеживается через `TaskCreate`/`TaskUpdate` на каждом шаге.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add microsoft/power-platform-skills
```
В чате агента (не в терминале):
```text
/plugin install power-pages@power-platform-skills
```
Команда ставит плагин power-pages целиком, со всеми его скиллами

2. **Через Skills CLI (Vercel)**
```bash
npx skills add microsoft/power-platform-skills --skill add-server-logic -a claude-code
```

3. **Вручную: положить файлы**
- Файл: `~/.claude/skills/add-server-logic/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/add-server-logic/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add microsoft/power-platform-skills --skill add-server-logic -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/add-server-logic/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add microsoft/power-platform-skills --skill add-server-logic -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/add-server-logic/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install microsoft/power-platform-skills plugins/power-pages/skills/add-server-logic
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/add-server-logic/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add microsoft/power-platform-skills --skill add-server-logic -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/microsoft/power-platform-skills --path plugins/power-pages/skills/add-server-logic
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/add-server-logic/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/microsoft/power-platform-skills/tree/HEAD/plugins/power-pages/skills/add-server-logic/SKILL.md

## Когда брать
- Вынести чувствительную логику из браузера на сервер Power Pages
- Создать API-эндпоинт с защитой по веб-ролям
- Подключить внешний API без раскрытия ключа клиенту
- Настроить доступ к таблицам Dataverse из серверного кода
- Задеплоить серверную логику и получить инструкцию по тестированию

## Примеры запросов агенту
- Создай серверную логику, которая принимает POST-запрос и записывает данные в таблицу Dataverse
- Перенеси вызов внешнего API из фронтенда в файл `.powerpages-site/server-logic/`
- Добавь эндпоинт `get` для получения данных с проверкой веб-роли

## Похожие
- [dataverse-python-sdk](https://affpapa.org/nevibecode/rules/dataverse-python-sdk.md) — правило · ★ 41430 у репозитория
- [MCP Dataverse](https://affpapa.org/nevibecode/mcp/mcp-dataverse.md) — MCP-сервер · ★ 18 у репозитория
- [microsoft-code-reference](https://affpapa.org/nevibecode/skills/microsoft-code-reference.md) — скилл · 14251 установка
- [Microsoft Learn MCP](https://affpapa.org/nevibecode/mcp/microsoft-microsoft-learn-mcp.md) — MCP-сервер · 1272 установки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
