SRE Agent MCP-server in Azure SRE-agent

Uw SRE-agent bouwt in de loop van de tijd diepe context over uw services: incidentpatronen, architectuurdetails, operationele expertise. Met de MCP-server van de SRE-agent is die kennis rechtstreeks beschikbaar in uw IDE-, terminal- of AI-assistent, ongeacht of u werkt vanuit GitHub Copilot CLI, Claude Code, VS Code of een andere client die geschikt is voor MCP.

Stel tijdens het coderen, foutopsporing of incidentrespons een vraag aan uw agent, start een onderzoek of configureer een connector zonder van hulpprogramma te wisselen. Uw ontwikkelomgeving en de operationele intelligentie van uw agent maken verbinding via dezelfde natuurlijke taalinterface die u al gebruikt.

Hoe werkt het?

De volgende stroom laat zien hoe een MCP-client SRE-agent bereikt via Azure MCP-server:

  1. U maakt een SRE-agentresource in Azure. De resource is een Microsoft.App/agents resource en bevat een agenteindpunt.
  2. U installeert Azure MCP-server in een MCP-client of -host.
  3. De MCP-client start Azure MCP-server lokaal of maakt verbinding met een gehoste server.
  4. Azure MCP-server wordt geverifieerd met behulp van de Azure identiteit die beschikbaar is op de host.
  5. De client vraagt Azure MCP Server om SRE Agent-resources te ontdekken.
  6. Azure MCP Server bepaalt het eindpunt van de SRE Agent via Azure Resource Graph.
  7. Azure MCP Server proxyt thread- en taakaanvragen naar het geselecteerde SRE-agent-eindpunt.

Verbinding maken met de MCP-server van de SRE-agent

De hulpprogramma's van de SRE-agent maken deel uit van het Azure MCP-server, waarmee het Model Context Protocol (MCP) wordt geïmplementeerd. U installeert de Azure MCP-server in uw MCP-client en de hulpprogramma's van de SRE-agent zijn beschikbaar naast andere Azure hulpprogramma's. De server draait lokaal via npx en verzorgt authenticatie, endpointresolutie en API-aanroepen namens u.

Twee API-lagen verwerken verschillende bewerkingen:

Laag Wat het aankan Authentication
Beheervlak (ARM) Agentresources, connectoren Rol lezer via Azure Resource Manager
Gegevensvlak Discussies, herinneringen, taken, vaardigheden, incidenten SRE Agent-beheerdersrol via agent-eindpunt (*.azuresre.ai)

De server lost agenteindpunten automatisch op via Azure Resource Graph. U geeft een abonnement en agentnaam op en de server vindt het eindpunt.

Hulpprogramma's worden weergegeven met het sreagent_ voorvoegsel in uw MCP-client (bijvoorbeeld sreagent_agents_list, sreagent_threads_create).

Authentication

Azure MCP-server gebruikt de Azure verificatiecontext die beschikbaar is op de host. Ondersteunde verificatiemethoden zijn onder andere Azure CLI aanmelding, VS Code Azure aanmelding, Azure PowerShell aanmeldingsgegevens, omgevingsreferenties en beheerde identiteit.

De MCP-server verleent geen nieuwe machtigingen. SRE Agent-bewerkingen worden uitgevoerd binnen de bestaande Azure machtigingen van de aanroeper en toegang tot de SRE-agent. Als de aanroeper geen machtigingen heeft om resources weer te geven, een thread te openen of agentconfiguratie te wijzigen, mislukt de bewerking met een autorisatiefout.

Important

Interactieve terugval van verificatie wordt onderdrukt wanneer Azure MCP-server wordt uitgevoerd in de servermodus. Meld u aan voordat u de server start of configureer een niet-inactieve referentie, zoals beheerde identiteit of omgevingsreferenties.

Stel AZURE_TOKEN_CREDENTIALS deze optie in om het referentietype vast te maken wanneer er meerdere referentiebronnen beschikbaar zijn.

toestemmingen

