add-mcscopilot — скилл для Claude Code: что делает и как установить
Скилл add-mcscopilot подключает коннектор Microsoft Copilot Studio к кодовому приложению Power Apps, настраивает вызов агентов и разбирает их ответы.
MIT ★ 1 167 обновлён 2026-10-29
/plugin marketplace add microsoft/power-platform-skills
/plugin install code-apps-preview@power-platform-skillsЧто делает add-mcscopilot
Скилл автоматизирует интеграцию Copilot Studio в TypeScript-проекты Power Apps. Сначала он находит активное подключение через /list-connections или отправляет за ним в веб-интерфейс Power Apps, а затем запускает pa app add data-source --connector microsoftcopilotstudio -c <connection-id>.
Перед генерацией кода агент должен быть уже опубликован в каналах Copilot Studio. Для реальных вызовов скилл использует строго метод ExecuteCopilotAsyncV2: эндпоинт ExecuteCopilotAsync падает с ошибкой 502, а обычный ExecuteCopilot не возвращает сам ответ.
Завершив правки в коде, скилл валидирует типы командой npm run build и фиксирует изменения в memory-bank.md.
Какие задачи решает
- добавить коннектор Copilot Studio в проект Power Apps
- настроить синхронный вызов агента через ExecuteCopilotAsyncV2
- разобрать JSON-ответы агента в TypeScript-коде
- проверить сборку приложения перед деплоем
Примеры запросов агенту
- Подключи коннектор Microsoft Copilot Studio к нашему Power Apps приложению
- Настрой вызов агента Copilot Studio через ExecuteCopilotAsyncV2 и добавь парсинг ответа
- Запусти скилл add-mcscopilot для интеграции бота cr3e1_myAgent
Как установить add-mcscopilot
1Через маркетплейс плагинов
/plugin marketplace add microsoft/power-platform-skills/plugin install code-apps-preview@power-platform-skillsКоманда ставит плагин code-apps-preview целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill add-mcscopilot -a claude-code3Вручную: положить файлы
~/.claude/skills/add-mcscopilot/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/add-mcscopilot/
1Через Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill add-mcscopilot -a codex2Вручную: положить файлы
.agents/skills/add-mcscopilot/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill add-mcscopilot -a cursor2Вручную: положить файлы
.cursor/skills/add-mcscopilot/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install microsoft/power-platform-skills plugins/code-apps/skills/add-mcscopilot2Вручную: положить файлы
.github/skills/add-mcscopilot/SKILL.md1Через Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill add-mcscopilot -a gemini-cli2Командой платформы
gemini skills install https://github.com/microsoft/power-platform-skills --path plugins/code-apps/skills/add-mcscopilotВручную: положить файлы
.devin/skills/add-mcscopilot/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об add-mcscopilot
Как установить add-mcscopilot в Claude Code?
Выполните по очереди две команды маркетплейса: /plugin marketplace add microsoft/power-platform-skills, а затем /plugin install code-apps-preview@power-platform-skills.
Что делает скилл add-mcscopilot?
Он связывает кодовое приложение Power Apps с агентом Copilot Studio, добавляет источник данных через интерфейс pa app и генерирует типобезопасный вызов сервиса.
Почему скилл настраивает именно ExecuteCopilotAsyncV2?
Остальные варианты вызова в API нестабильны: эндпоинт /executeAsync возвращает ошибку 502, а /execute отдаёт только идентификатор беседы без тела ответа.
Исходный текст
SKILL.md · MIT
---
name: add-mcscopilot
description: Adds Microsoft Copilot Studio connector to a Power Apps code app. Use when invoking Copilot Studio agents, sending prompts to agents, or integrating agent responses.
user-invocable: true
allowed-tools: Read, Edit, Write, Grep, Glob, Bash, LSP, TaskCreate, TaskUpdate, TaskList, TaskGet, AskUserQuestion, Skill
model: sonnet
---
**📋 Shared Instructions: [shared-instructions.md](${PLUGIN_ROOT}/shared/shared-instructions.md)** - Cross-cutting concerns.
# Add Microsoft Copilot Studio
## Workflow
1. Check Memory Bank → 2. Add Connector → 3. Configure → 4. Build → 5. Update Memory Bank
---
### Step 1: Check Memory Bank
Check for `memory-bank.md` per [shared-instructions.md](${PLUGIN_ROOT}/shared/shared-instructions.md).
### Step 2: Add Connector
**First, find the connection ID** (see [connector-reference.md](${PLUGIN_ROOT}/shared/connector-reference.md)):
Run the `/list-connections` skill. Find the Microsoft Copilot Studio connection in the output. If none exists, direct the user to create one using the environment-specific Connections URL — construct it from the active environment ID in context (from `power.config.json` or a prior step): `https://make.powerapps.com/environments/<environment-id>/connections` → **+ New connection** → search for the connector → Create.
```bash
pa app add data-source --connector microsoftcopilotstudio -c <connection-id>
```
### Step 3: Configure
Ask the user which Copilot Studio agent they want to invoke and what operations they need.
**Agent Setup Prerequisites** (manual steps the user must complete in Copilot Studio):
1. **Publish the agent**: In Copilot Studio, click Channels → select Teams → add to Teams → click Publish.
2. **Get the agent name**: Under Channels, click "Web app". The connection string URL contains the agent name. Example: `https://...api.powerplatform.com/copilotstudio/dataverse-backed/authenticated/bots/cr3e1_myAgent/conversations?...` — the agent name is `cr3e1_myAgent`.
**ExecuteCopilotAsyncV2** -- execute an agent and wait for the response:
Use the `ExecuteCopilotAsyncV2` operation (path: `/proactivecopilot/executeAsyncV2`). This is the **only** endpoint that reliably returns agent responses synchronously. It is the same endpoint used by Power Automate's "Execute Agent and wait" action.
```typescript
const result = await MicrosoftCopilotStudioService.ExecuteCopilotAsyncV2({
message: "Your prompt or data here", // Can be a JSON string
notificationUrl: "https://notificationurlplaceholder" // Required by API but unused; any URL works
});
// Response structure:
// result.responses — Array of response strings from the agent
// result.conversationId — The conversation ID
// result.lastResponse — The last response from the agent
// result.completed — Boolean indicating if the agent finished
```
**Important:** Agents often return responses as JSON strings. Parse the `responses` array to extract meaningful data:
```typescript
const agentResponse = result.responses?.[0];
if (agentResponse) {
const parsed = JSON.parse(agentResponse);
// Extract specific fields, e.g., parsed.trend_summary
}
```
Use `Grep` to find specific methods in the generated service file (generated files can be very large — see [connector-reference.md](${PLUGIN_ROOT}/shared/connector-reference.md#inspecting-large-generated-files)).
#### Known Issues
- **ExecuteCopilot** (`/execute`) -- fire-and-forget, only returns `ConversationId`, not the actual response. Do NOT use this.
- **ExecuteCopilotAsync** (`/executeAsync`) -- returns 502 "Cannot read server response" errors. Do NOT use this.
- **Conversation turn model** (`/conversations/{ConversationId}`) -- only works after `/execute`, which doesn't provide responses. Do NOT use this.
- **Response casing varies** -- check all variations: `conversationId`, `ConversationId`, `conversationID`.
### Step 4: Build
```bash
npm run build
```
Fix TypeScript errors before proceeding. Do NOT deploy yet.
### Step 5: Update Memory Bank
Update `memory-bank.md` with: connector added, agent name configured, configured operations, build status.
© Microsoft · MIT · microsoft/power-platform-skills