Σύνδεση διακομιστή Dynamics 365 CX MCP - Υπηρεσία μέσω της πύλης εργαλείων παράγοντα 365

Σημαντικό

ΕΙΔΟΠΟΙΗΣΗ ΗΠΑ: Η ενεργοποίηση αυτής της δυνατότητας θα επιτρέψει στα δεδομένα να εξέλθουν εκτός του ορίου FedRAMP High. Οι χρήστες θα πρέπει να επιβεβαιώσουν με τον διαχειριστή μισθωτή τους ότι αυτή η δυνατότητα πληροί τις συγκεκριμένες απαιτήσεις ασφαλείας και τις υποχρεώσεις συμμόρφωσης του οργανισμού τους.

Χρησιμοποιήστε το Dynamics 365 CX Model Context Protocol (MCP) Server - Service για να συνδέσετε δεδομένα και εργαλεία Customer Service με εκπροσώπους του Microsoft Copilot Studio ή άλλα προγράμματα-πελάτες MCP που υποστηρίζουν συνδέσεις MCP που βασίζονται σε HTTP. Το Agent 365 Tooling Gateway (ATG) παρέχει την πύλη που φιλοξενείται από τη Microsoft που βρίσκεται μπροστά από τον διακομιστή MCP εξυπηρέτησης πελατών και χειρίζεται τον έλεγχο ταυτότητας στο Dataverse.

Αυτό το άρθρο εξηγεί πώς μπορείτε να κάνετε τα εξής:

Κατανοήστε πώς λειτουργεί ο έλεγχος ταυτότητας πύλης εργαλείων φορέα 365 για τον διακομιστή - υπηρεσία Dynamics 365 CX MCP.
Ρυθμίστε τις παραμέτρους ενός εκπροσώπου Copilot Studio για χρήση του διακομιστή Dynamics 365 CX MCP Server - Service μέσω της πύλης εργαλείων φορέα 365.
Συνδέστε υποστηριζόμενους εξωτερικούς πελάτες MCP, όπως Cursor, ChatGPT, Claude Code, Visual Studio Code και GitHub Copilot CLI.
Αντιμετώπιση συνηθισμένων προβλημάτων εγκατάστασης και ελέγχου ταυτότητας.

Πώς λειτουργεί ο έλεγχος ταυτότητας της Πύλης εργαλείων Agent 365

Το Agent 365 Tooling Gateway είναι ένας πόρος που προστατεύεται από OAuth 2.0. Κάθε διεύθυνση URL διακομιστή MCP που βρίσκεται μπροστά από την πύλη εκθέτει τα μεταδεδομένα εντοπισμού OAuth μέσω ενός ανώνυμου τελικού σημείου εντοπισμού.

GET https://agent365.svc.cloud.microsoft/.well-known/oauth-protected-resource/mcp/environments/<environment-id>/servers/mcp_D365CX_Service

Η απόκριση εντοπισμού λέει στον υπολογιστή-πελάτη MCP ποιον διακομιστή εξουσιοδότησης, κοινό πόρων και εμβέλειες να χρησιμοποιήσει.

{
  "resource_name": "mcp_D365CX_Service",
  "resource": "https://agent365.svc.cloud.microsoft/mcp/environments/<environment-id>/servers/mcp_D365CX_Service",
  "authorization_servers": [
    "https://login.microsoftonline.com/organizations/v2.0"
  ],
  "scopes_supported": [
    "https://agent365.svc.cloud.microsoft/mcp/environments/<environment-id>/servers/mcp_D365CX_Service/.default",
    "openid",
    "profile",
    "offline_access"
  ],
  "bearer_methods_supported": [
    "header"
  ]
}

Ο υπολογιστής-πελάτης MCP ζητά ένα διακριτικό για τον πόρο πύλης εργαλείων παράγοντα 365. Στη συνέχεια, η πύλη εργαλείων εκπροσώπου 365 εκτελεί την ανταλλαγή εκ μέρους της που επιτρέπει στην αίτηση να φτάσει στο Dataverse.

Βασικές εκτιμήσεις

