ICM MCP

Med ICM MCP kan Microsofts interna MCS-agenter interagera med ICM-biljetter. Den har stöd för MCP-standardverktyg/-listor och verktyg/anrop och verktyg som sträcker sig från incidentinformation till redigering och överföring

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Service	Class	Regioner
Copilot Studio	Standard	Alla Power Automate-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD)
Power Apps	Standard	Alla Power Apps-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD)
Power Automate	Standard	Alla Power Automate-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD)

Kontakt
Namn	Agent365 Microsoft.com
URL	Microsoft Power Automate-support Microsoft Power Apps Support
E-postmeddelande	robsanto@microsoft.com

Metadata för anslutningsprogram
Publisher	Microsoft
Webbplats	https://eng.ms/docs/products/icm/onboarding/introduction
Sekretesspolicy	https://privacy.microsoft.com/en-US/privacystatement
Kategorier	Artificiell intelligens; Produktivitet

ICM MCP Tools Connector

Översikt

ICM MCP Tools-anslutningsappen ger åtkomst till Microsofts ICM-system (Incident Management) via MCP-gränssnittet (Model Context Protocol). Med den här anslutningsappen kan Power Automate och Power Apps interagera med ICM för incidenthantering med hjälp av AI-baserade verktyg och omfattande funktioner för incidentanalys.

Den här anslutningsappen ger direkt åtkomst till MCP-servern, så att du kan utnyttja en växande uppsättning kraftfulla verktyg för incidenthantering.

Förutsättningar

Giltiga autentiseringsuppgifter för Microsoft-företag
Åtkomst till ICM-systemet
Lämpliga behörigheter för de åtgärder som du vill utföra

Authentication

Anslutningsappen använder OAuth 2.0-autentisering med Azure Active Directory. När du skapar en anslutning uppmanas du att logga in med dina Microsoft-företagsautentiseringsuppgifter.

Tillgängliga åtgärder

Anropa MCP-server

Anslutningsappen ger en enda kraftfull åtgärd som ger dig åtkomst till alla MCP-verktyg:

Anropa MCP Server: Direktåtkomst till MCP-servern med stöd för tools/list och tools/call metoder

Tillgängliga MCP-verktyg

Anslutningsappen stöder för närvarande följande verktyg (den här listan fortsätter att växa):

Incidentanalys

get_incident_details_by_id – Hämta detaljerad information om en specifik incident
get_incident_context – Hämta sammanhangsbaserad information och relaterade data för en incident
get_incident_location – Hämta platsinformation för en incident
get_incident_customer_impact – Analysera kundpåverkan av en incident
get_similar_incidents – Hitta liknande incidenter för mönsteranalys
get_ai_summary – Få EN AI-genererad sammanfattning av incidentinformation
get_mitigation_hints – Hämta föreslagna åtgärdsstrategier

Analys av kundpåverkan

get_impacted_s500_customers – Hämta en lista över berörda S500-kunder
get_impacted_ace_customers – Hämta en lista över påverkade ACE-kunder
get_impacted_azure_priority0_customers – Hämta en lista över berörda Azure Priority 0-kunder
get_impacted_subscription_count – Få antal påverkade prenumerationer
is_specific_customer_impacted – Kontrollera om en specifik kund påverkas

Tjänst och infrastruktur

get_impacted_services_regions_clouds – Få information om påverkade tjänster, regioner och moln
get_services_by_names – Hämta tjänstinformation efter namn
get_outage_high_priority_events – Få högprioriterade avbrottshändelser

Team- och kontakthantering

get_teams_by_public_id – Hitta team efter deras offentliga ID
get_teams_by_name – Hitta team efter namn
get_team_by_id – Hämta teaminformation efter ID
get_contact_by_alias – Hämta kontaktinformation per alias
get_contact_by_id – Hämta kontaktuppgifter via ID
get_on_call_schedule_by_team_id – Hämta jourschema för ett team

Sök och frågor

search_incidents_by_owning_team_id – Söka efter incidenter efter ägande team
get_support_requests_crisit – Få kritiska supportbegäranden

Så här använder du anslutningsappen

1. Lista tillgängliga verktyg

Om du vill se alla tillgängliga verktyg använder du tools/list metoden:

Begäran:

{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "params": {},
  "id": 1
}

Svar:

