[{"_1":2,"_384":-5,"_385":-5},"loaderData",{"_3":4,"_22":23,"_279":280},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",22248096,"membership","referenceId","019a3c9b-43cc-72d8-8c00-496521d6e6ee","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_74":-5,"_75":38,"_27":76,"_195":196,"_278":177},"availableLocales",[26,38,44,50,56,62,68],{"_27":28,"_34":35,"_36":37},"mcpServer",{"_29":30,"_31":30,"_32":33},"description","Azure MCP-Server","displayName","readme","# 🌟 Azure MCP-Server\n\n[![Mit NPX in VS Code installieren](https://img.shields.io/badge/VS_Code-Install_Azure_MCP_Server-0098FF?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D) [![Installation mit NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Azure_MCP_Server-24bfa5?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D\\&quality=insiders)\n\nDer Azure MCP-Server implementiert die [MCP-Spezifikation](https://modelcontextprotocol.io) , um eine nahtlose Verbindung zwischen KI-Agenten und wichtigen Azure-Diensten wie Azure Storage, Cosmos DB und mehr herzustellen.\n\n> Bitte beachten Sie, dass sich dieses Projekt in der öffentlichen Vorschau befindet und sich die Implementierung vor unserer allgemeinen Verfügbarkeit erheblich ändern kann.\n\n## 📑 Inhaltsverzeichnis\n\n1. [🎯 Übersicht](#-overview)\n2. [🛠️ Derzeit unterstützte Tools](#%EF%B8%8F-currently-supported-tools)\n3. [🔌 Installation & Erste Schritte](#-getting-started)\n4. [🧪 Verwenden des Azure MCP-Servers](#-test-the-azure-mcp-server)\n5. [📝 Fehlerbehebung](#-troubleshooting)\n6. [👥 Beitragen zum Azure MCP Server](#-contributing)\n\n## 🎯 Übersicht\n\n### ✨ Was können Sie mit dem Azure MCP-Server tun?\n\nDer Azure MCP-Server erweitert Ihre Agenten um Azure-Kontext. Hier sind einige nützliche Eingabeaufforderungen, die Sie ausprobieren können:\n\n### 🔍 Entdecken Sie Ihre Azure-Ressourcen\n\n* „Meine Azure-Speicherkonten auflisten“\n* „Zeigen Sie mir alle meine Cosmos DB-Datenbanken“\n* „Welche Indizes habe ich in meinem Azure AI Search-Dienst ‚mysvc‘?“\n* „Meine Ressourcengruppen auflisten“\n* „Zeigen Sie mir die Tabellen in meinem Speicherkonto“\n* „Container in meiner Cosmos DB-Datenbank auflisten“\n* „Details zu meinem Lagercontainer erhalten“\n* „Kusto-Datenbanken im Cluster ‚mycluster‘ abrufen“\n* „Beispiel: 10 Zeilen aus der Tabelle ‚StormEvents‘ in der Kusto-Datenbank ‚db1‘“\n\n### 📊 Abfragen und Analysieren\n\n* „Meinen Log Analytics-Arbeitsbereich abfragen“\n* „Durchsuchen wir diesen Index nach ‚meiner Suchanfrage‘.“\n\n### ⚙️ Konfiguration verwalten\n\n* „Meine App Configuration Stores auflisten“\n* „Meine Schlüssel-Wert-Paare in der App-Konfiguration anzeigen“\n\n### 🔧 Erweiterte Azure-Operationen\n\n* „Meine Azure CDN-Endpunkte auflisten“\n* „Helfen Sie mir, eine Azure-Anwendung mit Node.js zu erstellen.“\n\n### 🔍 So funktioniert es\n\nDer Azure MCP-Server ermöglicht eine nahtlose Integration zwischen KI-Agenten und Azure-Diensten durch:\n\n* 🔄 Intelligente JSON-Kommunikation, die KI-Agenten verstehen\n* 🏗️ Natürliche Sprachbefehle, die in Azure-Operationen übersetzt werden\n* 💡 Intelligente Parametervorschläge und Autovervollständigung\n* ⚡ Konsistente und sinnvolle Fehlerbehandlung\n\n## 🛠️ Derzeit unterstützte Tools\n\nDer Azure MCP-Server bietet Tools für die Interaktion mit den folgenden Azure-Diensten:\n\n### 🔎 Azure AI Search (Suchmaschine/Vektordatenbank)\n\n* Auflisten der Azure AI Search-Dienste\n* Listen Sie Indizes auf und sehen Sie sich deren Schema und Konfiguration an\n* Suchindizes abfragen\n\n### 📊 Azure Cosmos DB (NoSQL-Datenbanken)\n\n* Auflisten von Cosmos DB-Konten\n* Auflisten und Abfragen von Datenbanken\n* Verwalten von Containern und Artikeln\n* Ausführen von SQL-Abfragen für Container\n\n### 🐘 Azure-Datenbank für PostgreSQL – Flexibler Server\n\n* Datenbanken auflisten und abfragen.\n* Listen Sie Tabellen auf und rufen Sie deren Schema ab.\n* Auflisten, Konfiguration abrufen und Parameter für Server abrufen.\n\n### 🧮 Kusto (Azure Data Explorer)\n\n* Auflisten von Kusto-Clustern\n* Auflisten von Datenbanken in einem Kusto-Cluster\n* Auflisten von Tabellen in einer Kusto-Datenbank\n* Abrufen des Schemas für eine Kusto-Tabelle\n* Beispielzeilen aus einer Kusto-Tabelle\n* Abfragen von Kusto-Datenbanken mit KQL\n\n### 💾 Azure-Speicher\n\n* Auflisten von Speicherkonten\n* Verwalten von Blobcontainern und Blobs\n* Auflisten und Abfragen von Speichertabellen\n* Abrufen von Containereigenschaften und Metadaten\n\n### 📈 Azure Monitor (Log Analytics)\n\n* Auflisten von Log Analytics-Arbeitsbereichen\n* Abfrageprotokolle mit KQL\n* Verfügbare Tabellen auflisten\n\n### ⚙️ Azure App-Konfiguration\n\n* Auflisten von App Configuration-Speichern\n* Schlüssel-Wert-Paare verwalten\n* Beschriftete Konfigurationen handhaben\n* Konfigurationseinstellungen sperren/entsperren\n\n### 🔑 Azure-Schlüsseltresor\n\n* Schlüssel auflisten, erstellen und abrufen\n\n### 📦 Azure-Ressourcengruppen\n\n* Auflisten von Ressourcengruppen\n\n### 🚌 Azure Service Bus\n\n* Untersuchen Sie Eigenschaften und Laufzeitinformationen zu Warteschlangen, Themen und Abonnements\n\n### 🔧 Azure CLI-Erweiterung\n\n* Führen Sie Azure CLI-Befehle direkt aus\n* Unterstützung für alle Azure CLI-Funktionen\n* JSON-Ausgabeformatierung\n* Plattformübergreifende Kompatibilität\n\n### 🚀 Azure Developer CLI (azd)-Erweiterung\n\n* Führen Sie Azure Developer CLI-Befehle direkt aus\n* Unterstützung für Vorlagenerkennung, Vorlageninitialisierung, Bereitstellung und Einsatz\n* Plattformübergreifende Kompatibilität\n\nAgenten und Modelle können Best Practices und Nutzungsrichtlinien für das `azd` MCP-Tool entdecken und erlernen. Weitere Informationen finden Sie unter [AZD Best Practices](https://github.com/Azure/azure-mcp/tree/main/src/Resources/azd-best-practices.txt) .\n\n### 🛡️ Azure Best Practices\n\n* Holen Sie sich bewährte Methoden für sicheres, produktionsreifes Azure SDK zur effektiven Codegenerierung.\n\nEine ausführliche Befehlsdokumentation und Beispiele finden Sie unter [Azure MCP-Befehle](https://github.com/Azure/azure-mcp/blob/main/docs/azmcp-commands.md) .\n\n## 🔌 Erste Schritte\n\nFür die Installation und Ausführung des Azure MCP-Servers ist Node.js erforderlich. Falls Sie Node.js nicht installiert haben, folgen Sie den Anweisungen [hier](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) .\n\n### VS Code + GitHub Copilot\n\nDer Azure MCP-Server bietet Azure SDK- und Azure CLI-Entwicklertools. Er kann allein oder mit der [GitHub Copilot für Azure-Erweiterung](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) in VS Code verwendet werden. Wenn Sie an umfassender Entwicklerunterstützung für verschiedene Azure-Entwicklungsszenarien interessiert sind, die nicht im Azure MCP-Server enthalten sind, z. B. für die Suche nach Dokumentation in Microsoft Learn, empfehlen wir diese Erweiterung ebenfalls.\n\n### Voraussetzungen\n\n1. Installieren Sie entweder die stabile oder die Insider-Version von VS Code:\n * [💫 Stabile Version](https://code.visualstudio.com/download)\n * [🔮 Insider-Veröffentlichung](https://code.visualstudio.com/insiders)\n2. Installieren Sie die Erweiterungen [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) und [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat)\n3. Installieren Sie [Node.js](https://nodejs.org/en/download) 20 oder höher\n * Stellen Sie sicher, dass sich `node` und `npm` in Ihrem Pfad befinden.\n4. Öffnen Sie VS Code in einem leeren Ordner\n\n### Installation\n\n#### ✨ Ein-Klick-Installation\n\nKlicken Sie auf eine dieser Schaltflächen, um den Azure MCP-Server für VS Code oder VS Code Insiders zu installieren.\n\n[![Mit NPX in VS Code installieren](https://img.shields.io/badge/VS_Code-Install_Azure_MCP_Server-0098FF?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D) [![Installation mit NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Azure_MCP_Server-24bfa5?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D\\&quality=insiders)\n\nNachdem Sie den Azure MCP-Server installiert haben, wählen Sie den GitHub Copilot-Agentmodus aus und aktualisieren Sie die Toolliste. Weitere Informationen zum Agentmodus finden Sie in der [VS Code-Dokumentation](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode) .\n\n#### 🔧 Manuelle Installation\n\nBefolgen Sie für eine schrittweise Installation diese Anweisungen:\n\n1. Fügen Sie `.vscode/mcp.json` hinzu:\n\n```json\n{\n \"servers\": {\n \"Azure MCP Server\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@azure/mcp@latest\",\n \"server\",\n \"start\"\n ]\n }\n }\n}\n```\n\n#### Docker-Installation\n\nBefolgen Sie für eine schrittweise Installation diese Anweisungen:\n\n1. Repository klonen\n2. Erstellen Sie das Docker-Image aus dem Stammverzeichnis des Repositorys: `docker build -t azure/azuremcp .`\n3. Erstellen Sie eine `.env` Datei mit Umgebungsvariablen, die [einem der `EnvironmentCredential` Sets entsprechen](https://learn.microsoft.com/dotnet/api/azure.identity.environmentcredential) . Eine `.env` Datei mit einem Dienstprinzipal könnte beispielsweise wie folgt aussehen:\n\n```json\nAZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}\nAZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}\nAZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}\n```\n\n1. Fügen Sie `.vscode/mcp.json` hinzu oder aktualisieren Sie die vorhandene MCP-Konfiguration. Ersetzen Sie `/full/path/to/.env` durch einen Pfad zu Ihrer `.env` Datei.\n\n```json\n{\n \"servers\": {\n \"Azure MCP Server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"azure/azuremcp\",\n \"--env-file\",\n \"/full/path/to/.env\"\n ]\n }\n }\n}\n```\n\nOptional können Kunden `--env` oder `--volume` verwenden, um Authentifizierungswerte zu übergeben.\n\n## 🧪 Testen des Azure MCP-Servers\n\n1. Öffnen Sie GitHub Copilot in VS Code und [wechseln Sie in den Agentenmodus](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)\n2. Sie sollten den Azure MCP-Server in der Liste der Tools sehen\n3. Versuchen Sie es mit einer Eingabeaufforderung, die den Agenten anweist, den Azure MCP-Server zu verwenden, z. B. „Meine Azure Storage-Container auflisten“.\n4. Der Agent sollte in der Lage sein, die Azure MCP Server-Tools zu verwenden, um Ihre Abfrage abzuschließen\n\n## 🤖 Benutzerdefinierte MCP-Clients\n\nSie können Ihren MCP-Client ganz einfach für die Verwendung des Azure MCP-Servers konfigurieren. Lassen Sie Ihren Client den folgenden Befehl ausführen und über Standard-E/A oder SSE darauf zugreifen.\n\n### Verwenden von Standard-IO\n\nKonfigurieren Sie den MCP-Client für die Ausführung von: `npx -y @azure/mcp@latest server start` . Anweisungen zur Verwendung von VS Code finden Sie in [der Ein-Klick-Installation](#-one-click-install) oder [der manuellen Installation](#-manual-install) .\n\n### Verwenden von SSE\n\n1. Öffnen Sie ein Terminalfenster und führen Sie Folgendes aus: `npx -y @azure/mcp@latest server start --transport sse`\n\n2. Der Server wird gestartet und unter folgender Adresse gehostet: . Um einen anderen Port zu verwenden, hängen Sie `--port {YOUR-PORT-NUMBER}` an.\n\n3. Öffnen Sie Ihren MCP-Client und fügen Sie den SSE-Konfigurationswert hinzu. Dieser kann je nach MCP-Client unterschiedlich sein. In VS Code sieht er folgendermaßen aus:\n\n ```json\n {\n \"servers\": {\n \"Azure MCP Server\": {\n \"type\": \"sse\",\n \"url\": \"http://localhost:5008/sse\"\n }\n }\n }\n ```\n\nWeitere End-to-End-Anleitungen für MCP-Clients/Agenten folgen in Kürze!\n\n## 📝 Fehlerbehebung\n\nHilfe zu häufigen Problemen und zur Protokollierung finden Sie [im Handbuch zur Fehlerbehebung](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md) .\n\n## 🔑 Authentifizierung\n\nDer Azure MCP-Server integriert sich nahtlos in die Authentifizierungsmechanismen Ihres Host-Betriebssystems und erleichtert so den Einstieg! Wir verwenden Azure Identity im Hintergrund über [`DefaultAzureCredential`](https://learn.microsoft.com/dotnet/azure/sdk/authentication/credential-chains?tabs=dac) , das diese Anmeldeinformationen der Reihe nach ausprobiert:\n\n1. **Umgebungsvariablen** ( `EnvironmentCredential` ) – Perfekt für CI/CD-Pipelines\n2. **Shared Token Cache** ( `SharedTokenCacheCredential` ) - Verwendet zwischengespeicherte Token von anderen Tools\n3. **Visual Studio** ( `VisualStudioCredential` ) – Verwendet Ihre Visual Studio-Anmeldeinformationen\n4. **Azure CLI** ( `AzureCliCredential` ) – Verwendet Ihre vorhandenen Azure CLI-Anmeldeinformationen\n5. **Azure PowerShell** ( `AzurePowerShellCredential` ) – Verwendet Ihre Az PowerShell-Anmeldung\n6. **Azure Developer CLI** ( `AzureDeveloperCliCredential` ) – Verwendet Ihre Azd-Anmeldung\n7. **Interaktiver Browser** ( `InteractiveBrowserCredential` ) – Fällt bei Bedarf auf die browserbasierte Anmeldung zurück\n\nWenn Sie bereits über eine dieser Methoden angemeldet sind, verwendet der Azure MCP-Server diese Anmeldeinformationen automatisch. Stellen Sie sicher, dass Sie über die korrekten Autorisierungsberechtigungen in Azure (z. B. Lesezugriff auf Ihr Speicherkonto) über RBAC (rollenbasierte Zugriffssteuerung) verfügen. Weitere Informationen zum RBAC-Autorisierungssystem von Azure finden Sie unter diesem [Link](https://learn.microsoft.com/azure/role-based-access-control/overview) .\n\nWenn bei der Authentifizierung Probleme auftreten, lesen Sie unseren [Leitfaden zur Fehlerbehebung](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md) .\n\n### Produktionsnachweise\n\nStandardmäßig schließt der Azure MCP-Server Produktionsanmeldeinformationen wie verwaltete Identität und Workloadidentität aus. Um diese Anmeldeinformationen zu aktivieren, legen Sie die Umgebungsvariable fest:\n\n```\nAZURE_MCP_INCLUDE_PRODUCTION_CREDENTIALS=true\n```\n\nDies ist nützlich, wenn Sie Azure-Dienste ausführen, bei denen Sie verwaltete Identitäten verwenden möchten.\n\n## 🛡️ Sicherheitshinweis\n\nIhre Anmeldeinformationen werden immer sicher über das offizielle [Azure Identity SDK](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/identity/Azure.Identity/README.md) behandelt – **wir speichern oder verwalten Token niemals direkt** .\n\nMCP ist ein neuartiges und hochaktuelles Phänomen. Wie bei allen neuen Technologiestandards sollten Sie eine Sicherheitsüberprüfung durchführen, um sicherzustellen, dass alle Systeme, die mit MCP-Servern integriert werden, alle Vorschriften und Standards erfüllen, die Ihr System einhalten muss. Dies gilt nicht nur für den Azure MCP-Server, sondern auch für alle MCP-Clients/-Agents, die Sie implementieren, bis hin zum Modellanbieter.\n\n## 👥 Beitragen\n\nWir freuen uns über Beiträge zum Azure MCP-Server! Egal, ob Sie Fehler beheben, neue Funktionen hinzufügen oder die Dokumentation verbessern – Ihre Beiträge sind willkommen.\n\nBitte lesen Sie unseren [Leitfaden](https://github.com/Azure/azure-mcp/blob/main/CONTRIBUTING.md) für Beiträge mit Richtlinien zu:\n\n* 🛠️ Einrichten Ihrer Entwicklungsumgebung\n* ✨ Neue Befehle hinzufügen\n* 📝 Codestil und Testanforderungen\n* 🔄 Pull Requests erstellen\n\n## 🤝 Verhaltenskodex\n\nDieses Projekt folgt dem [Microsoft Open Source-Verhaltenskodex](https://opensource.microsoft.com/codeofconduct/) . Weitere Informationen finden Sie in den häufig gestellten Fragen [zum Verhaltenskodex](https://opensource.microsoft.com/codeofconduct/faq/) . Bei Fragen oder Anmerkungen wenden Sie sich bitte an .","name","German","tag","de-DE",{"_27":39,"_34":42,"_36":43},{"_29":40,"_31":40,"_32":41},"Azure MCP Server","# 🌟 Azure MCP Server\n\n\n[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-Install_Azure_MCP_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D) [![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Azure_MCP_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D&quality=insiders)\n\nThe Azure MCP Server implements the [MCP specification](https://modelcontextprotocol.io) to create a seamless connection between AI agents and key Azure services like Azure Storage, Cosmos DB, and more.\n\n> Please note that this project is in Public Preview and implementation may significantly change prior to our General Availability.\n\n## 📑 Table of contents\n1. [🎯 Overview](#-overview)\n2. [🛠️ Currently Supported Tools](#%EF%B8%8F-currently-supported-tools)\n3. [🔌 Installation & Getting Started](#-getting-started)\n4. [🧪 Using Azure MCP Server](#-test-the-azure-mcp-server)\n5. [📝 Troubleshooting Issues](#-troubleshooting)\n6. [👥 Contributing to Azure MCP Server](#-contributing)\n\n\n\n## 🎯 Overview\n\n### ✨ What can you do with the Azure MCP Server?\n\nThe Azure MCP Server supercharges your agents with Azure context. Here are some cool prompts you can try:\n\n### 🔍 Explore Your Azure Resources\n\n- \"List my Azure storage accounts\"\n- \"Show me all my Cosmos DB databases\"\n- \"What indexes do I have in my Azure AI Search service 'mysvc'?\"\n- \"List my resource groups\"\n- \"Show me the tables in my Storage account\"\n- \"List containers in my Cosmos DB database\"\n- \"Get details about my Storage container\"\n- \"Get Kusto databases in cluster 'mycluster'\"\n- \"Sample 10 rows from table 'StormEvents' in Kusto database 'db1'\"\n\n### 📊 Query & Analyze\n- \"Query my Log Analytics workspace\"\n- \"Let's search this index for 'my search query'\"\n\n### ⚙️ Manage Configuration\n\n- \"List my App Configuration stores\"\n- \"Show my key-value pairs in App Config\"\n\n### 🔧 Advanced Azure Operations\n\n- \"List my Azure CDN endpoints\"\n- \"Help me build an Azure application using Node.js\"\n\n### 🔍 How It Works\n\nThe Azure MCP Server creates a seamless integration between AI agents and Azure services through:\n\n- 🔄 Smart JSON communication that AI agents understand\n- 🏗️ Natural language commands that get translated to Azure operations\n- 💡 Intelligent parameter suggestions and auto-completion\n- ⚡ Consistent error handling that makes sense\n\n## 🛠️ Currently Supported Tools\n\nThe Azure MCP Server provides tools for interacting with the following Azure services:\n\n### 🔎 Azure AI Search (search engine/vector database)\n- List Azure AI Search services\n- List indexes and look at their schema and configuration\n- Query search indexes\n\n### 📊 Azure Cosmos DB (NoSQL Databases)\n- List Cosmos DB accounts\n- List and query databases\n- Manage containers and items\n- Execute SQL queries against containers\n\n### 🐘 Azure Database for PostgreSQL - Flexible Server\n- List and query databases.\n- List and get schema for tables.\n- List, get configuration and get parameters for servers.\n\n### 🧮 Kusto (Azure Data Explorer)\n- List Kusto clusters\n- List databases in a Kusto cluster\n- List tables in a Kusto database\n- Get schema for a Kusto table\n- Sample rows from a Kusto table\n- Query Kusto databases using KQL\n\n### 💾 Azure Storage\n- List Storage accounts\n- Manage blob containers and blobs\n- List and query Storage tables\n- Get container properties and metadata\n\n### 📈 Azure Monitor (Log Analytics)\n- List Log Analytics workspaces\n- Query logs using KQL\n- List available tables\n\n### ⚙️ Azure App Configuration\n- List App Configuration stores\n- Manage key-value pairs\n- Handle labeled configurations\n- Lock/unlock configuration settings\n\n### 🔑 Azure Key Vault\n- List, create, and get keys\n\n### 📦 Azure Resource Groups\n- List resource groups\n\n### 🚌 Azure Service Bus\n- Examine properties and runtime information about queues, topics, and subscriptions\n\n### 🔧 Azure CLI Extension\n- Execute Azure CLI commands directly\n- Support for all Azure CLI functionality\n- JSON output formatting\n- Cross-platform compatibility\n\n### 🚀 Azure Developer CLI (azd) Extension\n- Execute Azure Developer CLI commands directly\n- Support for template discovery, template initialization, provisioning and deployment\n- Cross-platform compatibility\n\nAgents and models can discover and learn best practices and usage guidelines for the `azd` MCP tool. For more information, see [AZD Best Practices](https://github.com/Azure/azure-mcp/tree/main/src/Resources/azd-best-practices.txt).\n\n### 🛡️ Azure Best Practices\n- Get secure, production-grade Azure SDK best practices for effective code generation.\n\nFor detailed command documentation and examples, see [Azure MCP Commands](https://github.com/Azure/azure-mcp/blob/main/docs/azmcp-commands.md).\n\n## 🔌 Getting Started\n\nThe Azure MCP Server requires Node.js to install and run the server. If you don't have it installed, follow the instructions [here](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm).\n\n### VS Code + GitHub Copilot\n\nThe Azure MCP Server provides Azure SDK and Azure CLI developer tools. It can be used alone or with the [GitHub Copilot for Azure extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) in VS Code. If you're interested in broad developer support across a variety of Azure development scenarios not included in the Azure MCP Server, such as searching documentation on Microsoft Learn, we recommend this extension as well.\n\n### Prerequisites\n1. Install either the stable or Insiders release of VS Code:\n * [💫 Stable release](https://code.visualstudio.com/download)\n * [🔮 Insiders release](https://code.visualstudio.com/insiders)\n2. Install the [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) and [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) extensions\n3. Install [Node.js](https://nodejs.org/en/download) 20 or later\n * Ensure `node` and `npm` are in your path\n4. Open VS Code in an empty folder\n\n### Installation\n\n#### ✨ One-Click Install\n\nClick one of these buttons to install the Azure MCP Server for VS Code or VS Code Insiders.\n\n[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-Install_Azure_MCP_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D) [![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Azure_MCP_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D&quality=insiders)\n\nOnce you've installed the Azure MCP Server, make sure you select GitHub Copilot Agent Mode and refresh the tools list. To learn more about Agent Mode, visit the [VS Code Documentation](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode).\n\n#### 🔧 Manual Install\n\nFor a step-by-step installation, follow these instructions:\n\n1. Add `.vscode/mcp.json`:\n```json\n{\n \"servers\": {\n \"Azure MCP Server\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@azure/mcp@latest\",\n \"server\",\n \"start\"\n ]\n }\n }\n}\n```\n\n#### Docker Install\n\nFor a step-by-step installation, follow these instructions:\n1. Clone repository\n2. From repository root, build Docker image: `docker build -t azure/azuremcp .`\n3. Create an `.env` file with environment variables that [match one of the `EnvironmentCredential`](https://learn.microsoft.com/dotnet/api/azure.identity.environmentcredential) sets. For example, a `.env` file using a service principal could look like:\n```json\nAZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}\nAZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}\nAZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}\n```\n1. Add `.vscode/mcp.json` or update existing MCP configuration. Replace `/full/path/to/.env` with a path to your `.env` file.\n```json\n{\n \"servers\": {\n \"Azure MCP Server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"azure/azuremcp\",\n \"--env-file\",\n \"/full/path/to/.env\"\n ]\n }\n }\n}\n```\n\nOptionally, customers can use `--env` or `--volume` to pass authentication values.\n\n## 🧪 Test the Azure MCP Server\n\n1. Open GitHub Copilot in VS Code and [switch to Agent mode](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)\n2. You should see the Azure MCP Server in the list of tools\n3. Try a prompt that tells the agent to use the Azure MCP Server, such as \"List my Azure Storage containers\"\n4. The agent should be able to use the Azure MCP Server tools to complete your query\n\n## 🤖 Custom MCP Clients\n\nYou can easily configure your MCP client to use the Azure MCP Server. Have your client run the following command and access it via standard IO or SSE.\n\n### Using standard IO\n\nConfigure the MCP client to execute: `npx -y @azure/mcp@latest server start`. For instructions on using VS Code, follow instructions in [One-Click Install](#-one-click-install) or [Manual Install](#-manual-install).\n\n### Using SSE\n\n1. Open a terminal window and execute: `npx -y @azure/mcp@latest server start --transport sse`\n2. The server starts up and is hosted at: http://localhost:5008. To use another port, append `--port {YOUR-PORT-NUMBER}`.\n3. Open your MCP client and add the SSE configuration value. This may differ between MCP clients. In VS Code, it will look like:\n ```json\n {\n \"servers\": {\n \"Azure MCP Server\": {\n \"type\": \"sse\",\n \"url\": \"http://localhost:5008/sse\"\n }\n }\n }\n ```\n\n\nMore end-to-end MCP client/agent guides are coming soon!\n\n## 📝 Troubleshooting\n\nSee [Troubleshooting guide](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md) for help with common issues and logging.\n\n## 🔑 Authentication\n\nThe Azure MCP Server seamlessly integrates with your host operating system's authentication mechanisms, making it super easy to get started! We use Azure Identity under the hood via [`DefaultAzureCredential`](https://learn.microsoft.com/dotnet/azure/sdk/authentication/credential-chains?tabs=dac), which tries these credentials in order:\n\n1. **Environment Variables** (`EnvironmentCredential`) - Perfect for CI/CD pipelines\n2. **Shared Token Cache** (`SharedTokenCacheCredential`) - Uses cached tokens from other tools\n3. **Visual Studio** (`VisualStudioCredential`) - Uses your Visual Studio credentials\n4. **Azure CLI** (`AzureCliCredential`) - Uses your existing Azure CLI login\n5. **Azure PowerShell** (`AzurePowerShellCredential`) - Uses your Az PowerShell login\n6. **Azure Developer CLI** (`AzureDeveloperCliCredential`) - Uses your azd login\n7. **Interactive Browser** (`InteractiveBrowserCredential`) - Falls back to browser-based login if needed\n\nIf you're already logged in through any of these methods, the Azure MCP Server will automatically use those credentials. Ensure that you have the correct authorization permissions in Azure (e.g. read access to your Storage account) via RBAC (Role-Based Access Control). To learn more about Azure's RBAC authorization system, visit this [link](https://learn.microsoft.com/azure/role-based-access-control/overview).\n\nIf you're running into any issues with authentication, visit our [troubleshooting guide](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md).\n\n### Production Credentials\n\nBy default, the Azure MCP Server excludes production credentials like Managed Identity and Workload Identity. To enable these credentials, set the environment variable:\n\n```\nAZURE_MCP_INCLUDE_PRODUCTION_CREDENTIALS=true\n```\n\nThis is useful when running on Azure services where you want to use managed identities.\n\n## 🛡️ Security Note\n\nYour credentials are always handled securely through the official [Azure Identity SDK](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/identity/Azure.Identity/README.md) - **we never store or manage tokens directly**.\n\nMCP as a phenomenon is very novel and cutting-edge. As with all new technology standards, consider doing a security review to ensure any systems that integrate with MCP servers follow all regulations and standards your system is expected to adhere to. This includes not only the Azure MCP Server, but any MCP client/agent that you choose to implement down to the model provider.\n\n## 👥 Contributing\n\nWe welcome contributions to the Azure MCP Server! Whether you're fixing bugs, adding new features, or improving documentation, your contributions are welcome.\n\nPlease read our [Contributing Guide](https://github.com/Azure/azure-mcp/blob/main/CONTRIBUTING.md) for guidelines on:\n\n- 🛠️ Setting up your development environment\n- ✨ Adding new commands\n- 📝 Code style and testing requirements\n- 🔄 Making pull requests\n\n## 🤝 Code of Conduct\n\nThis project has adopted the\n[Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information, see the\n[Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)\nor contact [opencode@microsoft.com](mailto:opencode@microsoft.com)\nwith any additional questions or comments.\n","English","en-US",{"_27":45,"_34":48,"_36":49},{"_29":46,"_31":46,"_32":47},"Servidor MCP de Azure","# Servidor MCP de Azure\n\n[![Instalar con NPX en VS Code](https://img.shields.io/badge/VS_Code-Install_Azure_MCP_Server-0098FF?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D) [![Instalar con NPX en VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Azure_MCP_Server-24bfa5?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D\\&quality=insiders)\n\nEl servidor Azure MCP implementa la [especificación MCP](https://modelcontextprotocol.io) para crear una conexión perfecta entre los agentes de IA y los servicios clave de Azure, como Azure Storage, Cosmos DB y más.\n\n> Tenga en cuenta que este proyecto está en vista previa pública y su implementación puede cambiar significativamente antes de nuestra disponibilidad general.\n\n## 📑 Índice de contenidos\n\n1. [🎯 Descripción general](#-overview)\n2. [🛠️ Herramientas compatibles actualmente](#%EF%B8%8F-currently-supported-tools)\n3. [🔌 Instalación y primeros pasos](#-getting-started)\n4. [🧪 Uso del servidor Azure MCP](#-test-the-azure-mcp-server)\n5. [📝 Solución de problemas](#-troubleshooting)\n6. [👥 Contribución al servidor Azure MCP](#-contributing)\n\n## 🎯 Descripción general\n\n### ✨ ¿Qué puedes hacer con Azure MCP Server?\n\nEl servidor Azure MCP potencia a tus agentes con el contexto de Azure. Aquí tienes algunas sugerencias interesantes que puedes probar:\n\n### 🔍 Explora tus recursos de Azure\n\n* \"Enumerar mis cuentas de almacenamiento de Azure\"\n* \"Muéstrame todas mis bases de datos de Cosmos DB\"\n* \"¿Qué índices tengo en mi servicio Azure AI Search 'mysvc'?\"\n* \"Enumerar mis grupos de recursos\"\n* \"Muéstrame las tablas en mi cuenta de almacenamiento\"\n* \"Enumerar contenedores en mi base de datos Cosmos DB\"\n* Obtener detalles sobre mi contenedor de almacenamiento\n* Obtener las bases de datos de Kusto en el clúster 'mycluster'\n* Muestra de 10 filas de la tabla 'StormEvents' en la base de datos Kusto 'db1'.\n\n### 📊 Consultar y analizar\n\n* Consultar mi espacio de trabajo de Log Analytics\n* \"Busquemos en este índice 'mi consulta de búsqueda'\"\n\n### ⚙️ Administrar configuración\n\n* \"Enumerar mis tiendas de configuración de aplicaciones\"\n* Mostrar mis pares clave-valor en la configuración de la aplicación\n\n### Operaciones avanzadas de Azure\n\n* \"Enumerar mis puntos de conexión de Azure CDN\"\n* Ayúdame a crear una aplicación de Azure con Node.js.\n\n### 🔍 Cómo funciona\n\nEl servidor Azure MCP crea una integración perfecta entre los agentes de IA y los servicios de Azure a través de:\n\n* Comunicación JSON inteligente que los agentes de IA entienden\n* 🏗️ Comandos en lenguaje natural que se traducen a operaciones de Azure\n* 💡 Sugerencias de parámetros inteligentes y autocompletado\n* ⚡ Manejo de errores consistente y con sentido\n\n## 🛠️ Herramientas compatibles actualmente\n\nEl servidor MCP de Azure proporciona herramientas para interactuar con los siguientes servicios de Azure:\n\n### 🔎 Azure AI Search (motor de búsqueda/base de datos vectorial)\n\n* Enumerar los servicios de Azure AI Search\n* Enumere los índices y observe su esquema y configuración\n* Índices de búsqueda de consultas\n\n### 📊 Azure Cosmos DB (bases de datos NoSQL)\n\n* Lista de cuentas de Cosmos DB\n* Listar y consultar bases de datos\n* Administrar contenedores y artículos\n* Ejecutar consultas SQL contra contenedores\n\n### 🐘 Azure Database for PostgreSQL: servidor flexible\n\n* Enumerar y consultar bases de datos.\n* Enumerar y obtener el esquema de las tablas.\n* Listar, obtener configuración y obtener parámetros para los servidores.\n\n### 🧮 Kusto (Explorador de datos de Azure)\n\n* Lista de clústeres de Kusto\n* Listar bases de datos en un clúster de Kusto\n* Listar tablas en una base de datos de Kusto\n* Obtener el esquema para una tabla Kusto\n* Filas de muestra de una tabla Kusto\n* Consultar bases de datos de Kusto usando KQL\n\n### Almacenamiento de Azure\n\n* Lista de cuentas de almacenamiento\n* Administrar contenedores de blobs y blobs\n* Listar y consultar tablas de almacenamiento\n* Obtener propiedades y metadatos del contenedor\n\n### 📈 Azure Monitor (Análisis de registros)\n\n* Lista de espacios de trabajo de Log Analytics\n* Consultar registros mediante KQL\n* Lista de mesas disponibles\n\n### ⚙️ Configuración de la aplicación de Azure\n\n* Lista de tiendas de configuración de aplicaciones\n* Administrar pares clave-valor\n* Manejar configuraciones etiquetadas\n* Bloquear/desbloquear la configuración\n\n### Almacén de claves de Azure\n\n* Listar, crear y obtener claves\n\n### 📦 Grupos de recursos de Azure\n\n* Lista de grupos de recursos\n\n### 🚌 Bus de servicio de Azure\n\n* Examinar las propiedades y la información de tiempo de ejecución sobre colas, temas y suscripciones\n\n### Extensión CLI de Azure\n\n* Ejecutar comandos de la CLI de Azure directamente\n* Compatibilidad con todas las funciones de la CLI de Azure\n* Formato de salida JSON\n* Compatibilidad entre plataformas\n\n### Extensión CLI para desarrolladores de Azure (azd)\n\n* Ejecutar comandos CLI de Azure Developer directamente\n* Soporte para descubrimiento de plantillas, inicialización de plantillas, aprovisionamiento e implementación\n* Compatibilidad entre plataformas\n\nLos agentes y modelos pueden descubrir y aprender las mejores prácticas y pautas de uso de la herramienta `azd` MCP. Para obtener más información, consulte [las mejores prácticas de AZD](https://github.com/Azure/azure-mcp/tree/main/src/Resources/azd-best-practices.txt) .\n\n### 🛡️ Prácticas recomendadas de Azure\n\n* Obtenga las mejores prácticas seguras y de nivel de producción del SDK de Azure para una generación de código efectiva.\n\nPara obtener documentación detallada y ejemplos de comandos, consulte [Comandos de Azure MCP](https://github.com/Azure/azure-mcp/blob/main/docs/azmcp-commands.md) .\n\n## 🔌 Primeros pasos\n\nEl servidor Azure MCP requiere Node.js para su instalación y ejecución. Si no lo tiene instalado, siga las instrucciones [aquí](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) .\n\n### VS Code + GitHub Copilot\n\nAzure MCP Server proporciona herramientas para desarrolladores del SDK de Azure y la CLI de Azure. Puede usarse solo o con la [extensión GitHub Copilot para Azure](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) en VS Code. Si le interesa obtener un amplio soporte para desarrolladores en diversos escenarios de desarrollo de Azure no incluidos en Azure MCP Server, como la búsqueda de documentación en Microsoft Learn, también le recomendamos esta extensión.\n\n### Prerrequisitos\n\n1. Instale la versión estable o Insiders de VS Code:\n * [💫 Versión estable](https://code.visualstudio.com/download)\n * [🔮 Comunicado de prensa de Insiders](https://code.visualstudio.com/insiders)\n2. Instalar las extensiones [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) y [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat)\n3. Instalar [Node.js](https://nodejs.org/en/download) 20 o posterior\n * Asegúrese de que `node` y `npm` estén en su ruta\n4. Abra VS Code en una carpeta vacía\n\n### Instalación\n\n#### ✨ Instalación con un solo clic\n\nHaga clic en uno de estos botones para instalar Azure MCP Server para VS Code o VS Code Insiders.\n\n[![Instalar con NPX en VS Code](https://img.shields.io/badge/VS_Code-Install_Azure_MCP_Server-0098FF?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D) [![Instalar con NPX en VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Azure_MCP_Server-24bfa5?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D\\&quality=insiders)\n\nUna vez instalado Azure MCP Server, asegúrese de seleccionar el modo de agente de GitHub Copilot y actualice la lista de herramientas. Para obtener más información sobre el modo de agente, visite la [documentación de VS Code](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode) .\n\n#### 🔧 Instalación manual\n\nPara una instalación paso a paso, siga estas instrucciones:\n\n1. Agregar `.vscode/mcp.json` :\n\n```json\n{\n \"servers\": {\n \"Azure MCP Server\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@azure/mcp@latest\",\n \"server\",\n \"start\"\n ]\n }\n }\n}\n```\n\n#### Instalación de Docker\n\nPara una instalación paso a paso, siga estas instrucciones:\n\n1. Repositorio de clones\n2. Desde la raíz del repositorio, cree una imagen de Docker: `docker build -t azure/azuremcp .`\n3. Cree un archivo `.env` con variables de entorno que [coincidan con uno de los conjuntos `EnvironmentCredential`](https://learn.microsoft.com/dotnet/api/azure.identity.environmentcredential) . Por ejemplo, un archivo `.env` que utilice una entidad de servicio podría tener el siguiente aspecto:\n\n```json\nAZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}\nAZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}\nAZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}\n```\n\n1. Agregue `.vscode/mcp.json` o actualice la configuración de MCP existente. Reemplace `/full/path/to/.env` con la ruta a su archivo `.env` .\n\n```json\n{\n \"servers\": {\n \"Azure MCP Server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"azure/azuremcp\",\n \"--env-file\",\n \"/full/path/to/.env\"\n ]\n }\n }\n}\n```\n\nOpcionalmente, los clientes pueden usar `--env` o `--volume` para pasar valores de autenticación.\n\n## 🧪 Pruebe el servidor Azure MCP\n\n1. Abra GitHub Copilot en VS Code y [cambie al modo Agente](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)\n2. Debería ver Azure MCP Server en la lista de herramientas\n3. Pruebe con un mensaje que le indique al agente que use el servidor Azure MCP, como \"Enumerar mis contenedores de Azure Storage\".\n4. El agente debe poder usar las herramientas de Azure MCP Server para completar su consulta\n\n## 🤖 Clientes MCP personalizados\n\nPuede configurar fácilmente su cliente MCP para usar Azure MCP Server. Ejecute el siguiente comando y acceda a él mediante E/S estándar o SSE.\n\n### Uso de E/S estándar\n\nConfigure el cliente MCP para ejecutar: `npx -y @azure/mcp@latest server start` . Para obtener instrucciones sobre el uso de VS Code, siga las instrucciones en [Instalación en un clic](#-one-click-install) o [Instalación manual](#-manual-install) .\n\n### Uso de SSE\n\n1. Abra una ventana de terminal y ejecute: `npx -y @azure/mcp@latest server start --transport sse`\n\n2. El servidor se inicia y se aloja en: . Para usar otro puerto, añada `--port {YOUR-PORT-NUMBER}` .\n\n3. Abra su cliente MCP y agregue el valor de configuración de SSE. Esto puede variar entre clientes MCP. En VS Code, se verá así:\n\n ```json\n {\n \"servers\": {\n \"Azure MCP Server\": {\n \"type\": \"sse\",\n \"url\": \"http://localhost:5008/sse\"\n }\n }\n }\n ```\n\n¡Pronto habrá más guías de agente/cliente MCP de extremo a extremo!\n\n## 📝 Solución de problemas\n\nConsulte [la guía de solución de problemas](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md) para obtener ayuda con problemas comunes y registros.\n\n## 🔑 Autenticación\n\nEl servidor Azure MCP se integra a la perfección con los mecanismos de autenticación del sistema operativo del host, lo que facilita enormemente el inicio. Usamos Azure Identity en segundo plano mediante [`DefaultAzureCredential`](https://learn.microsoft.com/dotnet/azure/sdk/authentication/credential-chains?tabs=dac) , que prueba estas credenciales en orden:\n\n1. **Variables de entorno** ( `EnvironmentCredential` ): perfectas para pipelines de CI/CD\n2. **Caché de token compartido** ( `SharedTokenCacheCredential` ): utiliza tokens almacenados en caché de otras herramientas\n3. **Visual Studio** ( `VisualStudioCredential` ): utiliza sus credenciales de Visual Studio\n4. **CLI de Azure** ( `AzureCliCredential` ): utiliza su inicio de sesión de CLI de Azure existente\n5. **Azure PowerShell** ( `AzurePowerShellCredential` ): utiliza su inicio de sesión de Az PowerShell\n6. **CLI para desarrolladores de Azure** ( `AzureDeveloperCliCredential` ): utiliza su inicio de sesión de azd\n7. **Navegador interactivo** ( `InteractiveBrowserCredential` ): recurre al inicio de sesión basado en navegador si es necesario\n\nSi ya ha iniciado sesión mediante alguno de estos métodos, Azure MCP Server usará automáticamente esas credenciales. Asegúrese de tener los permisos de autorización correctos en Azure (por ejemplo, acceso de lectura a su cuenta de almacenamiento) mediante RBAC (Control de acceso basado en roles). Para obtener más información sobre el sistema de autorización RBAC de Azure, visite este [enlace](https://learn.microsoft.com/azure/role-based-access-control/overview) .\n\nSi tiene algún problema con la autenticación, visite nuestra [guía de solución de problemas](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md) .\n\n### Credenciales de producción\n\nDe forma predeterminada, Azure MCP Server excluye las credenciales de producción, como Identidad administrada e Identidad de carga de trabajo. Para habilitar estas credenciales, configure la variable de entorno:\n\n```\nAZURE_MCP_INCLUDE_PRODUCTION_CREDENTIALS=true\n```\n\nEsto es útil cuando se ejecuta en servicios de Azure donde desea utilizar identidades administradas.\n\n## 🛡️ Nota de seguridad\n\nSus credenciales siempre se manejan de forma segura a través del [SDK oficial de Azure Identity](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/identity/Azure.Identity/README.md) : **nunca almacenamos ni administramos tokens directamente** .\n\nEl fenómeno MCP es muy novedoso y vanguardista. Al igual que con todos los nuevos estándares tecnológicos, considere realizar una revisión de seguridad para garantizar que todos los sistemas que se integran con servidores MCP cumplan con todas las regulaciones y estándares que se espera que su sistema cumpla. Esto incluye no solo el servidor Azure MCP, sino también cualquier cliente/agente MCP que decida implementar, incluyendo el proveedor del modelo.\n\n## 👥 Contribuyendo\n\n¡Agradecemos sus contribuciones al servidor Azure MCP! Ya sea que esté corrigiendo errores, agregando nuevas características o mejorando la documentación, sus contribuciones son bienvenidas.\n\nLea nuestra [Guía de contribución](https://github.com/Azure/azure-mcp/blob/main/CONTRIBUTING.md) para obtener pautas sobre:\n\n* 🛠️ Configurando tu entorno de desarrollo\n* ✨Añadiendo nuevos comandos\n* 📝 Requisitos de estilo y pruebas de código\n* 🔄 Realizar solicitudes de extracción\n\n## 🤝 Código de conducta\n\nEste proyecto ha adoptado el [Código de Conducta de Código Abierto de Microsoft](https://opensource.microsoft.com/codeofconduct/) . Para más información, consulte las [preguntas frecuentes sobre el Código de Conducta](https://opensource.microsoft.com/codeofconduct/faq/) o escriba [a opencode@microsoft.com](mailto:opencode@microsoft.com) si tiene alguna pregunta o comentario.","Spanish","es-ES",{"_27":51,"_34":54,"_36":55},{"_29":52,"_31":52,"_32":53},"Azure MCP サーバー","# 🌟 Azure MCP サーバー\n\n[![VS CodeでNPXを使ってインストールする](https://img.shields.io/badge/VS_Code-Install_Azure_MCP_Server-0098FF?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D) [![VS Code Insiders で NPX を使用してインストールする](https://img.shields.io/badge/VS_Code_Insiders-Install_Azure_MCP_Server-24bfa5?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D\\&quality=insiders)\n\nAzure MCP サーバーは[MCP 仕様](https://modelcontextprotocol.io)を実装し、AI エージェントと Azure Storage、Cosmos DB などの主要な Azure サービス間のシームレスな接続を作成します。\n\n> このプロジェクトはパブリックプレビュー段階であり、一般公開前に実装が大幅に変更される可能性があることにご注意ください。\n\n## 📑 目次\n\n1. [🎯 概要](#-overview)\n2. [🛠️ 現在サポートされているツール](#%EF%B8%8F-currently-supported-tools)\n3. [🔌 インストールと開始方法](#-getting-started)\n4. [🧪 Azure MCP サーバーの使用](#-test-the-azure-mcp-server)\n5. [📝 問題のトラブルシューティング](#-troubleshooting)\n6. [👥 Azure MCP サーバーへの貢献](#-contributing)\n\n## 🎯 概要\n\n### ✨ Azure MCP サーバーで何ができるでしょうか?\n\nAzure MCP サーバーは、Azure コンテキストを活用してエージェントを強化します。以下に、試してみる価値のある便利なプロンプトをいくつかご紹介します。\n\n### 🔍 Azure リソースを探索する\n\n* 「Azure ストレージアカウントの一覧を表示する」\n* 「すべての Cosmos DB データベースを表示」\n* 「Azure AI Search サービス 'mysvc' にはどのようなインデックスがありますか?」\n* 「リソースグループの一覧を表示」\n* 「ストレージアカウント内のテーブルを表示してください」\n* 「Cosmos DB データベース内のコンテナーを一覧表示する」\n* 「ストレージコンテナの詳細を取得する」\n* 「クラスター 'mycluster' 内の Kusto データベースを取得する」\n* 「Kusto データベース 'db1' のテーブル 'StormEvents' から 10 行をサンプリングします」\n\n### 📊 クエリと分析\n\n* 「Log Analytics ワークスペースをクエリする」\n* 「このインデックスで「検索クエリ」を検索してみましょう」\n\n### ⚙️ 構成の管理\n\n* 「App Configuration ストアの一覧を表示」\n* 「App Config でキーと値のペアを表示する」\n\n### 🔧 高度な Azure 操作\n\n* 「Azure CDN エンドポイントの一覧を表示する」\n* 「Node.js を使用して Azure アプリケーションを構築するのを手伝ってください」\n\n### 🔍 仕組み\n\nAzure MCP サーバーは、次の機能を通じて AI エージェントと Azure サービス間のシームレスな統合を実現します。\n\n* 🔄 AIエージェントが理解できるスマートなJSON通信\n* 🏗️ Azure 操作に翻訳される自然言語コマンド\n* 💡 インテリジェントなパラメータ提案と自動補完\n* ⚡ 意味のある一貫したエラー処理\n\n## 🛠️ 現在サポートされているツール\n\nAzure MCP サーバーは、次の Azure サービスと対話するためのツールを提供します。\n\n### 🔎 Azure AI Search（検索エンジン/ベクターデータベース）\n\n* Azure AI Search サービスの一覧\n* インデックスを一覧表示し、そのスキーマと構成を確認します\n* クエリ検索インデックス\n\n### 📊 Azure Cosmos DB (NoSQL データベース)\n\n* Cosmos DB アカウントの一覧表示\n* データベースの一覧表示とクエリ\n* コンテナとアイテムを管理する\n* コンテナに対してSQLクエリを実行する\n\n### 🐘 Azure Database for PostgreSQL - フレキシブルサーバー\n\n* データベースを一覧表示し、クエリを実行します。\n* テーブルのスキーマを一覧表示して取得します。\n* サーバーの一覧表示、構成の取得、およびパラメータの取得を行います。\n\n### 🧮 Kusto (Azure データエクスプローラー)\n\n* Kusto クラスターの一覧表示\n* Kusto クラスター内のデータベースを一覧表示する\n* Kusto データベース内のテーブルを一覧表示する\n* Kusto テーブルのスキーマを取得する\n* Kusto テーブルのサンプル行\n* KQL を使用して Kusto データベースをクエリする\n\n### 💾 Azure ストレージ\n\n* ストレージアカウントの一覧表示\n* BLOB コンテナーと BLOB を管理する\n* ストレージテーブルの一覧表示とクエリ\n* コンテナのプロパティとメタデータを取得する\n\n### 📈 Azure モニター (ログ分析)\n\n* Log Analytics ワークスペースの一覧表示\n* KQL を使用してログをクエリする\n* 利用可能なテーブルの一覧\n\n### ⚙️ Azure アプリ構成\n\n* アプリ構成ストアの一覧\n* キーと値のペアを管理する\n* ラベル付き構成を処理する\n* 設定のロック/ロック解除\n\n### 🔑 Azure キーボールト\n\n* キーの一覧表示、作成、取得\n\n### 📦 Azure リソースグループ\n\n* リソースグループの一覧表示\n\n### 🚌 Azure サービスバス\n\n* キュー、トピック、サブスクリプションに関するプロパティとランタイム情報を調べる\n\n### 🔧 Azure CLI 拡張機能\n\n* Azure CLI コマンドを直接実行する\n* すべての Azure CLI 機能のサポート\n* JSON出力フォーマット\n* クロスプラットフォームの互換性\n\n### 🚀 Azure 開発者 CLI (azd) 拡張機能\n\n* Azure Developer CLI コマンドを直接実行する\n* テンプレートの検出、テンプレートの初期化、プロビジョニング、およびデプロイメントのサポート\n* クロスプラットフォームの互換性\n\nエージェントとモデルは、 `azd` MCPツールのベストプラクティスと使用ガイドラインを発見し、学習できます。詳細については、 [AZDベストプラクティス](https://github.com/Azure/azure-mcp/tree/main/src/Resources/azd-best-practices.txt)をご覧ください。\n\n### 🛡️ Azure のベストプラクティス\n\n* 効果的なコード生成のために、安全で運用レベルの Azure SDK ベストプラクティスを入手します。\n\n詳細なコマンドのドキュメントと例については、 [「Azure MCP コマンド」を](https://github.com/Azure/azure-mcp/blob/main/docs/azmcp-commands.md)参照してください。\n\n## 🔌 はじめに\n\nAzure MCP サーバーのインストールと実行には Node.js が必要です。インストールされていない場合は、[こちらの](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)手順に従ってください。\n\n### VS Code + GitHub コパイロット\n\nAzure MCP Server は、Azure SDK と Azure CLI 開発者ツールを提供します。単独で使用することも、VS Code の[GitHub Copilot for Azure 拡張機能](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot)と併用することもできます。Microsoft Learn でのドキュメント検索など、Azure MCP Server に含まれていないさまざまな Azure 開発シナリオにわたる幅広い開発者サポートにご興味がある場合は、この拡張機能もお勧めします。\n\n### 前提条件\n\n1. VS Code の安定版または Insiders リリースのいずれかをインストールします。\n * [💫 安定版リリース](https://code.visualstudio.com/download)\n * [🔮 インサイダーリリース](https://code.visualstudio.com/insiders)\n2. [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot)と[GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat)拡張機能をインストールする\n3. [Node.js](https://nodejs.org/en/download) 20以降をインストールする\n * `node`と`npm`パスに含まれていることを確認する\n4. 空のフォルダでVS Codeを開く\n\n### インストール\n\n#### ✨ ワンクリックインストール\n\nこれらのボタンのいずれかをクリックして、VS Code または VS Code Insiders 用の Azure MCP サーバーをインストールします。\n\n[![VS CodeでNPXを使ってインストールする](https://img.shields.io/badge/VS_Code-Install_Azure_MCP_Server-0098FF?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D) [![VS Code Insiders で NPX を使用してインストールする](https://img.shields.io/badge/VS_Code_Insiders-Install_Azure_MCP_Server-24bfa5?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D\\&quality=insiders)\n\nAzure MCP Server をインストールしたら、GitHub Copilot エージェントモードを選択し、ツールリストを更新してください。エージェントモードの詳細については、 [VS Code ドキュメント](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)をご覧ください。\n\n#### 🔧 手動インストール\n\nステップバイステップのインストールについては、次の手順に従ってください。\n\n1. `.vscode/mcp.json`を追加します:\n\n```json\n{\n \"servers\": {\n \"Azure MCP Server\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@azure/mcp@latest\",\n \"server\",\n \"start\"\n ]\n }\n }\n}\n```\n\n#### Dockerのインストール\n\nステップバイステップのインストールについては、次の手順に従ってください。\n\n1. リポジトリのクローン\n2. リポジトリのルートから、Docker イメージをビルドします: `docker build -t azure/azuremcp .`\n3. [`EnvironmentCredential`セットのいずれかに一致する](https://learn.microsoft.com/dotnet/api/azure.identity.environmentcredential)環境変数を含む`.env`ファイルを作成します。例えば、サービスプリンシパルを使用する`.env`ファイルは次のようになります。\n\n```json\nAZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}\nAZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}\nAZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}\n```\n\n1. `.vscode/mcp.json`を追加するか、既存の MCP 設定を更新してください。/full/path/to/.env `/full/path/to/.env``.env`ファイルへのパスに置き換えてください。\n\n```json\n{\n \"servers\": {\n \"Azure MCP Server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"azure/azuremcp\",\n \"--env-file\",\n \"/full/path/to/.env\"\n ]\n }\n }\n}\n```\n\nオプションで、顧客は`--env`または`--volume`を使用して認証値を渡すことができます。\n\n## 🧪 Azure MCP サーバーをテストする\n\n1. VS CodeでGitHub Copilotを開き、[エージェントモードに切り替えます。](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)\n2. ツールの一覧にAzure MCP Serverが表示されます。\n3. 「Azure Storage コンテナーの一覧を表示する」など、エージェントに Azure MCP サーバーを使用するように指示するプロンプトを試してください。\n4. エージェントはAzure MCP Serverツールを使用してクエリを完了できる必要があります\n\n## 🤖 カスタム MCP クライアント\n\nMCPクライアントをAzure MCPサーバーを使用するように簡単に構成できます。クライアントで以下のコマンドを実行し、標準IOまたはSSE経由でアクセスしてください。\n\n### 標準IOの使用\n\nMCPクライアントを`npx -y @azure/mcp@latest server start`を実行するように構成します。VS Codeの使用方法については、 [「ワンクリックインストール」](#-one-click-install)または[「手動インストール」](#-manual-install)の手順に従ってください。\n\n### SSEの使用\n\n1. ターミナルウィンドウを開き、次のコマンドを実行します: `npx -y @azure/mcp@latest server start --transport sse`\n\n2. サーバーが起動し、でホストされます。別のポートを使用する場合は、 `--port {YOUR-PORT-NUMBER}`を追加してください。\n\n3. MCPクライアントを開き、SSE設定値を追加します。MCPクライアントによって異なる場合があります。VS Codeでは、以下のようになります。\n\n ```json\n {\n \"servers\": {\n \"Azure MCP Server\": {\n \"type\": \"sse\",\n \"url\": \"http://localhost:5008/sse\"\n }\n }\n }\n ```\n\nエンドツーエンドの MCP クライアント/エージェントガイドが近日中に公開される予定です。\n\n## 📝 トラブルシューティング\n\n一般的な問題とログ記録に関するヘルプについては[、トラブルシューティングガイド](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md)を参照してください。\n\n## 🔑 認証\n\nAzure MCP サーバーは、ホストオペレーティングシステムの認証メカニズムとシームレスに統合されるため、導入が非常に簡単です。Azure Identity は[`DefaultAzureCredential`](https://learn.microsoft.com/dotnet/azure/sdk/authentication/credential-chains?tabs=dac)を介して内部的に使用され、以下の資格情報が順に試行されます。\n\n1. **環境変数**（ `EnvironmentCredential` ） - CI/CDパイプラインに最適\n2. **共有トークンキャッシュ**（ `SharedTokenCacheCredential` ） - 他のツールからキャッシュされたトークンを使用します\n3. **Visual Studio** ( `VisualStudioCredential` ) - Visual Studio の資格情報を使用します\n4. **Azure CLI** ( `AzureCliCredential` ) - 既存のAzure CLIログインを使用します\n5. **Azure PowerShell** ( `AzurePowerShellCredential` ) - Az PowerShell ログインを使用します\n6. **Azure Developer CLI** ( `AzureDeveloperCliCredential` ) - azdログインを使用します\n7. **インタラクティブブラウザ**( `InteractiveBrowserCredential` ) - 必要に応じてブラウザベースのログインにフォールバックします\n\nこれらのいずれかの方法で既にログインしている場合は、Azure MCP サーバーはそれらの資格情報を自動的に使用します。RBAC (ロールベースのアクセス制御) を介して、Azure で適切な承認権限 (例: ストレージアカウントへの読み取りアクセス) があることを確認してください。Azure の RBAC 承認システムの詳細については、こちらの[リンク](https://learn.microsoft.com/azure/role-based-access-control/overview)をご覧ください。\n\n認証で問題が発生した場合は、[トラブルシューティングガイド](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md)をご覧ください。\n\n### 制作資格\n\nデフォルトでは、Azure MCP サーバーはマネージド ID やワークロード ID などの運用環境の資格情報を除外します。これらの資格情報を有効にするには、環境変数を設定します。\n\n```\nAZURE_MCP_INCLUDE_PRODUCTION_CREDENTIALS=true\n```\n\nこれは、マネージド ID を使用する Azure サービスで実行する場合に役立ちます。\n\n## 🛡️ セキュリティに関する注意事項\n\n資格情報は常に公式の[Azure Identity SDK](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/identity/Azure.Identity/README.md)を通じて安全に処理されます。**トークンを直接保存したり管理したりすることはありません**。\n\nMCPという現象は非常に斬新で最先端です。他の新しい技術標準と同様に、MCPサーバーと統合するすべてのシステムが、システムが遵守すべきすべての規制と標準に準拠していることを確認するために、セキュリティレビューの実施を検討してください。これには、Azure MCPサーバーだけでなく、実装するすべてのMCPクライアント/エージェント、そしてモデルプロバイダーも含まれます。\n\n## 👥 貢献する\n\nAzure MCP サーバーへの貢献を歓迎します。バグの修正、新機能の追加、ドキュメントの改善など、どのような貢献でも歓迎します。\n\n以下のガイドラインについては、[貢献��イド](https://github.com/Azure/azure-mcp/blob/main/CONTRIBUTING.md)をお読みください。\n\n* 🛠️ 開発環境の設定\n* ✨ 新しいコマンドの追加\n* 📝 コードスタイルとテスト要件\n* 🔄 プルリクエストの作成\n\n## 🤝 行動規範\n\nこのプロジェクトは[、Microsoft オープンソース行動規範](https://opensource.microsoft.com/codeofconduct/)を採用しています。詳細については、[行動規範に関する FAQ を](https://opensource.microsoft.com/codeofconduct/faq/)ご覧ください。ご質問やご意見がございましたら、までお問い合わせください。","Japanese","ja-JP",{"_27":57,"_34":60,"_36":61},{"_29":58,"_31":58,"_32":59},"Azure MCP 서버","# 🌟 Azure MCP 서버\n\n[![VS Code에서 NPX로 설치](https://img.shields.io/badge/VS_Code-Install_Azure_MCP_Server-0098FF?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D) [![VS Code Insiders에서 NPX로 설치](https://img.shields.io/badge/VS_Code_Insiders-Install_Azure_MCP_Server-24bfa5?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D\\&quality=insiders)\n\nAzure MCP 서버는 AI 에이전트와 Azure Storage, Cosmos DB 등의 주요 Azure 서비스 간에 원활한 연결을 구축하기 위해 [MCP 사양을](https://modelcontextprotocol.io) 구현합니다.\n\n> 이 프로젝트는 아직 공개 미리보기 단계에 있으며, 일반 공개 전에 구현 방식이 상당히 변경될 수 있습니다.\n\n## 📑 목차\n\n1. [🎯 개요](#-overview)\n2. [🛠️ 현재 지원되는 도구](#%EF%B8%8F-currently-supported-tools)\n3. [🔌 설치 및 시작하기](#-getting-started)\n4. [🧪 Azure MCP 서버 사용](#-test-the-azure-mcp-server)\n5. [📝 문제 해결](#-troubleshooting)\n6. [👥 Azure MCP 서버에 기여](#-contributing)\n\n## 🎯 개요\n\n### ✨ Azure MCP 서버로 무엇을 할 수 있나요?\n\nAzure MCP 서버는 Azure 컨텍스트를 통해 에이전트의 역량을 강화합니다. 다음은 시도해 볼 만한 몇 가지 멋진 프롬프트입니다.\n\n### 🔍 Azure 리소스 탐색\n\n* \"내 Azure 저장소 계정 나열\"\n* \"내 모든 Cosmos DB 데이터베이스를 보여주세요\"\n* \"Azure AI Search 서비스 'mysvc'에는 어떤 인덱스가 있나요?\"\n* \"내 리소스 그룹 나열\"\n* \"내 저장소 계정의 테이블을 보여주세요\"\n* \"Cosmos DB 데이터베이스에 있는 컨테이너 나열\"\n* \"내 스토리지 컨테이너에 대한 세부 정보 가져오기\"\n* \"클러스터 'mycluster'에서 Kusto 데이터베이스 가져오기\"\n* \"Kusto 데이터베이스 'db1'의 'StormEvents' 테이블에서 10개 행 샘플\"\n\n### 📊 쿼리 및 분석\n\n* \"내 Log Analytics 작업 공간 쿼리\"\n* \"이 인덱스에서 '내 검색어'를 검색해 보겠습니다.\"\n\n### ⚙️ 구성 관리\n\n* \"내 앱 구성 저장소 나열\"\n* \"앱 구성에서 키-값 쌍 표시\"\n\n### 🔧 고급 Azure 작업\n\n* \"Azure CDN 엔드포인트 나열\"\n* \"Node.js를 사용하여 Azure 애플리케이션을 빌드하는 데 도움을 주세요\"\n\n### 🔍 작동 원리\n\nAzure MCP 서버는 다음을 통해 AI 에이전트와 Azure 서비스 간의 원활한 통합을 구축합니다.\n\n* 🔄 AI 에이전트가 이해하는 스마트 JSON 통신\n* 🏗️ Azure 작업으로 번역되는 자연어 명령\n* 💡 지능형 매개변수 제안 및 자동 완성\n* ⚡ 의미 있는 일관된 오류 처리\n\n## 🛠️ 현재 지원되는 도구\n\nAzure MCP 서버는 다음 Azure 서비스와 상호 작용하기 위한 도구를 제공합니다.\n\n### 🔎 Azure AI Search(검색 엔진/벡터 데이터베이스)\n\n* Azure AI Search 서비스 나열\n* 인덱스를 나열하고 스키마와 구성을 살펴보세요.\n* 쿼리 검색 인덱스\n\n### 📊 Azure Cosmos DB(NoSQL 데이터베이스)\n\n* Cosmos DB 계정 나열\n* 데이터베이스 목록 및 쿼리\n* 컨테이너 및 항목 관리\n* 컨테이너에 대해 SQL 쿼리 실행\n\n### 🐘 PostgreSQL용 Azure 데이터베이스 - 유연한 서버\n\n* 데이터베이스를 나열하고 쿼리합니다.\n* 테이블에 대한 스키마를 나열하고 가져옵니다.\n* 서버에 대한 목록을 작성하고, 구성을 가져오고, 매개변수를 가져옵니다.\n\n### 🧮 Kusto(Azure Data Explorer)\n\n* Kusto 클러스터 나열\n* Kusto 클러스터의 데이터베이스 나열\n* Kusto 데이터베이스의 테이블 나열\n* Kusto 테이블에 대한 스키마 가져오기\n* Kusto 테이블의 샘플 행\n* KQL을 사용하여 Kusto 데이터베이스 쿼리\n\n### 💾 Azure 저장소\n\n* 저장소 계정 목록\n* Blob 컨테이너 및 Blob 관리\n* 저장소 테이블 목록 및 쿼리\n* 컨테이너 속성 및 메타데이터 가져오기\n\n### 📈 Azure Monitor(로그 분석)\n\n* Log Analytics 작업 영역 나열\n* KQL을 사용하여 로그 쿼리\n* 사용 가능한 테이블 나열\n\n### ⚙️ Azure 앱 구성\n\n* 앱 구성 저장소 나열\n* 키-값 쌍 관리\n* 라벨이 지정된 구성 처리\n* 잠금/잠금 해제 구성 설정\n\n### 🔑 Azure 키 보관함\n\n* 키 나열, 생성 및 가져오기\n\n### 📦 Azure 리소스 그룹\n\n* 리소스 그룹 나열\n\n### 🚌 Azure 서비스 버스\n\n* 큐, 토픽 및 구독에 대한 속성 및 런타임 정보를 조사합니다.\n\n### 🔧 Azure CLI 확장\n\n* Azure CLI 명령을 직접 실행\n* 모든 Azure CLI 기능 지원\n* JSON 출력 형식\n* 크로스 플랫폼 호환성\n\n### 🚀 Azure 개발자 CLI(azd) 확장\n\n* Azure Developer CLI 명령을 직접 실행\n* 템플릿 검색, 템플릿 초기화, 프로비저닝 및 배포 지원\n* 크로스 플랫폼 호환성\n\n에이전트와 모델은 `azd` MCP 도구의 모범 사례와 사용 지침을 확인하고 학습할 수 있습니다. 자세한 내용은 [AZD 모범 사례를](https://github.com/Azure/azure-mcp/tree/main/src/Resources/azd-best-practices.txt) 참조하세요.\n\n### 🛡️ Azure 모범 사례\n\n* 효과적인 코드 생성을 위한 안전하고 프로덕션 수준의 Azure SDK 모범 사례를 알아보세요.\n\n자세한 명령 설명서와 예제는 [Azure MCP 명령을](https://github.com/Azure/azure-mcp/blob/main/docs/azmcp-commands.md) 참조하세요.\n\n## 🔌 시작하기\n\nAzure MCP 서버를 설치하고 실행하려면 Node.js가 필요합니다. 아직 설치하지 않은 경우 [여기의](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) 지침을 따르세요.\n\n### VS 코드 + GitHub Copilot\n\nAzure MCP Server는 Azure SDK 및 Azure CLI 개발자 도구를 제공합니다. 단독으로 사용하거나 VS Code에서 [GitHub Copilot for Azure 확장 프로그램](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) 과 함께 사용할 수 있습니다. Microsoft Learn에서 문서 검색과 같이 Azure MCP Server에 포함되지 않은 다양한 Azure 개발 시나리오에 대한 광범위한 개발자 지원에 관심이 있는 경우에도 이 확장 프로그램을 사용하는 것이 좋습니다.\n\n### 필수 조건\n\n1. VS Code의 안정 버전이나 Insiders 릴리스를 설치하세요.\n * [💫 안정적인 출시](https://code.visualstudio.com/download)\n * [🔮 인사이더 릴리스](https://code.visualstudio.com/insiders)\n2. [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) 및 [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) 확장 프로그램 설치\n3. [Node.js](https://nodejs.org/en/download) 20 이상을 설치하세요\n * `node` 와 `npm` 경로에 있는지 확인하세요.\n4. 빈 폴더에서 VS Code를 엽니다.\n\n### 설치\n\n#### ✨ 원클릭 설치\n\nVS Code 또는 VS Code Insiders용 Azure MCP 서버를 설치하려면 이 버튼 중 하나를 클릭하세요.\n\n[![VS Code에서 NPX로 설치](https://img.shields.io/badge/VS_Code-Install_Azure_MCP_Server-0098FF?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D) [![VS Code Insiders에서 NPX로 설치](https://img.shields.io/badge/VS_Code_Insiders-Install_Azure_MCP_Server-24bfa5?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D\\&quality=insiders)\n\nAzure MCP 서버를 설치한 후 GitHub Copilot 에이전트 모드를 선택하고 도구 목록을 새로 고치세요. 에이전트 모드에 대한 자세한 내용은 [VS Code 설명서를](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode) 참조하세요.\n\n#### 🔧 수동 설치\n\n단계별 설치 방법은 다음 지침을 따르세요.\n\n1. `.vscode/mcp.json` 추가합니다.\n\n지엑스피1\n\n#### 도커 설치\n\n단계별 설치 방법은 다음 지침을 따르세요.\n\n1. 복제 저장소\n2. 저장소 루트에서 Docker 이미지를 빌드합니다: `docker build -t azure/azuremcp .`\n3. [`EnvironmentCredential` 세트 중 하나와 일치하는](https://learn.microsoft.com/dotnet/api/azure.identity.environmentcredential) 환경 변수를 사용하여 `.env` 파일을 만듭니다. 예를 들어, 서비스 주체를 사용하는 `.env` 파일은 다음과 같습니다.\n\n```json\nAZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}\nAZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}\nAZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}\n```\n\n1. `.vscode/mcp.json` 추가하거나 기존 MCP 구성을 업데이트하세요. `/full/path/to/.env``.env` 파일 경로로 바꾸세요.\n\n```json\n{\n \"servers\": {\n \"Azure MCP Server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"azure/azuremcp\",\n \"--env-file\",\n \"/full/path/to/.env\"\n ]\n }\n }\n}\n```\n\n선택적으로 고객은 `--env` 또는 `--volume` 사용하여 인증 값을 전달할 수 있습니다.\n\n## 🧪 Azure MCP 서버 테스트\n\n1. VS Code에서 GitHub Copilot을 열고 [에이전트 모드로 전환합니다.](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)\n2. 도구 목록에 Azure MCP 서버가 표시되어야 합니다.\n3. \"내 Azure Storage 컨테이너 나열\"과 같이 에이전트에게 Azure MCP 서버를 사용하도록 알려주는 프롬프트를 시도해 보세요.\n4. 에이전트는 Azure MCP 서버 도구를 사용하여 쿼리를 완료할 수 있어야 합니다.\n\n## 🤖 맞춤형 MCP 클라이언트\n\nMCP 클라이언트가 Azure MCP 서버를 사용하도록 쉽게 구성할 수 있습니다. 클라이언트에서 다음 명령을 실행하고 표준 IO 또는 SSE를 통해 액세스하도록 하세요.\n\n### 표준 IO 사용\n\nMCP 클라이언트를 구성하여 다음을 실행합니다: `npx -y @azure/mcp@latest server start` . VS Code 사용 방법은 [원클릭 설치](#-one-click-install) 또는 [수동 설치의](#-manual-install) 지침을 따르세요.\n\n### SSE 사용\n\n1. 터미널 창을 열고 다음을 실행합니다: `npx -y @azure/mcp@latest server start --transport sse`\n\n2. 서버가 시작되고 에 호스팅됩니다. 다른 포트를 사용하려면 `--port {YOUR-PORT-NUMBER}` 추가하세요.\n\n3. MCP 클라이언트를 열고 SSE 구성 값을 추가하세요. 이 설정은 MCP 클라이언트마다 다를 수 있습니다. VS Code에서는 다음과 같습니다.\n\n ```json\n {\n \"servers\": {\n \"Azure MCP Server\": {\n \"type\": \"sse\",\n \"url\": \"http://localhost:5008/sse\"\n }\n }\n }\n ```\n\n더 많은 엔드투엔드 MCP 클라이언트/에이전트 가이드가 곧 출시될 예정입니다!\n\n## 📝 문제 해결\n\n일반적인 문제 및 로깅에 대한 도움말은 [문제 해결 가이드를](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md) 참조하세요.\n\n## 🔑 인증\n\nAzure MCP 서버는 호스트 운영 체제의 인증 메커니즘과 완벽하게 통합되어 매우 쉽게 시작할 수 있습니다! Azure Identity는 [`DefaultAzureCredential`](https://learn.microsoft.com/dotnet/azure/sdk/authentication/credential-chains?tabs=dac) 통해 내부적으로 사용되며, 다음과 같은 자격 증명을 시도합니다.\n\n1. **환경 변수** ( `EnvironmentCredential` ) - CI/CD 파이프라인에 적합\n2. **공유 토큰 캐시** ( `SharedTokenCacheCredential` ) - 다른 도구에서 캐시된 토큰을 사용합니다.\n3. **Visual Studio** ( `VisualStudioCredential` ) - Visual Studio 자격 증명을 사용합니다.\n4. **Azure CLI** ( `AzureCliCredential` ) - 기존 Azure CLI 로그인을 사용합니다.\n5. **Azure PowerShell** ( `AzurePowerShellCredential` ) - Az PowerShell 로그인을 사용합니다.\n6. **Azure Developer CLI** ( `AzureDeveloperCliCredential` ) - azd 로그인을 사용합니다.\n7. **대화형 브라우저** ( `InteractiveBrowserCredential` ) - 필요한 경우 브라우저 기반 로그인으로 돌아갑니다.\n\n이미 이러한 방법 중 하나를 통해 로그인한 경우 Azure MCP 서버는 해당 자격 증명을 자동으로 사용합니다. RBAC(역할 기반 액세스 제어)를 통해 Azure에서 올바른 권한 부여 권한(예: 저장소 계정에 대한 읽기 권한)을 가지고 있는지 확인하세요. Azure의 RBAC 권한 부여 시스템에 대해 자세히 알아보려면 이 [링크를](https://learn.microsoft.com/azure/role-based-access-control/overview) 방문하세요.\n\n인증에 문제가 발생하는 경우 [문제 해결 가이드를](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md) 참조하세요.\n\n### 프로덕션 자격 증명\n\n기본적으로 Azure MCP 서버는 관리 ID 및 워크로드 ID와 같은 프로덕션 자격 증명을 제외합니다. 이러한 자격 증명을 활성화하려면 환경 변수를 설정하세요.\n\n```\nAZURE_MCP_INCLUDE_PRODUCTION_CREDENTIALS=true\n```\n\n이 기능은 관리형 ID를 사용하려는 Azure 서비스에서 실행할 때 유용합니다.\n\n## 🛡️ 보안 참고 사항\n\n귀하의 자격 증명은 항상 공식 [Azure Identity SDK를](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/identity/Azure.Identity/README.md) 통해 안전하게 처리됩니다. **당사는 토큰을 직접 저장하거나 관리하지 않습니다** .\n\nMCP는 매우 새롭고 최첨단의 현상입니다. 모든 새로운 기술 표준과 마찬가지로, MCP 서버와 통합되는 모든 시스템이 시스템이 준수해야 하는 모든 규정과 표준을 준수하는지 확인하기 위해 보안 검토를 수행하는 것이 좋습니다. 여기에는 Azure MCP 서버뿐만 아니라 구현하기로 선택한 모든 MCP 클라이언트/에이전트, 그리고 모델 공급자까지 포함됩니다.\n\n## 👥 기여하기\n\nAzure MCP 서버에 대한 기여를 환영합니다! 버그 수정, 새로운 기능 추가, 문서 개선 등 어떤 기여든 환영합니다.\n\n다음 사항에 대한 지침은 [기여 가이드를](https://github.com/Azure/azure-mcp/blob/main/CONTRIBUTING.md) 읽어보세요.\n\n* 🛠️ 개발 환경 설정\n* ✨ 새로운 명령 추가\n* 📝 코드 스타일 및 테스트 요구 사항\n* 🔄 풀 리퀘스트 만들기\n\n## 🤝 행동 강령\n\n이 프로젝트는 [Microsoft 오픈 소스 행동 강령을](https://opensource.microsoft.com/codeofconduct/) 채택했습니다. 자세한 내용은 [행동 강령 FAQ를](https://opensource.microsoft.com/codeofconduct/faq/) 참조하시거나, 추가 질문이나 의견이 있으시면 [opencode@microsoft.com으로](mailto:opencode@microsoft.com) 문의해 주세요.","Korean","ko-KR",{"_27":63,"_34":66,"_36":67},{"_29":64,"_31":64,"_32":65},"Сервер Azure MCP","# 🌟 Azure MCP-сервер\n\n[![Установить с помощью NPX в VS Code](https://img.shields.io/badge/VS_Code-Install_Azure_MCP_Server-0098FF?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D) [![Установка с NPX в VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Azure_MCP_Server-24bfa5?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D\\&quality=insiders)\n\nСервер Azure MCP реализует [спецификацию MCP](https://modelcontextprotocol.io) для создания бесшовного соединения между агентами ИИ и ключевыми службами Azure, такими как хранилище Azure, Cosmos DB и другими.\n\n> Обратите внимание, что этот проект находится на стадии публичного ознакомления, и его реализация может существенно измениться до момента его общедоступности.\n\n## 📑 Содержание\n\n1. [🎯 Обзор](#-overview)\n2. [🛠️ Поддерживаемые в настоящее время инструменты](#%EF%B8%8F-currently-supported-tools)\n3. [🔌 Установка и начало работы](#-getting-started)\n4. [🧪 Использование сервера Azure MCP](#-test-the-azure-mcp-server)\n5. [📝 Устранение неполадок](#-troubleshooting)\n6. [👥 Участие в разработке Azure MCP Server](#-contributing)\n\n## 🎯 Обзор\n\n### ✨ Что можно делать с помощью сервера Azure MCP?\n\nAzure MCP Server нагружает ваших агентов контекстом Azure. Вот несколько интересных подсказок, которые вы можете попробовать:\n\n### 🔍 Изучите свои ресурсы Azure\n\n* «Список моих учетных записей хранилища Azure»\n* «Покажи мне все мои базы данных Cosmos DB»\n* «Какие индексы есть в моей службе поиска Azure AI «mysvc»?»\n* «Список моих групп ресурсов»\n* «Покажи мне таблицы в моей учетной записи хранилища»\n* «Список контейнеров в моей базе данных Cosmos DB»\n* «Получить сведения о моем контейнере Storage»\n* «Получить базы данных Kusto в кластере 'mycluster'»\n* «Выборка 10 строк из таблицы 'StormEvents' в базе данных Kusto 'db1'»\n\n### 📊 Запрос и анализ\n\n* «Запросить мою рабочую область Log Analytics»\n* «Давайте выполним поиск по этому индексу по моему поисковому запросу»\n\n### ⚙️ Управление конфигурацией\n\n* «Список моих магазинов конфигурации приложений»\n* «Показать мои пары ключ-значение в App Config»\n\n### 🔧 Расширенные операции Azure\n\n* «Список моих конечных точек Azure CDN»\n* «Помогите мне создать приложение Azure с использованием Node.js»\n\n### 🔍 Как это работает\n\nСервер Azure MCP обеспечивает бесшовную интеграцию между агентами ИИ и службами Azure посредством:\n\n* 🔄 Интеллектуальная JSON-коммуникация, которую понимают агенты ИИ\n* 🏗️ Команды на естественном языке, которые преобразуются в операции Azure\n* 💡 Интеллектуальные подсказки параметров и автодополнение\n* ⚡ Последовательная обработка ошибок, которая имеет смысл\n\n## 🛠️ Поддерживаемые в настоящее время инструменты\n\nСервер Azure MCP предоставляет инструменты для взаимодействия со следующими службами Azure:\n\n### 🔎 Azure AI Search (поисковая система/векторная база данных)\n\n* Список служб поиска Azure AI\n* Перечислите индексы и посмотрите на их схему и конфигурацию.\n* Индексы поиска запросов\n\n### 📊 Azure Cosmos DB (Базы данных NoSQL)\n\n* Список учетных записей Cosmos DB\n* Список и запрос баз данных\n* Управление контейнерами и предметами\n* Выполнение SQL-запросов к контейнерам\n\n### 🐘 База данных Azure для PostgreSQL — гибкий сервер\n\n* Составление списка и запросов к базам данных.\n* Перечислить и получить схему для таблиц.\n* Список, получение конфигурации и параметров для серверов.\n\n### 🧮 Kusto (Azure Data Explorer)\n\n* Список кластеров Kusto\n* Список баз данных в кластере Kusto\n* Список таблиц в базе данных Kusto\n* Получить схему для таблицы Kusto\n* Примеры строк из таблицы Kusto\n* Запрос к базам данных Kusto с использованием KQL\n\n### 💾 Хранилище Azure\n\n* Список учетных записей хранения\n* Управление контейнерами BLOB-объектов и BLOB-объектами\n* Список и запрос таблиц хранения\n* Получить свойства контейнера и метаданные\n\n### 📈 Azure Monitor (аналитика журналов)\n\n* Список рабочих областей Log Analytics\n* Запрос журналов с использованием KQL\n* Список доступных таблиц\n\n### ⚙️ Конфигурация приложения Azure\n\n* Список магазинов конфигурации приложений\n* Управление парами ключ-значение\n* Обработка маркированных конфигураций\n* Блокировка/разблокировка настроек конфигурации\n\n### 🔑 Хранилище ключей Azure\n\n* Список, создание и получение ключей\n\n### 📦 Группы ресурсов Azure\n\n* Список групп ресурсов\n\n### 🚌 Шина обслуживания Azure\n\n* Изучите свойства и информацию о времени выполнения очередей, тем и подписок.\n\n### 🔧 Расширение Azure CLI\n\n* Выполняйте команды Azure CLI напрямую\n* Поддержка всех функций Azure CLI\n* Форматирование выходных данных JSON\n* Кроссплатформенная совместимость\n\n### 🚀 Расширение Azure Developer CLI (azd)\n\n* Выполняйте команды Azure Developer CLI напрямую\n* Поддержка обнаружения шаблонов, инициализации шаблонов, предоставления и развертывания\n* Кроссплатформенная совместимость\n\nАгенты и модели могут обнаружить и изучить лучшие практики и руководства по использованию инструмента `azd` MCP. Для получения дополнительной информации см. [AZD Best Practices](https://github.com/Azure/azure-mcp/tree/main/src/Resources/azd-best-practices.txt) .\n\n### 🛡️ Лучшие практики Azure\n\n* Получите безопасные рекомендации по использованию Azure SDK промышленного уровня для эффективной генерации кода.\n\nПодробную документацию по командам и примеры см. в разделе [Команды Azure MCP](https://github.com/Azure/azure-mcp/blob/main/docs/azmcp-commands.md) .\n\n## 🔌 Начало работы\n\nДля установки и запуска сервера Azure MCP Server требуется Node.js. Если он у вас не установлен, следуйте инструкциям [здесь](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) .\n\n### VS Code + GitHub Copilot\n\nAzure MCP Server предоставляет инструменты разработчика Azure SDK и Azure CLI. Его можно использовать отдельно или с [расширением GitHub Copilot для Azure](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) в VS Code. Если вы заинтересованы в широкой поддержке разработчиков в различных сценариях разработки Azure, не включенных в Azure MCP Server, например, поиск документации в Microsoft Learn, мы также рекомендуем это расширение.\n\n### Предпосылки\n\n1. Установите стабильную или инсайдерскую версию VS Code:\n * [💫 Стабильный релиз](https://code.visualstudio.com/download)\n * [🔮 Инсайдерский релиз](https://code.visualstudio.com/insiders)\n2. Установите расширения [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) и [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat)\n3. Установите [Node.js](https://nodejs.org/en/download) 20 или более позднюю версию\n * Убедитесь, что `node` и `npm` находятся в вашем пути\n4. Откройте VS Code в пустой папке.\n\n### Установка\n\n#### ✨ Установка в один клик\n\nНажмите одну из этих кнопок, чтобы установить сервер Azure MCP для VS Code или VS Code Insiders.\n\n[![Установить с помощью NPX в VS Code](https://img.shields.io/badge/VS_Code-Install_Azure_MCP_Server-0098FF?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D) [![Установка с NPX в VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Azure_MCP_Server-24bfa5?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D\\&quality=insiders)\n\nПосле установки Azure MCP Server убедитесь, что вы выбрали GitHub Copilot Agent Mode и обновите список инструментов. Чтобы узнать больше о Agent Mode, посетите [документацию VS Code](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode) .\n\n#### 🔧 Ручная установка\n\nДля пошаговой установки следуйте этим инструкциям:\n\n1. Добавьте `.vscode/mcp.json` :\n\n```json\n{\n \"servers\": {\n \"Azure MCP Server\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@azure/mcp@latest\",\n \"server\",\n \"start\"\n ]\n }\n }\n}\n```\n\n#### Установка докера\n\nДля пошаговой установки следуйте этим инструкциям:\n\n1. Клонировать репозиторий\n2. Из корня репозитория соберите образ Docker: `docker build -t azure/azuremcp .`\n3. Создайте файл `.env` с переменными среды, [соответствующими одному из наборов `EnvironmentCredential`](https://learn.microsoft.com/dotnet/api/azure.identity.environmentcredential) . Например, файл `.env` , использующий принципал-службу, может выглядеть так:\n\n```json\nAZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}\nAZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}\nAZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}\n```\n\n1. Добавьте `.vscode/mcp.json` или обновите существующую конфигурацию MCP. Замените `/full/path/to/.env` на путь к вашему файлу `.env` .\n\n```json\n{\n \"servers\": {\n \"Azure MCP Server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"azure/azuremcp\",\n \"--env-file\",\n \"/full/path/to/.env\"\n ]\n }\n }\n}\n```\n\nПри желании клиенты могут использовать `--env` или `--volume` для передачи значений аутентификации.\n\n## 🧪 Тестирование сервера Azure MCP\n\n1. Откройте GitHub Copilot в VS Code и [переключитесь в режим агента.](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)\n2. В списке инструментов вы должны увидеть Azure MCP Server.\n3. Попробуйте запрос, который сообщает агенту о необходимости использовать сервер Azure MCP, например «Перечислить мои контейнеры хранилища Azure».\n4. Агент должен иметь возможность использовать инструменты Azure MCP Server для выполнения вашего запроса.\n\n## 🤖 Индивидуальные клиенты MCP\n\nВы можете легко настроить свой клиент MCP для использования сервера Azure MCP. Пусть ваш клиент запустит следующую команду и получит к ней доступ через стандартный ввод-вывод или SSE.\n\n### Использование стандартного ввода-вывода\n\nНастройте клиент MCP для выполнения: `npx -y @azure/mcp@latest server start` . Для получения инструкций по использованию VS Code следуйте инструкциям в [разделе Установка одним щелчком](#-one-click-install) или [Ручная установка](#-manual-install) .\n\n### Использование SSE\n\n1. Откройте окно терминала и выполните: `npx -y @azure/mcp@latest server start --transport sse`\n\n2. Сервер запускается и размещается по адресу: . Чтобы использовать другой порт, добавьте `--port {YOUR-PORT-NUMBER}` .\n\n3. Откройте клиент MCP и добавьте значение конфигурации SSE. Это может отличаться в разных клиентах MCP. В VS Code это будет выглядеть так:\n\n ```json\n {\n \"servers\": {\n \"Azure MCP Server\": {\n \"type\": \"sse\",\n \"url\": \"http://localhost:5008/sse\"\n }\n }\n }\n ```\n\nСкоро появятся новые комплексные руководства для клиентов/агентов MCP!\n\n## 📝 Устранение неполадок\n\nИнформацию о распространенных проблемах и ведении журнала см. [в руководстве по устранению неполадок](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md) .\n\n## 🔑 Аутентификация\n\nAzure MCP Server легко интегрируется с механизмами аутентификации вашей операционной системы хоста, что делает его очень простым для начала работы! Мы используем Azure Identity под капотом через [`DefaultAzureCredential`](https://learn.microsoft.com/dotnet/azure/sdk/authentication/credential-chains?tabs=dac) , который пробует эти учетные данные в следующем порядке:\n\n1. **Переменные среды** ( `EnvironmentCredential` ) — идеально подходят для конвейеров CI/CD\n2. **Общий кэш токенов** ( `SharedTokenCacheCredential` ) — использует кэшированные токены из других инструментов.\n3. **Visual Studio** ( `VisualStudioCredential` ) — использует ваши учетные данные Visual Studio.\n4. **Azure CLI** ( `AzureCliCredential` ) — использует существующий логин Azure CLI.\n5. **Azure PowerShell** ( `AzurePowerShellCredential` ) — использует ваш логин Az PowerShell\n6. **Azure Developer CLI** ( `AzureDeveloperCliCredential` ) — использует ваш логин azd\n7. **Интерактивный браузер** ( `InteractiveBrowserCredential` ) — при необходимости возвращается к входу через браузер.\n\nЕсли вы уже вошли в систему любым из этих методов, сервер Azure MCP автоматически будет использовать эти учетные данные. Убедитесь, что у вас есть правильные разрешения на авторизацию в Azure (например, доступ на чтение к вашей учетной записи хранилища) через RBAC (управление доступом на основе ролей). Чтобы узнать больше о системе авторизации RBAC Azure, перейдите по этой [ссылке](https://learn.microsoft.com/azure/role-based-access-control/overview) .\n\nЕсли у вас возникли проблемы с аутентификацией, ознакомьтесь с нашим [руководством по устранению неполадок](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md) .\n\n### Производственные полномочия\n\nПо умолчанию Azure MCP Server исключает производственные учетные данные, такие как Managed Identity и Workload Identity. Чтобы включить эти учетные данные, задайте переменную среды:\n\n```\nAZURE_MCP_INCLUDE_PRODUCTION_CREDENTIALS=true\n```\n\nЭто полезно при работе в службах Azure, где вы хотите использовать управляемые удостоверения.\n\n## 🛡️ Примечание по безопасности\n\nВаши учетные данные всегда надежно обрабатываются с помощью официального [пакета SDK Azure Identity](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/identity/Azure.Identity/README.md) — **мы никогда не храним и не управляем токенами напрямую** .\n\nMCP как явление является очень новым и передовым. Как и в случае со всеми новыми технологическими стандартами, рассмотрите возможность проведения проверки безопасности, чтобы убедиться, что все системы, которые интегрируются с серверами MCP, соответствуют всем правилам и стандартам, которых должна придерживаться ваша система. Это касается не только Azure MCP Server, но и любого клиента/агента MCP, который вы решите реализовать вплоть до поставщика модели.\n\n## 👥 Вклад\n\nМы приветствуем вклад в Azure MCP Server! Независимо от того, исправляете ли вы ошибки, добавляете новые функции или улучшаете документацию, ваш вклад приветствуется.\n\nПожалуйста, ознакомьтесь с нашим [Руководством по внесению вклада](https://github.com/Azure/azure-mcp/blob/main/CONTRIBUTING.md) , где вы найдете рекомендации по следующим вопросам:\n\n* 🛠️ Настройка среды разработки\n* ✨ Добавление новых команд\n* 📝 Требования к стилю кода и тестированию\n* 🔄 Создание запросов на извлечение\n\n## 🤝 Кодекс поведения\n\nЭтот проект принял [Кодекс поведения Microsoft Open Source](https://opensource.microsoft.com/codeofconduct/) . Для получения дополнительной информации см. [раздел FAQ Кодекса поведения](https://opensource.microsoft.com/codeofconduct/faq/) или свяжитесь с с любыми дополнительными вопросами или комментариями.","Russian","ru-RU",{"_27":69,"_34":72,"_36":73},{"_29":70,"_31":70,"_32":71},"Azure MCP 服务器","# 🌟 Azure MCP 服务器\n\n[![在 VS Code 中使用 NPX 安装](https://img.shields.io/badge/VS_Code-Install_Azure_MCP_Server-0098FF?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D) [![在 VS Code Insiders 中使用 NPX 安装](https://img.shields.io/badge/VS_Code_Insiders-Install_Azure_MCP_Server-24bfa5?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D\\&quality=insiders)\n\nAzure MCP 服务器实现了[MCP 规范](https://modelcontextprotocol.io)，以在 AI 代理和关键 Azure 服务（如 Azure 存储、Cosmos DB 等）之间建立无缝连接。\n\n> 请注意，该项目处于公开预览阶段，在正式发布之前实施情况可能会发生重大变化。\n\n## 📑 目录\n\n1. [🎯 概述](#-overview)\n2. [🛠️ 当前支持的工具](#%EF%B8%8F-currently-supported-tools)\n3. [🔌 安装和入门](#-getting-started)\n4. [🧪 使用 Azure MCP 服务器](#-test-the-azure-mcp-server)\n5. [📝 故障排除问题](#-troubleshooting)\n6. [👥 为 Azure MCP 服务器做出贡献](#-contributing)\n\n## 🎯 概述\n\n### ✨ 您可以使用 Azure MCP 服务器做什么？\n\nAzure MCP 服务器通过 Azure 上下文为您的代理提供强大的功能。以下是一些您可以尝试的酷炫提示：\n\n### 🔍 探索您的 Azure 资源\n\n* “列出我的 Azure 存储帐户”\n* “显示我的所有 Cosmos DB 数据库”\n* “我的 Azure AI 搜索服务‘mysvc’中有哪些索引？”\n* “列出我的资源组”\n* “显示我的存储帐户中的表”\n* “列出我的 Cosmos DB 数据库中的容器”\n* “获取有关我的存储容器的详细信息”\n* “获取集群“mycluster”中的 Kusto 数据库”\n* “从 Kusto 数据库“db1”中的表“StormEvents”中抽取 10 行样本”\n\n### 📊 查询和分析\n\n* “查询我的 Log Analytics 工作区”\n* “让我们在这个索引中搜索‘我的搜索查询’”\n\n### ⚙️ 管理配置\n\n* “列出我的应用程序配置存储”\n* “在应用程序配置中显示我的键值对”\n\n### 🔧 高级 Azure 操作\n\n* “列出我的 Azure CDN 端点”\n* “帮助我使用 Node.js 构建 Azure 应用程序”\n\n### 🔍 工作原理\n\nAzure MCP 服务器通过以下方式在 AI 代理和 Azure 服务之间创建无缝集成：\n\n* 🔄 AI 代理能够理解的智能 JSON 通信\n* 🏗️ 可转换为 Azure 操作的自然语言命令\n* 💡 智能参数建议和自动完成\n* ⚡ 一致且合理的错误处理\n\n## 🛠️ 当前支持的工具\n\nAzure MCP 服务器提供了与以下 Azure 服务交互的工具：\n\n### 🔎 Azure AI Search（搜索引擎/矢量数据库）\n\n* 列出 Azure AI 搜索服务\n* 列出索引并查看其架构和配置\n* 查询搜索索引\n\n### 📊 Azure Cosmos DB（NoSQL 数据库）\n\n* 列出 Cosmos DB 帐户\n* 列出和查询数据库\n* 管理容器和物品\n* 对容器执行 SQL 查询\n\n### 🐘 Azure Database for PostgreSQL - 灵活服务器\n\n* 列出和查询数据库。\n* 列出并获取表的模式。\n* 列出、获取配置并获取服务器的参数。\n\n### 🧮 Kusto（Azure 数据资源管理器）\n\n* 列出 Kusto 群集\n* 列出 Kusto 群集中的数据库\n* 列出 Kusto 数据库中的表\n* 获取 Kusto 表的架构\n* Kusto 表中的示例行\n* 使用 KQL 查询 Kusto 数据库\n\n### 💾 Azure 存储\n\n* 列出存储帐户\n* 管理 Blob 容器和 Blob\n* 列出并查询存储表\n* 获取容器属性和元数据\n\n### 📈 Azure Monitor（日志分析）\n\n* 列出 Log Analytics 工作区\n* 使用 KQL 查询日志\n* 列出可用的表\n\n### ⚙️ Azure 应用配置\n\n* 列出应用程序配置存储\n* 管理键值对\n* 处理标记的配置\n* 锁定/解锁配置设置\n\n### 🔑 Azure 密钥保管库\n\n* 列出、创建和获取密钥\n\n### 📦 Azure 资源组\n\n* 列出资源组\n\n### 🚌 Azure 服务总线\n\n* 检查有关队列、主题和订阅的属性和运行时信息\n\n### 🔧 Azure CLI 扩展\n\n* 直接执行 Azure CLI 命令\n* 支持所有 Azure CLI 功能\n* JSON 输出格式\n* 跨平台兼容性\n\n### 🚀 Azure 开发人员 CLI（azd）扩展\n\n* 直接执行 Azure Developer CLI 命令\n* 支持模板发现、模板初始化、配置和部署\n* 跨平台兼容性\n\n代理和模型可以发现并学习`azd` MCP 工具的最佳实践和使用指南。更多信息，请参阅[AZD 最佳实践](https://github.com/Azure/azure-mcp/tree/main/src/Resources/azd-best-practices.txt)。\n\n### 🛡️ Azure 最佳实践\n\n* 获取安全、生产级 Azure SDK 最佳实践，以实现有效的代码生成。\n\n有关详细的命令文档和示例，请参阅[Azure MCP 命令](https://github.com/Azure/azure-mcp/blob/main/docs/azmcp-commands.md)。\n\n## 🔌 入门\n\nAzure MCP 服务器需要安装并运行 Node.js。如果您尚未安装，请按照[此处的](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)说明操作。\n\n### VS Code + GitHub Copilot\n\nAzure MCP 服务器提供 Azure SDK 和 Azure CLI 开发人员工具。它可以单独使用，也可以与 VS Code 中的[GitHub Copilot for Azure 扩展](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot)一起使用。如果您对 Azure MCP 服务器中未包含的各种 Azure 开发场景（例如在 Microsoft Learn 上搜索文档）的广泛开发人员支持感兴趣，我们也推荐此扩展。\n\n### 先决条件\n\n1. 安装 VS Code 的稳定版本或 Insiders 版本：\n * [💫 稳定版本](https://code.visualstudio.com/download)\n * [🔮 内部人士发布](https://code.visualstudio.com/insiders)\n2. 安装[GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot)和[GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat)扩展\n3. 安装[Node.js](https://nodejs.org/en/download) 20 或更高版本\n * 确保`node`和`npm`在你的路径中\n4. 在空文件夹中打开 VS Code\n\n### 安装\n\n#### ✨ 一键安装\n\n单击其中一个按钮即可为 VS Code 或 VS Code Insiders 安装 Azure MCP 服务器。\n\n[![在 VS Code 中使用 NPX 安装](https://img.shields.io/badge/VS_Code-Install_Azure_MCP_Server-0098FF?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D) [![在 VS Code Insiders 中使用 NPX 安装](https://img.shields.io/badge/VS_Code_Insiders-Install_Azure_MCP_Server-24bfa5?style=flat-square\\&logo=visualstudiocode\\&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Azure%20MCP%20Server\\&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40azure%2Fmcp%40latest%22%2C%22server%22%2C%22start%22%5D%7D\\&quality=insiders)\n\n安装 Azure MCP 服务器后，请务必选择 GitHub Copilot 代理模式并刷新工具列表。要了解有关代理模式的更多信息，请访问[VS Code 文档](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)。\n\n#### 🔧 手动安装\n\n要进行逐步安装，请按照以下说明操作：\n\n1. 添加`.vscode/mcp.json` ：\n\n```json\n{\n \"servers\": {\n \"Azure MCP Server\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@azure/mcp@latest\",\n \"server\",\n \"start\"\n ]\n }\n }\n}\n```\n\n#### Docker 安装\n\n要进行逐步安装，请按照以下说明操作：\n\n1. 克隆存储库\n2. 从存储库根目录构建 Docker 映像： `docker build -t azure/azuremcp .`\n3. 创建一个`.env`文件，其中包含与[某个`EnvironmentCredential`集匹配的](https://learn.microsoft.com/dotnet/api/azure.identity.environmentcredential)环境变量。例如，使用服务主体的`.env`文件可能如下所示：\n\n```json\nAZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}\nAZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}\nAZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}\n```\n\n1. 添加`.vscode/mcp.json`或更新现有的 MCP 配置。将`/full/path/to/.env`替换为你的`.env`文件的路径。\n\n```json\n{\n \"servers\": {\n \"Azure MCP Server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"azure/azuremcp\",\n \"--env-file\",\n \"/full/path/to/.env\"\n ]\n }\n }\n}\n```\n\n客户可以选择使用`--env`或`--volume`来传递身份验证值。\n\n## 🧪 测试 Azure MCP 服务器\n\n1. 在 VS Code 中打开 GitHub Copilot 并[切换到代理模式](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)\n2. 您应该在工具列表中看到 Azure MCP 服务器\n3. 尝试提示代理使用 Azure MCP 服务器，例如“列出我的 Azure 存储容器”\n4. 代理应该能够使用 Azure MCP 服务器工具来完成您的查询\n\n## 🤖 自定义 MCP 客户端\n\n您可以轻松配置 MCP 客户端以使用 Azure MCP 服务器。让您的客户端运行以下命令并通过标准 IO 或 SSE 访问它。\n\n### 使用标准IO\n\n配置 MCP 客户端执行： `npx -y @azure/mcp@latest server start` 。有关使用 VS Code 的说明，请按照[一键安装](#-one-click-install)或[手动安装](#-manual-install)中的说明进行操作。\n\n### 使用 SSE\n\n1. 打开终端窗口并执行： `npx -y @azure/mcp@latest server start --transport sse`\n\n2. 服务器启动并托管在：。要使用其他端口，请附加`--port {YOUR-PORT-NUMBER}` 。\n\n3. 打开您的 MCP 客户端并添加 SSE 配置值。不同 MCP 客户端的配置值可能有所不同。在 VS Code 中，配置如下：\n\n ```json\n {\n \"servers\": {\n \"Azure MCP Server\": {\n \"type\": \"sse\",\n \"url\": \"http://localhost:5008/sse\"\n }\n }\n }\n ```\n\n更多端到端 MCP 客户端/代理指南即将推出！\n\n## 📝 故障排除\n\n请参阅[故障排除指南](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md)以获取有关常见问题和日志记录的帮助。\n\n## 🔑 身份验证\n\nAzure MCP 服务器与主机操作系统的身份验证机制无缝集成，让您轻松上手！我们通过[`DefaultAzureCredential`](https://learn.microsoft.com/dotnet/azure/sdk/authentication/credential-chains?tabs=dac)在后台使用 Azure Identity，它会按以下顺序尝试以下凭据：\n\n1. **环境变量**（ `EnvironmentCredential` ）——非常适合 CI/CD 管道\n2. **共享令牌缓存**（ `SharedTokenCacheCredential` ） - 使用来自其他工具的缓存令牌\n3. **Visual Studio** （ `VisualStudioCredential` ）-使用您的Visual Studio凭据\n4. **Azure CLI** （ `AzureCliCredential` ）- 使用现有的 Azure CLI 登录名\n5. **Azure PowerShell** （ `AzurePowerShellCredential` ）-使用您的 Az PowerShell 登录名\n6. **Azure 开发人员 CLI** （ `AzureDeveloperCliCredential` ）- 使用您的 azd 登录\n7. **交互式浏览器**（ `InteractiveBrowserCredential` ）- 如果需要，可以回退到基于浏览器的登录\n\n如果您已通过上述任何一种方式登录，Azure MCP 服务器将自动使用这些凭据。请确保您通过 RBAC（基于角色的访问控制）在 Azure 中拥有正确的授权权限（例如，拥有存储帐户的读取权限）。要了解有关 Azure RBAC 授权系统的更多信息，请访问此[链接](https://learn.microsoft.com/azure/role-based-access-control/overview)。\n\n如果您遇到任何身份验证问题，请访问我们的[故障排除指南](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md)。\n\n### 生产凭证\n\n默认情况下，Azure MCP 服务器不包含托管标识和工作负载标识等生产凭据。要启用这些凭据，请设置环境变量：\n\n```\nAZURE_MCP_INCLUDE_PRODUCTION_CREDENTIALS=true\n```\n\n当您在想要使用托管标识的 Azure 服务上运行时，这很有用。\n\n## 🛡️ 安全说明\n\n您的凭据始终通过官方[Azure Identity SDK](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/identity/Azure.Identity/README.md)安全处理 -**我们从不直接存储或管理令牌**。\n\nMCP 作为一种现象，既新颖又前沿。与所有新技术标准一样，请考虑进行安全审查，以确保与 MCP 服务器集成的任何系统都遵守系统应遵循的所有法规和标准。这不仅包括 Azure MCP 服务器，还包括您选择实现的任何 MCP 客户端/代理，直至模型提供商。\n\n## 👥 贡献\n\n欢迎为 Azure MCP 服务器做出贡献！无论您是修复错误、添加新功能还是改进文档，我们都欢迎您的贡献。\n\n请阅读我们的[贡献指南](https://github.com/Azure/azure-mcp/blob/main/CONTRIBUTING.md)以获取以下方面的指导：\n\n* 🛠️ 设置你的开发环境\n* ✨ 添加新命令\n* 📝 代码风格和测试要求\n* 🔄 发起拉取请求\n\n## 🤝 行为准则\n\n本项目已遵循[Microsoft 开放源代码行为准则](https://opensource.microsoft.com/codeofconduct/)。如需了解更多信息，请参阅[行为准则常见问题解答](https://opensource.microsoft.com/codeofconduct/faq/)，或联系咨询其他问题或意见。","Chinese","zh-CN","githubUser","locale",{"_77":78,"_13":79,"_87":40,"_88":40,"_31":40,"_16":89,"_90":91,"_110":111,"_118":-5,"_119":-5,"_120":121,"_184":185,"_189":-5,"_98":152,"_190":191,"_101":192,"_193":194},"addedAt","2025-04-21T14:50:48.998498Z",[80,81,82,83,84,85,86],"author:official","category:cloud-platforms","category:agent-orchestration","environment:network","hosting:remote-capable","language:c#","author:claimed","descriptionMarkdown","descriptionPlainText",5771,"integrations",[92,103],{"_93":94,"_29":100,"_101":102},"brand",{"_95":96,"_34":97,"_98":99},"logoSvgPath","M23.922 16.997C23.061 18.492 18.063 22.02 12 22.02 5.937 22.02.939 18.492.078 16.997A.641.641 0 0 1 0 16.741v-2.869a.883.883 0 0 1 .053-.22c.372-.935 1.347-2.292 2.605-2.656.167-.429.414-1.055.644-1.517a10.098 10.098 0 0 1-.052-1.086c0-1.331.282-2.499 1.132-3.368.397-.406.89-.717 1.474-.952C7.255 2.937 9.248 1.98 11.978 1.98c2.731 0 4.767.957 6.166 2.093.584.235 1.077.546 1.474.952.85.869 1.132 2.037 1.132 3.368 0 .368-.014.733-.052 1.086.23.462.477 1.088.644 1.517 1.258.364 2.233 1.721 2.605 2.656a.841.841 0 0 1 .053.22v2.869a.641.641 0 0 1-.078.256Zm-11.75-5.992h-.344a4.359 4.359 0 0 1-.355.508c-.77.947-1.918 1.492-3.508 1.492-1.725 0-2.989-.359-3.782-1.259a2.137 2.137 0 0 1-.085-.104L4 11.746v6.585c1.435.779 4.514 2.179 8 2.179 3.486 0 6.565-1.4 8-2.179v-6.585l-.098-.104s-.033.045-.085.104c-.793.9-2.057 1.259-3.782 1.259-1.59 0-2.738-.545-3.508-1.492a4.359 4.359 0 0 1-.355-.508Zm2.328 3.25c.549 0 1 .451 1 1v2c0 .549-.451 1-1 1-.549 0-1-.451-1-1v-2c0-.549.451-1 1-1Zm-5 0c.549 0 1 .451 1 1v2c0 .549-.451 1-1 1-.549 0-1-.451-1-1v-2c0-.549.451-1 1-1Zm3.313-6.185c.136 1.057.403 1.913.878 2.497.442.544 1.134.938 2.344.938 1.573 0 2.292-.337 2.657-.751.384-.435.558-1.15.558-2.361 0-1.14-.243-1.847-.705-2.319-.477-.488-1.319-.862-2.824-1.025-1.487-.161-2.192.138-2.533.529-.269.307-.437.808-.438 1.578v.021c0 .265.021.562.063.893Zm-1.626 0c.042-.331.063-.628.063-.894v-.02c-.001-.77-.169-1.271-.438-1.578-.341-.391-1.046-.69-2.533-.529-1.505.163-2.347.537-2.824 1.025-.462.472-.705 1.179-.705 2.319 0 1.211.175 1.926.558 2.361.365.414 1.084.751 2.657.751 1.21 0 1.902-.394 2.344-.938.475-.584.742-1.44.878-2.497Z","GitHub Copilot","slug","github-copilot","Integrates with GitHub Copilot in VS Code, enabling AI agents to use Azure services through the Azure MCP Server when in Agent mode.","uid","ykwlwohbg3",{"_93":104,"_29":108,"_101":109},{"_95":105,"_34":106,"_98":107},"M11.998,24c-0.321,0-0.641-0.084-0.922-0.247l-2.936-1.737c-0.438-0.245-0.224-0.332-0.08-0.383 c0.585-0.203,0.703-0.25,1.328-0.604c0.065-0.037,0.151-0.023,0.218,0.017l2.256,1.339c0.082,0.045,0.197,0.045,0.272,0l8.795-5.076 c0.082-0.047,0.134-0.141,0.134-0.238V6.921c0-0.099-0.053-0.192-0.137-0.242l-8.791-5.072c-0.081-0.047-0.189-0.047-0.271,0 L3.075,6.68C2.99,6.729,2.936,6.825,2.936,6.921v10.15c0,0.097,0.054,0.189,0.139,0.235l2.409,1.392 c1.307,0.654,2.108-0.116,2.108-0.89V7.787c0-0.142,0.114-0.253,0.256-0.253h1.115c0.139,0,0.255,0.112,0.255,0.253v10.021 c0,1.745-0.95,2.745-2.604,2.745c-0.508,0-0.909,0-2.026-0.551L2.28,18.675c-0.57-0.329-0.922-0.945-0.922-1.604V6.921 c0-0.659,0.353-1.275,0.922-1.603l8.795-5.082c0.557-0.315,1.296-0.315,1.848,0l8.794,5.082c0.57,0.329,0.924,0.944,0.924,1.603 v10.15c0,0.659-0.354,1.273-0.924,1.604l-8.794,5.078C12.643,23.916,12.324,24,11.998,24z M19.099,13.993 c0-1.9-1.284-2.406-3.987-2.763c-2.731-0.361-3.009-0.548-3.009-1.187c0-0.528,0.235-1.233,2.258-1.233 c1.807,0,2.473,0.389,2.747,1.607c0.024,0.115,0.129,0.199,0.247,0.199h1.141c0.071,0,0.138-0.031,0.186-0.081 c0.048-0.054,0.074-0.123,0.067-0.196c-0.177-2.098-1.571-3.076-4.388-3.076c-2.508,0-4.004,1.058-4.004,2.833 c0,1.925,1.488,2.457,3.895,2.695c2.88,0.282,3.103,0.703,3.103,1.269c0,0.983-0.789,1.402-2.642,1.402 c-2.327,0-2.839-0.584-3.011-1.742c-0.02-0.124-0.126-0.215-0.253-0.215h-1.137c-0.141,0-0.254,0.112-0.254,0.253 c0,1.482,0.806,3.248,4.655,3.248C17.501,17.007,19.099,15.91,19.099,13.993z","Node.js","node-dot-js","Provides support for building Azure applications using Node.js, with specific guidance available through prompts.","h468j8ybx5","namespace",{"_112":113,"_98":117},"owner",{"_114":115},"githubAccount",{"_116":117},"login","Azure","readmeMarkdown","redditPostExternalId","repository",{"_122":123,"_136":137,"_141":142,"_162":163,"_176":177,"_178":-5,"_179":180},"argumentsJsonSchema",{"_124":125,"_133":134,"_131":135},"properties",{"_126":127},"AZURE_MCP_INCLUDE_PRODUCTION_CREDENTIALS",{"_128":129,"_29":130,"_131":132},"default","false","Set to 'true' to enable production credentials like Managed Identity and Workload Identity","type","string","required",[],"object","githubProject",{"_32":138,"_139":140},">[!IMPORTANT]\n🚀 Active development has moved to [microsoft/mcp](https://github.com/microsoft/mcp/tree/main/servers/Azure.Mcp.Server) as of August 25, 2025\n--------\n\n# 🌟 Azure MCP Server\n\nThe Azure MCP Server implements the [MCP specification](https://modelcontextprotocol.io) to create a seamless connection between AI agents and Azure services. Azure MCP Server can be used alone or with the [GitHub Copilot for Azure extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-github-copilot) in VS Code. This project is in Public Preview and implementation may significantly change prior to our General Availability.\n\n\n>[!WARNING]\n>**Deprecation Notice: SSE transport mode has been removed in version [0.4.0 (2025-07-15)](https://github.com/Azure/azure-mcp/blob/main/CHANGELOG.md#breaking-changes-7).**\n>\n> SSE was deprecated in MCP `2025-03-26` due to [security vulnerabilities and architectural limitations](https://blog.fka.dev/blog/2025-06-06-why-mcp-deprecated-sse-and-go-with-streamable-http/). Users must discontinue use of SSE transport mode and upgrade to version `0.4.0` or newer to maintain compatibility with current MCP clients.\n\n\n### ✅ VS Code Install Guide (Recommended)\n\n1. Install either the stable or Insiders release of VS Code:\n * [💫 Stable release](https://code.visualstudio.com/download)\n * [🔮 Insiders release](https://code.visualstudio.com/insiders)\n1. Install the [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) and [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) extensions\n1. Install the [Azure MCP Server](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-mcp-server) extension\n\n### 🚀 Quick Start\n\n1. Open GitHub Copilot in VS Code and [switch to Agent mode](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode)\n1. Click `refresh` on the tools list\n - You should see the Azure MCP Server in the list of tools\n1. Try a prompt that tells the agent to use the Azure MCP Server, such as `List my Azure Storage containers`\n - The agent should be able to use the Azure MCP Server tools to complete your query\n1. Check out the [documentation](https://learn.microsoft.com/azure/developer/azure-mcp-server/) and review the [troubleshooting guide](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md) for commonly asked questions\n1. We're building this in the open. Your feedback is much appreciated, and will help us shape the future of the Azure MCP server\n - 👉 [Open an issue in the public repository](https://github.com/Azure/azure-mcp/issues/new/choose)\n\n\n## ✨ What can you do with the Azure MCP Server?\n\nThe Azure MCP Server supercharges your agents with Azure context. Here are some cool prompts you can try:\n\n### 🔎 Azure AI Search\n\n* \"What indexes do I have in my Azure AI Search service 'mysvc'?\"\n* \"Let's search this index for 'my search query'\"\n\n### ⚙️ Azure App Configuration\n\n* \"List my App Configuration stores\"\n* \"Show my key-value pairs in App Config\"\n\n### 📦 Azure Container Registry (ACR)\n\n* \"List all my Azure Container Registries\"\n* \"Show me my container registries in the 'myproject' resource group\"\n* \"List all my Azure Container Registry repositories\"\n\n### ☸️ Azure Kubernetes Service (AKS)\n\n* \"List my AKS clusters in my subscription\"\n* \"Show me all my Azure Kubernetes Service clusters\"\n\n### 📊 Azure Cosmos DB\n\n* \"Show me all my Cosmos DB databases\"\n* \"List containers in my Cosmos DB database\"\n\n### 🧮 Azure Data Explorer\n\n* \"Get Azure Data Explorer databases in cluster 'mycluster'\"\n* \"Sample 10 rows from table 'StormEvents' in Azure Data Explorer database 'db1'\"\n\n### ⚡ Azure Managed Lustre\n\n* \"List the Azure Managed Lustre clusters in resource group 'my-resourcegroup'\"\n* \"How many IP Addresses I need to create a 128 TiB cluster of AMLFS 500?\"\n\n### 📊 Azure Monitor\n\n* \"Query my Log Analytics workspace\"\n\n### 🔧 Azure Resource Management\n\n* \"List my resource groups\"\n* \"List my Azure CDN endpoints\"\n* \"Help me build an Azure application using Node.js\"\n\n### 🗄️ Azure SQL Database\n\n* \"Show me details about my Azure SQL database 'mydb'\"\n* \"List all databases in my Azure SQL server 'myserver'\"\n* \"List all firewall rules for my Azure SQL server 'myserver'\"\n* \"List all elastic pools in my Azure SQL server 'myserver'\"\n* \"List Active Directory administrators for my Azure SQL server 'myserver'\"\n\n### 💾 Azure Storage\n\n* \"List my Azure storage accounts\"\n* \"Get details about my storage account 'mystorageaccount'\"\n* \"Create a new storage account in East US with Data Lake support\"\n* \"Show me the tables in my Storage account\"\n* \"Get details about my Storage container\"\n* \"Upload my file to the blob container\"\n* \"List paths in my Data Lake file system\"\n* \"List files and directories in my File Share\"\n* \"Send a message to my storage queue\"\n\n## 🛠️ Currently Supported Tools\n\n

The Azure MCP Server provides tools for interacting with the following Azure services

\n\n### 🔎 Azure AI Search (search engine/vector database)\n\n* List Azure AI Search services\n* List indexes and look at their schema and configuration\n* Query search indexes\n\n### ⚙️ Azure App Configuration\n\n* List App Configuration stores\n* Manage key-value pairs\n* Handle labeled configurations\n* Lock/unlock configuration settings\n\n### 🛡️ Azure Best Practices\n\n* Get secure, production-grade Azure SDK best practices for effective code generation.\n\n### 🖥️ Azure CLI Extension\n\n* Execute Azure CLI commands directly\n* Support for all Azure CLI functionality\n\n### 📦 Azure Container Registry (ACR)\n\n* List Azure Container Registries and repositories in a subscription\n* Filter container registries and repositories by resource group\n* JSON output formatting\n* Cross-platform compatibility\n\n### 📊 Azure Cosmos DB (NoSQL Databases)\n\n* List Cosmos DB accounts\n* List and query databases\n* Manage containers and items\n* Execute SQL queries against containers\n\n### 🧮 Azure Data Explorer\n\n* List Azure Data Explorer clusters\n* List databases\n* List tables\n* Get schema for a table\n* Sample rows from a table\n* Query using KQL\n\n### 🐬 Azure Database for MySQL - Flexible Server\n\n* List and query databases.\n* List and get schema for tables.\n* List, get configuration and get parameters for servers.\n\n### 🐘 Azure Database for PostgreSQL - Flexible Server\n\n* List and query databases.\n* List and get schema for tables.\n* List, get configuration and get/set parameters for servers.\n\n### 🛠️ Azure Developer CLI (azd) Extension\n\n* Execute Azure Developer CLI commands directly\n* Support for template discovery, template initialization, provisioning and deployment\n* Cross-platform compatibility\n\n### 🚀 Azure Deploy\n\n* Generate Azure service architecture diagrams from source code\n* Create a deploy plan for provisioning and deploying the application\n* Get the application service log for a specific azd environment\n* Get the bicep or terraform file generation rules for an application\n* Get the GitHub pipeline creation guideline for an application\n\n### 🧮 Azure Foundry\n\n* List Azure Foundry models\n* Deploy foundry models\n* List foundry model deployments\n* List knowledge indexes\n\n### ☁️ Azure Function App\n\n* List Azure Function Apps\n* Get details for a specific Function App\n\n### 🔑 Azure Key Vault\n\n* List, create, and import certificates\n* List and create keys\n* List and create secrets\n\n### ☸️ Azure Kubernetes Service (AKS)\n\n* List Azure Kubernetes Service clusters\n\n### 📦 Azure Load Testing\n\n* List, create load test resources\n* List, create load tests\n* Get, list, (create) run and rerun, update load test runs\n\n\n### 🚀 Azure Managed Grafana\n\n* List Azure Managed Grafana\n\n### ⚡ Azure Managed Lustre\n\n* List Azure Managed Lustre filesystems\n* Get the number of IP addresses required for a specific SKU and size of Azure Managed Lustre filesystem\n\n### 🏪 Azure Marketplace\n\n* Get details about Marketplace products\n\n### 📈 Azure Monitor\n\n#### Log Analytics\n\n* List Log Analytics workspaces\n* Query logs using KQL\n* List available tables\n\n#### Health Models\n\n* Get health of an entity\n\n#### Metrics\n\n* Query Azure Monitor metrics for resources with time series data\n* List available metric definitions for resources\n\n### 🏥 Azure Service Health\n\n* Get the availability status for a specific resource\n* List availability statuses for all resources in a subscription or resource group\n\n### ⚙️ Azure Native ISV Services\n\n* List Monitored Resources in a Datadog Monitor\n\n### 🛡️ Azure Quick Review CLI Extension\n\n* Scan Azure resources for compliance related recommendations\n\n### 📊 Azure Quota\n\n* List available regions\n* Check quota usage\n\n### 🔴 Azure Redis Cache\n\n* List Redis Cluster resources\n* List databases in Redis Clusters\n* List Redis Cache resources\n* List access policies for Redis Caches\n\n### 🏗️ Azure Resource Groups\n\n* List resource groups\n\n### 🎭 Azure Role-Based Access Control (RBAC)\n\n* List role assignments\n\n### 🚌 Azure Service Bus\n\n* Examine properties and runtime information about queues, topics, and subscriptions\n\n### 🗄️ Azure SQL Database\n\n* Show database details and properties\n* List the details and properties of all databases\n* List SQL server firewall rules\n\n### 🗄️ Azure SQL Elastic Pool\n\n* List elastic pools in SQL servers\n\n### 🗄️ Azure SQL Server\n\n* List Microsoft Entra ID administrators for SQL servers\n\n### 💾 Azure Storage\n\n* List and create Storage accounts\n* Get detailed information about specific Storage accounts\n* Manage blob containers and blobs\n* Upload files to blob containers\n* List and query Storage tables\n* List paths in Data Lake file systems\n* Get container properties and metadata\n* List files and directories in File Shares\n\n### 📋 Azure Subscription\n\n* List Azure subscriptions\n\n### 🏗️ Azure Terraform Best Practices\n\n* Get secure, production-grade Azure Terraform best practices for effective code generation and command execution\n\n### 🖥️ Azure Virtual Desktop\n\n* List Azure Virtual Desktop host pools\n* List session hosts in host pools\n* List user sessions on a session host\n\n### 📊 Azure Workbooks\n\n* List workbooks in resource groups\n* Create new workbooks with custom visualizations\n* Update existing workbook configurations\n* Get workbook details and metadata\n* Delete workbooks when no longer needed\n\n### 🏗️ Bicep\n\n* Get the Bicep schema for specific Azure resource types\n\n### 🏗️ Cloud Architect\n\n* Design Azure cloud architectures through guided questions\n\nAgents and models can discover and learn best practices and usage guidelines for the `azd` MCP tool. For more information, see [AZD Best Practices](https://github.com/Azure/azure-mcp/tree/main/areas/extension/src/AzureMcp.Extension/Resources/azd-best-practices.txt).\n\n

\n\nFor detailed command documentation and examples, see [Azure MCP Commands](https://github.com/Azure/azure-mcp/blob/main/docs/azmcp-commands.md).\n\n## 🔄️ Upgrading Existing Installs to the Latest Version\n\n

How to stay current with releases of Azure MCP Server

\n\n#### NPX\n\nIf you use the default package spec of `@azure/mcp@latest`, npx will look for a new version on each server start. If you use just `@azure/mcp`, npx will continue to use its cached version until its cache is cleared.\n\n#### NPM\n\nIf you globally install the cli via `npm install -g @azure/mcp` it will use the installed version until you manually update it with `npm update -g @azure/mcp`.\n\n#### Docker\n\nThere is no version update built into the docker image. To update, just pull the latest from the repo and repeat the [docker installation instructions](#docker-install).\n\n#### VS Code\n\nInstallation in VS Code should be in one of the previous forms and the update instructions are the same. If you installed the mcp server with the `npx` command and `-y @azure/mcp@latest` args, npx will check for package updates each time VS Code starts the server. Using a docker container in VS Code has the same no-update limitation described above.\n

\n\n## ⚙️ Advanced Install Scenarios (Optional)\n\n

Docker containers, custom MCP clients, and manual install options

\n\n### 🐋 Docker Install Steps (Optional)\n\nMicrosoft publishes an official Azure MCP Server Docker container on the [Microsoft Artifact Registry](https://mcr.microsoft.com/artifact/mar/azure-sdk/azure-mcp).\n\nFor a step-by-step Docker installation, follow these instructions:\n\n1. Create an `.env` file with environment variables that [match one of the `EnvironmentCredential`](https://learn.microsoft.com/dotnet/api/azure.identity.environmentcredential) sets. For example, a `.env` file using a service principal could look like:\n\n ```bash\n AZURE_TENANT_ID={YOUR_AZURE_TENANT_ID}\n AZURE_CLIENT_ID={YOUR_AZURE_CLIENT_ID}\n AZURE_CLIENT_SECRET={YOUR_AZURE_CLIENT_SECRET}\n ```\n\n2. Add `.vscode/mcp.json` or update existing MCP configuration. Replace `/full/path/to/.env` with a path to your `.env` file.\n\n ```json\n {\n \"servers\": {\n \"Azure MCP Server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"-i\",\n \"--rm\",\n \"--env-file\",\n \"/full/path/to/.env\"\n \"mcr.microsoft.com/azure-sdk/azure-mcp:latest\",\n ]\n }\n }\n }\n ```\n\nOptionally, use `--env` or `--volume` to pass authentication values.\n\n### 🤖 Custom MCP Client Install Steps (Optional)\n\nYou can easily configure your MCP client to use the Azure MCP Server. Have your client run the following command and access it via standard IO.\n\n```bash\nnpx -y @azure/mcp@latest server start\n```\n\n### 🔧 Manual Install Steps (Optional)\n\nFor a step-by-step installation, follow these instructions:\n\n1. Add `.vscode/mcp.json`:\n\n ```json\n {\n \"servers\": {\n \"Azure MCP Server\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@azure/mcp@latest\",\n \"server\",\n \"start\"\n ]\n }\n }\n }\n ```\n\n You can optionally set the `--namespace ` flag to install tools for the specified Azure product or service.\n\n1. Add `.vscode/mcp.json`:\n\n ```json\n {\n \"servers\": {\n \"Azure Best Practices\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@azure/mcp@latest\",\n \"server\",\n \"start\",\n \"--namespace\",\n \"bestpractices\" // Any of the available MCP servers can be referenced here.\n ]\n }\n }\n }\n ```\n\nMore end-to-end MCP client/agent guides are coming soon!\n

\n\n## Data Collection\n\nThe software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's [privacy statement](https://www.microsoft.com/privacy/privacystatement). You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.\n\n### Telemetry Configuration\n\nTelemetry collection is on by default.\n\nTo opt out, set the environment variable `AZURE_MCP_COLLECT_TELEMETRY` to `false` in your environment.\n\n## 📝 Troubleshooting\n\nSee [Troubleshooting guide](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md#128-tool-limit-issue) for help with common issues and logging.\n\n### 🔑 Authentication\n\n

Authentication options including DefaultAzureCredential flow, RBAC permissions, troubleshooting, and production credentials

\n\nThe Azure MCP Server uses the Azure Identity library for .NET to authenticate to Microsoft Entra ID. For detailed information, see [Authentication Fundamentals](https://github.com/Azure/azure-mcp/blob/main/docs/Authentication.md#authentication-fundamentals).\n\nIf you're running into any issues with authentication, visit our [troubleshooting guide](https://github.com/Azure/azure-mcp/blob/main/TROUBLESHOOTING.md#authentication).\n\nFor enterprise authentication scenarios, including network restrictions, security policies, and protected resources, see [Authentication Scenarios in Enterprise Environments](https://github.com/Azure/azure-mcp/blob/main/docs/Authentication.md#authentication-scenarios-in-enterprise-environments).\n

\n\n## 🛡️ Security Note\n\nYour credentials are always handled securely through the official [Azure Identity SDK](https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/identity/Azure.Identity/README.md) - **we never store or manage tokens directly**.\n\nMCP as a phenomenon is very novel and cutting-edge. As with all new technology standards, consider doing a security review to ensure any systems that integrate with MCP servers follow all regulations and standards your system is expected to adhere to. This includes not only the Azure MCP Server, but any MCP client/agent that you choose to implement down to the model provider.\n\n## 👥 Contributing\n\nWe welcome contributions to the Azure MCP Server! Whether you're fixing bugs, adding new features, or improving documentation, your contributions are welcome.\n\nPlease read our [Contributing Guide](https://github.com/Azure/azure-mcp/blob/main/CONTRIBUTING.md) for guidelines on:\n\n* 🛠️ Setting up your development environment\n* ✨ Adding new commands\n* 📝 Code style and testing requirements\n* 🔄 Making pull requests\n\n## 🤝 Code of Conduct\n\nThis project has adopted the\n[Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information, see the\n[Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)\nor contact [open@microsoft.com](mailto:open@microsoft.com)\nwith any additional questions or comments.\n","url","https://github.com/Azure/azure-mcp","githubRepository",{"_143":144,"_145":146,"_147":148,"_16":149,"_150":151,"_34":152,"_112":153,"_155":156,"_157":158,"_160":161},"defaultBranch","main","fullName","Azure/azure-mcp","githubTreeId",761745,10862,"language","C#","azure-mcp",{"_116":117,"_101":154},"xSDG4qFExH","recentStargazers",5,"spdxLicense",{"_34":159},"MIT License","stargazers",1161,"glamaJson",{"_164":165},"maintainers",[166,167,168,169,170,171,172,173,174,175],"jongio","joshfree","hallipr","g2vinay","conniey","xiangyan99","JonathanCrd","rohit-ganguly","lfraleigh","Petermarcu","inspectable",false,"npmPackage","supportedPlatforms",[181,182,183],"WINDOWS","LINUX","MACOS","scores",{"_186":-5,"_187":-5,"_188":-5},"license","quality","security","simpleIcon","toolCount",0,"kru2ypgb7q","updatedAt","2025-10-01T22:25:31.918792Z","meta",[197,200,202,209,212,214,217,220,223,226,229,231,234,237,239,241,243,245,247],{"_198":199},"title","Azure MCP Server | Glama",{"_201":40,"_34":29},"content",{"_203":204,"_205":206,"_207":208},"href","https://glama.ai/mcp/servers/@Azure/azure-mcp","rel","canonical","tagName","link",{"_201":40,"_210":211},"property","og:title",{"_201":40,"_210":213},"og:description",{"_201":215,"_210":216},"https://glama.ai/logo.png","og:logo",{"_201":218,"_210":219},"https://glama.ai/mcp/servers/@Azure/azure-mcp/og-image","og:image",{"_201":221,"_210":222},"630","og:image:height",{"_201":224,"_210":225},"1200","og:image:width",{"_201":227,"_210":228},"website","og:type",{"_201":204,"_210":230},"og:url",{"_201":232,"_210":233},"Glama – MCP Hosting Platform","og:site_name",{"_201":235,"_34":236},"summary_large_image","twitter:card",{"_201":232,"_34":238},"twitter:title",{"_201":40,"_34":240},"twitter:description",{"_201":218,"_34":242},"twitter:image",{"_201":221,"_34":244},"twitter:image:height",{"_201":224,"_34":246},"twitter:image:width",{"_248":249},"script:ld+json",{"_250":251,"_252":253},"@context","http://schema.org","@graph",[254],{"_250":255,"_256":257,"_258":259},"https://schema.org","@type","BreadcrumbList","itemListElement",[260,267,271,275],{"_256":261,"_262":263,"_34":264,"_265":266},"ListItem","item","/","Glama","position",1,{"_256":261,"_262":268,"_34":269,"_265":270},"/mcp","MCP",2,{"_256":261,"_262":272,"_34":273,"_265":274},"/mcp/servers","Servers",3,{"_256":261,"_262":276,"_34":40,"_265":277},"/mcp/servers/@Azure/azure-mcp",4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_281":282,"_27":288,"_311":312,"_195":326,"_323":350,"_351":352},"blob",{"_201":283,"_284":285,"_286":287},"\n \n true\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n","fileName","AzureMcp.Workbooks.csproj","size",865,{"_77":78,"_13":289,"_87":40,"_88":40,"_31":40,"_16":89,"_90":290,"_110":295,"_118":-5,"_119":-5,"_120":298,"_184":310,"_189":-5,"_98":152,"_190":191,"_101":192,"_193":194},[80,81,82,83,84,85,86],[291,293],{"_93":292,"_29":100,"_101":102},{"_95":96,"_34":97,"_98":99},{"_93":294,"_29":108,"_101":109},{"_95":105,"_34":106,"_98":107},{"_112":296,"_98":117},{"_114":297},{"_116":117},{"_122":299,"_136":303,"_141":304,"_162":307,"_176":177,"_178":-5,"_179":309},{"_124":300,"_133":302,"_131":135},{"_126":301},{"_128":129,"_29":130,"_131":132},[],{"_32":138,"_139":140},{"_143":144,"_145":146,"_147":148,"_16":149,"_150":151,"_34":152,"_112":305,"_155":156,"_157":306,"_160":161},{"_116":117,"_101":154},{"_34":159},{"_164":308},[166,167,168,169,170,171,172,173,174,175],[181,182,183],{"_186":-5,"_187":-5,"_188":-5},"member",{"_313":314,"_317":318,"_319":320,"_147":321,"_322":177,"_323":285,"_324":325,"_286":287,"_131":281},"commit",{"_315":316},"sha","b8fb975d73fb120aceeb1ea271c64751fd3f11b2","contentStoredObjectPointerId",14457692,"fullPath","areas/workbooks/src/AzureMcp.Workbooks/AzureMcp.Workbooks.csproj",761599,"indexable","path","safeToDisplayAsText",true,[327,329,331,333,335,336,337,339,340,341,342,343,344,345,346,347,348,349],{"_198":328},"AzureMcp.Workbooks.csproj | Azure MCP Server | Glama",{"_201":330,"_34":29},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_203":332,"_205":206,"_207":208},"https://glama.ai/mcp/servers/@Azure/azure-mcp/blob/b8fb975d73fb120aceeb1ea271c64751fd3f11b2/areas/workbooks/src/AzureMcp.Workbooks",{"_201":334,"_210":211},"AzureMcp.Workbooks.csproj | Azure MCP Server",{"_201":330,"_210":213},{"_201":215,"_210":216},{"_201":338,"_210":219},"https://glama.ai/generated-images/og?title=AzureMcp.Workbooks.csproj+%7C+Azure+MCP+Server",{"_201":221,"_210":222},{"_201":224,"_210":225},{"_201":227,"_210":228},{"_201":332,"_210":230},{"_201":232,"_210":233},{"_201":235,"_34":236},{"_201":232,"_34":238},{"_201":330,"_34":240},{"_201":338,"_34":242},{"_201":221,"_34":244},{"_201":224,"_34":246},"areas/workbooks/src/AzureMcp.Workbooks","treeMembers",[353,358,362,366,370,374,376,380],{"_313":354,"_319":355,"_323":356,"_131":357},{"_315":316},"areas/workbooks/src/AzureMcp.Workbooks/Commands","Commands","tree",{"_313":359,"_319":360,"_323":361,"_131":357},{"_315":316},"areas/workbooks/src/AzureMcp.Workbooks/Models","Models",{"_313":363,"_319":364,"_323":365,"_131":357},{"_315":316},"areas/workbooks/src/AzureMcp.Workbooks/Options","Options",{"_313":367,"_319":368,"_323":369,"_131":357},{"_315":316},"areas/workbooks/src/AzureMcp.Workbooks/Services","Services",{"_313":371,"_319":372,"_323":373,"_131":281},{"_315":316},"areas/workbooks/src/AzureMcp.Workbooks/AssemblyInfo.cs","AssemblyInfo.cs",{"_313":375,"_319":320,"_323":285,"_131":281},{"_315":316},{"_313":377,"_319":378,"_323":379,"_131":281},{"_315":316},"areas/workbooks/src/AzureMcp.Workbooks/GlobalUsings.cs","GlobalUsings.cs",{"_313":381,"_319":382,"_323":383,"_131":281},{"_315":316},"areas/workbooks/src/AzureMcp.Workbooks/WorkbooksSetup.cs","WorkbooksSetup.cs","actionData","errors"]

MCP directory API