ICM MCP
ICM MCP permet aux agents MCS internes Microsoft d’interagir avec les tickets ICM. Il prend en charge les outils MCP standard, la liste et les outils/appels et outils allant des détails de l’incident à la modification et au transfert
Ce connecteur est disponible dans les produits et régions suivants :
| Service | Classe | Régions |
|---|---|---|
| Copilot Studio | Norme | Toutes les régions Power Automate à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Apps | Norme | Toutes les régions Power Apps à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Norme | Toutes les régions Power Automate à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Agent365 Microsoft.com |
| URL | support Microsoft Power Automate support Microsoft Power Apps |
| Courrier électronique | robsanto@microsoft.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
| Website | https://eng.ms/docs/products/icm/onboarding/introduction |
| Politique de confidentialité | https://privacy.microsoft.com/en-US/privacystatement |
| Catégories | IA; Productivité |
Connecteur d’outils MCP ICM
Aperçu
Le connecteur Outils MCP ICM permet d’accéder au système ICM (Gestion des incidents) de Microsoft via l’interface MCP (Model Context Protocol). Ce connecteur permet à Power Automate et Power Apps d’interagir avec ICM pour la gestion des incidents à l’aide d’outils basés sur l’IA et de fonctionnalités d’analyse complète des incidents.
Ce connecteur fournit un accès direct au serveur MCP, ce qui vous permet de tirer parti d’un ensemble croissant d’outils de gestion des incidents puissants.
Prerequisites
- Informations d’identification d’entreprise Microsoft valides
- Accès au système ICM
- Autorisations appropriées pour les opérations que vous souhaitez effectuer
Authentification
Le connecteur utilise l’authentification OAuth 2.0 avec Azure Active Directory. Lorsque vous créez une connexion, vous êtes invité à vous connecter avec vos informations d’identification d’entreprise Microsoft.
Opérations disponibles
Appeler le serveur MCP
Le connecteur fournit une opération unique et puissante qui vous donne accès à tous les outils MCP :
-
Appeler le serveur MCP : accès direct au serveur MCP avec prise en charge et
tools/listtools/callméthodes
Outils MCP disponibles
Le connecteur prend actuellement en charge les outils suivants (cette liste continuera de croître) :
Analyse des incidents
-
get_incident_details_by_id- Récupérer des informations détaillées sur un incident spécifique -
get_incident_context- Obtenir des informations contextuelles et des données associées pour un incident -
get_incident_location- Obtenir des informations d’emplacement pour un incident -
get_incident_customer_impact- Analyser l’impact du client sur un incident -
get_similar_incidents- Rechercher des incidents similaires pour l’analyse des modèles -
get_ai_summary- Obtenir un résumé généré par l’IA des informations sur les incidents -
get_mitigation_hints- Obtenir des stratégies d’atténuation suggérées
Analyse de l’impact du client
-
get_impacted_s500_customers- Obtenir la liste des clients S500 impactés -
get_impacted_ace_customers- Obtenir la liste des clients ACE impactés -
get_impacted_azure_priority0_customers- Obtenir la liste des clients Azure Priority 0 impactés -
get_impacted_subscription_count- Obtenir le nombre d’abonnements affectés -
is_specific_customer_impacted- Vérifier si un client spécifique est affecté
Service et infrastructure
-
get_impacted_services_regions_clouds- Obtenir des informations sur les services, régions et clouds impactés -
get_services_by_names- Récupérer des informations de service par noms -
get_outage_high_priority_events- Obtenir des événements de panne de haute priorité
Gestion des équipes et des contacts
-
get_teams_by_public_id- Rechercher des équipes par leur ID public -
get_teams_by_name- Rechercher des équipes par nom -
get_team_by_id- Obtenir des informations d’équipe par ID -
get_contact_by_alias- Obtenir des informations de contact par alias -
get_contact_by_id- Obtenir les informations de contact par ID -
get_on_call_schedule_by_team_id- Obtenir la planification des appels pour une équipe
Recherche et requêtes
-
search_incidents_by_owning_team_id- Rechercher des incidents en propriétaire de l’équipe -
get_support_requests_crisit- Obtenir des demandes de support critiques
Guide pratique pour utiliser le connecteur
1. Répertorier les outils disponibles
Pour afficher tous les outils disponibles, utilisez la tools/list méthode :
Demande :
{
"jsonrpc": "2.0",
"method": "tools/list",
"params": {},
"id": 1
}
Réponse :
{
"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. Appeler des outils spécifiques
Pour appeler un outil spécifique, utilisez la tools/call méthode :
Exemple : Obtenir les détails de l’incident
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "get_incident_details_by_id",
"arguments": {
"incident_id": "12345678"
}
},
"id": 1
}
Réponse :
{
"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
}
Exemple : Obtenir l’analyse de l’impact du client
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "get_impacted_s500_customers",
"arguments": {
"incident_id": "12345678"
}
},
"id": 1
}
Exemple : Rechercher des incidents par équipe
{
"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
}
Exemple : Obtenir un résumé de l’IA
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "get_ai_summary",
"arguments": {
"incident_id": "12345678",
"include_mitigation": true
}
},
"id": 1
}
Utilisation de Power Automate
Configuration de l’action
- Ajoutez l’action « Appeler le serveur MCP » à votre flux
- Définissez le champ de méthode sur :
-
tools/list- pour découvrir les outils disponibles -
tools/call- pour exécuter un outil spécifique
-
- Configurer l’objet params en fonction de la méthode choisie
Exemple de flux : Analyse automatisée des incidents
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
Exemple de flux : Évaluation de l’impact du client
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
Cas d’usage courants
1. Analyse complète des incidents
Combinez plusieurs outils pour obtenir une image complète :
-
get_incident_details_by_id- Informations de base sur les incidents -
get_incident_context- Contexte et données connexes -
get_ai_summary- Analyse basée sur l’IA -
get_similar_incidents- Modèles historiques -
get_mitigation_hints- Actions suggérées
2. Évaluation de l’impact du client
Évaluez l’étendue complète de l’impact du client :
-
get_impacted_s500_customers- Clients d’entreprise -
get_impacted_ace_customers- Clients ACE -
get_impacted_azure_priority0_customers- Priorité 0 clients -
get_impacted_subscription_count- Impact total de l’abonnement
3. Coordination de l’équipe
Coordonner les efforts de réponse entre les équipes :
-
get_teams_by_name- Rechercher des équipes pertinentes -
get_on_call_schedule_by_team_id- Vérifier qui est à l’appel -
get_contact_by_alias- Obtenir des informations de contact -
search_incidents_by_owning_team_id- Vérifier la charge de travail de l’équipe
4. Surveillance de l’intégrité du service
Surveillez et analysez l’intégrité du service :
-
get_impacted_services_regions_clouds- Infrastructure affectée -
get_outage_high_priority_events- Événements critiques -
get_services_by_names- Détails du service
Détails techniques
Flux de demande/réponse
- Power Automate envoie JSON-RPC demande mise en forme au connecteur
- Le connecteur transfère la demande au serveur MCP avec une authentification appropriée
- Le serveur MCP traite la requête et retourne JSON-RPC réponse
- Le connecteur gère les événements Server-Sent (SSE) s’ils sont présents et convertis en JSON
- La réponse est retournée à Power Automate au format JSON standard
Gestion des erreurs
Le connecteur gère différents scénarios d’erreur :
- Noms d’outils non valides
- Arguments obligatoires manquants
- Échecs d’authentification
- Indisponibilité du serveur
Limites de débit
Le connecteur implémente la limitation du débit de 100 appels par période de 60 secondes par connexion pour garantir une utilisation équitable du système ICM.
Utilisation avancée
Découverte d’outils dynamiques
Utilisez tools/list au début de vos flux pour découvrir dynamiquement les outils disponibles et leurs schémas. Cela garantit que vos flux fonctionnent même lorsque de nouveaux outils sont ajoutés.
Flux de travail complexes
Chaînez plusieurs appels d’outils pour créer des workflows de gestion des incidents sophistiqués qui tirent parti de la puissance totale de l’écosystème MCP.
Essai
Test rapide : Outils de liste
- Créer un flux avec l’action « Appeler le serveur MCP »
- Définir la méthode sur
tools/list - Laissez les paramètres vides :
{} - Exécuter le flux pour afficher tous les outils disponibles
Test : Obtenir les détails de l’incident
- Utiliser la méthode
tools/call - Définissez les paramètres sur :
{ "name": "get_incident_details_by_id", "arguments": { "incident_id": "your-test-incident-id" } } - Vérifier que la réponse contient des informations sur l’incident
Ensemble d’outils de croissance
L’écosystème des outils MCP est en constante expansion. De nouveaux outils sont régulièrement ajoutés pour améliorer les fonctionnalités de gestion des incidents. Utilisez la tools/list méthode pour rester à jour sur les nouveaux outils disponibles et leurs fonctionnalités.
Support
- Pour les problèmes liés au connecteur : Contactez l’équipe Power Platform
- Pour les questions spécifiques à ICM : Contacter icmsupport@microsoft.com
- Pour obtenir une prise en charge générale de Power Platform : visitez la communauté Microsoft Power Platform
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Fournir toutes les informations de contexte détaillées |
Fournissez toutes les informations de contexte détaillées, toutes les métadonnées d’origine pour l’incident et la panne |
| Fournir un impact global pour l’incident spécifié |
Fournir un impact global sur l’incident ou la panne spécifiés. |
| ICM MCP |
Appel direct des opérations de serveur MCP ICM |
|
Obtenir des demandes de support et des tickets de support (SRs) et SevA (Crit |
Obtenez des demandes de support/tickets de support (SRs) et SevA (CritSit) liés à un incident/panne donné. |
| Obtenir des indicateurs d’atténuation pour un ID d’incident donné |
Obtenez des indicateurs d’atténuation pour un ID d’incident donné. |
| Obtenir des informations sur l’emplacement de l’incident |
Obtenez des informations d’emplacement sur l’incident et/ou la panne, notamment la région, la zone de disponibilité, le centre de données, le cluster, le nœud et l’alias arm de région. |
| Obtenir la liste des incidents similaires |
Obtenez la liste des incidents similaires pour un ID d’incident donné. |
| Obtenir la planification des appels pour une équipe |
Obtenez la planification des appels pour une équipe par ID d’équipe. |
| Obtenir le nombre d’abonnements affectés |
Obtenez le nombre d’abonnements affectés pour un incident ou une panne donné. |
| Obtenir le résumé des incidents et des pannes |
Obtenez un résumé des incidents et/ou des pannes et uniquement pour le résumé. |
| Obtenir les clients ACE affectés |
Obtenez les clients ACE affectés pour un incident ou une panne donnés. |
| Obtenir les clients S500 impactés |
Obtenez les clients S500 affectés pour un incident ou une panne donnés. |
| Obtenir les clients « Azure Priority 0 » ou « Vie et sécurité » affectés |
Obtenez les clients « Azure Priority 0 » ou « Life and Safety » pour un incident ou une panne donné. |
| Obtenir les coordonnées par alias de contact |
Obtenez les coordonnées par alias de contact. |
| Obtenir les coordonnées par ID de contact |
Obtenez les coordonnées par ID de contact. |
| Obtenir les détails de l’incident par ID |
Obtenez les détails de l’incident par ID. |
| Obtenir les détails de l’équipe par ID d’équipe |
Obtenez les détails de l’équipe par ID d’équipe. |
| Obtenir les détails de l’équipe par ID public d’équipe |
Obtenir les détails de l’équipe par ID public d’équipe. L’ID public ressemble à TenantName\TeamName |
| Obtenir les détails de l’équipe par nom d’équipe |
Obtenez les détails de l’équipe par nom d’équipe. |
| Obtenir les détails des services par liste de noms |
Obtenez les détails des services par liste de noms. |
| Obtenir les services, régions et clouds affectés |
Obtenez les services, régions et clouds affectés pour un incident ou une panne donné. |
| Obtenir les événements haute priorité impactés |
Obtenez les événements haute priorité affectés pour un incident ou une panne donné. |
| Rechercher des incidents en propriétaire de l’ID de l’équipe |
Cet outil recherche les incidents en propriétaire de l’ID de l’équipe. |
| Vérifier si un client spécifique est affecté |
Vérifiez si un client spécifique figure dans la liste des clients concerné par l’ID d’incident/panne. Remarque : Même si le résultat est faux, cela ne signifie pas que le client n’est pas affecté. Demandez à l’utilisateur de vérifier d’autres métriques d’impact telles que les demandes de support, sev A (CritSit) etc. |
Fournir toutes les informations de contexte détaillées
Fournissez toutes les informations de contexte détaillées, toutes les métadonnées d’origine pour l’incident et la panne
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
L’ID d’incident |
Fournir un impact global pour l’incident spécifié
Fournir un impact global sur l’incident ou la panne spécifiés.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
L’ID d’incident |
ICM MCP
Appel direct des opérations de serveur MCP ICM
Obtenir des demandes de support et des tickets de support (SRs) et SevA (CritSit)
Obtenez des demandes de support/tickets de support (SRs) et SevA (CritSit) liés à un incident/panne donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
L’ID d’incident |
Obtenir des indicateurs d’atténuation pour un ID d’incident donné
Obtenez des indicateurs d’atténuation pour un ID d’incident donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
L’ID d’incident |
Obtenir des informations sur l’emplacement de l’incident
Obtenez des informations d’emplacement sur l’incident et/ou la panne, notamment la région, la zone de disponibilité, le centre de données, le cluster, le nœud et l’alias arm de région.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
L’ID d’incident |
Obtenir la liste des incidents similaires
Obtenez la liste des incidents similaires pour un ID d’incident donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
L’ID d’incident |
Obtenir la planification des appels pour une équipe
Obtenez la planification des appels pour une équipe par ID d’équipe.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
teamIds
|
teamIds | True | string |
ID d’équipe |
Obtenir le nombre d’abonnements affectés
Obtenez le nombre d’abonnements affectés pour un incident ou une panne donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
L’ID d’incident |
Obtenir le résumé des incidents et des pannes
Obtenez un résumé des incidents et/ou des pannes et uniquement pour le résumé.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
L’ID d’incident |
Obtenir les clients ACE affectés
Obtenez les clients ACE affectés pour un incident ou une panne donnés.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
L’ID d’incident |
Obtenir les clients S500 impactés
Obtenez les clients S500 affectés pour un incident ou une panne donnés.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
L’ID d’incident |
Obtenir les clients « Azure Priority 0 » ou « Vie et sécurité » affectés
Obtenez les clients « Azure Priority 0 » ou « Life and Safety » pour un incident ou une panne donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
L’ID d’incident |
Obtenir les coordonnées par alias de contact
Obtenez les coordonnées par alias de contact.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
alias
|
alias | True | string |
Alias de contact |
Obtenir les coordonnées par ID de contact
Obtenez les coordonnées par ID de contact.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
contactId
|
contactId | True | string |
ID de contact |
Obtenir les détails de l’incident par ID
Obtenez les détails de l’incident par ID.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
L’ID d’incident |
Obtenir les détails de l’équipe par ID d’équipe
Obtenez les détails de l’équipe par ID d’équipe.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
teamId
|
teamId | True | string |
ID d’équipe |
Obtenir les détails de l’équipe par ID public d’équipe
Obtenir les détails de l’équipe par ID public d’équipe. L’ID public ressemble à TenantName\TeamName
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
publicId
|
publicId | True | string |
ID public de l’équipe |
Obtenir les détails de l’équipe par nom d’équipe
Obtenez les détails de l’équipe par nom d’équipe.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
teamName
|
teamName | True | string |
Nom de l’équipe |
Obtenir les détails des services par liste de noms
Obtenez les détails des services par liste de noms.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
noms
|
names | True | string |
Noms de service |
Obtenir les services, régions et clouds affectés
Obtenez les services, régions et clouds affectés pour un incident ou une panne donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
L’ID d’incident |
Obtenir les événements haute priorité impactés
Obtenez les événements haute priorité affectés pour un incident ou une panne donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
L’ID d’incident |
Rechercher des incidents en propriétaire de l’ID de l’équipe
Cet outil recherche les incidents en propriétaire de l’ID de l’équipe.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
teamId
|
teamId | True | string |
ID d’équipe |
Vérifier si un client spécifique est affecté
Vérifiez si un client spécifique figure dans la liste des clients concerné par l’ID d’incident/panne. Remarque : Même si le résultat est faux, cela ne signifie pas que le client n’est pas affecté. Demandez à l’utilisateur de vérifier d’autres métriques d’impact telles que les demandes de support, sev A (CritSit) etc.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
incidentId
|
incidentId | True | string |
L’ID d’incident |
|
customerName
|
customerName | True | string |
Nom du client |