{
  "jsonrpc": "2.0",
  "result": {
    "tools": [
      {
        "name": "get_incident_details_by_id",
        "description": "Get detailed information about an incident by its ID",
        "inputSchema": {
          "type": "object",
          "properties": {
            "incident_id": {
              "type": "string",
              "description": "The unique identifier of the incident"
            }
          },
          "required": ["incident_id"]
        }
      },
      {
        "name": "get_incident_context",
        "description": "Get contextual information for an incident",
        "inputSchema": {
          "type": "object",
          "properties": {
            "incident_id": {
              "type": "string",
              "description": "The unique identifier of the incident"
            }
          },
          "required": ["incident_id"]
        }
      }
    ]
  },
  "id": 1
}

2. Anropa specifika verktyg

Om du vill anropa ett specifikt verktyg använder du tools/call metoden:

Exempel: Hämta incidentinformation

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_incident_details_by_id",
    "arguments": {
      "incident_id": "12345678"
    }
  },
  "id": 1
}

Svar:

{
  "jsonrpc": "2.0",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"id\": \"12345678\", \"title\": \"Service degradation in West US\", \"severity\": \"Sev2\", \"status\": \"Active\", \"createDate\": \"2024-01-15T10:30:00Z\", \"description\": \"Users experiencing slow response times\", \"owningTeam\": \"ServiceTeam\", \"impactedServices\": [\"WebApp\", \"API\"]}"
      }
    ]
  },
  "id": 1
}

Exempel: Hämta kundpåverkansanalys

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_impacted_s500_customers",
    "arguments": {
      "incident_id": "12345678"
    }
  },
  "id": 1
}

Exempel: Sök efter incidenter efter team

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_incidents_by_owning_team_id",
    "arguments": {
      "team_id": "team-123",
      "status": "Active",
      "max_results": 50
    }
  },
  "id": 1
}

Exempel: Hämta AI-sammanfattning

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_ai_summary",
    "arguments": {
      "incident_id": "12345678",
      "include_mitigation": true
    }
  },
  "id": 1
}

Power Automate-användning

Konfigurera åtgärden

Lägg till åtgärden "Anropa MCP Server" i flödet
Ange metodfältet till antingen:
- tools/list – identifiera tillgängliga verktyg
- tools/call – för att köra ett specifikt verktyg
Konfigurera params-objektet baserat på den valda metoden

Exempelflöde: Automatiserad incidentanalys

1. Trigger: When an incident is created
2. Action: Invoke MCP Server
   - method: "tools/call"
   - params: {
       "name": "get_incident_details_by_id",
       "arguments": {"incident_id": "@{triggerBody()['incident_id']}"}
     }
3. Action: Invoke MCP Server  
   - method: "tools/call"
   - params: {
       "name": "get_ai_summary", 
       "arguments": {"incident_id": "@{triggerBody()['incident_id']}"}
     }
4. Action: Send notification with incident details and AI summary

Exempelflöde: Kundkonsekvensbedömning

1. Trigger: Manual trigger with incident ID
2. Action: Invoke MCP Server (Get S500 Customers)
   - method: "tools/call"
   - params: {
       "name": "get_impacted_s500_customers",
       "arguments": {"incident_id": "@{triggerBody()['incident_id']}"}
     }
3. Action: Invoke MCP Server (Get ACE Customers)
   - method: "tools/call" 
   - params: {
       "name": "get_impacted_ace_customers",
       "arguments": {"incident_id": "@{triggerBody()['incident_id']}"}
     }
4. Action: Create comprehensive impact report

Vanliga Användningsfall

1. Omfattande incidentanalys

Kombinera flera verktyg för att få en fullständig bild:

get_incident_details_by_id – Grundläggande incidentinformation
get_incident_context – Relaterad kontext och data
get_ai_summary – AI-baserad analys
get_similar_incidents - Historiska mönster
get_mitigation_hints – Föreslagna åtgärder

2. Kundkonsekvensbedömning

Utvärdera hela omfattningen av kundpåverkan:

get_impacted_s500_customers – Företagskunder
get_impacted_ace_customers - ACE-kunder
get_impacted_azure_priority0_customers – Prioritet 0 kunder
get_impacted_subscription_count – Total prenumerationspåverkan

3. Teamsamordning

Samordna svarsinsatser mellan team:

get_teams_by_name – Hitta relevanta team
get_on_call_schedule_by_team_id - Kontrollera vem som är i jour
get_contact_by_alias – Hämta kontaktinformation
search_incidents_by_owning_team_id – Kontrollera teamets arbetsbelastning

4. Hälsoövervakning av tjänster

Övervaka och analysera tjänstens hälsa:

get_impacted_services_regions_clouds – Påverkad infrastruktur
get_outage_high_priority_events – Kritiska händelser
get_services_by_names – Tjänstinformation

Teknisk information

