Collega l'MCP dell'area di lavoro Notiondesk a Codex per esaminare le informazioni dell'area di lavoro ed eseguire le azioni supportate da Notiondesk tramite la CLI di Codex o l'estensione IDE.
Notiondesk viene eseguito come server MCP remoto e utilizza OAuth per autenticare il tuo account Notiondesk.
Prima di iniziare
Assicurarsi:
- Workspace MCP è abilitato per almeno un centro assistenza Notiondesk
- Puoi accedere allo spazio di lavoro Notiondesk a cui vuoi connetterti
- Codex è installato e in esecuzione sul tuo computer.
Se Workspace MCP non è ancora abilitato, vedere Abilitare Workspace MCP in Notiondesk .
Aggiungi Notiondesk MCP al Codex
Correre:
Questo aggiunge il server Workspace MCP Notiondesk alla configurazione di Codex.
Autenticati con Notiondesk
Dopo aver aggiunto il server, eseguire:
Il tuo browser apre la pagina di autorizzazione OAuth Notiondesk.
Poi:
codex mcp add notiondesk --url https://mcp.notiondesk.so/mcpcodex mcp login notiondesk- Accedi a Notiondesk se necessario.
- Verificare che venga visualizzato lo spazio di lavoro corretto.
- Esamina le autorizzazioni richieste.
- Approva la connessione.
- Torna al Codex.
Non è necessario aggiungere manualmente una chiave API, una password o un token Notiondesk.
L'autenticazione viene gestita tramite OAuth.
Verifica la connessione
Verifica la configurazione dei tuoi server MCP:
Verificare che notiondesk sia presente e abilitato.
A questo punto puoi avviare Codex:
Inizia con una richiesta di sola lettura:
Verifica che vengano visualizzati i centri di assistenza previsti.
Allora prova:
Iniziare con richieste di sola lettura semplifica la verifica della corretta connessione di Codex all'area di lavoro Notiondesk prima di eseguire qualsiasi azione.
Utilizzare Workspace MCP da Codex
Una volta connesso, Codex può utilizzare gli strumenti Notiondesk disponibili quando sono pertinenti al tuo compito.
Per esempio:
O:
Se il tuo ruolo Notiondesk consente modifiche supportate, puoi anche chiedere a Codex di eseguire delle azioni:
Le azioni disponibili dipendono dal tuo ruolo Notiondesk e dai centri di assistenza a cui puoi accedere.
Utilizzare Notiondesk MCP dall'estensione Codex IDE
Codex condivide la sua configurazione MCP tra la CLI e le integrazioni IDE supportate.
Dopo aver configurato Notiondesk con:
Lo stesso server MCP può essere reso disponibile tramite l'estensione Codex IDE.
codex mcp listcodexList 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/mcpSe l'estensione era già aperta quando hai aggiunto il server, ricaricala se Notiondesk non viene visualizzato.
Ogni connessione Notiondesk autenticata continua a seguire le autorizzazioni del tuo spazio di lavoro.
Configurare manualmente Notiondesk
Codex memorizza la sua configurazione MCP in:
È possibile configurare Notiondesk manualmente con:
Dopo aver salvato la configurazione, autenticati con:
Utilizzare codex mcp add è solitamente più semplice che modificare manualmente la configurazione.
Collaborare con più centri di assistenza
Una singola connessione Codex consente di accedere a più centri di assistenza Notiondesk.
Il centro assistenza è disponibile quando:
~/.codex/config.toml[mcp_servers.notiondesk]
url = "https://mcp.notiondesk.so/mcp"codex mcp login notiondesk- L'area di lavoro MCP è abilitata per questo
- Il tuo account Notiondesk ha accesso a
Non è necessario configurare un server MCP separato per ogni centro assistenza.
Quando sono disponibili più centri di assistenza, specificare con quale Codex deve collaborare:
Autorizzazioni
Workspace MCP segue le autorizzazioni dell'account Notiondesk utilizzato durante l'autorizzazione OAuth.
Per esempio:
Check the French translation status for the Developer Docs help center.- Gli spettatori possono accedere alle informazioni di sola lettura supportate
- Gli editor possono eseguire azioni di gestione supportate
- Gli amministratori e i proprietari degli spazi di lavoro possono accedere ad azioni amministrative aggiuntive
Collegare Notiondesk a Codex non conferisce al tuo account ulteriori autorizzazioni Notiondesk.
Risoluzione dei problemi
Notiondesk non compare nel Codex
Correre:
Verificare che sia presente notiondesk.
Se il problema persiste, aggiungi nuovamente il server:
codex mcp listcodex mcp add notiondesk --url https://mcp.notiondesk.so/mcp Notiondesk è configurato ma non autenticato
Correre:
L'aggiunta del server MCP e il completamento dell'autenticazione OAuth sono passaggi distinti.
codex mcp login notiondesk L'autenticazione OAuth non si apre
Conferma che l'URL di Workspace MCP sia:
Quindi riprova:
Non aggiungere /sse all'URL dell'MCP dell'area di lavoro.
https://mcp.notiondesk.so/mcpcodex mcp login notiondesk Manca un centro di assistenza.
Confermare quanto segue:
- L'area di lavoro MCP è abilitata per quel centro assistenza.
- Il tuo account Notiondesk ha accesso a questo contenuto.
Codex non può accedere a un centro assistenza non disponibile per l'account Notiondesk utilizzato durante l'autorizzazione OAuth.
Alcuni strumenti Notiondesk non sono disponibili
Workspace MCP segue il tuo ruolo Notiondesk.
Se Codex è in grado di leggere le informazioni dell'area di lavoro ma non può eseguire alcuna azione, il tuo account potrebbe non disporre delle autorizzazioni necessarie.
Per maggiori dettagli, consultare la sezione Ruoli, autorizzazioni e sicurezza di Workspace MCP .
Il server appare in codex mcp list ma non è disponibile in una sessione
codex mcp list ma non è disponibile in una sessioneDopo aver configurato il server MCP, avviare una nuova sessione Codex.
Se utilizzi l'estensione IDE, ricaricala dopo aver modificato la configurazione di MCP.
Rimuovere Notiondesk MCP
Per rimuovere la connessione da Codex, utilizzare i comandi di gestione MCP disponibili nella versione di Codex installata.
È inoltre possibile rimuovere la voce notiondesk da:
La rimozione della connessione Codex non disabilita Workspace MCP in Notiondesk e non influisce su altri client AI o compagni di squadra.
~/.codex/config.toml