azure-service-connector

name	azure-service-connector
description	Expert knowledge for Azure Service Connector development including troubleshooting, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when wiring Azure compute to Cosmos DB, Key Vault, Redis, Kafka, OpenAI, or external services via Service Connector, and other Azure Service Connector related development tasks. Not for Azure App Service (use azure-app-service), Azure Functions (use azure-functions), Azure Logic Apps (use azure-logic-apps), Azure API Management (use azure-api-management).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-04-19","generator":"docs2skills/1.0.0"}

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 Azure Service Connector failures, including common error codes, connection issues, and step-by-step troubleshooting for misconfigurations.
Limits & Quotas	L39-L43	Limits on number/types of connections, supported scenarios, and guidance to mitigate Service Connector constraints or unsupported configurations.
Security	L44-L50	Service Connector security, required permissions and Microsoft Entra roles, and how to configure and choose authentication methods for connected services
Configuration	L51-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	How to connect Azure compute to databases, messaging, storage, AI, and external services (Cosmos DB, Kafka, Redis, Key Vault, OpenAI, etc.) using Service Connector integration patterns
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
Diagnose and fix Azure Service Connector errors	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
Configure authentication options for Azure Service Connector	https://learn.microsoft.com/en-us/azure/service-connector/how-to-manage-authentication

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
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

Deployment

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