Verbinden Sie den Arbeitsbereich Notiondesk (MCP) mit Codex

Verbinden Sie den Workspace MCP mit Codex, um Workspace-Informationen einzusehen und unterstützte Aktionen über die Codex-Befehlszeilenschnittstelle oder die IDE-Erweiterung durchzuführen.

Notiondesk fungiert als Remote-MCP-Server und verwendet OAuth zur Authentifizierung Ihres Notiondesk-Kontos.

Bevor Sie beginnen

Stellen Sie sicher:

• Workspace MCP ist für mindestens ein Notiondesk Hilfezentrum aktiviert

• Sie können sich bei dem Notiondesk-Arbeitsbereich anmelden, mit dem Sie sich verbinden möchten.

• Codex ist auf Ihrem Computer installiert und funktioniert.

Falls Workspace MCP noch nicht aktiviert ist, siehe Workspace MCP aktivieren in Notiondesk .

Füge Notiondesk MCP zum Codex hinzu

Laufen:

Dadurch wird der Workspace MCP-Server Notiondesk zu Ihrer Codex-Konfiguration hinzugefügt.

Authentifizieren Sie sich mit Notiondesk

Nach dem Hinzufügen des Servers führen Sie Folgendes aus:

Ihr Browser öffnet die OAuth-Autorisierungsseite Notiondesk.

Dann:

codex mcp add notiondesk --url https://mcp.notiondesk.so/mcp

codex mcp login notiondesk

1. Melden Sie sich bei Bedarf bei Notiondesk an.

2. Vergewissern Sie sich, dass der richtige Arbeitsbereich angezeigt wird.

3. Überprüfen Sie die angeforderten Berechtigungen.

4. Verbindung genehmigen.

5. Zurück zum Codex.

Sie müssen keinen Notiondesk API-Schlüssel, kein Passwort oder kein Token manuell hinzufügen.

Die Authentifizierung erfolgt über OAuth.

Überprüfen Sie die Verbindung.

Überprüfen Sie Ihre konfigurierten MCP-Server:

Vergewissern Sie sich, dass notiondesk angezeigt und aktiviert ist.

Anschließend können Sie Codex starten:

Beginnen Sie mit einer Anfrage mit Lesezugriff:

Prüfen Sie, ob die erwarteten Hilfezentren angezeigt werden.

Dann versuchen Sie Folgendes:

Durch das Starten mit reinen Leseanfragen lässt sich leichter bestätigen, dass Codex mit dem richtigen Notiondesk-Arbeitsbereich verbunden ist, bevor Aktionen ausgeführt werden.

Verwenden Sie Workspace MCP aus Codex

Sobald die Verbindung hergestellt ist, kann Codex die verfügbaren Notiondesk-Tools nutzen, wenn diese für Ihre Aufgabe relevant sind.

Zum Beispiel:

Oder:

Wenn Ihre Notiondesk-Rolle unterstützte Änderungen zulässt, können Sie Codex auch anweisen, Aktionen auszuführen:

Die verfügbaren Aktionen hängen von Ihrer Notiondesk Rolle und den Hilfezentren ab, auf die Sie Zugriff haben.

Verwenden Sie Notiondesk MCP aus der Codex IDE-Erweiterung

Codex teilt seine MCP-Konfiguration zwischen der CLI und den unterstützten IDE-Integrationen.

Nach der Konfiguration von Notiondesk mit:

Derselbe MCP-Server ist auch über die Codex IDE-Erweiterung verfügbar.

codex mcp list

codex

List the Notiondesk help centers I can access.

Show the sync status for my main help center.

Review the last 30 days of article feedback and analytics. Show me which documentation needs attention first.

Review recent chatbot conversations and identify repeated customer questions that are not covered well by our documentation.

Trigger a sync for the onboarding collection.

codex mcp add notiondesk --url https://mcp.notiondesk.so/mcp

Wenn die Erweiterung bereits geöffnet war, als Sie den Server hinzugefügt haben, laden Sie sie neu, falls Notiondesk nicht angezeigt wird.

Jede authentifizierte Notiondesk-Verbindung folgt weiterhin den Berechtigungen Ihres eigenen Arbeitsbereichs.

Notiondesk manuell konfigurieren

Codex speichert seine MCP-Konfiguration in:

Sie können Notiondesk manuell konfigurieren mit:

Nach dem Speichern der Konfiguration authentifizieren Sie sich mit:

Die Verwendung von codex mcp add ist in der Regel einfacher als die manuelle Bearbeitung der Konfiguration.

Arbeiten Sie mit mehreren Hilfezentren zusammen

Eine Codex-Verbindung kann auf mehrere Notiondesk Hilfezentren zugreifen.

Ein Hilfecenter ist verfügbar, wenn:

~/.codex/config.toml

[mcp_servers.notiondesk]
url = "https://mcp.notiondesk.so/mcp"

codex mcp login notiondesk

• Workspace MCP ist dafür aktiviert.

• Ihr Notiondesk-Konto hat Zugriff darauf.

Sie müssen nicht für jedes Hilfezentrum einen separaten MCP-Server konfigurieren.

Wenn mehrere Hilfezentren verfügbar sind, geben Sie an, mit welchem ​​Codex arbeiten soll:

Berechtigungen

Workspace MCP richtet sich nach den Berechtigungen des Kontos Notiondesk, das während der OAuth-Autorisierung verwendet wurde.

Zum Beispiel:

Check the French translation status for the Developer Docs help center.

• Betrachter können auf unterstützte, schreibgeschützte Informationen zugreifen.

• Redakteure können unterstützte Verwaltungsaktionen durchführen.

• Administratoren und Workspace-Inhaber können auf zusätzliche administrative Aktionen zugreifen.

Durch die Verbindung von Notiondesk mit Codex erhält Ihr Konto keine zusätzlichen Notiondesk Berechtigungen.

Fehlerbehebung

codex mcp list

codex mcp add notiondesk --url https://mcp.notiondesk.so/mcp

codex mcp login notiondesk

https://mcp.notiondesk.so/mcp

codex mcp login notiondesk

Entfernen Sie Notiondesk MCP

Um die Verbindung zu Codex zu entfernen, verwenden Sie die in Ihrer installierten Codex-Version verfügbaren MCP-Verwaltungsbefehle.

Sie können auch den Eintrag notiondesk entfernen aus:

Das Entfernen der Codex-Verbindung deaktiviert Workspace MCP in Notiondesk nicht und hat keine Auswirkungen auf andere KI-Clients oder Teammitglieder.

~/.codex/config.toml