Το ακροατήριο του διακριτικού είναι η πύλη εργαλείων και όχι απευθείας η Υπηρεσία Dynamics 365 CX MCP Server.
Το πεδίο OAuth χρησιμοποιεί τη διεύθυνση URL πόρου της πύλης εργαλείων παράγοντα 365 και τελειώνει με /.default.
Το /.default εύρος δεν υποστηρίζει επαυξητική ή δυναμική συναίνεση χρήστη. Η συγκατάθεση διαχειριστή πρέπει να εκχωρηθεί εκ των προτέρων στον μισθωτή πελάτη.
Το πεδίο εφαρμογής είναι συγκεκριμένο για το περιβάλλον και τον διακομιστή. Κάθε περιβάλλον απαιτεί τη δική του διαμόρφωση σύνδεσης.
Οι υπολογιστές-πελάτες με δυνατότητα εντοπισμού μπορούν να διαβάσουν αυτόματα τα μεταδεδομένα OAuth. Η ρύθμιση προσαρμοσμένης σύνδεσης του Copilot Studio ενδέχεται να απαιτεί από εσάς να εισαγάγετε τιμές OAuth με μη αυτόματο τρόπο.

Προϋποθέσεις

Χρησιμοποιήστε τον ρόλο διαχειριστή συστήματος ή διαχειριστή πανκαναλικού για να διαμορφώσετε τον διακομιστή MCP.
Χρησιμοποιήστε τον ρόλο Αντιπρόσωπος Εξυπηρέτησης Πελατών ή Υπεύθυνος CSR για να χρησιμοποιήσετε τον διακομιστή MCP και τα εργαλεία του.
Ο διακομιστής Dynamics 365 CX MCP - Υπηρεσία πρέπει να ρυθμιστεί και να είναι διαθέσιμος στη λίστα εργαλείων Copilot Studio.
Αναγνωριστικό περιβάλλοντος Dataverse. Αυτό το αναγνωριστικό απαιτείται στη διεύθυνση URL του διακομιστή πύλης εργαλείων παράγοντα 365.
Διορθώστε το αναγνωριστικό εφαρμογής της πύλης εργαλείων Agent 365.
Δικαιώματα διαχειριστή μισθωτή ή δικαιώματα εκχώρησης συγκατάθεσης διαχειριστή.

Σημαντικό

Η ενεργοποίηση συνδέσεων μεταξύ του Dynamics 365 και των υπηρεσιών που δεν είναι Dynamics 365, συμπεριλαμβανομένης της Microsoft ή εξωτερικών υπηρεσιών, θα επιτρέψει την έξοδο δεδομένων εκτός του ορίου του Dynamics 365 FedRAMP High. Τα δεδομένα που ρέουν από το Dynamics 365 σε άλλες υπηρεσίες θα υποβάλλονται σε επεξεργασία και θα αποθηκεύονται σύμφωνα με τους όρους, τις δεσμεύσεις συμμόρφωσης και τις απαιτήσεις σημείου αποθήκευσης και χειρισμού δεδομένων της υπηρεσίας προορισμού.

Αυτά τα δεδομένα μπορεί να περιλαμβάνουν ερωτήματα και άλλα δεδομένα που υποβάλλονται σε εκπροσώπους από χρήστες στον οργανισμό σας. Πριν ενεργοποιήσετε τις συνδέσεις διακομιστή MCP για τον οργανισμό σας, ο διαχειριστής μισθωτή θα πρέπει να επιβεβαιώσει ότι αυτές οι συνδέσεις πληρούν τις απαιτήσεις ασφάλειας δεδομένων, συμμόρφωσης, τόπου διαμονής και διαχείρισης.

Αναγνωριστικό εφαρμογής της πύλης εργαλείων Agent 365

Η πύλη εργαλείων παράγοντα 365 χρησιμοποιεί ένα αναγνωριστικό εφαρμογής Microsoft Entra. Χρησιμοποιήστε το ακόλουθο αναγνωριστικό εφαρμογής.

Αναγνωριστικό εφαρμογής Microsoft Entra
`ea9ffc3e-8a23-4a7d-836d-234d7c7565c1`

Χρησιμοποιήστε αυτήν τη μορφή URL διακομιστή:

https://agent365.svc.cloud.microsoft/mcp/environments/<environment-id>/servers/mcp_D365CX_Service

Απαιτείται το /mcp/environments/ τμήμα διαδρομής. Εάν το παραλείψετε, το αίτημα επιστρέφει 404 RouteNotFound.

Η εφαρμογή Agent 365 Tooling Gateway είναι μια καταχώρηση εφαρμογής πρώτου κατασκευαστή της Microsoft. Για να μπορέσει μια εφαρμογή-πελάτης να ζητήσει ένα διακριτικό για αυτήν, η κύρια υπηρεσία πύλης εργαλείων πρέπει να υπάρχει στον μισθωτή πελάτη και το δικαίωμα ανάθεσης πρέπει να έχει συγκατάθεση διαχειριστή.

Ως διαχειριστής μισθωτή, ανοίξτε την ακόλουθη διεύθυνση URL συγκατάθεσης διαχειριστή. Αντικαταστήστε <customer-tenant-id> με το αναγνωριστικό μισθωτή πελάτη και <ATG-app-id> με το αναγνωριστικό εφαρμογής.

https://login.microsoftonline.com/<customer-tenant-id>/adminconsent?client_id=<ATG-app-id>

Εισέλθετε ως διαχειριστής μισθωτή και εγκρίνετε την αίτηση. Το Microsoft Entra δημιουργεί την οντότητα υπηρεσίας πόρου του Agent 365 Tooling Gateway στην ενότητα Εταιρικές εφαρμογές στον μισθωτή του πελάτη.

Μπορείτε επίσης να παράσχετε την κύρια υπηρεσία με μη αυτόματο τρόπο και να εκχωρήσετε συγκατάθεση διαχειριστή ως εξής:

az ad sp create --id <ATG-app-id>

New-MgServicePrincipal -AppId "<ATG-app-id>"

Δημιουργία εφαρμογής-πελάτη Microsoft Entra για το Copilot Studio

Για να ρυθμίσετε τις παραμέτρους μιας προσαρμοσμένης σύνδεσης στο Copilot Studio, δημιουργήστε τη δική σας εμπιστευτική εφαρμογή προγράμματος-πελάτη στο Microsoft Entra ID. Αυτή η εφαρμογή δεν είναι η εφαρμογή πρώτου μέρους του Dynamics 365 και απαιτεί μόνο δικαιώματα πρόσβασης στο πεδίο πόρων πύλης εργαλείων παράγοντα 365.

Στο Κέντρο διαχείρισης Microsoft Entra, ολοκληρώστε τα παρακάτω βήματα:

Δημιουργήστε μια καταχώρηση εφαρμογής Microsoft Entra ακολουθώντας τα βήματα στην ενότητα Καταχώρηση εφαρμογής. Βεβαιωθείτε ότι χρησιμοποιείτε μια καταχώρηση εφαρμογής ενός μισθωτή.
Δημιουργήστε έναν μυστικό κωδικό προγράμματος-πελάτη για την καταχώρηση της εφαρμογής. Μάθετε περισσότερα στο θέμα Προσθήκη μυστικού κωδικού προγράμματος-πελάτη. Αντιγράψτε τη μυστική τιμή. Μπορείτε να χρησιμοποιήσετε αυτήν την τιμή όταν ρυθμίζετε τις παραμέτρους του OAuth στο Copilot Studio.
Μεταβείτε στην ενότητα Δικαιώματα API και, στη συνέχεια, επιλέξτε Προσθήκη δικαιώματος.
Επιλέξτε API που χρησιμοποιεί ο οργανισμός μου.
Αναζητήστε την εφαρμογή Πύλη εργαλείων παράγοντα 365 χρησιμοποιώντας το αναγνωριστικό εφαρμογής.
Προσθέστε το εκχωρημένο δικαίωμα που εκθέτει η εφαρμογή Agent 365 Tooling Gateway για το McpServers.D365Service.All.
Επιλέξτε Εκχώρηση συναίνεσης διαχειριστή.

