Verbindung mit einem MCP-Server über einen MCP-Client

Stellen Sie eine Verbindung zu her Modellkontext-Protokoll(MCP) Server von einem MCP-Client, indem eine eingehende OAuth-Integration erstellt und der Client mit den Serverdetails konfiguriert wird.

Mit dem Schnellstart-Server oder nach dem Erstellen eines Servers können Sie die folgenden Schritte ausführen, um über einen Client eine Verbindung zu einem Server herzustellen:

1. Erstellen Sie eine eingehende OAuth-Integration für einen MCP-Client
2. Konfigurieren Sie einen MCP-Client, um eine Verbindung zu einem MCP-Server herzustellen

Der Prozess zum Konfigurieren eines Clients für die Verbindung mit einem Server hängt vom verwendeten Client ab. Weitere Informationen finden Sie in der Dokumentation für Ihre KI-Anwendung und Ihren Client.

Erstellen Sie eine eingehende OAuth-Integration für einen MCP-Client

Sicherer Zugriff auf Modellkontext-Protokoll(MCP) Server in einer Instanz, indem für jeden MCP-Client eine eingehende OAuth-Integration erstellt wird.

Vorbereitungen

Erforderliche Rolle: oauth_admin, mi_admin, admin

Warum und wann dieser Vorgang ausgeführt wird

Erstellen Sie für jeden Client, auf den Sie auf Server in einer Instanz zugreifen möchten, eine eingehende OAuth-Integration in der Rechneridentitätskonsole. Zum Erstellen der OAuth-Integration benötigen Sie eine Umleitungs-URL vom Client. Weitere Informationen finden Sie in der Dokumentation für Ihre KI-Anwendung und Ihren Client.

Prozedur

1. Navigieren zu Alle > MCP-Serverkonsolean.
2. Wählen Sie auf der Registerkarte Konfiguration die Option aus Server .
3. Wählen Sie im erforderlichen OAuth-Setup-Banner die Option aus Richten Sie OAuth ein .
   Alternativ können Sie zu navigieren Alle > Rechneridentitätskonsole Und wählen Sie aus Eingehende Integrationen Registerkarte.

   Hinweis:

   In der Liste der vorhandenen eingehenden Integrationen werden möglicherweise Integrationen mit den gleichen Namen wie Server (einschließlich Unterstriche) erstellt. Dies sind Integrationen zur Überwachung von Servern von KI-Kontrollstelle Und sollten nicht zur Integration in Clients verwendet werden.
4. Wählen Sie Aus Neue Integration .
5. Wählen Sie Aus OAuth: Autorisierungscodegewährung .
6. Füllen Sie im Formular die erforderlichen Felder aus.
   Weitere Informationen zu diesem Formular finden Sie unter Configure an OAuth authorization code grant.

   Tabelle : 1. Eingehendes Integrationsformular

   Feld	Wert
   Abschnitt „Details“
   Name	Geben Sie einen Namen für die OAuth-Integration ein.
   Umleitungs-URLs	Geben Sie die Umleitungs-URL für einen Client ein. Der Autorisierungscode wird nach der Authentifizierung an diese URL gesendet. Informationen zum Abrufen der Umleitungs-URL finden Sie in der Dokumentation für Ihre KI-Anwendung und Ihren Client. Um eine Verbindung mit herzustellen ServiceNow MCP-Client auf einer anderen Instanz verwenden Sie die folgende Umleitungs-URL: https://<client-instance>.service-now.com/oauth_redirect.do . Weitere Informationen finden Sie unter Modellkontext-Protokoll-Client Dokumentation.
   Abschnitt „Authentifizierungsbereich“
   Zugriff nur auf APIs im ausgewählten Bereich zulassen	Deaktivieren Sie das Kontrollkästchen, um den Umfang der OAuth-Integration zu erweitern.
   Abschnitt „Erweiterte Optionen“
   Tokenformat	Wählen Sie Aus JWT .

7. Wählen Sie Speichern.
   Die eingehende OAuth-Integration wird im breiten Umfang mit einer Client-ID und einem geheimen Client erstellt, die Sie beim Konfigurieren des Clients für die Verbindung mit Servern in der Instanz verwenden.

   

Nächste Maßnahme

Konfigurieren Sie den Client so, dass er die Client-ID und den geheimen Client für die Authentifizierung bei Servern in der Instanz verwendet.

Konfigurieren Sie einen MCP-Client, um eine Verbindung zu einem MCP-Server herzustellen

Konfigurieren Sie ein Modellkontext-Protokoll(MCP) Client, um eine Verbindung zu einem MCP-Server herzustellen und den Server zur Ausführung einer Aufgabe aufzufordern.

