MCP mit einem benutzerdefinierten Stecker verbinden

Der Document360 MCP-Server kann mit KI-Assistenten über die MCP-Server-URL oder eine JSON-Konfigurationsdatei verbunden werden. Leser können sich auf unterstützte Weise mit Claude verbinden und über die Konfigurationsdatei auf den Artikelinhalt zugreifen.

Individuelle Connectoren ermöglichen es Ihnen, eine sichere Verbindung zwischen Ihrer Wissensdatenbank und unterstützten KI-Assistenten herzustellen. Nach der Verbindung kann der KI-Assistent über MCP mit Dokumentationsinhalten in Ihrem Document360-Projekt interagieren.

Verwenden Sie die MCP-Server-URL, wenn Ihre KI-Plattform eine direkte URL für die Connector-Einrichtung akzeptiert (zum Beispiel Claude AI und Copilot). Verwenden Sie die JSON-Konfiguration, wenn Ihre KI-Plattform eine strukturierte Konfigurationsdatei benötigt (zum Beispiel Cursor-IDE).

Bevor du anfängst

Achten Sie vor der Einrichtung des MCP auf Folgendes:

• Du hast eine Rolle als Projektleiter oder Administrator . Nur diese Rollen können MCP für ein Projekt aktivieren oder deaktivieren.
• Sie haben Zugang zu einem unterstützten KI-Assistenten: ChatGPT, Claude AI, Cursor IDE, Copilot oder jede Plattform, die MCP oder benutzerdefinierte Connectoren unterstützt.

MCP aktivieren

Um MCP zu aktivieren,

1. Navigiere in der linken Navigationsleiste zu () ().

2. Gehe zu den KI-Einstellungen > MCP.

3. Klicken Sie auf MCP aktivieren.

   Eine Bestätigungsmeldung erscheint mit der Frage, ob Sie externen KI-Assistenten den Zugriff auf Ihre Wissensdatenbank erlauben möchten. Nur Projektverantwortliche und Administratoren können MCP für ein Projekt aktivieren oder deaktivieren.

4. Klicken Sie auf Zugriff erlauben , um fortzufahren.

Sobald aktiviert, wird die MCP-Konfiguration unter Custom Connectors verfügbar.

HINWEIS

Die Aktivierung von MCP ermöglicht einen strukturierten Zugriff auf Ihre Wissensdatenbank. Der Inhaltszugriff folgt weiterhin Ihrer bestehenden Projektversion, Sprache und Sichtbarkeitseinstellungen.

Hol dir die JSON-Konfiguration

Nach der Aktivierung von MCP,

1. Unter Custom Connectors klicken Sie auf Details abrufen.

   

2. Die MCP-Konfiguration wird angezeigt.

3. Du kannst entweder die vollständige JSON-Konfiguration kopieren oder die darin angegebene URL verwenden, je nach den Anforderungen deines KI-Assistenten.

   Diese Konfiguration ist erforderlich, um die MCP-Verbindung in deinem KI-Assistenten herzustellen.

MCP-Server-URLs

Verwenden Sie die folgenden MCP-Server-URLs bei der Konfiguration der Connectors in Ihrem KI-Assistenten. Wählen Sie die passende URL basierend auf der Region oder Umgebung Ihres Projekts aus. Füge die URL in das MCP-Konfigurationsfeld für benutzerdefinierte Connectoren in deinem KI-Assistant ein.

Verbinden Sie MCP mit Ihrem KI-Assistenten

Nachdem Sie MCP in Document360 aktiviert haben, können Sie Ihre Wissensdatenbank mit einem KI-Assistenten über die bereitgestellte MCP-JSON-Konfiguration verbinden. Je nach KI-Plattform müssen Sie möglicherweise entweder die MCP-Server-URL oder die JSON-Konfiguration verwenden. Die Aufbauschritte variieren leicht zwischen den Plattformen.

Die folgenden Abschnitte beschreiben den Verbindungsprozess für häufig verwendete KI-Assistenten wie ChatGPT, Claude und Copilot.

ChatGPT

Um MCP in ChatGPT zu verbinden:

1. Öffne ChatGPT.
2. Gehe zu den Einstellungen.
3. Navigiere zu Apps > Erweiterten Einstellungen.
4. Aktiviere den Entwicklermodus.
5. Klicken Sie auf App erstellen.

Geben Sie folgende Details an:

1. Name – Geben Sie ein Label für die Verbindung ein (zum Beispiel Document360 MCP).
2. Beschreibung – (Optional) Fügen Sie eine Beschreibung zur Referenz hinzu.
3. MCP Server URL – Fügen Sie die in Document360 bereitgestellte MCP Server URL ein.
4. Authentifizierungsmethode – Wählen Sie OAuth aus.
5. Klicken Sie auf Erweiterte Einstellungen.
6. Im angezeigten Seitenpanel scrolle nach unten.
7. Deaktivieren Sie die OIDC-aktivierte Option.
8. Wähle das Bestätigungskästchen aus (ich verstehe...).
9. Klicken Sie auf Erstellen.

