Collega l'MCP dell'area di lavoro Notiondesk a Claude Code per visualizzare le informazioni sull'area di lavoro ed eseguire le azioni supportate di Notiondesk direttamente dal tuo terminale.
Claude Code si connette a Notiondesk come server HTTP MCP remoto e si autentica tramite OAuth.
Prima di iniziare
Assicurarsi:
- Workspace MCP è abilitato per almeno un centro assistenza Notiondesk
- Puoi accedere allo spazio di lavoro Notiondesk a cui vuoi connetterti
- Claude Code è installato e funzionante sul tuo computer.
Se Workspace MCP non è ancora abilitato, vedere Abilitare Workspace MCP in Notiondesk .
Aggiungi Notiondesk MCP al codice Claude
Correre:
Questo aggiunge il server Workspace MCP Notiondesk a Claude Code.
Rendi Notiondesk disponibile in tutti i progetti
Se desideri utilizzare Notiondesk MCP da ogni progetto Claude Code, aggiungilo con ambito utente:
Utilizza l'ambito di progetto o locale se desideri che la connessione sia disponibile solo in uno specifico ambiente di sviluppo.
Autenticati con Notiondesk
Dopo aver aggiunto il server, avviare Claude Code:
Quindi inserisci:
Seleziona il server notiondesk e avvia il flusso di autenticazione.
Claude Code apre Notiondesk nel tuo browser.
Poi:
claude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcpclaude mcp add --transport http --scope user notiondesk https://mcp.notiondesk.so/mcpclaude/mcp- Accedi a Notiondesk se necessario.
- Verificare che venga visualizzato lo spazio di lavoro corretto.
- Esamina le autorizzazioni richieste.
- Approva la connessione.
- Torna al Codice Claude.
Claude Code memorizza l'autenticazione OAuth per la connessione e può aggiornarla quando necessario.
Verifica il server MCP
È possibile verificare la configurazione dei server MCP dal terminale:
È inoltre possibile ispezionare il server Notiondesk:
Avvia quindi Claude Code e verifica la connessione con:
Verifica che vengano visualizzati i centri di assistenza previsti.
Successivamente, prova:
Iniziare con richieste di sola lettura aiuta a confermare che Claude Code è connesso allo spazio di lavoro corretto Notiondesk.
Utilizzare Notiondesk dal codice Claude
Una volta connesso, Claude Code può utilizzare gli strumenti Notiondesk disponibili quando sono pertinenti alla tua richiesta.
Per esempio:
O:
Se il tuo ruolo Notiondesk consente modifiche, puoi anche chiedere a Claude Code di eseguire azioni supportate:
Le azioni disponibili per Claude Code dipendono dalle autorizzazioni del tuo spazio di lavoro Notiondesk.
Collaborare con più centri di assistenza
La stessa connessione Claude Code può accedere a più centri di assistenza Notiondesk.
Il centro assistenza è disponibile quando:
claude mcp listclaude mcp get notiondeskList the Notiondesk help centers I can access.Show the sync status for my main help center.Review recent article feedback and search analytics. Show me which documentation needs attention first.Review recent chatbot conversations and identify repeated questions that are not covered well by our help center.Trigger a sync for the onboarding collection.- L'area di lavoro MCP è abilitata per questo scopo.
- Il tuo account Notiondesk ha accesso a questo contenuto.
Non è necessario configurare un server MCP separato per ogni centro assistenza.
Quando sono disponibili più centri di assistenza, specifica quello che desideri che Claude Code utilizzi.
Per esempio:
Scegli l'ambito corretto del Codice Claude
Claude Code supporta diversi ambiti per i server MCP.
Ambito locale
L'ambito locale è quello predefinito.
Utilizzalo quando hai bisogno solo di Notiondesk MCP nel progetto corrente.
Ambito del progetto
Utilizzare l'ambito di progetto quando la configurazione MCP deve essere condivisa con i colleghi tramite la configurazione .mcp.json del progetto.
Ogni membro della squadra si autentica ancora con il proprio account Notiondesk.
Non condividere le credenziali OAuth con i tuoi colleghi.
Ambito utente
Utilizza l'ambito utente quando desideri che Notiondesk sia disponibile in tutti i progetti di Claude Code sul tuo computer:
Per la maggior parte delle persone che gestiscono regolarmente Notiondesk da Claude Code, l'ambito utente è l'opzione più conveniente.
Autorizzazioni
L'MCP dell'area di lavoro segue le autorizzazioni del collega Notiondesk che completa l'autorizzazione OAuth.
Per esempio:
Check the French translation status for the Developer Docs help center.claude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcpclaude mcp add --transport http --scope project notiondesk https://mcp.notiondesk.so/mcpclaude mcp add --transport http --scope user notiondesk https://mcp.notiondesk.so/mcp- Un visualizzatore può utilizzare strumenti di sola lettura supportati
- Un editor può accedere alle azioni di gestione supportate
- Un amministratore o il proprietario dello spazio di lavoro può accedere ad azioni amministrative aggiuntive
L'aggiunta dell'MCP Notiondesk a un progetto condiviso non comporta la condivisione delle autorizzazioni Notiondesk di un membro del team con tutti gli altri.
Ciascun membro della squadra si autentica separatamente.
Risoluzione dei problemi
Claude Code non riesce a trovare il server MCP Notiondesk
Correre:
Verificare che sia presente notiondesk.
Se non funziona, aggiungilo di nuovo:
claude mcp listclaude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcp L'autenticazione OAuth non si avvia
Apri Claude Code e inserisci:
Seleziona il server Notiondesk e avvia l'autenticazione.
Se il tuo browser non si apre automaticamente, Claude Code potrebbe fornirti un URL che puoi aprire manualmente.
/mcp Il server Notiondesk è stato aggiunto ma non autenticato
Utilizzo:
Quindi seleziona il server Notiondesk e completa il flusso OAuth.
L'aggiunta del server MCP e l'autenticazione del tuo account Notiondesk sono passaggi separati.
/mcp 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
Claude Code non può accedere a un centro assistenza non disponibile per l'account utilizzato durante l'autorizzazione OAuth.
Alcune azioni non sono disponibili
Workspace MCP segue il tuo ruolo Notiondesk.
Se Claude Code è in grado di leggere le informazioni ma non può eseguire una determinata azione, il tuo account potrebbe non disporre delle autorizzazioni necessarie.
Per maggiori dettagli, consultare la sezione Ruoli, autorizzazioni e sicurezza di Workspace MCP .
L'autenticazione smette di funzionare
Aprire:
Seleziona il server Notiondesk e autenticati di nuovo.
È inoltre possibile cancellare l'autenticazione esistente dal menu MCP prima di riconnettersi.
/mcpRimuovere Notiondesk MCP
Per rimuovere il server da Claude Code:
La rimozione del server da Claude Code non disabilita Workspace MCP in Notiondesk e non influisce sulle connessioni provenienti da altri client AI.
claude mcp remove notiondesk