Twee Azure RBAC-rollen op de resource Microsoft.App/agents:

Role Omvang Wat het mogelijk maakt
Reader Beheerlaag (ARM) Agents en connectors weergeven en ophalen
SRE-agentbeheerder Gegevensvlak Threads, herinneringen, geplande taken, vaardigheden, hooks, prompts, incidenten, werkstromen

Ondersteunde clients

Cliënt Installatiemethode
VS-code met GitHub Copilot Installeer de Azure MCP Server-extensie en meld u aan bij Azure
GITHUB COPILOT CLI Gebruik /mcp add of configureer ~/.copilot/mcp.json handmatig
Cursor Toevoegen aan MCP-configuratie
Claude Code Toevoegen aan MCP-configuratie van gebruiker of project
Claude Desktop MCPB-bundel installeren of opdracht voor lokale server configureren
Andere MCP-clients Configureren met behulp van npx, dotnet, Docker uvxof andere ondersteunde methoden

Verbindingswerkstroom

Gebruik deze werkstroom op hoog niveau om een MCP-client te verbinden met SRE Agent:

  1. SRE-agent inrichten: Maak de SRE-agentresource met behulp van de Azure-portal, ARM of Bicep. Met deze stap maakt u de Microsoft.App/agents resource en het bijbehorende agenteindpunt.

  2. Installeer Azure MCP-server: gebruik een ondersteunde methode, zoals de VS Code-extensie, npx, , dotnetDockeruvx, MCPB of een clientspecifiek installatieprogramma.

  3. Registreer Azure MCP-server bij uw MCP-client: kies een modus voor blootstelling van het hulpprogramma. De standaardmodus groepeert hulpprogramma's per naamruimte.

  4. Verifiëren bij Azure: meld u aan bij de host of geef een beheerde identiteit of omgevingsreferentie op.

  5. Agents detecteren: Vraag de MCP-client om SRE Agent-resources in een abonnement weer te geven.

  6. Een onderzoek starten: Vraag de client om een thread te maken of een onderzoek uit te voeren op een geselecteerde agent.

  7. Agent beheren: Gebruik de beheertools om vaardigheden, connectoren, hooks, subagenten, geplande taken, prompts en incidentresponsintegraties te configureren.

Beschikbare bewerkingen en voorbeeldprompts

Belangrijkste kerngebieden, elk toegankelijk via prompts in natuurlijke taal:

Area Operations Voorbeeldprompt
Agents beheren Subagents weergeven, details ophalen, maken en verwijderen 'Mijn SRE-agents weergeven in abonnement X'
Connectors configureren Kusto- en MCP-connectors maken, testen en verwijderen Maak een Kusto-connector met de naam prod-logs op agent Y
Onderzoeken uitvoeren Threads maken, berichten verzenden, autonoom onderzoek "Onderzoeken waarom de productie-API verhoogde latentie heeft"
Werk plannen Geplande taken maken, onderbreken, hervatten en verwijderen Pauzeer de geplande nachtelijke taak voor agent Y
Incidenten beheren Actieve incidenten weergeven, PagerDuty en ServiceNow instellen Actieve incidenten voor agent Y weergeven
Kennis en opdrachten Herinneringen zoeken en uploaden, algemene prompts beheren Doorzoek herinneringen op 'uitrolfouten'
Werkstromen maken YAML-werkstromen genereren, valideren en toepassen 'Een werkstroom genereren voor geautomatiseerd terugdraaien'

Nadat u verbinding hebt gemaakt en geverifieerd, kunt u ook beginnen met prompts voor natuurlijke taal, zoals:

List my SRE Agent resources in subscription <SUBSCRIPTION_ID>.
Create an SRE Agent thread for <agent-name> and investigate why the production API has elevated latency.
Continue the investigation thread and check whether recent deployments or PagerDuty incidents are related.

Autonoom onderzoek

