Setup Cursor

Cursor supporta i server MCP tramite file di configurazione dedicato. Una volta configurato, il server @pzeta/vue-components Docs e' disponibile nel pannello AI di Cursor per rispondere a domande sui componenti.

Configurazione tramite file .cursor/mcp.json

Crea il file .cursor/mcp.json nella root del tuo progetto:

{
  "mcpServers": {
    "vue-components-docs": {
      "type": "http",
      "url": "https://docscomp.pzeta.it/mcp"
    }
  }
}

Riavvia Cursor dopo aver creato il file. Il server apparira' nella lista dei server MCP attivi in Settings > MCP.

Configurazione globale

Per usare il server in tutti i progetti Cursor, aggiungi la configurazione nel file globale ~/.cursor/mcp.json:

{
  "mcpServers": {
    "vue-components-docs": {
      "type": "http",
      "url": "https://docscomp.pzeta.it/mcp"
    }
  }
}

Sviluppo locale

Se la documentazione gira in locale (ad esempio per documentare una branch feature):

{
  "mcpServers": {
    "vue-components-docs": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

Configurazione tramite Settings UI

In alternativa al file JSON, puoi configurare il server direttamente dall'interfaccia:

1. Apri Cursor Settings (Cmd+, / Ctrl+,)
2. Cerca MCP nella barra di ricerca
3. Clicca Add MCP Server
4. Inserisci:
   • Name: vue-components-docs
   • Type: http
   • URL: https://docscomp.pzeta.it/mcp
5. Salva e riavvia Cursor

Verifica della connessione

Vai in Settings > MCP e verifica che vue-components-docs mostri lo stato Connected. Se lo stato e' Error, controlla che l'URL sia raggiungibile e che non ci siano blocchi di rete o proxy aziendali.

Esempi di query nel chat Cursor

Apri il pannello chat di Cursor (Cmd+L / Ctrl+L) e prova queste query:

Quali props accetta il componente Button di @pzeta/vue-components?

Come si configura il tema dark mode nella libreria?

Mostrami come si usa DataTable con selezione multipla e lazy loading.

Quali eventi emette il componente FileUpload?

Cursor combinera' la documentazione MCP con il contesto del file aperto nell'editor. Se hai un componente Vue aperto, puoi chiedere:

Come posso aggiungere un Dialog di conferma prima del salvataggio in questo componente?

Il modello consultara' la documentazione di Dialog e useConfirm e suggeriria il codice appropriato nel contesto del tuo file.

Note

• Cursor utilizza il protocollo MCP per arricchire il contesto delle risposte; non e' necessario citare esplicitamente il server nelle query.
• Se il server non risponde, verifica la connettivita' all'URL https://docscomp.pzeta.it/mcp dal browser.
• In ambienti con proxy aziendale, potrebbe essere necessario configurare le variabili HTTP_PROXY / HTTPS_PROXY nell'ambiente di Cursor.