Vorbereitungen

Erforderliche Rolle: keine

Warum und wann dieser Vorgang ausgeführt wird

Der Prozess zum Konfigurieren eines Clients für die Verbindung mit einem Server hängt vom verwendeten Client ab. Das folgende Verfahren ist eine allgemeine Übersicht über den Workflow, um einen Client so zu konfigurieren, dass er einen Server aufruft. Weitere Informationen finden Sie in der Dokumentation für Ihre KI-Anwendung und Ihren Client. Ein Beispiel, das demonstriert, wie Sie eine Verbindung von einem Server auf einer Instanz mit herstellen können ServiceNow Modellkontext-Protokoll-Client In einer anderen Instanz finden Sie das Beispiel nach diesem Verfahren.

Prozedur

1. Konfigurieren Sie einen Client mit den erforderlichen Serverdetails, wie vom Client festgelegt.

   Tabelle : 2. Serverdetails für die MCP-Client-Konfiguration

   Serverdetails	Wert
   Server-URL	https://<server-instance>.service-now.com/sncapps/mcp-server/mcp/<server-name> Verwenden Sie zum Herstellen einer Verbindung mit dem vorkonfigurierten Schnellstart-Server https://<server-instance>.service-now.com/sncapps/mcp-server/mcp/sn_mcp_server_default .
   Host	<server-instance>.service-now.com
   Basis-URL	/Sncapps/mcp-Server
   Umfang	mcp_Server
   Authentifizierungstyp	OAuth 2.0
   Identitätsanbieter	Generisches OAuth 2
   Autorisierungs-URL	https://<server-instance>.service-now.com/oauth_auth.do
   Token-URL	https://<server-instance>.service-now.com/oauth_token.do
   Token-Sperr-URL	https://<server-instance>.service-now.com/oauth_revoke.do
   Aktualisieren Sie die URL	https://<server-instance>.service-now.com/oauth_auth.do
   Umleitungs-URL	https://<server-instance>.service-now.com/oauth/callback
   Client-ID	Die Client-ID aus der eingehenden OAuth-Integration auf der Serverinstanz.
   Geheimer Clientschlüssel	Der geheime Clientschlüssel aus der eingehenden OAuth-Integration auf der Serverinstanz.

   Nach der Konfiguration dieser Details ruft der Client den Server mit auf Autorisierung: Bearer-<token> Header. Wenn das Token vom Server validiert wird, erhält der Client die Liste der zur Verwendung verfügbaren Tools.

2. Auf dem Client können Sie die Liste der verfügbaren Tools anzeigen, um zu bestimmen, wie der Server aufgefordert wird.
3. Geben Sie eine Aufforderung für die benötigten Informationen ein, oder geben Sie ein, damit das Tool eine Aktion für die Instanz ausführen kann.

   Wenn beispielsweise das Tool „Incident-Datensätze suchen“ verfügbar ist, können Sie „alle offenen Incidents abrufen“ eingeben. Mit dem Fallzusammenfassungstool können Sie „alle in dieser Woche geschlossenen Fälle zusammenfassen“ eingeben.

   Der Server führt die relevanten Tools aus und gibt das Ergebnis als JSON-Daten an den Client zurück. Der Client zeigt die Antwort als formatierten Text an.

Verbindung mit einem MCP-Server über wird hergestellt ServiceNow Modellkontext-Protokoll-Client

Dieses Beispiel zeigt, wie Sie über einen KI-Agenten auf einer anderen Instanz eine Verbindung zu einem Server herstellen können, indem Sie verwenden ServiceNow Modellkontext-Protokoll-Client. Zuerst konfigurieren Sie den Client so, dass er den vorkonfigurierten Schnellstartserver aufruft. Über einen KI-Agenten greifen Sie auf die Liste der Tools des QuickStart-Servers zu und fügen dem Agenten einzelne Tools hinzu. Zuletzt testen Sie den Service Desk-Mitarbeiter in KI-Agenten-Studio Indem Sie einen Prompt bereitstellen und die Antwort des Service Desk-Mitarbeiters anzeigen. Weitere Informationen finden Sie unter Modellkontext-Protokoll-Client Dokumentation.

Erforderliche Rolle: sn_mcp_Client.admin

1. Erstellen Sie auf der Serverinstanz eine eingehende OAuth-Integration für ServiceNow Modellkontext-Protokoll-Client.

   Weitere Informationen finden Sie unter Erstellen Sie eine eingehende OAuth-Integration für einen MCP-Client.

