Cos’è l’MCP?
Il Model Context Protocol (MCP) è uno standard aperto che consente agli assistenti AI come ChatGPT, Claude o Cursor di connettersi direttamente a strumenti e origini dati esterni, incluso Primo. Con il server MCP Primo, il tuo assistente AI può interrogare e gestire la tua flotta IT in linguaggio naturale: elencare dispositivi, cercare dipendenti, gestire accessori, creare ticket e altro ancora.Prerequisiti
Per utilizzare il server MCP Primo è sufficiente:- Un account Primo con accesso allo spazio di lavoro della tua azienda
- Un assistente AI che supporta MCP (ChatGPT, Claude, Cursor, ecc.)
URL del server MCP
Il server MCP Primo è disponibile all’indirizzo:Guida all’installazione
ChatGPT
- Apri ChatGPT (è richiesto il piano Plus o Team)
- Vai su Impostazioni → App connesse o utilizza il menu “Connetti”
- Seleziona “Aggiungi server MCP”
- Immettere l’URL del server:
https://api.getprimo.com/mcp - Verrai reindirizzato a accedi con il tuo account Primo (OAuth)
- Autorizza la connessione: è tutto pronto!
- “Elenca tutti i dispositivi gestiti in Primo”
- “Mostrami i dipendenti che hanno aderito questo mese”
- “Quali ticket sono attualmente in sospeso?”
Claudio Desktop
- Apri l’app Claude Desktop
- Vai su Impostazioni → Sviluppatore → Server MCP
- Fai clic su “Aggiungi server”
- Inserisci un nome (ad esempio “Primo”) e l’URL:
https://api.getprimo.com/mcp - Completa il flusso di accesso OAuth con il tuo account Primo
- Salva e riconnetti: gli strumenti Primo verranno visualizzati nella casella degli strumenti di Claude
Cursore
- Apri le impostazioni del Cursore
- Passare a Server MCP
- Aggiungi un nuovo server con l’URL:
https://api.getprimo.com/mcp - Completa l’autenticazione OAuth con il tuo account Primo
- Gli strumenti Primo saranno disponibili nell’assistente AI del cursore
Altri client compatibili con MCP
Qualsiasi applicazione che supporti lo standard MCP può connettersi a Primo. Utilizza l’URL del serverhttps://api.getprimo.com/mcp: l’autenticazione viene gestita tramite OAuth.
Supporto multiaziendale
Se la tua organizzazione gestisce più aziende in Primo, per impostazione predefinita il server MCP è quello della tua azienda principale. Per scegliere come target un’azienda specifica, aggiungi il parametrox-company-id all’URL:
Per trovare l’ID della tua azienda, utilizza API per elencare le tue aziende o controlla l’URL nella dashboard Primo.
Cosa puoi fare?
Una volta connesso, il tuo assistente AI può eseguire le seguenti azioni tramite Primo:| Categoria | Operazioni di lettura | Operazioni di scrittura |
|---|---|---|
| Accessori | Elenca e visualizza gli accessori | Crea e aggiorna gli accessori |
| Azienda | Visualizza i dettagli dell’azienda autenticata | — |
| Dispositivi | Elenca, cerca e visualizza i dettagli dei dispositivi | Crea, blocca, sblocca, cancella (⚠️) |
| Gruppi dispositivi | Elenca e visualizza i gruppi di dispositivi | — |
| Dipendenti | Elenca e visualizza i profili dei dipendenti | Crea dipendenti |
| Controlli MDM | Elenca e visualizza i controlli MDM | — |
| SaaS | Elenca e visualizza le applicazioni SaaS | Aggiorna i contratti SaaS |
| Software | Elenca e visualizza i software | — |
| Ticket | Elenca, cerca, filtra e visualizza i ticket | Crea ticket, aggiungi commenti, aggiorna stato/priorità/assegnatario |
Risoluzione dei problemi
“404 Not Found” quando si apre l’URL in un browser Questo è normale. Il server MCP non è una pagina Web: è un endpoint di protocollo progettato per essere utilizzato dagli assistenti AI. Aggiungilo come server MCP nel tuo client preferito. Errore di autenticazione Assicurati di completare il flusso di accesso OAuth quando richiesto. Hai bisogno di un account Primo attivo con accesso all’azienda che desideri interrogare. Dati provenienti dall’azienda sbagliata Se gestisci più aziende, specifica l’azienda di destinazione utilizzando il parametrox-company-id (vedi Supporto multiaziendale sopra).