Skip to content
azure-service-connector logo

Azure Service Connector Skill

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, storage, messaging, AI services, managing auth, regions, IaC, or connection limits, a...

MicrosoftDocs/Agent-Skills0installs773stars

SKILL.md

Full skill instructions

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

CategoryLinesDescription
TroubleshootingL34-L39Diagnosing and resolving common Azure Service Connector errors, connection failures, auth/​permission issues, and configuration problems across supported services and runtimes.
Limits & QuotasL40-L44Limits on number/​types of connections, supported scenarios, and guidance to mitigate Service Connector constraints or unsupported configurations.
SecurityL45-L51Service Connector security, required permissions and Microsoft Entra roles, and how to configure and choose authentication methods for connected services
ConfigurationL52-L58How to define and retrieve Service Connector connection settings, choose and configure auth methods, and supply correct CLI/​IaC parameters for creating connections
Integrations & Coding PatternsL59-L91How to connect Azure compute to databases, messaging, storage, AI, and config services using Service Connector, including auth patterns, setup steps, and integration examples.
DeploymentL92-L95Info on where Service Connector is regionally supported per compute service and how to create connections using infrastructure-as-code tools.

Troubleshooting

Limits & Quotas

TopicURL
Service Connector limitations and mitigation guidancehttps://learn.microsoft.com/en-us/azure/service-connector/known-limitations

Security

TopicURL
Review Microsoft Entra roles assigned by Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/concept-microsoft-entra-roles
Understand Service Connector permission requirements in Azurehttps://learn.microsoft.com/en-us/azure/service-connector/concept-permission
Configure authentication options for Azure Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-manage-authentication

Configuration

Integrations & Coding Patterns

TopicURL
Integrate Foundry Tools via Azure Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-ai-services
Integrate Azure App Configuration via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-app-configuration
Connect Azure AI multi-service via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-cognitive-services
Connect Confluent Cloud Kafka with Azure via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-confluent-kafka
Connect Cosmos DB Cassandra via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-cosmos-cassandra
Connect Cosmos DB MongoDB via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-cosmos-db
Connect Cosmos DB Gremlin via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-cosmos-gremlin
Connect Cosmos DB NoSQL via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-cosmos-sql
Connect Cosmos DB Table via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-cosmos-table
Configure Service Connector integration with Azure Event Hubshttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-event-hubs
Connect Fabric SQL database via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-fabric-sql
Connect Azure Key Vault via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-key-vault
Connect MongoDB Atlas via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-mongodb-atlas
Connect Azure Database for MySQL via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-mysql
Connect Neon Serverless Postgres via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-neon-postgres
Connect Azure OpenAI Foundry via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-openai
Connect Azure Database for PostgreSQL via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-postgres
Integrate Azure Cache for Redis using Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-redis-cache
Connect Azure Service Bus via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-service-bus
Integrate Azure SignalR Service using Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-signalr
Connect Azure SQL Database via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-sql-database
Integrate Azure Blob Storage with Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-storage-blob
Connect Azure Files to compute with Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-storage-file
Integrate Azure Queue Storage via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-storage-queue
Connect Azure Table Storage via Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-storage-table
Connect Azure Web PubSub using Service Connectorhttps://learn.microsoft.com/en-us/azure/service-connector/how-to-integrate-web-pubsub
Connect JBoss EAP on App Service to MySQL with managed identityhttps://learn.microsoft.com/en-us/azure/service-connector/tutorial-java-jboss-connect-managed-identity-mysql-database
Store Service Connector settings in Azure App Configurationhttps://learn.microsoft.com/en-us/azure/service-connector/tutorial-portal-app-configuration-store
Use Service Connector with AKS workload identity for Storagehttps://learn.microsoft.com/en-us/azure/service-connector/tutorial-python-aks-storage-workload-identity

Deployment

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