Nach der Erstellung der App wirst du zu Document360 weitergeleitet. Überprüfen Sie die Verbindungsanfrage und wählen Sie das erforderliche Projekt aus.

1. Wähle das Bestätigungskästchen aus (ich verstehe und vertraue dieser URL).
2. Klicken Sie auf Weitermachen. Sie werden zu ChatGPT weitergeleitet.

Um den MCP-Anschluss in ChatGPT zu verwenden:

• Geben Sie im ChatGPT-Nachrichtenfeld eine / Liste verfügbarer Optionen ein.
• Scrollen Sie nach unten, um die hinzugefügten Steckverbinder zu finden, und wählen Sie dann den Document360-Stecker aus, indem Sie auf den angegebenen Namen klicken.

ChatGPT kann jetzt mit deiner Wissensdatenbank interagieren, indem du die in deinem Projekt aktivierten MCP-Funktionen nutzt.

Claude AI

Um MCP in Claude AI zu verbinden:

1. Claude AI öffnen.

2. Klicken Sie auf Ihr Profil und gehen Sie zu Einstellungen.

   

3. Gehe zu Connectors.

4. Klicken Sie auf Hinzufügen.

5. Wählen Sie Benutzerdefiniert aus den angegebenen Optionen.

6. Wähle Web oder Desktop je nach Anforderung.

Wenn Ihre Organisation erlaubt, benutzerdefinierte Connectoren hinzuzufügen, können Sie mit der Einrichtung fortfahren.

Falls nicht, müssen Sie möglicherweise Ihren Organisationsadministrator kontaktieren, um die Berechtigung zum Hinzufügen benutzerdefinierter Connectors zu aktivieren oder zu erteilen.

Geben Sie die erforderlichen Angaben an:

1. Name – Geben Sie ein Label ein (zum Beispiel Document360 MCP) ein.
2. Konfiguration – Füge die MCP-Server-URL aus der in Document360 bereitgestellten MCP-Konfiguration ein.
3. Klicken Sie auf Hinzufügen.
4. Navigiere zu den persönlichen Einstellungen und finde den benutzerdefinierten Connector mit dem von dir angegebenen Namen.
5. Klicken Sie auf Verbinden , um die MCP-Verbindung herzustellen.

Nach der Herstellung der Verbindung:

1. Sie werden auf Document360 weitergeleitet.
2. Überprüfen Sie die Verbindungsanfrage und wählen Sie das erforderliche Projekt aus.
3. Wähle das Bestätigungskästchen aus (ich verstehe und vertraue dieser URL).
4. Klicken Sie auf Weitermachen.

Die Verbindung ist nun hergestellt. Claude AI kann mit deiner Wissensdatenbank interagieren, indem die in deinem Projekt aktivierten MCP-Funktionen genutzt werden.

Cursor-IDE

Um MCP in der Cursor-IDE zu verbinden:

1. Cursor-IDE öffnen.
2. Navigiere zu den Einstellungen.
3. Geh zu Tools & MCP.
4. Klicken Sie auf Neuen MCP-Server hinzufügen.

Du wirst zum MCP-Konfigurationsbildschirm weitergeleitet.

1. Fügen Sie die MCP JSON-Konfiguration ein, die aus Document360 kopiert wurde.
2. Spar dir das.

Nach dem Speichern:

1. Zurück zu Cursor-IDE-Einstellungen > Tools & MCP.
2. Finde den konfigurierten MCP-Server.
3. Sobald die Authentifizierung aktiviert ist, klicken Sie auf Verbinden.

Nach der Herstellung der Verbindung:

1. Sie werden auf Document360 weitergeleitet.
2. Überprüfen Sie die Verbindungsanfrage und wählen Sie das erforderliche Projekt aus.
3. Wähle das Bestätigungskästchen aus (ich verstehe und vertraue dieser URL).
4. Klicken Sie auf Weitermachen.

Die Verbindung ist nun hergestellt. Du kannst MCP-Funktionen direkt innerhalb der Cursor-IDE nutzen, um Dokumentation beim Programmieren zu suchen, abzurufen und zu aktualisieren.

Copilot

Um MCP in Copilot-Agenten zu verbinden:

Erstelle einen neuen Agenten

1. Melde dich in deiner Copilot-Umgebung an.
2. Navigieren Sie zu Agenten.
3. Klicken Sie auf Leere Agenten erstellen.
4. Geben Sie einen Namen für den Agenten ein.
5. Klicken Sie auf Erstellen.

Du wirst auf den neu erstellten Agenten weitergeleitet.

MCP als Werkzeug hinzufügen

1. Auf der Agentenseite navigieren Sie zum Reiter Tools in der oberen Navigationsleiste.
2. Klicken Sie auf Tool hinzufügen.
3. Wählen Sie Model Context Protocol.

