К основному содержанию
скилл CX Codex

add-connector · microsoft, mobile-apps — скилл для Claude Code: что делает и как установить

Скилл add-connector добавляет коннекторы Power Platform в мобильные приложения на Expo и React Native, если для них нет отдельного специализированного скилла.

MIT ★ 1 167 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add microsoft/power-platform-skills
/plugin install mobile-app@power-platform-skills
Открыть на GitHub

Что делает add-connector

Скилл настраивает интеграцию с сервисами Power Platform (Teams, Azure DevOps, Office 365, SQL) в мобильных проектах Power Apps. Для SharePoint Online и Dataverse скилл сразу перенаправляет запросы на отдельные инструменты /add-sharepoint и /add-dataverse.

Среда выполнения использует библиотеку @microsoft/power-apps-native-host и компонент PowerAppsProvider в файле app/_layout.tsx, поэтому отдельный исполнитель маршрутизации не требуется. Перед работой проверяются файлы power.config.json, app.config.js и memory-bank.md. Если проект ещё не инициализирован, выполнение блокируется.

Скилл категорически не поддерживает облачные потоки Cloud Flows и вернёт блокирующую ошибку при попытке их привязать. Любые действия и функции Dataverse доступны только в режиме чтения метаданных без генерации сервисов.

Какие задачи решает

  • подключить сторонний коннектор Power Platform к коду на Expo
  • проверить конфигурацию мобильного приложения Power Apps перед связыванием данных
  • найти метаданные операций Dataverse без вызова генерации таблиц
  • делегировать настройку SharePoint и Dataverse в профильные скиллы

Примеры запросов агенту

  • Добавь коннектор Azure DevOps к моему мобильному приложению
  • Подключи коннектор Office 365 Users через add-connector
  • Сделай рефреш коннектора Teams с сохранением connection-id

Как установить add-connector

1Через маркетплейс плагинов

/plugin marketplace add microsoft/power-platform-skills
/plugin install mobile-app@power-platform-skills

Команда ставит плагин mobile-app целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add microsoft/power-platform-skills --skill add-connector -a claude-code

3Вручную: положить файлы

~/.claude/skills/add-connector/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/add-connector/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об add-connector

Как установить add-connector в Claude Code?

Выполните сначала /plugin marketplace add microsoft/power-platform-skills, а затем команду /plugin install mobile-app@power-platform-skills.

Для чего нужен скилл add-connector?

Это резервный инструмент для подключения любых API Power Platform в мобильное приложение на Expo, когда для коннектора нет отдельной специализированной команды.

Поддерживает ли скилл работу с Cloud Flows?

Нет, интеграция с Cloud Flows в мобильных скиллах полностью заблокирована. При попытке привязать или вызвать облачный поток скилл возвращает статус BLOCKED: cloud-flow integration is not supported.

Исходный текст

SKILL.md · MIT
---
name: add-connector
description: Use when adding a Power Platform connector to an Expo/React Native Power Apps mobile app and no dedicated mobile connector skill exists.
user-invocable: true
allowed-tools: Read, Edit, Write, Grep, Glob, Bash, AskUserQuestion, Skill
model: sonnet
---

> **Plugin check**: Run `node "${PLUGIN_ROOT}/scripts/check-version.js"` - if it outputs a message, show it to the user before proceeding.

**📋 Shared instructions: [shared-instructions.md](${PLUGIN_ROOT}/shared/shared-instructions.md)** | **Connector reference: [connector-reference.md](${PLUGIN_ROOT}/shared/connector-reference.md)** — read both first.

# Add Connector (Generic)

**App root:** before any project read or command, execute
[app-working-directory.md](${PLUGIN_ROOT}/shared/references/app-working-directory.md).
Use its resolved absolute `working_dir` for every shell call and file tool,
including referenced commands and delegated skills; never inherit a prior `cd`.