Αφήστε κενό το URI ανακατεύθυνσης web έως ότου το Copilot Studio δημιουργήσει τη διεύθυνση URL επιστροφής κλήσης κατά τη ρύθμιση της σύνδεσης.

Προσθήκη διακομιστή MCP σε παράγοντα

Ανοίξτε το Copilot Studio και, στη συνέχεια, ανοίξτε ή δημιουργήστε έναν εκπρόσωπο.

Ακολουθήστε τα βήματα στην ενότητα Προσθήκη εργαλείων και πόρων από έναν διακομιστή Model Context Protocol (MCP) στο copilot σας για να δημιουργήσετε έναν νέο διακομιστή MCP και δώστε τις ακόλουθες λεπτομέρειες:

Πεδίο	Τιμή
Όνομα διακομιστή	Εισαγάγετε ένα σαφές όνομα, όπως `Dynamics 365 CX MCP Server through ATG`.
Περιγραφή διακομιστή	Περιγράψτε τις διαθέσιμες δυνατότητες, ώστε το Orchestrator να μπορεί να δρομολογεί αιτήματα σε αυτόν τον διακομιστή. Για παράδειγμα, `Use Dynamics 365 Customer Experience tools to list, read, and update cases; search knowledge; view activity timelines; and draft emails.`
Διεύθυνση URL διακομιστή	`https://agent365.svc.cloud.microsoft/mcp/environments/<environment-id>/servers/mcp_D365CX_Service`
Έλεγχος ταυτότητας	Επιλέξτε OAuth 2.0.

Εισαγάγετε τις τιμές OAuth που παρέχονται από τα μεταδεδομένα ανακάλυψης του Agent 365 Tooling Gateway. Χρησιμοποιήστε μη αυτόματη ρύθμιση παραμέτρων, εκτός εάν το περιβάλλον του Copilot Studio υποστηρίζει δυναμική ανακάλυψη OAuth για διακομιστές MCP.

Πεδίο	Τιμή
Αναγνωριστικό πελάτη	Το αναγνωριστικό προγράμματος-πελάτη της εφαρμογής Microsoft Entra που δημιουργήσατε για το Copilot Studio.
Μυστικός κωδικός προγράμματος-πελάτη	Η τιμή μυστικού κωδικού προγράμματος-πελάτη από την εφαρμογή Microsoft Entra.
Διεύθυνση URL εξουσιοδότησης	`https://login.microsoftonline.com/<customer-tenant-id>/oauth2/v2.0/authorize`
Διεύθυνση URL διακριτικού	`https://login.microsoftonline.com/<customer-tenant-id>/oauth2/v2.0/token`
Ανανέωση διεύθυνσης URL	Το ίδιο με τη διεύθυνση URL του διακριτικού.
Πεδίο εφαρμογής	`<ATG App ID>/.default` Για παράδειγμα: `ea9ffc3e-8a23-4a7d-836d-234d7c7565c1/.default`

Αφού δημιουργήσετε τη ρύθμιση παραμέτρων OAuth, το Copilot Studio εμφανίζει μια διεύθυνση URL επιστροφής κλήσης. Αντιγράψτε τη διεύθυνση URL επιστροφής κλήσης και προσθέστε την ως URI ανακατεύθυνσης Web στην εφαρμογή Microsoft Entra που δημιουργήσατε για το Copilot Studio.

Δημιουργήστε τη σύνδεση και προσθέστε το εργαλείο

Στον agent του Copilot Studio, ολοκληρώστε τα ακόλουθα βήματα:

Στο παράθυρο διαλόγου Προσθήκη εργαλείου , επιλέξτε Δημιουργία νέας σύνδεσης.
Συνδεθείτε με έναν λογαριασμό που έχει πρόσβαση στο περιβάλλον Customer Service προορισμού.
Προσθέστε το εργαλείο στον παράγοντα.
Δημοσίευση πράκτορα.

Προαιρετικά, εάν θέλετε να χρησιμοποιήσετε το copilot σας στο Customer Service, μεταβείτε στην καρτέλα Κανάλια και συνδέστε το copilot στο Dynamics 365 Customer Service.