2. Navigieren Sie in der Clientinstanz zu Alle > KI-Agenten-Studio > Einstellungenan.
3. Wählen Sie Aus Verwalten Sie MCP-Server .
4. Wählen Sie Neu.
5. Fügen Sie den Schnellstart-Server hinzu.

   Weitere Informationen zu diesem Schritt finden Sie unter Fügen Sie einen MCP-Server mit OAuth 2,1 hinzu.

   1. Füllen Sie im Formular MCP-Server hinzufügen die Felder aus.

      Tabelle : 3. Fügen Sie das MCP-Serverformular hinzu

      Feld	Wert
      Name	Schnellstart-Server
      Authentifizierungstyp	OAuth 2.1
      URL des MCP-Servers	https://<server-instance>.service-now.com/sncapps/mcp-server/mcp/sn_mcp_server_default

   2. Wählen Sie Weiter.
   3. Füllen Sie im Formular die Felder aus.

      Tabelle : 4. Fügen Sie das MCP-Serverformular hinzu

      Feld	Wert
      Client-Registrierungstyp	Manuelle Registrierung
      Gewährungstyp	Autorisierungscode
      Tokenauthentifizierungsmethode	Geheimer Client-Post
      Client-ID	Die Client-ID aus der eingehenden OAuth-Integration für Modellkontext-Protokoll-Client Auf der Serverinstanz.
      Geheimer Clientschlüssel	Der geheime Clientschlüssel aus der eingehenden OAuth-Integration für Modellkontext-Protokoll-Client Auf der Serverinstanz.
      Autorisierungs-URL	https://<server-instance>.service-now.com/oauth_auth.do
      Token-URL	https://<server-instance>.service-now.com/oauth_token.do
      Token-Sperr-URL	https://<server-instance>.service-now.com/oauth_revoke.do

   4. Wählen Sie Speichern.
6. Überprüfen Sie die OAuth-Konfiguration.
   1. Wählen Sie Aus Authentifizieren .
   2. Wählen Sie Aus Zulassen Damit der Client eine Verbindung zum Server herstellen kann.
7. Fügen Sie einem KI-Agenten Tools vom Schnellstart-Server hinzu.

   Weitere Informationen zu diesem Schritt finden Sie unter Fügen Sie ein hinzu MCP Servertool zu einem KI-Agenten.

   1. In KI-Agenten-Studio, Wählen Sie aus Erstellen und verwalten Registerkarte.
   2. Wählen Sie auf der Registerkarte „KI-Agenten“ einen vorhandenen Agenten aus, oder erstellen Sie einen.

      Informationen zum Erstellen eines Service Desk-Mitarbeiters finden Sie unter KI-Agenten erstellen.

   3. Wählen Sie Aus Fügen Sie Tools und Informationen hinzu .
   4. Auswählen Tool hinzufügen > MCP-Servertoolan.
   5. Füllen Sie im Formular die Felder aus.

      Tabelle : 5. Fügen Sie ein hinzu Modellkontext-Protokoll Toolformular

      Feld	Wert
      Wählen Sie Aus Modellkontext-Protokoll Server	Schnellstart-Server
      Tool auswählen	Wählen Sie die Tools auf dem Schnellstart-Server aus, die Sie mit diesem KI-Agenten verwenden möchten.

      

   6. Wählen Sie Hinzufügen.
   7. Wählen Sie Aus Speichern und fortfahren .
8. Testen Sie den KI-Agenten.

   Weitere Informationen zu diesem Schritt finden Sie unter Testen Sie einen KI-Agent.

   1. In KI-Agenten-Studio, Wählen Sie aus Wird Getestet Registerkarte.
   2. Wählen Sie Aus Starten Sie den manuellen Test .
   3. Wählen Sie im Feld Testtyp auswählen die Option aus KI-Agent oder Workflow .
   4. Wählen Sie den konfigurierten KI-Agenten und seine Version aus.
   5. Geben Sie im Feld Aufgabe eine Aufforderung ein, um Informationen abzurufen oder eine Aktion für die Instanz auszuführen.

      Der Prompt muss darauf basieren, welche Tools verfügbar sind. Wenn Sie beispielsweise die Tools „Falldatensätze suchen“ und „Fallzusammenfassung“ hinzugefügt haben, können Sie „alle in dieser Woche geschlossenen Fälle zusammenfassen“ eingeben.

      

   6. Wählen Sie Aus Fahren Sie mit Chat-Antwort testen fort .

   Der KI-Agent ruft den Server auf, und der Server führt die angeforderten Tools basierend auf dem Prompt aus. Der Server gibt die Informationen als JSON-Daten an den Agent zurück, und der Agent stellt sie als formatierten Text dar. In diesem Beispiel gibt der Service Desk-Mitarbeiter Zusammenfassungen der Fälle zurück, die in der letzten Woche von Abel Tuter geschlossen wurden.