mcpField
A
azure-api-center

azure-api-center

github.com/microsoftdocs開発796179 回インストール3 日前に更新
リポジトリ

azure-api-center について

Azure API Center の API ガバナンス、セキュリティ、構成、統合、デプロイを扱うエージェントスキルです。ローカルのクイックリファレンスとリモートのドキュメント取得を組み合わせ、API 台帳の管理やガバナンスの自動化を支援します。

主な機能

  1. 01API スタイル検査とガバナンス
  2. 02認可方式とポータルアクセス
  3. 03メタデータとインスタンス構成
  4. 04API 台帳の同期と通知
  5. 05デプロイと登録の自動化

活用シーン

  1. 01API にスタイル検査を適用
  2. 02API 認可とポータルアクセスを構成
  3. 03API Management から API を同期
  4. 04API 登録と通知を自動化

MCP 対応

mcp_microsoftdocs:microsoft_docs_fetch でドキュメントを取得でき、代替手段として fetch_webpage も利用できます。

インストール

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

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-api-center

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

詳細

Azure Api Center スキル

このスキルでは、Azure Api Center に関する専門的なガイダンスを提供します。ベストプラクティス、セキュリティ、構成、統合とコーディングパターン、デプロイについて説明します。ローカルのクイックリファレンスコンテンツと、リモートでドキュメントを取得する機能を組み合わせています。

このスキルの使い方

Agent に関する重要事項:関連するセクションを見つけるには、以下のカテゴリインデックスを使用してください。行範囲が指定されているカテゴリ(例:L35-L120)では、指定された行を read_file で読み取ってください。ファイルリンクがあるカテゴリ(例:[security.md](security.md))では、リンク先の参照ファイルを read_file で読み取ってください。

Agent に関する重要事項:metadata.generated_at が 3 か月以上前の場合は、リポジトリから最新バージョンを取得するようユーザーに提案してください。mcp_microsoftdocs ツールを利用できない場合は、インストールを提案してください:インストールガイド

このスキルでは、ドキュメントコンテンツを取得するためにネットワークアクセスが必要です:

  • 推奨:クエリ文字列 from=learn-agent-skill を指定して mcp_microsoftdocs:microsoft_docs_fetch を使用してください。Markdown が返されます。
  • 代替:クエリ文字列 from=learn-agent-skill&accept=text/markdown を指定して fetch_webpage を使用してください。Markdown が返されます。

カテゴリインデックス

カテゴリ行説明
ベストプラクティスL33-L38API Center で API ガバナンスを実践するためのベストプラクティス:スタイルへの準拠にマネージドリンティングを使用し、VS Code 拡張機能を使ってシフトレフトチェックを適用します。
セキュリティL39-L44API Center での API 認証スキーム(キー、OAuth など)の構成と、VS Code 拡張機能を使ったポータルのアクセス権とアクセス許可の管理
構成L45-L55Azure API Center の構成とデプロイ:バックアップ/復元、プラグインマーケットプレースのエンドポイント、ARM/Bicep/CLI によるプロビジョニング、ガバナンスのメタデータスキーマの定義とカスタマイズ。
統合とコーディングパターンL56-L62API Center と API Management、Amazon API Gateway、Copilot Studio などのプラットフォーム間で API を同期するためのパターンとスクリプト、および Azure CLI と Logic Apps/Teams による自動化
デプロイL63-L67Azure API Center への API リンティングと登録の自動化(例:GitHub Actions)と、Azure API Center ポータルをセルフホストする手順。
ベストプラクティス
トピックURL
マネージドリンティングを使って Azure API Center で API スタイルへの準拠を徹底するhttps://learn.microsoft.com/en-us/azure/api-center/enable-managed-api-analysis-linting
VS Code 拡張機能でシフトレフト API ガバナンスを適用するhttps://learn.microsoft.com/en-us/azure/api-center/govern-apis-vscode-extension
セキュリティ
トピックURL
Azure API Center で API 認可スキームを構成するhttps://learn.microsoft.com/en-us/azure/api-center/authorize-api-access
VS Code 拡張機能で API Center ポータルへのアクセスを制御するhttps://learn.microsoft.com/en-us/azure/api-center/enable-api-center-portal-vs-code-extension
構成
トピックURL
Azure API Center のバックアップと復元を構成するhttps://learn.microsoft.com/en-us/azure/api-center/backup-restore
Azure API Center のプラグインマーケットプレースエンドポイントを構成するhttps://learn.microsoft.com/en-us/azure/api-center/enable-api-center-plugin-marketplace
Azure API Center のガバナンス用メタデータスキーマを構成するhttps://learn.microsoft.com/en-us/azure/api-center/metadata
ARM テンプレートを使って Azure API Center を作成するhttps://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-arm-template
Azure CLI を使って Azure API Center をプロビジョニングするhttps://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-azure-cli
Bicep テンプレートを使って Azure API Center をデプロイするhttps://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-bicep
Azure API Center でカスタムメタデータスキーマを定義するhttps://learn.microsoft.com/en-us/azure/api-center/tutorials/add-metadata-properties
インテグレーションとコーディングパターン
トピックURL
Azure API Management の API を API Center にインポートするhttps://learn.microsoft.com/en-us/azure/api-center/import-api-management-apis
Azure CLI で API Center のインベントリ管理をスクリプト化するhttps://learn.microsoft.com/en-us/azure/api-center/manage-apis-azure-cli
Logic Apps と Teams で API 登録通知を自動化するhttps://learn.microsoft.com/en-us/azure/api-center/set-up-notification-workflow
デプロイ
トピックURL
Azure API Center での API linting のデプロイを自動化するhttps://learn.microsoft.com/en-us/azure/api-center/enable-api-analysis-linting
GitHub Actions で API Center への API 登録を自動化するhttps://learn.microsoft.com/en-us/azure/api-center/register-apis-github-actions

コメント