Flöde för begäran/svar

Power Automate skickar JSON-RPC formaterad begäran till anslutningsappen
Anslutningsappen vidarebefordrar begäran till MCP-servern med rätt autentisering
MCP-servern bearbetar begäran och returnerar JSON-RPC svar
Anslutningsappen hanterar Server-Sent händelser (SSE) om det finns och konverteras till JSON
Svaret returneras till Power Automate i JSON-standardformat

Felhantering

Anslutningsappen hanterar olika felscenarier:

Ogiltiga verktygsnamn
Nödvändiga argument saknas
Autentiseringsfel
Servern är otillgänglig

Hastighetsgränser

Anslutningsappen implementerar hastighetsbegränsning på 100 anrop per 60 sekunder per anslutning för att säkerställa en rättvis användning av ICM-systemet.

Avancerad användning

Identifiering av dynamiskt verktyg

Använd tools/list i början av dina flöden för att dynamiskt identifiera tillgängliga verktyg och deras scheman. Detta säkerställer att dina flöden fungerar även när nya verktyg läggs till.

Komplexa arbetsflöden

Länka flera verktygsanrop tillsammans för att skapa avancerade arbetsflöden för incidenthantering som utnyttjar den fulla kraften i MCP-ekosystemet.

Testar

Snabbtest: Listverktyg

Skapa ett nytt flöde med åtgärden "Anropa MCP Server"
Ange metod till tools/list
Lämna params tom: {}
Kör flödet för att se alla tillgängliga verktyg

Test: Hämta incidentinformation

Använd metod tools/call

Ange params till:

{
  "name": "get_incident_details_by_id",
  "arguments": {
    "incident_id": "your-test-incident-id"
  }
}

Kontrollera att svaret innehåller incidentinformation

Växande verktygsuppsättning

MCP-verktygets ekosystem expanderar kontinuerligt. Nya verktyg läggs regelbundet till för att förbättra incidenthanteringsfunktionerna. Använd metoden tools/list för att hålla dig uppdaterad om nyligen tillgängliga verktyg och deras funktioner.

Support

För anslutningsproblem: Kontakta Power Platform-teamet
För ICM-specifika frågor: Kontakta icmsupport@microsoft.com
Allmänt stöd för Power Platform: Besök Microsoft Power Platform Community

Begränsningsgränser

Name	Anrop	Förnyelseperiod
API-anrop per anslutning	100	60 sekunder

Åtgärder

Ange all detaljerad kontextinformation	Ange all detaljerad kontextinformation, alla ursprungliga metadata för incidenten och avbrott
Ange övergripande påverkan för den angivna incidenten	Ange övergripande påverkan för den angivna incidenten eller driftstoppet.
Få berörda S500-kunder	Få berörda S500-kunder för en viss incident eller ett avbrott.
Få påverkad "Azure Priority 0" eller "Life and Safety"-kunder	Få påverkad "Azure Priority 0" eller "Life and Safety"-kunder för en viss incident eller ett avbrott.
Få påverkade händelser med hög prioritet	Få påverkade högprioriterade händelser för en viss incident eller ett avbrott.
Få sammanfattning av incidenter och avbrott	Hämta incident- och/eller avbrottssammanfattning och endast för sammanfattning.
Få supportförfrågningar och supportärenden (SR) och SevA (CritSit)	Få supportbegäranden/supportärenden (SR) och SevA (CritSit) länkade till en viss incident/ett avbrott.
Få tips om åtgärder för ett visst incident-ID	Få tips om åtgärder för ett visst incident-ID.
Hämta antal påverkade prenumerationer	Få antal påverkade prenumerationer för en viss incident eller ett avbrott.
Hämta berörda tjänster, regioner och moln	Få berörda tjänster, regioner och moln för en viss incident eller ett avbrott.
Hämta en lista över liknande incidenter	Hämta en lista över liknande incidenter för ett visst incident-ID.
Hämta incidentinformation efter ID	Hämta incidentinformation efter ID.
Hämta jourschemat för ett team	Hämta jourschemat för ett team efter team-ID.
Hämta kontaktuppgifter via kontakt-ID	Få kontaktuppgifter via kontakt-ID.
Hämta kontaktuppgifter via kontaktalias	Hämta kontaktuppgifter via kontaktalias.
Hämta platsinformation om incidenten	Hämta platsinformation om incidenten och/eller avbrott, inklusive region, tillgänglighetszon, datacenter, kluster, nod och regionarmalias.
Hämta påverkade ACE-kunder	Få påverkade ACE-kunder för en viss incident eller ett avbrott.
Hämta teaminformation efter offentligt team-ID	Hämta teaminformation efter team offentligt ID. Offentligt ID ser ut som TenantName\TeamName
Hämta teaminformation efter team-ID	Hämta teaminformation efter team-ID.
Hämta teaminformation efter teamnamn	Hämta teaminformation efter teamnamn.
Hämta tjänstinformationen efter lista med namn	Hämta tjänstinformationen efter lista med namn.
ICM MCP	Direkt anrop av ICM MCP-serveråtgärder
Kontrollera om en specifik kund påverkas	Kontrollera om en specifik kund finns med i listan över berörda kunder på grund av incident-/avbrotts-ID. Obs! Även om resultatet är falskt betyder det inte att kunden inte påverkas. Be användaren att kontrollera andra effektmått som supportbegäranden, Sev A (CritSit) osv.
Sök efter incidenter genom att äga teamets ID	Det här verktyget Söker efter incidenter genom att äga teamets ID.

