ICM MCP

ICM MCP consente agli agenti MCS interni Microsoft di interagire con i ticket ICM. Supporta strumenti,elenchi e strumenti/chiamate e strumenti MCP standard, che vanno dai dettagli degli eventi imprevisti alla modifica e al trasferimento

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Service	Classe	Regioni
Copilot Studio	Standard	Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Standard	Tutte le aree di Power Apps , ad eccezione dei seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Standard	Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Nome	Agent365 Microsoft.com
URL	Supporto di Microsoft Power Automate Supporto di Microsoft Power Apps
Email	robsanto@microsoft.com

Metadati del connettore
Server di pubblicazione	Microsoft
Sito web	https://eng.ms/docs/products/icm/onboarding/introduction
Informativa sulla privacy	https://privacy.microsoft.com/en-US/privacystatement
Categorie	IA; Produttività

Connettore degli strumenti MCP ICM

Informazioni generali

Il connettore ICM MCP Tools consente di accedere al sistema ICM (Incident Management) di Microsoft tramite l'interfaccia MCP (Model Context Protocol). Questo connettore consente a Power Automate e Power Apps di interagire con ICM per la gestione degli eventi imprevisti usando strumenti basati sull'intelligenza artificiale e funzionalità complete di analisi degli eventi imprevisti.

Questo connettore consente l'accesso diretto al server MCP, consentendo di sfruttare un set crescente di potenti strumenti di gestione degli eventi imprevisti.

Prerequisiti

Credenziali aziendali Microsoft valide
Accesso al sistema ICM
Autorizzazioni appropriate per le operazioni da eseguire

Autenticazione

Il connettore usa l'autenticazione OAuth 2.0 con Azure Active Directory. Quando si crea una connessione, verrà richiesto di accedere con le credenziali aziendali di Microsoft.

Operazioni disponibili

Richiamare il server MCP

Il connettore offre una singola operazione potente che consente di accedere a tutti gli strumenti MCP:

Richiamare il server MCP: accesso diretto al server MCP con supporto per tools/list i metodi e tools/call

Strumenti MCP disponibili

Il connettore supporta attualmente gli strumenti seguenti (questo elenco continuerà a crescere):

Analisi degli eventi imprevisti

get_incident_details_by_id - Recuperare informazioni dettagliate su un evento imprevisto specifico
get_incident_context - Ottenere informazioni contestuali e dati correlati per un evento imprevisto
get_incident_location - Ottenere informazioni sulla posizione per un evento imprevisto
get_incident_customer_impact - Analizzare l'impatto dei clienti di un evento imprevisto
get_similar_incidents - Trovare eventi imprevisti simili per l'analisi dei modelli
get_ai_summary - Ottenere un riepilogo generato dall'intelligenza artificiale delle informazioni sugli eventi imprevisti
get_mitigation_hints - Ottenere strategie di mitigazione suggerite

Analisi dell'impatto dei clienti

get_impacted_s500_customers - Ottenere l'elenco dei clienti S500 interessati
get_impacted_ace_customers - Ottenere l'elenco dei clienti ACE interessati
get_impacted_azure_priority0_customers - Ottenere l'elenco dei clienti interessati con priorità 0 di Azure
get_impacted_subscription_count - Ottenere il numero di sottoscrizioni interessate
is_specific_customer_impacted - Controllare se un cliente specifico è interessato

Servizio e infrastruttura

get_impacted_services_regions_clouds - Ottenere informazioni su servizi, aree e cloud interessati
get_services_by_names - Recuperare le informazioni sul servizio in base ai nomi
get_outage_high_priority_events - Ottenere eventi di interruzione con priorità elevata

Gestione dei team e dei contatti

get_teams_by_public_id - Trovare i team in base all'ID pubblico
get_teams_by_name - Trovare i team in base al nome
get_team_by_id - Ottenere informazioni sul team in base all'ID
get_contact_by_alias - Ottenere le informazioni di contatto per alias
get_contact_by_id - Ottenere le informazioni di contatto in base all'ID
get_on_call_schedule_by_team_id - Ottenere la pianificazione delle chiamate per un team

Ricerca e query

search_incidents_by_owning_team_id - Cercare eventi imprevisti di proprietà del team
get_support_requests_crisit - Ottenere richieste di supporto critiche

Come usare il connettore

1. Elencare gli strumenti disponibili

Per visualizzare tutti gli strumenti disponibili, usare il tools/list metodo :

Richiesta:

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

Risposta:

{
  "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. Chiamare strumenti specifici

Per chiamare uno strumento specifico, usare il tools/call metodo :

Esempio: Ottenere i dettagli degli eventi imprevisti

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

Risposta:

{
  "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
}

Esempio: Ottenere l'analisi dell'impatto dei clienti

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

Esempio: Ricerca di eventi imprevisti per 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
}

Esempio: Ottenere il riepilogo dell'intelligenza artificiale

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

Utilizzo di Power Automate

Configurazione dell'azione

Aggiungere l'azione "Invoke MCP Server" al flusso
Impostare il campo del metodo su:
- tools/list - per individuare gli strumenti disponibili
- tools/call - per eseguire uno strumento specifico
Configurare l'oggetto params in base al metodo scelto

Flusso di esempio: analisi automatizzata degli eventi imprevisti

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

Flusso di esempio: Valutazione dell'impatto del cliente

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

Casi d'uso comuni

1. Analisi completa degli eventi imprevisti

Combinare più strumenti per ottenere un quadro completo:

get_incident_details_by_id - Informazioni di base sugli eventi imprevisti
get_incident_context - Contesto e dati correlati
get_ai_summary - Analisi basata sull'intelligenza artificiale
get_similar_incidents - Modelli cronologici
get_mitigation_hints - Azioni suggerite

2. Valutazione dell'impatto del cliente

Valutare l'ambito completo dell'impatto dei clienti:

get_impacted_s500_customers - Clienti aziendali
get_impacted_ace_customers - Clienti ACE
get_impacted_azure_priority0_customers - Clienti con priorità 0
get_impacted_subscription_count - Impatto totale della sottoscrizione

3. Coordinamento del team

Coordinare le attività di risposta tra i team:

get_teams_by_name - Trovare i team pertinenti
get_on_call_schedule_by_team_id - Controllare chi è in chiamata
get_contact_by_alias - Ottenere le informazioni di contatto
search_incidents_by_owning_team_id - Controllare il carico di lavoro del team

4. Monitoraggio dell'integrità dei servizi

Monitorare e analizzare l'integrità dei servizi:

get_impacted_services_regions_clouds - Infrastruttura interessata
get_outage_high_priority_events - Eventi critici
get_services_by_names - Dettagli del servizio

Dettagli tecnici

Flusso di richiesta/risposta

Power Automate invia JSON-RPC richiesta formattata al connettore
Il connettore inoltra la richiesta al server MCP con l'autenticazione appropriata
Il server MCP elabora la richiesta e restituisce JSON-RPC risposta
Il connettore gestisce gli eventi Server-Sent (SSE) se presenti e converte in JSON
La risposta viene restituita a Power Automate in formato JSON standard

Gestione degli errori

Il connettore gestisce diversi scenari di errore:

Nomi degli strumenti non validi
Argomenti obbligatori mancanti
Errori di autenticazione
Mancata disponibilità del server

Limiti di frequenza

Il connettore implementa una limitazione della velocità di 100 chiamate al periodo di 60 secondi per ogni connessione per garantire un uso equo del sistema ICM.

Utilizzo avanzato

Individuazione dinamica degli strumenti

Usare tools/list all'inizio dei flussi per individuare in modo dinamico gli strumenti disponibili e i relativi schemi. In questo modo i flussi funzionano anche quando vengono aggiunti nuovi strumenti.

Flussi di lavoro complessi

Concatenare più chiamate di strumenti per creare flussi di lavoro sofisticati di gestione degli eventi imprevisti che sfruttano tutta la potenza dell'ecosistema MCP.

Esecuzione del test

Test rapido: Elencare gli strumenti

Creare un nuovo flusso con l'azione "Richiama server MCP"
Impostare il metodo su tools/list
Lasciare vuoti i parametri: {}
Eseguire il flusso per visualizzare tutti gli strumenti disponibili

Test: Ottenere i dettagli degli eventi imprevisti

Metodo Use tools/call

Impostare i parametri su:

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

Verificare che la risposta contenga informazioni sugli eventi imprevisti

Set di strumenti in crescita

L'ecosistema di strumenti MCP è in continua espansione. Vengono aggiunti regolarmente nuovi strumenti per migliorare le funzionalità di gestione degli eventi imprevisti. Usare il tools/list metodo per rimanere aggiornati sui nuovi strumenti disponibili e sulle relative funzionalità.

Support

Per i problemi del connettore: contattare il team di Power Platform
Per domande specifiche di ICM: Contatto icmsupport@microsoft.com
Per il supporto generale di Power Platform: visitare la community di Microsoft Power Platform

Limiti per la limitazione delle richieste

Nome	Chiamate	Periodo di rinnovo
Chiamate API per connessione	100	60 secondi