De investigate-opdracht voert een onderzoekslus met meerdere stappen uit. Je agent analyseert het probleem, vraagt data op, formuleert hypotheses en volgt automatisch op.

  • Standaardlimieten: 20 iteraties, een time-out van 10 minuten (beide configureerbaar via --max-iterations en --timeout-seconds)
  • Standaardmodus: Pauzes bij goedkeuringspoorten voor menselijke bevestiging
  • Modus voor automatische goedkeuring (investigate_yolo): doorloopt alle poorten autonoom

Warning

Met de investigate_yolo opdracht worden alle goedkeuringspoorten automatisch goedgekeurd, inclusief acties die uw infrastructuur wijzigen (podverwijdering, Kubernetes YAML-toepassing, schalen, wijzigingen in incidentstatus). Er is geen beperking voor alleen-lezen. De agent kan elk hulpprogramma aanroepen dat de beheerde identiteit toestaat. Gebruik deze opdracht niet in productie tenzij u volledig autonome infrastructuurwijziging accepteert.

Wat kunt u doen

Gebruik de MCP-server van de SRE-agent voor de volgende scenario's:

  • Agents snel zoeken: Geef beschikbare SRE-agentresources per abonnement weer en bekijk van elke agent de naam, resourcegroep, locatie, provisioningstatus en het data-plane-eindpunt.

  • Onderzoek vanuit uw ontwikkelomgeving: Start een incidentonderzoek van Copilot CLI, Claude Code of een andere client die geschikt is voor MCP.

  • Doorgaan met onderzoeken: Verzend opvolgingsberichten naar een bestaande SRE-agentthread zonder uw MCP-client te verlaten.

  • Algemene instellingen automatiseren: Configureer agentvaardigheden, connectors, hooks, subagents, geplande taken, prompts en integraties van incidentrespons wanneer u schrijfmachtigingen hebt.

  • Gebruik bestaande Azure beveiligingsgrenzen: Houd bewerkingen beperkt door de Azure RBAC- en SRE-agentmachtigingen van de aanroeper.

Limitations

  • Maak de SRE-agentresource voordat Azure MCP-server deze kan detecteren of gebruiken.

  • Azure MCP Server verhoogt geen machtigingen. Zorg ervoor dat u over de vereiste machtigingen beschikt voor de aangevraagde bewerking.

  • Clientinstallatie verschilt tussen MCP-hosts. Valideer de configuratie-indeling voor uw client voordat u een installatiehandleiding voor het hele team publiceert.

SRE Agent MCP-server vergeleken met MCP-connectors

Deze twee opties gebruiken hetzelfde protocol, maar werken in tegenovergestelde richtingen:

Feature Direction Gebruiksituatie
SRE Agent MCP-server (dit artikel) Je IDE of CLI roept SRE Agent aan Agents beheren en gebruiken vanuit uw ontwikkelomgeving
MCP-connectors SRE-agent roept externe MCP-servers aan Breid uw agent uit met Datadog, GitHub, Splunk-hulpprogramma's

Veiligheidsrails

Beveiliging Description
Bevestiging van destructieve actie Verwijderingsbewerkingen vereisen --confirm true. Geen onbedoelde demontage.
Goedkeuringspoorten Schrijfbewerkingen vereisen menselijke goedkeuring in de standaardmodus. In de modus voor automatische goedkeuring (investigate_yolo) worden alle poorten omzeild.
Vertrouwelijke redactie Veelvoorkomende referentiepatronen, waaronder bearer-tokens, API-sleutels en wachtwoorden, worden verwijderd uit antwoorden voordat u uw client bereikt.
Fouten opschonen Foutberichten van upstream worden ontdaan van inloggegevens en ingekort.
Eindpunt vastmaken Aanroepen van gegevensvlakken zijn beperkt tot toegestane Azure SRE-domeinen (alleen HTTPS).
Validatie van host van derden ServiceNow beperkt tot .service-now.com; PagerDuty-subdomeinen gevalideerd.
Geheimen van MCP-connectors Omgevingswaarden moeten de syntaxis ${env:NAME} gebruiken. Letterlijke geheimen worden geweigerd.