Ange all detaljerad kontextinformation

Åtgärds-ID:: GetIncidentContext

Ange all detaljerad kontextinformation, alla ursprungliga metadata för incidenten och avbrott

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
incidentId	incidentId	True	string	Incident-ID

Ange övergripande påverkan för den angivna incidenten

Åtgärds-ID:: GetIncidentCustomerImpact

Ange övergripande påverkan för den angivna incidenten eller driftstoppet.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
incidentId	incidentId	True	string	Incident-ID

Få berörda S500-kunder

Åtgärds-ID:: GetImpactedS500Customers

Få berörda S500-kunder för en viss incident eller ett avbrott.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
incidentId	incidentId	True	string	Incident-ID

Få påverkad "Azure Priority 0" eller "Life and Safety"-kunder

Åtgärds-ID:: GetImpactedAzurePriority0Customers

Få påverkad "Azure Priority 0" eller "Life and Safety"-kunder för en viss incident eller ett avbrott.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
incidentId	incidentId	True	string	Incident-ID

Få påverkade händelser med hög prioritet

Åtgärds-ID:: GetOutageHighPriorityEvents

Få påverkade högprioriterade händelser för en viss incident eller ett avbrott.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
incidentId	incidentId	True	string	Incident-ID

Få sammanfattning av incidenter och avbrott

Åtgärds-ID:: GetAiSummary

Hämta incident- och/eller avbrottssammanfattning och endast för sammanfattning.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
incidentId	incidentId	True	string	Incident-ID

Få supportförfrågningar och supportärenden (SR) och SevA (CritSit)

Åtgärds-ID:: GetSupportRequestsCrisit

Få supportbegäranden/supportärenden (SR) och SevA (CritSit) länkade till en viss incident/ett avbrott.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
incidentId	incidentId	True	string	Incident-ID

Få tips om åtgärder för ett visst incident-ID

Åtgärds-ID:: GetMitigationHints

Få tips om åtgärder för ett visst incident-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
incidentId	incidentId	True	string	Incident-ID

Hämta antal påverkade prenumerationer

Åtgärds-ID:: GetImpactedSubscriptionCount

Få antal påverkade prenumerationer för en viss incident eller ett avbrott.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
incidentId	incidentId	True	string	Incident-ID

Hämta berörda tjänster, regioner och moln

Åtgärds-ID:: GetImpactedServicesRegionsClouds

Få berörda tjänster, regioner och moln för en viss incident eller ett avbrott.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
incidentId	incidentId	True	string	Incident-ID

Hämta en lista över liknande incidenter

Åtgärds-ID:: GetSimilarIncidents

Hämta en lista över liknande incidenter för ett visst incident-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
incidentId	incidentId	True	string	Incident-ID

Hämta incidentinformation efter ID

Åtgärds-ID:: GetIncidentDetailsById

Hämta incidentinformation efter ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
incidentId	incidentId	True	string	Incident-ID

Hämta jourschemat för ett team

Åtgärds-ID:: GetOnCallScheduleByTeamId

Hämta jourschemat för ett team efter team-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
teamIds	teamIds	True	string	Team-ID:t

Hämta kontaktuppgifter via kontakt-ID

Åtgärds-ID:: GetContactById

Få kontaktuppgifter via kontakt-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
contactId	contactId	True	string	Kontakt-ID:t

Hämta kontaktuppgifter via kontaktalias

Åtgärds-ID:: GetContactByAlias

Hämta kontaktuppgifter via kontaktalias.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
alias	alias	True	string	Kontaktaliaset

Hämta platsinformation om incidenten

