Skill 05 · AKS Troubleshooting
Subchapter 5.3
references/azure-mcp.mdMarkdown3 KBView on GitHub
Azure MCP Server is the @azure/mcp package configured by this repository. The AKS MCP server is the separate Azure/aks-mcp product; this repository does not configure it, and none of its deep Kubernetes tools or access-level flags are part of this reference.
Use this reference to select Azure MCP Server operations and portable fallbacks in the current host.
Do not guess names, translate one host’s name to another, or build a mapping layer. Capability metadata supplied by the host is the source of truth.
az and kubectl flows for all other Azure-side and Kubernetes-side evidenceAfter selecting the Azure MCP AKS area, inspect the exact operations and parameter schemas the host advertises. Its current scope is read-only metadata:
Do not infer detector execution, monitoring queries, Resource Health checks, or Kubernetes command execution from the AKS area. Use the separate Azure MCP area that advertises the needed operation, or use the portable command flows.
Authentication is host-specific. In Azure SRE Agent, built-in Azure operations use the agent’s user-assigned managed identity; verify its target scope and RBAC. An external MCP connector uses the authentication configured on that connector. In CLI-backed hosts, the Azure MCP server can use the host’s Azure CLI or service-principal context. Inspect the host and tool schema rather than assuming one credential source.
Use these portable fallbacks whenever the host lacks the relevant Azure MCP Server area or its advertised schema does not provide the needed operation:
az aks for Azure-side AKS operationskubectl for Kubernetes-side inspection