Agent-Skills azure-service-connector

Expert knowledge for Azure Service Connector development including troubleshooting, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when wiring Azure compute to DBs, messaging, storage, AI, or config services via Service Connector APIs, and other Azure Service Connector related development tasks. Not for Azure API Management (use azure-api-management), Azure App Service (use azure-app-service), Azure Functions (use azure-functions), Azure Logic Apps (use azure-logic-apps).

install

source · Clone the upstream repo

git clone https://github.com/MicrosoftDocs/Agent-Skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/MicrosoftDocs/Agent-Skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/azure-service-connector" ~/.claude/skills/microsoftdocs-agent-skills-azure-service-connector && rm -rf "$T"

manifest: skills/azure-service-connector/SKILL.md

source content

Azure Service Connector Skill

This skill provides expert guidance for Azure Service Connector. Covers troubleshooting, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,
L35-L120
), use
read_file
with the specified lines. For categories with file links (e.g.,
[security.md](security.md)
), use
read_file
on the linked reference file

IMPORTANT for Agent: If
metadata.generated_at
is more than 3 months old, suggest the user pull the latest version from the repository. If
mcp_microsoftdocs
tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

Preferred: Use

mcp_microsoftdocs:microsoft_docs_fetch

with query string

from=learn-agent-skill

. Returns Markdown.

Fallback: Use

fetch_webpage

with query string

from=learn-agent-skill&accept=text/markdown

. Returns Markdown.

Category Index

Category	Lines	Description
Troubleshooting	L34-L38	Diagnosing and resolving Service Connector errors and failures, including common error codes, connection issues, and steps to debug and fix failed connections.
Limits & Quotas	L39-L43	Limits on number/types of connections, supported scenarios, and guidance to mitigate Service Connector constraints or unsupported configurations.
Security	L44-L49	Details on what Azure and Microsoft Entra roles/permissions Service Connector needs or assigns, and how to review and manage those access requirements securely
Configuration	L50-L57	How to define and retrieve Service Connector connection settings, choose and configure auth methods, and supply correct CLI/IaC parameters for creating connections
Integrations & Coding Patterns	L58-L87	Patterns and how-to guides for connecting apps to databases, messaging, storage, AI, and config services using Azure Service Connector (auth options, setup steps, language samples).
Deployment	L88-L91	Info on where Service Connector is regionally supported per compute service and how to create connections using infrastructure-as-code tools.

Troubleshooting

Topic	URL
Troubleshoot Service Connector errors and failures	https://learn.microsoft.com/en-us/azure/service-connector/how-to-troubleshoot-front-end-error

Limits & Quotas

Topic	URL
Service Connector limitations and mitigation guidance	https://learn.microsoft.com/en-us/azure/service-connector/known-limitations

Security

Topic	URL
Review Microsoft Entra roles assigned by Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/concept-microsoft-entra-roles
Understand Service Connector permission requirements in Azure	https://learn.microsoft.com/en-us/azure/service-connector/concept-permission

Configuration

Topic	URL
Define Azure Service Connector IaC connection settings	https://learn.microsoft.com/en-us/azure/service-connector/how-to-build-connections-with-iac-tools
Retrieve Service Connector-added connection configurations	https://learn.microsoft.com/en-us/azure/service-connector/how-to-get-configurations
Configure authentication options in Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-manage-authentication
Provide correct CLI parameters to Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-provide-correct-parameters

Integrations & Coding Patterns

Topic	URL
Integrate Foundry Tools via Azure Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-ai-services
Integrate Azure App Configuration via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-app-configuration
Connect Azure AI multi-service via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-cognitive-services
Connect Confluent Cloud Kafka with Azure via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-confluent-kafka
Connect Cosmos DB Cassandra via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-cosmos-cassandra
Connect Cosmos DB MongoDB via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-cosmos-db
Connect Cosmos DB Gremlin via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-cosmos-gremlin
Connect Cosmos DB NoSQL via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-cosmos-sql
Connect Cosmos DB Table via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-cosmos-table
Configure Service Connector integration with Azure Event Hubs	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-event-hubs
Connect Fabric SQL database via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-fabric-sql
Connect Azure Key Vault via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-key-vault
Connect MongoDB Atlas via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-mongodb-atlas
Connect Azure Database for MySQL via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-mysql
Connect Neon Serverless Postgres via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-neon-postgres
Connect Azure OpenAI Foundry via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-openai
Connect Azure Database for PostgreSQL via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-postgres
Integrate Azure Cache for Redis using Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-redis-cache
Connect Azure Service Bus via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-service-bus
Integrate Azure SignalR Service using Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-signalr
Connect Azure SQL Database via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-sql-database
Integrate Azure Blob Storage with Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-storage-blob
Connect Azure Files via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-storage-file
Connect Azure Queue Storage via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-storage-queue
Connect Azure Table Storage via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-storage-table
Connect Azure Web PubSub via Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-web-pubsub

Deployment

Topic	URL
Check Service Connector regional support by compute service	https://learn.microsoft.com/en-us/azure/service-connector/concept-region-support