**Entry routing:** use the shared [App feature entry points](../../shared/shared-instructions.md#app-feature-entry-points)
preflight before the workflow below.

**Invocation scope:** follow [Data-source invocation scope](../../shared/shared-instructions.md#data-source-invocation-scope)
before the workflow below. This skill owns connector bindings and generated
services, not a full-app plan or screen implementation.

For a standalone request, approve the current data-source delta before each
mutation: the exact connector, environment, binding, and dataset/table or
procedure as applicable. Connection creation needs explicit approval too.
An approved child reuses only its owner's current scope; a missing choice may
be resolved read-only, but a changed scope returns to that owner.
For `--plan-only` or a planning-phase handoff, return the proposed bindings and
unresolved choices before connection creation or `pa app add data-source`.
Do not update the app plan, memory-bank, configuration, or generated files on
that path; missing discovery access is not permission to create a connection.

Action connectors do not imply Dataverse Data Model changes.

**Cloud flows are not supported by mobile skills.** For a request to add,
refresh, invoke, or remove a cloud-flow binding, report
`BLOCKED: cloud-flow integration is not supported` and return before discovery
or mutation. Do not treat a flow as a connector data source.

**Removal branch:** after resolving invocation scope, if `--remove` or the approved scope
requests removal, execute
[data-source-removal.md](../../shared/references/data-source-removal.md) and return.
Do not run Steps 1-6, connection creation, or `add-data-source` for a removal.

**Refresh branch:** after resolving invocation scope, `--refresh` or an approved retained-source
refresh executes [Refresh a retained source](../../shared/references/data-source-removal.md#refresh-a-retained-source)
and returns before Steps 1-6. Preserve the exact `--data-source-name` and approved
binding identity; do not create connections or run `add-data-source`.

Fallback skill for any connector not covered by a dedicated `/add-*` skill. For common connectors, prefer the dedicated skills:

- `/add-dataverse` — Dataverse tables
- `/add-sharepoint` — SharePoint Online

(More dedicated skills will land in v1: `/add-teams`, `/add-excel`, `/add-onedrive`, `/add-azuredevops`, `/add-office365`.)

The native host runtime (`@microsoft/power-apps-native-host`) handles connector routing, connection resolution, and OAuth consent through `PowerAppsProvider` in `app/_layout.tsx` — no separate executor wiring is needed.

## Workflow

1. Check Memory Bank → 2. Identify Connector → 3. Add Connector → 4. Inspect & Configure → 5. Build → 6. Update Memory Bank

---

### Step 1 — Check Memory Bank

**Telemetry checkpoint: `validate_connector_project`**

Check for `memory-bank.md` per [shared-instructions.md](${PLUGIN_ROOT}/shared/shared-instructions.md).

Also confirm we're inside a Power Apps mobile app:

```bash
cd -- '<working_dir>' || { echo "BLOCKED: cannot enter working_dir" >&2; exit 1; }
if [ ! -f power.config.json ] || [ ! -f app.config.js ]; then
  echo "BLOCKED: working_dir is not an initialized app" >&2
  exit 1
fi
```

If either is missing, instruct the user to run `/create-mobile-app` first and stop.

### Step 2 — Identify Connector

**Telemetry checkpoint: `resolve_connector_request`**

**If `$ARGUMENTS` is provided or the caller already specified the connector**, use it directly and skip the question below.

Otherwise, ask the user which connector they want to add. Browse available connectors: [Connector Reference](https://learn.microsoft.com/en-us/connectors/connector-reference/).

Classify the requested operation before matching the delegation table. Dataverse
actions/functions follow the discovery-only branch below directly, skipping
connection lookup and data-source generation, never the table CRUD workflow.
If the operation is ambiguous, ask before delegating.
Use aliases only for routing; pass the exact discovered API ID to CLI commands.

**Dataverse actions/functions: discover and return here.**

```bash
cd -- '<working_dir>' || { echo "BLOCKED: cannot enter working_dir" >&2; exit 1; }
$PA app find-dataverse-api --search '<operation-name>' --json
```

Surface the matching metadata and STOP this leaf with a clear note that this
plugin adds Dataverse table CRUD, not actions/functions. Do not enter Step 3,
invoke `/list-connections`, or generate a table service on this branch.
If the user actually needs table CRUD, use the delegation table below.

**Then check if this operation has a dedicated skill. If it does, delegate and STOP:**

| Connector API name      | Delegate to        |
| ----------------------- | ------------------ |
| `sharepointonline`, `shared_sharepointonline` | `/add-sharepoint` |
| `dataverse`, `commondataservice`, `shared_commondataservice`, `commondataserviceforapps`, `shared_commondataserviceforapps` (table CRUD only) | `/add-dataverse` |

Invoke the appropriate skill with the same `$ARGUMENTS`, absolute `working_dir`,
current request, owner/phase/scope, and proposal-only mode. **Do not continue this
skill's workflow** or infer execution approval from this routing decision.

Common connector API names:

- `sharepointonline`, `teams`, `excelonlinebusiness`, `onedriveforbusiness`
- `azuredevops`, `azureblob`, `azurequeues`
- `office365`, `office365users`, `office365groups`
- `sql`, `commondataservice`

### Step 3 — Add Connector

**Telemetry checkpoint: `generate_connector_data_source`**

**First, preserve or resolve the connection binding** using
[connector-reference.md](../../shared/connector-reference.md#step-1--get-a-connection):

- Supplied `--connection-id` (or approved caller `connectionId`): reuse that exact
  ID for the confirmed connector/environment; skip `/list-connections` and creation.
- Supplied `--connection-ref` (or approved caller `connectionRef`): preserve that
  reference for generation; skip `/list-connections` and creation. Do not replace
  it with a newly selected ID.
- Missing binding only: invoke `/list-connections` with the connector API ID
  and current scoped context to resolve the missing value. Conflicting, blank,
  or ambiguous supplied values return to the owner instead of creating a fallback.

The commands below show the connection-ID path. For a reference binding,
replace `--connection-id <connectionId>` with
`--connection-ref '<connectionRef>'` on `add-data-source` only. Reuse supplied
dataset/table/procedure choices and skip their discovery. If discovery is still
needed and requires an ID, obtain the backing ID for the approved reference or
the missing concrete choices; do not create another connection or pass an
unsupported reference flag to a picker command.

If creation was needed but cannot complete in the CLI, direct the user to the
environment-specific Connections URL from `power.config.json` `environmentId`:
`https://make.powerapps.com/environments/<environment-id>/connections` → **+ New connection** → search for the connector → Create.

**Classify the connector before running `pa app add data-source`:**

| Connector shape | Examples | Required discovery | Add command |
| --- | --- | --- | --- |
| Action-style connector | Teams, Office 365 Users, Outlook, Azure DevOps | None after connection lookup | `$PA app add data-source --connector <apiId> --connection-id <connectionId>` |
| Table-based connector | Excel Online, OneDrive for Business, Azure Blob, SQL, SharePoint if not delegated | `connection list-datasets`, then `connection list-tables` | `$PA app add data-source --connector <apiId> --connection-id <connectionId> --dataset '<dataset>' --table '<table>'` |
| SQL stored procedure | SQL Server | `connection list-datasets`, then `connection list-procedures` if needed | `$PA app add data-source --connector shared_sql --connection-id <connectionId> --dataset '<database>' --procedure '<procedure>'` |

**For action-style connectors, print before starting:**
> "→ Running `pa app add data-source` for <connector>. ~10–30 seconds (writes generated services + connector schemas)."

Then run:

```bash
cd -- '<working_dir>' || { echo "BLOCKED: cannot enter working_dir" >&2; exit 1; }
$PA app add data-source --connector <apiId> --connection-id <connectionId>
```

**For table-based connectors, discover datasets and tables first:**

```bash
cd -- '<working_dir>' || { echo "BLOCKED: cannot enter working_dir" >&2; exit 1; }
$PA connection list-datasets --connector <apiId> --connection-id <connectionId> --json
$PA connection list-tables --connector <apiId> --connection-id <connectionId> --dataset '<dataset>' --json
```

Present the datasets/tables to the user if they did not specify them. Approve
the exact selected bindings before generation, or reuse matching current owner
approval; proposal-only discovery returns without adding sources.
Add one data source per approved table:

```bash
cd -- '<working_dir>' || { echo "BLOCKED: cannot enter working_dir" >&2; exit 1; }
$PA app add data-source --connector <apiId> --connection-id <connectionId> --dataset '<dataset>' --table '<table>'
```

**For SQL stored procedures, discover procedures only when the user asks to invoke a stored procedure rather than a table:**

```bash
cd -- '<working_dir>' || { echo "BLOCKED: cannot enter working_dir" >&2; exit 1; }
$PA connection list-procedures --connection-id <connectionId> --dataset '<database>' --json
```

Approve the exact procedure binding before generation if it was not already in
the current approved scope; proposal-only discovery returns without adding it.

```bash
cd -- '<working_dir>' || { echo "BLOCKED: cannot enter working_dir" >&2; exit 1; }
$PA app add data-source --connector shared_sql --connection-id <connectionId> --dataset '<database>' --procedure '<procedure>'
```

**Parameter reference:**

- `--connector` — connector API ID (often `shared_<connector>`, e.g., `shared_office365users`). Use the exact value provided by the caller or connector docs.
- `--connection-id` / `-c` — required for non-Dataverse connectors unless using `--connection-ref`. Get from `pa connection create`, the maker portal, or caller context.
- `--connection-ref` — optional connection reference name when adding into a solution-aware app.
- `--dataset` / `-d` — required for table-based datasources (for example SharePoint site URL, Excel file/location, SQL database).
- `--table` — table/list/resource name for table-based datasources.
- `--procedure` — SQL stored procedure name when adding a stored procedure instead of a table.
- `--non-interactive` — use only on commands whose required options are fully supplied and whose implementation supports non-interactive omission of optional prompts. Do not add `--environment-id` to app-root verbs once `power.config.json` exists.
- `--solution-id` / `-s` — optional solution identifier when the data source should be added to a specific solution.

### Step 4 — Inspect & Configure

After adding, inspect the generated files. **Generated service files can be very large** — use `Grep` to find specific methods instead of reading the entire file:

```
Grep pattern="async \w+" path="<working_dir>/src/generated/services/<Connector>Service.ts"
```

Files to check:

- `src/generated/services/<Connector>Service.ts` — available operations and their parameters
- `src/generated/models/<Connector>Model.ts` — TypeScript interfaces (if generated)
- `.power/schemas/<connector>/` — connector schema and configuration

For each method the user needs:

1. Grep for the method name to find its signature
2. Read just that method's section (use `offset` and `limit` parameters on Read)
3. Identify required vs optional parameters and response type

Return the needed method signatures and usage guidance to the user or current
owner. Do not change screens or launch another app workflow. Report generated
service availability separately from consumer integration.

### Step 5 — Build

**Telemetry checkpoint: `validate_connector_integration`**

**Print before starting:**
> "→ Regenerating connector schemas + running tsc to verify the new connector wires in cleanly (~10–20 seconds)."

`pa app add data-source` (Step 3) wrote new files into `.power/schemas/<connector>/`. The `connectorSchemas.ts` consumed by `app/_layout.tsx` is now stale — regenerate it before type-checking so the new connector is wired into the runtime schema map:

```bash
cd -- '<working_dir>' || { echo "BLOCKED: cannot enter working_dir" >&2; exit 1; }
npm run generate-schemas
npx --no-install tsc --noEmit
```

Fix TypeScript errors before proceeding. If a generated service requires a missing
dependency, inspect its package contents before choosing a repair. Do not install
native packages absent from the template. Return a JS-only dependency requirement
to the orchestrator for the approved exact-version
[JavaScript dependency plan](../../shared/references/javascript-dependency-planning.md);
for a standalone call obtain that approval before installation. Do not
install an unplanned package merely to silence TypeScript.

Do NOT deploy yet — that's `/deploy`'s job after all data sources are added.

### Step 6 — Update Memory Bank

Update `memory-bank.md` with: connector added, configured operations, build status.

## Remove a data source

Apply the data-source invocation scope first for removals too. Identify consuming
screens/services before deleting a dependency. Standalone removal must stop if
it would leave broken consumers; report the required consumer work separately
rather than automatically invoking another workflow.

Read and execute
[data-source-removal.md](../../shared/references/data-source-removal.md) for the
supported command, scope preflight, generated/config cleanup checks, and
inventory reconciliation. This also covers sources originally added outside
this skill; use the actual registered identity rather than assuming its name.

## Runtime connector handling

The native host runtime handles all connector routing automatically via `PowerAppsProvider` in `app/_layout.tsx`. When a screen calls a generated service method:

1. `PowerAppsProvider` resolves the connection from `connectionReferences` in `power.config.json`
2. If the connection requires OAuth consent, `ConnectionSetupScreen` is shown automatically
3. `NativePowerAppsBridge` dispatches the call with the correct auth token

No separate executor or provider wiring is needed — Dataverse and non-Dataverse connectors use the same unified pipeline.

## Notes

- Generated files in `src/generated/` are produced directly by `pa app add data-source`. Differences in behavior come from runtime wiring in this mobile plugin.
- This skill never modifies `app.config.js` or `playerConfig.ts` — connector discovery is dynamic at runtime.

© Microsoft · MIT · microsoft/power-platform-skills

Похожие скиллы

Все скиллы по теме «Мобильная разработка» →

Сначала — add-connector от других авторов.

add-connector Microsoft Скилл add-connector подключает любые коннекторы Power Platform к кодовым приложениям Power Apps, если для них нет отдельного специализированного скилла. CX Codex +1 ★ 1 167звёзд репо power-platform-connector официальный github Правило power-platform-connector для GitHub Copilot, которое подсказывает, как писать JSON-схемы кастомных коннекторов Power Platform: Swagger 2.0, apiProperties и settings. CX Codex +1 ★ 41 430звёзд репо power-platform-architect официальный Tim Hanewich Скилл power-platform-architect для GitHub Copilot превращает требования бизнеса и расшифровки встреч в архитектуру решения на Power Platform. Он также подбирает компоненты и строит диаграммы Mermaid.js. CX Codex +1 205установок design-mobile-apps designed-by-ai Скилл design-mobile-apps генерирует экраны мобильных приложений через сервис Sleek и помогает перенести готовый макет в React Native или HTML. CX Codex +1 1 500 000установок vercel-react-native-skills vercel Скилл vercel-react-native-skills для Claude Code и других агентов: правила React Native и Expo по спискам, анимациям и навигации. Держит правки мобильного кода в одном стиле. CX Codex +1 283 800установок animate-expo emilkowalski Скилл animate-expo для Claude Code, который автоматизирует создание анимаций в React Native и Expo. Агент выбирает инструменты и методы реализации, ориентируясь на производительность UI-потока. CX Codex +1 189 400установок expo-module expo Скилл expo-module для Claude Code помогает создавать и менять нативные модули и представления Expo. Он подключается к задачам с Expo Modules API на Swift, Kotlin и TypeScript. CX Codex +1 51 000установок

Из того же набора157

Весь набор →
pcf Скилл pcf собирает, тестирует, обновляет и разворачивает кодовые компоненты Power Apps Component Framework для model-driven apps и Power Pages — поля, датасеты, React-контролы. CX Codex +1 ★ 1 167звёзд репо create-webroles Скилл create-webroles создаёт и настраивает веб-роли для сайтов Power Pages. Помогает разграничить доступ для авторизованных и анонимных посетителей прямо в YAML-файлах проекта. CX Codex +1 ★ 1 167звёзд репо setup-app-insights Скилл setup-app-insights для настройки Application Insights в мобильном приложении Power Apps. Включает телеметрию на существующий ресурс Azure, меняет или отключает её. CX Codex +1 ★ 1 167звёзд репо build-ios-binary Скилл build-ios-binary собирает iOS-модуль контрола PAM в плоский device-slice .framework для бандла .ppmplugin. Нужен Mac с Xcode, сборка идёт из одноразовой копии исходников. CX Codex +1 ★ 1 167звёзд репо force-link-environment Скилл force-link-environment для Claude Code переносит среду Power Platform Pipelines на другой хост. Он запускается при ошибке связи с прежним хостом или по запросу сменить хост. CX Codex +1 ★ 1 167звёзд репо create-code-app Скилл create-code-app для Claude Code собирает Power Apps code apps: по заданной задаче создаёт проект на React и Vite и разворачивает его в Power Platform. CX Codex +1 ★ 1 167звёзд репо add-table-to-offline-profile Скилл add-table-to-offline-profile для Claude Code подключает одну таблицу Dataverse к настроенному Mobile Offline Profile. Запускается после добавления новой сущности. CX Codex +1 ★ 1 167звёзд репо security-review Скилл security-review проводит проверку безопасности сайта Power Pages и собирает результаты в HTML-отчёт. Выберите проверку локальных файлов, готовности к публикации или развёрнутого сайта. CX Codex +1 ★ 1 167звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой