È possibile connettere Notiondesk Workspace MCP a qualsiasi client AI compatibile che supporti server MCP remoti e autenticazione OAuth .
Utilizza questa guida quando il tuo client MCP non dispone di una guida di installazione dedicata 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
- Il tuo client MCP supporta server MCP HTTP remoti.
- Il tuo client MCP supporta l'autenticazione OAuth.
Se Workspace MCP non è ancora abilitato, vedere Abilitare Workspace MCP in Notiondesk .
Dettagli di connessione
Utilizza questi dettagli quando aggiungi Notiondesk al tuo client MCP:
Non aggiungere /sse all'URL.
L'endpoint di Workspace MCP è:
Aggiungi il server MCP
Apri le impostazioni MCP o del connettore del tuo client AI.
L'interfaccia esatta dipende dal client, ma in genere sarà necessario:
Name: Notiondesk MCP
URL: https://mcp.notiondesk.so/mcp
Authentication: OAuthhttps://mcp.notiondesk.so/mcp- Aggiungi un nuovo server MCP remoto
- Inserisci Notiondesk MCP come nome
- Inserisci
https://mcp.notiondesk.so/mcpcome URL del server
- Seleziona l'autenticazione OAuth se il tuo client richiede un metodo di autenticazione
- Salva o connetti il server
Se il client MCP utilizza un file di configurazione anziché un'interfaccia di impostazioni, aggiungi Notiondesk come server MCP HTTP remoto utilizzando lo stesso URL.
Consulta la documentazione MCP del tuo cliente per conoscere il formato di configurazione esatto.
Autenticati con Notiondesk
Dopo aver aggiunto il server, avviare il flusso di connessione o di autenticazione.
Il tuo client dovrebbe aprire Notiondesk nel tuo browser.
Poi:
- Accedi a Notiondesk se necessario
- Verificare che venga visualizzato lo spazio di lavoro corretto.
- Esamina le autorizzazioni richieste
- Approva la connessione
- Torna al tuo client MCP
Workspace MCP utilizza OAuth, quindi non è necessario copiare manualmente una password o una chiave API nel client MCP.
Verifica la connessione
Inizia con una richiesta di sola lettura:
Verifica che vengano visualizzati i centri di assistenza previsti.
Allora prova:
Puoi anche chiedere:
Iniziare con richieste di sola lettura aiuta a confermare che il client sia connesso all'area di lavoro Notiondesk corretta prima di eseguire qualsiasi azione.
Utilizzare Workspace MCP
Una volta connesso, il tuo client MCP può utilizzare gli strumenti Notiondesk disponibili per il tuo account.
Per esempio:
O:
Se il tuo ruolo Notiondesk consente modifiche supportate, puoi anche richiedere azioni come:
Le modalità esatte con cui il client scopre o richiama gli strumenti MCP dipendono dal client stesso.
Autorizzazioni
L'MCP dell'area di lavoro segue le autorizzazioni del collega Notiondesk che completa l'autorizzazione OAuth.
La connessione tramite un altro client MCP non modifica le autorizzazioni Notiondesk.
Per esempio:
List the Notiondesk help centers I can access.Show the sync status for my main help center.Show me the latest negative article feedback.Review our article feedback and analytics from the last 30 days. Show me which articles need attention first.Check the translation status for my main help center.Trigger a sync for the onboarding collection.- Un visualizzatore riceve accesso in sola lettura supportato.
- Un editor può eseguire azioni di gestione supportate.
- Un amministratore o il proprietario dello spazio di lavoro può accedere ad azioni amministrative aggiuntive.
Il client MCP non può ottenere un livello di accesso superiore a quello già posseduto dal tuo account Notiondesk.
Collaborare con più centri di assistenza
Una singola connessione Workspace MCP può fornire accesso a più centri di assistenza.
Il centro assistenza è disponibile quando:
- L'area di lavoro MCP è abilitata per questo
- Il tuo account Notiondesk ha accesso a
Non è necessario un URL MCP di Workspace diverso per ogni centro assistenza.
Viene utilizzato lo stesso endpoint:
Quando sono disponibili più centri di assistenza, specifica quello che desideri che il tuo assistente utilizzi.
Per esempio:
Risoluzione dei problemi
https://mcp.notiondesk.so/mcpReview article feedback for the Developer Docs help center. Il mio client non riesce a connettersi al server.
Conferma che l'URL del server sia esattamente:
Non utilizzare:
oppure aggiungi /sse all'endpoint.
Il client deve supportare i server MCP remoti.
https://mcp.notiondesk.so/mcphttps://mcp.notiondesk.so/mcp/sse L'autenticazione OAuth non si avvia
Il client MCP deve supportare l'autenticazione OAuth per i server MCP remoti.
Se il client supporta solo server MCP locali, chiavi API o intestazioni statiche, potrebbe non essere compatibile con Workspace MCP.
Verifica la documentazione MCP del tuo cliente.
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.
Workspace MCP non può rendere disponibile un centro assistenza a cui il tuo account non può accedere.
Alcuni strumenti non sono disponibili
Gli strumenti MCP di Workspace disponibili dipendono dal tuo ruolo Notiondesk.
Il tuo client MCP potrebbe inoltre imporre delle restrizioni sugli strumenti utilizzabili.
Per maggiori dettagli, consultare la sezione Ruoli, autorizzazioni e sicurezza di Workspace MCP .
La connessione funziona, ma gli strumenti non vengono utilizzati automaticamente.
La modalità di selezione degli strumenti MCP dipende dal cliente AI.
Alcuni clienti richiedono di:
- Abilita il server MCP per una conversazione
- Selezionare manualmente il connettore
- Abilita l'utilizzo dello strumento
- Approvare le singole azioni
Verifica le impostazioni MCP del tuo client se la connessione Notiondesk è attiva ma i relativi strumenti non sono disponibili nelle conversazioni.