Azioni

Cercare gli eventi imprevisti proprietario dell'ID del team

ID operazione:: SearchIncidentsByOwningTeamId

Questo strumento cerca gli eventi imprevisti proprietario dell'ID del team.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
teamId	teamId	True	string	The team ID

Controllare se un cliente specifico è interessato

ID operazione:: IsSpecificCustomerImpacted

Controllare se un cliente specifico è incluso nell'elenco dei clienti interessati dall'ID evento imprevisto/interruzione. Nota: anche se il risultato è false, non significa che il cliente non sia interessato. Chiedere all'utente di controllare altre metriche di impatto, ad esempio richieste di supporto, Sev A (CritSit) e così via.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
incidentId	incidentId	True	string	ID evento imprevisto
nome cliente	customerName	True	string	Nome del cliente

Fornire tutte le informazioni dettagliate sul contesto

ID operazione:: GetIncidentContext

Fornire tutte le informazioni di contesto dettagliate, tutti i metadati originali per l'evento imprevisto e l'interruzione

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
incidentId	incidentId	True	string	ID evento imprevisto

Fornire un impatto complessivo per l'evento imprevisto specificato

ID operazione:: GetIncidentCustomerImpact

Fornire un impatto complessivo per l'evento imprevisto o l'interruzione specificati.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
incidentId	incidentId	True	string	ID evento imprevisto

ICM MCP

ID operazione:: InvokeServer

Chiamata diretta delle operazioni del server ICM MCP

Ottenere clienti ACE interessati

ID operazione:: GetImpactedAceCustomers

Ottenere clienti ACE interessati per un evento imprevisto o un'interruzione del servizio.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
incidentId	incidentId	True	string	ID evento imprevisto

Ottenere clienti S500 interessati

ID operazione:: GetImpactedS500Customers

Ottenere clienti S500 interessati per un determinato evento imprevisto o interruzione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
incidentId	incidentId	True	string	ID evento imprevisto

Ottenere eventi ad alta priorità interessati

ID operazione:: GetOutageHighPriorityEvents

Ottenere eventi con priorità alta interessati per un determinato evento imprevisto o interruzione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
incidentId	incidentId	True	string	ID evento imprevisto

Ottenere hint di mitigazione per un id evento imprevisto specifico

ID operazione:: GetMitigationHints

Ottenere hint di mitigazione per un id evento imprevisto specificato.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
incidentId	incidentId	True	string	ID evento imprevisto

Ottenere i clienti "Priorità di Azure 0" o "Vita e sicurezza" interessati

ID operazione:: GetImpactedAzurePriority0Customers

Ottenere i clienti "Priorità di Azure 0" o "Vita e sicurezza" interessati per un determinato evento imprevisto o interruzione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
incidentId	incidentId	True	string	ID evento imprevisto

Ottenere i dettagli dei servizi in base all'elenco dei nomi

ID operazione:: GetServicesByNames

Ottenere i dettagli dei servizi in base all'elenco di nomi.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
names	names	True	string	Nomi dei servizi

Ottenere i dettagli del contatto in base all'ID contatto

ID operazione:: GetContactById

Ottenere i dettagli del contatto in base all'ID contatto.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
contactId	contactId	True	string	ID contatto

Ottenere i dettagli del contatto tramite l'alias di contatto

ID operazione:: GetContactByAlias

Ottenere i dettagli del contatto in base all'alias di contatto.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
alias	alias	True	string	Alias del contatto

Ottenere i dettagli del team in base al nome del team

ID operazione:: GetTeamsByName

Ottenere i dettagli del team in base al nome del team.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
teamName	teamName	True	string	Nome del team

Ottenere i dettagli del team in base all'ID pubblico del team

ID operazione:: GetTeamsByPublicId

Ottenere i dettagli del team in base all'ID pubblico del team. L'ID pubblico ha un aspetto simile a TenantName\TeamName

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
publicId	publicId	True	string	ID pubblico del team

Ottenere i dettagli del team in base all'ID team

ID operazione:: GetTeamById

Ottenere i dettagli del team in base all'ID del team.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
teamId	teamId	True	string	The team ID

Ottenere i dettagli dell'evento imprevisto in base all'ID

ID operazione:: GetIncidentDetailsById

Ottenere i dettagli dell'evento imprevisto in base all'ID.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
incidentId	incidentId	True	string	ID evento imprevisto

Ottenere il numero di sottoscrizioni interessate

ID operazione:: GetImpactedSubscriptionCount