Ρυθμίστε πελάτες MCP με δυνατότητα ανακάλυψης

Οι πελάτες MCP με δυνατότητα εντοπισμού, όπως το Visual Studio Code, το GitHub Copilot CLI, το Cursor, το ChatGPT και το Claude Code, μπορούν να ανακτήσουν αυτόματα τα μεταδεδομένα OAuth της πύλης εργαλείων. Για αυτούς τους υπολογιστές-πελάτες, διαμορφώστε τη διεύθυνση URL του διακομιστή MCP και αφήστε τον υπολογιστή-πελάτη να χειριστεί τη σύνδεση.

Σημείωμα

Δεν απαιτείται μη αυτόματο τελικό σημείο, αναγνωριστικό προγράμματος-πελάτη, πεδίο εφαρμογής ή μυστικός κωδικός OAuth για υπολογιστές-πελάτες που υποστηρίζουν εντοπισμό OAuth για διακομιστές MCP.

κώδικας Visual Studio

Στο Visual Studio Code, ανοίξτε την παλέτα εντολών πατώντας Ctrl+Shift+P.
Εισαγάγετε MCP: Add Server.
Επιλέξτε HTTP ή Server sent Events.
Προσθέστε τη διεύθυνση URL διακομιστή MCP του Customer Service.

{
  "servers": {
    "d365-customer-service": {
      "type": "http",
      "url": "https://agent365.svc.cloud.microsoft/mcp/environments/<environment-id>/servers/mcp_D365CX_Service"
    }
  },
  "inputs": []
}

GitHub Copilot CLI

Προσθέστε τον διακομιστή στο .mcp.json.

{
  "mcpServers": {
    "d365-customer-service": {
      "type": "http",
      "url": "https://agent365.svc.cloud.microsoft/mcp/environments/<environment-id>/servers/mcp_D365CX_Service"
    }
  }
}

Δρομέας

Ανοίξτε το δρομέα.
Ανοίξτε τις Ρυθμίσεις.
Μεταβείτε στην ενότητα Λειτουργίες>Διακομιστές MCP.
Επιλέξτε Προσθήκη διακομιστή MCP.
Προσθέστε τη διαμόρφωση διακομιστή.

{
  "mcpServers": {
    "d365-customer-service": {
      "url": "https://agent365.svc.cloud.microsoft/mcp/environments/<environment-id>/servers/mcp_D365CX_Service"
    }
  }
}

Αντικαταστήστε <environment-id> με το αναγνωριστικό περιβάλλοντος Dataverse για το περιβάλλον προορισμού.

ChatGPT

Ανοίξτε τις Ρυθμίσεις>Συνδέσεις>Διακομιστές MCP.
Προσθέστε τη διεύθυνση URL διακομιστή MCP του Customer Service.

https://agent365.svc.cloud.microsoft/mcp/environments/<environment-id>/servers/mcp_D365CX_Service

Επιλέξτε Σύνδεση.
Εισέλθετε όταν ανοίξει η ροή ελέγχου ταυτότητας της Microsoft.
Βεβαιωθείτε ότι τα διαθέσιμα εργαλεία MCP είναι καταχωρημένα.

Κωδικός Claude

Όταν ο Claude Code κάνει το πρώτο του αίτημα MCP, ανακαλύπτει τα μεταδεδομένα OAuth του Agent 365 Tooling Gateway, ανοίγει τη σύνδεση της Microsoft και αποθηκεύει διακριτικά τοπικά μετά τον έλεγχο ταυτότητας του χρήστη.

Διαμορφώστε τον διακομιστή MCP στον κώδικα Claude.

{
  "mcpServers": {
    "d365-customer-service": {
      "transport": {
        "type": "http",
        "url": "https://agent365.svc.cloud.microsoft/mcp/environments/<environment-id>/servers/mcp_D365CX_Service"
      }
    }
  }
}

Σχόλια

Ήταν χρήσιμη αυτή η σελίδα;

Τελευταία ενημέρωση στις 2026-08-18