mcpField
A
add-connector

add-connector

github.com/microsoft開発1.1k252 回インストール今日更新
リポジトリ

add-connector について

専用の追加スキルがない場合に、Power Apps プロジェクトへコネクタを追加する開発スキルです。コネクタの選定、生成されたサービスの確認、設定、ビルド検証を案内します。

主な機能

  1. 01コネクタと専用スキルの判別
  2. 02接続 ID の確認
  3. 03表形式・非表形式データソースの追加
  4. 04生成サービスとモデルの確認
  5. 05ビルドと Memory Bank の更新

活用シーン

  1. 01Azure DevOps などのコネクタを追加
  2. 02操作パラメーターを確認して呼び出しコードを作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/microsoft/power-platform-skills --skill add-connector

インストール後、Claude Code で/add-connectorを入力して読み込まれたか確認します。

詳細

📋 共通手順： shared-instructions.md - 全般的な注意事項。

コネクタの追加（汎用）

特定の /add-* スキルで扱われていないコネクタ用のフォールバックスキルです。よく使われるコネクタには、専用スキルを優先してください。

  • /add-dataverse -- Dataverse テーブル
  • /add-azuredevops -- Azure DevOps
  • /add-teams -- Microsoft Teams
  • /add-excel -- Excel Online (Business)
  • /add-onedrive -- OneDrive for Business
  • /add-sharepoint -- SharePoint Online
  • /add-office365 -- Office 365 Outlook（カレンダー、メール、連絡先）
  • /add-workiq -- Work IQ（M365 Copilot Search）

ワークフロー

  1. Memory Bank を確認 → 2. コネクタを特定 → 3. コネクタを追加 → 4. 調査して設定 → 5. ビルド → 6. Memory Bank を更新
ステップ 1：Memory Bank を確認

shared-instructions.mdに従ってmemory-bank.mdを確認します。

ステップ 2：コネクタを特定

$ARGUMENTSが指定されている場合、または呼び出し元がすでにコネクタを指定している場合は、それをそのまま使用し、以下の質問はスキップします。

それ以外の場合は、追加するコネクタをユーザーに尋ねます。利用可能なコネクタを参照してください：コネクタリファレンス

続行する前に、コネクタに専用スキルがあるか確認します。ある場合は、すぐに委任して終了します。

コネクタ API 名委任先
shared_a365copilotchatmcp/add-workiq
sharepointonline/add-sharepoint
teams/add-teams
excelonlinebusiness/add-excel
onedriveforbusiness/add-onedrive
azuredevops/add-azuredevops
office365/add-office365
commondataservice/add-dataverse

同じ$ARGUMENTSを指定して適切なスキルを呼び出し、このスキルのワークフローは続行しないでください。

一般的なコネクタ API 名：

  • sharepointonline、teams、excelonlinebusiness、onedriveforbusiness
  • azuredevops、azureblob、azurequeues
  • office365、office365users、office365groups
  • sql、commondataservice
ステップ 3：コネクタを追加

まず、接続 ID を確認します（connector-reference.mdを参照）。

/list-connectionsスキルを実行します。出力からコネクタを探します。該当するものがない場合は、環境固有の接続 URL を使用して作成するようユーザーに案内します。コンテキスト内のアクティブな環境 ID（power.config.jsonまたは前のステップから取得）を使って、次のように URL を組み立てます：https://make.powerapps.com/environments/<environment-id>/connections → + 新しい接続 → コネクタを検索 → 作成。

# Non-tabular connectors (Teams, Azure DevOps, etc.)
pa app add data-source --connector <connector-api-name> -c <connection-id>

# Tabular connectors (SharePoint, Excel, SQL, etc.) -- also need dataset and table
pa app add data-source --connector <connector-api-name> -c <connection-id> -d '<dataset>' --table '<table>'

パラメーターリファレンス：

  • --connector（apiId）-- コネクタ名（例：sharepointonline、teams）。フラットなpower-appsバイナリでは、--api-id/-aです。
  • -c（connectionId）-- Dataverse 以外のすべてのコネクタで必須です。/list-connectionsから取得します。
  • -d（dataset）-- 表形式のデータソース（例：SharePoint サイトの URL、SQL データベース）で必須です。Dataverse では不要です。
  • --table（table）-- 表形式のデータソースのテーブル／リスト名（例：SharePoint リスト、Dataverse テーブルの論理名）。フラットなpower-appsバイナリでは、--resource-name/-tです。
ステップ 4：確認と設定

追加後、生成されたファイルを確認します。生成されたサービスファイルは非常に大きくなる場合があります。ファイル全体を読むのではなく、Grep を使って特定のメソッドを探してください。

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

確認するファイル：

  • src/generated/services/<Connector>Service.ts -- 利用可能な操作とそのパラメーター
  • src/generated/models/<Connector>Model.ts -- TypeScript インターフェース（生成されている場合）
  • .power/schemas/<connector>/ -- コネクターのスキーマと設定

ユーザーが必要とする各メソッドについて：

  1. メソッド名を Grep で検索し、シグネチャを確認します
  2. そのメソッドのセクションだけを読みます（Read の offset と limit パラメーターを使用します）
  3. 必須パラメーターと任意パラメーター、およびレスポンスの型を特定します

生成されたサービスメソッドを使ったコードの作成をユーザーに支援します。

ステップ 5：ビルド
npm run build

先に進む前に TypeScript のエラーを修正します。まだデプロイしないでください。

ステップ 6：メモリーバンクの更新

memory-bank.md を更新し、追加したコネクター、設定した操作、ビルドのステータスを記録します。

コメント

Markdown 対応