MCP-Einstellungen konfigurieren

1. Geben Sie folgende Details ein:
   • Name – Geben Sie einen Namen für den MCP-Stecker an
   • Beschreibung – Geben Sie eine Beschreibung ein (mindestens 30 Zeichen)
   • URL – Füge die passende MCP-Server-URL ein
2. Wählen Sie unter Authentifizierungsmethode OAuth 2.0 aus.
3. Stellen Sie sicher, dass die dynamische Entdeckung standardmäßig ausgewählt ist.
4. Klicken Sie auf Erstellen.

Verbindung herstellen

1. Nach der Erstellung des Tools erscheint ein Verbindungsbildschirm , der Nicht verbunden zeigt.
2. Klicken Sie auf Nicht verbunden.
3. Wählen Sie Neue Verbindung erstellen.
4. Klicken Sie auf Erstellen.

Nach der Herstellung der Verbindung:

1. Sie werden auf Document360 weitergeleitet.
2. Überprüfen Sie die Verbindungsanfrage und wählen Sie das erforderliche Projekt aus.
3. Wähle das Bestätigungskästchen aus (ich verstehe und vertraue dieser URL).
4. Klicken Sie auf Weitermachen.

Die Verbindung ist nun hergestellt. Ein Copilot-Agent kann mit deiner Wissensdatenbank interagieren, indem du die in deinem Projekt aktivierten MCP-Funktionen nutzt.

HINWEIS

Die MCP-Unterstützung kann je nach verwendetem KI-Assistenten oder Client variieren (wie IDE-basierte Assistenten oder experimentelle Werkzeuge). Einige Plattformen bieten begrenzte oder sich entwickelnde Unterstützung für MCP-Fähigkeiten. Die verfügbaren Felder und die Benutzeroberfläche können je nach KI-Plattform leicht variieren. Siehe die Dokumentation deines KI-Assistenten für Details zur Kompatibilität.

Nach der Verbindung

Nach einer erfolgreichen Verbindung können Sie MCP-unterstützte Funktionen über Ihren KI-Assistenten nutzen, darunter:

• Durchsuchung von Dokumentationen über Projektversionen und Sprachen hinweg
• Abruf des vollständigen Artikelinhalts nach ID oder URL
• Erstellung neuer Artikel und Kategorien (sofern Schreibberechtigungen konfiguriert sind)
• Aktualisierung bestehender Artikel bei Beibehaltung von Struktur und Formatierung

Alle Interaktionen respektieren Ihre bestehende Konfiguration, einschließlich Projektversionen, Sprachen und Sichtbarkeitsregeln. Eine ausführliche Erklärung der verfügbaren MCP-Funktionen und deren Funktionsweise in Document360 finden Sie im Artikel zu Supported MCP Tools .

Überprüfen Sie die MCP-Verbindung

Nachdem du MCP in deinem KI-Assistenten konfiguriert hast, kannst du die Verbindung überprüfen.

1. Öffne deinen KI-Assistenten.
2. Fang ein neues Gespräch an.
3. Geben Sie eine Abfrage im Zusammenhang mit Ihrer Dokumentation ein.

Zum Beispiel:

• Fragen Sie nach Details zu einem bestimmten Merkmal.
• Suche und rufe Inhalte aus einer bestimmten Projektversion oder -sprache ab.
• Bitte sie, einen Artikel in einer bestimmten Kategorie in Document360 zu schreiben.

Wenn die Verbindung erfolgreich ist, liefert der KI-Assistent Ergebnisse, die aus Ihrer Document360-Wissensdatenbank stammen.
Wenn keine Ergebnisse zurückgegeben werden oder ein Fehler auftritt, überprüfen Sie:

• MCP ist in Document360 aktiviert.
• Die JSON-Konfiguration wurde korrekt kopiert.
• Der Connector ist in deinem KI-Assistenten aktiv.

Wenn das Problem weiterhin besteht, authentifizieren Sie sich erneut, indem Sie den MCP-Anschluss ab- und wieder anschließen, oder kontaktieren Sie den Document360-Support.

HINWEIS

Der KI-Assistent kann nur auf Inhalte zugreifen, die durch die Version, die Sprache und die Sichtbarkeitseinstellungen Ihres Projekts erlaubt sind.

Deaktivieren Sie MCP

Um MCP zu deaktivieren:

1. Navigiere in der linken Navigationsleiste zu () ().
2. Gehe zu den KI-Einstellungen > MCP.
3. Klicken Sie auf MCP deaktivieren.
4. Bestätigen Sie die Aktion im erschienenen Dialog.

Sobald sie deaktiviert sind, hören alle aktiven MCP-Verbindungen auf zu funktionieren und bestehende Sitzungen werden beendet. Zugangstoken werden ebenfalls widerrufen. Wenn du MCP wieder aktivierst, müssen sich verbundene KI-Assistenten wieder verbinden.

FAQ