Collega il pannello di controllo MCP dell'area di lavoro Notiondesk a Visual Studio Code per accedere alla tua area di lavoro Notiondesk dagli strumenti di intelligenza artificiale di VS Code.
È possibile installare la connessione direttamente da Notiondesk oppure configurare manualmente il server MCP remoto.
Workspace MCP utilizza OAuth e segue le autorizzazioni del collega Notiondesk che autorizza la connessione.
Prima di iniziare
Assicurarsi:
- Workspace MCP è abilitato per almeno un centro assistenza Notiondesk
- Puoi accedere allo spazio di lavoro Notiondesk a cui vuoi connetterti
- Stai utilizzando una versione di VS Code con supporto MCP
Se Workspace MCP non è ancora abilitato, vedere Abilitare Workspace MCP in Notiondesk .
Collega Notiondesk dalla dashboard
La configurazione più semplice inizia da Notiondesk.
- Apri la tua dashboard Notiondesk
- Seleziona un centro assistenza in cui Workspace MCP è abilitato.
- Vai su Impostazioni → Generali
- Individua la sezione Workspace MCP
- Apri Installa nel tuo client
- Seleziona VS Code
- Fai clic su Aggiungi a VS Code
VS Code apre i dettagli del server MCP Notiondesk.
- Verifica il nome del server e l'URL
- Fare clic su Installa
- Avvia il server se VS Code te lo chiede
- Completa l'autorizzazione OAuth Notiondesk nel tuo browser
Una volta completata l'autorizzazione, gli strumenti Notiondesk diventano disponibili in VS Code.
Configurare manualmente l'MCP Notiondesk
È inoltre possibile configurare Workspace MCP con il file mcp.json di VS Code.
Per una connessione specifica del progetto, crea o apri:
Aggiungere:
Salva il file.
VS Code dovrebbe rilevare il nuovo server MCP.
Rendi Notiondesk disponibile in tutti i progetti
Se utilizzi Notiondesk regolarmente in diversi progetti, puoi aggiungere il server al tuo profilo utente di VS Code anziché a un singolo spazio di lavoro.
Apri la tavolozza dei comandi ed esegui:
Aggiungi il server HTTP remoto:
Seleziona il tuo profilo utente come destinazione della configurazione.
Un server MCP a livello utente è disponibile in tutti i tuoi spazi di lavoro di VS Code.
Avviare il server MCP Notiondesk
Apri la tavolozza dei comandi ed esegui:
Seleziona notiondesk .
Da lì è possibile avviare, arrestare, riavviare o ispezionare il server.
Al primo avvio della connessione, VS Code potrebbe richiedere la conferma dell'autorizzazione a considerare attendibile il server MCP.
Rivedi la configurazione e approvala per continuare.
Autenticati con Notiondesk
Quando VS Code si connette all'MCP dell'area di lavoro Notiondesk, avvia il flusso di autorizzazione OAuth.
.vscode/mcp.json{
"servers": {
"notiondesk": {
"type": "http",
"url": "https://mcp.notiondesk.so/mcp"
}
}
}MCP: Add Serverhttps://mcp.notiondesk.so/mcpMCP: List ServersNotiondesk si apre 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 a VS Code
Verifica la connessione
Inizia con una richiesta di sola lettura in VS Code:
Verificare che vengano restituiti i centri di assistenza previsti.
Allora prova:
Puoi anche chiedere:
O:
Prima di chiedere a VS Code di apportare modifiche, iniziate con richieste di sola lettura.
Utilizzare Workspace MCP da VS Code
Una volta connesso, VS Code può utilizzare gli strumenti Notiondesk disponibili quando sono pertinenti alla tua richiesta.
Per esempio:
Se il tuo ruolo Notiondesk consente azioni supportate, puoi anche chiedere:
Gli strumenti disponibili dipendono dal tuo ruolo Notiondesk e dai centri di assistenza a cui puoi accedere.
Collaborare con più centri di assistenza
La stessa connessione VS Code può accedere a più centri di assistenza Notiondesk.
Il centro assistenza è disponibile quando:
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 recent chatbot conversations and identify repeated customer questions.Review article feedback and help center analytics from the last 30 days. Show me which articles need attention first.Trigger a sync for the onboarding collection.- L'area di lavoro MCP è abilitata per questo
- Il tuo account Notiondesk ha l'autorizzazione ad accedervi
Non è necessaria una configurazione MCP separata per ogni centro assistenza.
Quando si utilizza più centri di assistenza, specificare a quale ci si riferisce:
Spazio di lavoro vs configurazione utente
Utilizzare una configurazione dell'area di lavoro quando Notiondesk MCP deve essere configurato solo per un progetto:
Utilizza una configurazione utente quando desideri che Notiondesk MCP sia disponibile in tutti i tuoi spazi di lavoro di VS Code.
Se la configurazione di un'area di lavoro viene salvata nel sistema di controllo della versione, gli altri membri del team possono ricevere la stessa definizione del server MCP, ma ciascuno di essi deve comunque autenticarsi con il proprio account Notiondesk.
Non condividere le credenziali OAuth con i tuoi colleghi.
Risoluzione dei problemi
Check the translation status for the Developer Docs help center..vscode/mcp.json Notiondesk non compare in VS Code
Apri la tavolozza dei comandi ed esegui:
Verificare che il server notiondesk sia presente.
Se la configurazione è stata eseguita manualmente, verifica che il file contenga:
MCP: List Servers{
"servers": {
"notiondesk": {
"type": "http",
"url": "https://mcp.notiondesk.so/mcp"
}
}
} Il server non si avvia
Correre:
Seleziona il server Notiondesk e scegli Mostra output per esaminare i log MCP.
È possibile riavviare il server anche dallo stesso menu.
MCP: List Servers L'autenticazione OAuth non si avvia
Conferma che l'URL del server sia esattamente:
Non aggiungere /sse né modificare l'URL.
Riavvia il server da MCP: Elenca server e riprova l'autenticazione.
https://mcp.notiondesk.so/mcp Manca un centro di assistenza.
Verifica quanto segue:
- L'area di lavoro MCP è abilitata per quel centro assistenza.
- Il tuo account Notiondesk ha accesso a
VS Code non può accedere ai centri di assistenza non disponibili per il collega Notiondesk che ha completato l'autorizzazione.
Mancano alcuni strumenti Notiondesk
Workspace MCP segue il tuo ruolo Notiondesk.
Un utente con ruolo di spettatore non può eseguire le stesse azioni di un editor o di un amministratore.
Per maggiori dettagli, consultare la sezione Ruoli, autorizzazioni e sicurezza di Workspace MCP .
Disconnetti Notiondesk da VS Code
È possibile disabilitare o rimuovere il server MCP Notiondesk da VS Code quando non si desidera più utilizzarlo.
Correre:
Seleziona il server Notiondesk e disabilitalo o rimuovilo.
Se l'hai configurato manualmente, puoi anche rimuovere la voce notiondesk dal tuo mcp.json.
La rimozione della connessione da VS Code non disabilita Workspace MCP in Notiondesk e non influisce su altri client AI o colleghi.
MCP: List Servers