Åtgärds-ID:: GetIncidentLocation

Hämta platsinformation om incidenten och/eller avbrott, inklusive region, tillgänglighetszon, datacenter, kluster, nod och regionarmalias.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
incidentId	incidentId	True	string	Incident-ID

Hämta påverkade ACE-kunder

Åtgärds-ID:: GetImpactedAceCustomers

Få påverkade ACE-kunder för en viss incident eller ett avbrott.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
incidentId	incidentId	True	string	Incident-ID

Hämta teaminformation efter offentligt team-ID

Åtgärds-ID:: GetTeamsByPublicId

Hämta teaminformation efter team offentligt ID. Offentligt ID ser ut som TenantName\TeamName

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
publicId	publicId	True	string	Teamets offentliga ID

Hämta teaminformation efter team-ID

Åtgärds-ID:: GetTeamById

Hämta teaminformation efter team-ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
teamId	teamId	True	string	Team-ID:t

Hämta teaminformation efter teamnamn

Åtgärds-ID:: GetTeamsByName

Hämta teaminformation efter teamnamn.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
teamName	teamName	True	string	Teamets namn

Hämta tjänstinformationen efter lista med namn

Åtgärds-ID:: GetServicesByNames

Hämta tjänstinformationen efter lista med namn.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
names	names	True	string	Tjänstnamnen

ICM MCP

Åtgärds-ID:: InvokeServer

Direkt anrop av ICM MCP-serveråtgärder

Kontrollera om en specifik kund påverkas

Åtgärds-ID:: IsSpecificCustomerImpacted

Kontrollera om en specifik kund finns med i listan över berörda kunder på grund av incident-/avbrotts-ID. Obs! Även om resultatet är falskt betyder det inte att kunden inte påverkas. Be användaren att kontrollera andra effektmått som supportbegäranden, Sev A (CritSit) osv.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
incidentId	incidentId	True	string	Incident-ID
kundnamn	customerName	True	string	Kundens namn

Sök efter incidenter genom att äga teamets ID

Åtgärds-ID:: SearchIncidentsByOwningTeamId

Det här verktyget Söker efter incidenter genom att äga teamets ID.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
teamId	teamId	True	string	Team-ID:t

Dela via

ICM MCP

ICM MCP Tools Connector

Översikt

Förutsättningar

Authentication

Tillgängliga åtgärder

Anropa MCP-server

Tillgängliga MCP-verktyg

Incidentanalys

Analys av kundpåverkan

Tjänst och infrastruktur

Team- och kontakthantering

Sök och frågor

Så här använder du anslutningsappen

1. Lista tillgängliga verktyg

2. Anropa specifika verktyg

Power Automate-användning

Konfigurera åtgärden

Exempelflöde: Automatiserad incidentanalys

Exempelflöde: Kundkonsekvensbedömning

Vanliga Användningsfall

1. Omfattande incidentanalys

2. Kundkonsekvensbedömning

3. Teamsamordning

4. Hälsoövervakning av tjänster

Teknisk information

Flöde för begäran/svar

Felhantering

Hastighetsgränser

Avancerad användning

Identifiering av dynamiskt verktyg

Komplexa arbetsflöden

Testar

Snabbtest: Listverktyg

Test: Hämta incidentinformation

Växande verktygsuppsättning

Support

Begränsningsgränser

Åtgärder

Ange all detaljerad kontextinformation

Parametrar

Ange övergripande påverkan för den angivna incidenten

Parametrar

Få berörda S500-kunder

Parametrar

Få påverkad "Azure Priority 0" eller "Life and Safety"-kunder

Parametrar

Få påverkade händelser med hög prioritet

Parametrar

Få sammanfattning av incidenter och avbrott

Parametrar

Få supportförfrågningar och supportärenden (SR) och SevA (CritSit)

Parametrar

Få tips om åtgärder för ett visst incident-ID

Parametrar

Hämta antal påverkade prenumerationer

Parametrar

Hämta berörda tjänster, regioner och moln

Parametrar

Hämta en lista över liknande incidenter

Parametrar

Hämta incidentinformation efter ID

Parametrar

Hämta jourschemat för ett team

Parametrar

Hämta kontaktuppgifter via kontakt-ID

Parametrar

Hämta kontaktuppgifter via kontaktalias

Parametrar

Hämta platsinformation om incidenten

Parametrar

Hämta påverkade ACE-kunder

Parametrar

Hämta teaminformation efter offentligt team-ID

Parametrar

Hämta teaminformation efter team-ID

Parametrar

Hämta teaminformation efter teamnamn

Parametrar