Ottenere il numero di sottoscrizioni interessate per un determinato evento imprevisto o interruzione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
incidentId	incidentId	True	string	ID evento imprevisto

Ottenere informazioni sulla posizione dell'evento imprevisto

ID operazione:: GetIncidentLocation

Ottenere informazioni sulla posizione dell'evento imprevisto e/o dell'interruzione, tra cui area, zona di disponibilità, data center, cluster, nodo e alias arm dell'area.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
incidentId	incidentId	True	string	ID evento imprevisto

Ottenere la pianificazione on-call per un team

ID operazione:: GetOnCallScheduleByTeamId

Ottenere la pianificazione delle chiamate per un team in base all'ID team.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
teamIds	teamIds	True	string	ID del team

Ottenere richieste di supporto e ticket di supporto (SRS) e SevA (CritSit)

ID operazione:: GetSupportRequestsCrisit

Ottenere richieste di supporto/ticket di supporto (SRS) e SevA (CritSit) collegati a un determinato evento imprevisto/interruzione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
incidentId	incidentId	True	string	ID evento imprevisto

Ottenere servizi, aree e cloud interessati

ID operazione:: GetImpactedServicesRegionsClouds

Ottenere servizi, aree e cloud interessati per un determinato evento imprevisto o interruzione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
incidentId	incidentId	True	string	ID evento imprevisto

Ottenere un elenco di eventi imprevisti simili

ID operazione:: GetSimilarIncidents

Ottenere un elenco di eventi imprevisti simili per un ID evento imprevisto specificato.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
incidentId	incidentId	True	string	ID evento imprevisto

Ottenere un riepilogo degli eventi imprevisti e delle interruzioni

ID operazione:: GetAiSummary

Ottenere il riepilogo degli eventi imprevisti e/o delle interruzioni e solo per il riepilogo.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
incidentId	incidentId	True	string	ID evento imprevisto

Condividi tramite

ICM MCP

Connettore degli strumenti MCP ICM

Informazioni generali

Prerequisiti

Autenticazione

Operazioni disponibili

Richiamare il server MCP

Strumenti MCP disponibili

Analisi degli eventi imprevisti

Analisi dell'impatto dei clienti

Servizio e infrastruttura

Gestione dei team e dei contatti

Ricerca e query

Come usare il connettore

1. Elencare gli strumenti disponibili

2. Chiamare strumenti specifici

Utilizzo di Power Automate

Configurazione dell'azione

Flusso di esempio: analisi automatizzata degli eventi imprevisti

Flusso di esempio: Valutazione dell'impatto del cliente

Casi d'uso comuni

1. Analisi completa degli eventi imprevisti

2. Valutazione dell'impatto del cliente

3. Coordinamento del team

4. Monitoraggio dell'integrità dei servizi

Dettagli tecnici

Flusso di richiesta/risposta

Gestione degli errori

Limiti di frequenza

Utilizzo avanzato

Individuazione dinamica degli strumenti

Flussi di lavoro complessi

Esecuzione del test

Test rapido: Elencare gli strumenti

Test: Ottenere i dettagli degli eventi imprevisti

Set di strumenti in crescita

Support

Limiti per la limitazione delle richieste

Azioni

Cercare gli eventi imprevisti proprietario dell'ID del team

Parametri

Controllare se un cliente specifico è interessato

Parametri

Fornire tutte le informazioni dettagliate sul contesto

Parametri

Fornire un impatto complessivo per l'evento imprevisto specificato

Parametri

ICM MCP

Ottenere clienti ACE interessati

Parametri

Ottenere clienti S500 interessati

Parametri

Ottenere eventi ad alta priorità interessati

Parametri

Ottenere hint di mitigazione per un id evento imprevisto specifico

Parametri

Ottenere i clienti "Priorità di Azure 0" o "Vita e sicurezza" interessati

Parametri

Ottenere i dettagli dei servizi in base all'elenco dei nomi

Parametri

Ottenere i dettagli del contatto in base all'ID contatto

Parametri

Ottenere i dettagli del contatto tramite l'alias di contatto

Parametri

Ottenere i dettagli del team in base al nome del team

Parametri

Ottenere i dettagli del team in base all'ID pubblico del team

Parametri

Ottenere i dettagli del team in base all'ID team

Parametri

Ottenere i dettagli dell'evento imprevisto in base all'ID

Parametri

Ottenere il numero di sottoscrizioni interessate

Parametri

Ottenere informazioni sulla posizione dell'evento imprevisto

Parametri

Ottenere la pianificazione on-call per un team

Parametri

Ottenere richieste di supporto e ticket di supporto (SRS) e SevA (CritSit)