Collega l'area di lavoro MCP Notiondesk a VS Code

Collega l'area di lavoro Notiondesk MCP a VS Code tramite installazione con un clic o mcp.json, quindi autenticati in modo sicuro con OAuth.

4 min di lettura

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.

  1. Apri la tua dashboard Notiondesk
  1. Seleziona un centro assistenza in cui Workspace MCP è abilitato.
  1. Vai su Impostazioni → Generali
  1. Individua la sezione Workspace MCP
  1. Apri Installa nel tuo client
  1. Seleziona VS Code
  1. Fai clic su Aggiungi a VS Code

VS Code apre i dettagli del server MCP Notiondesk.

  1. Verifica il nome del server e l'URL
  1. Fare clic su Installa
  1. Avvia il server se VS Code te lo chiede
  1. 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 Server
https://mcp.notiondesk.so/mcp
MCP: List Servers

Notiondesk si apre nel tuo browser.

Poi:

  1. Accedi a Notiondesk se necessario
  1. Verificare che venga visualizzato lo spazio di lavoro corretto.
  1. Esamina le autorizzazioni richieste
  1. Approva la connessione
  1. 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

Articoli correlati

Questa pagina è stata utile?