Il server Primo MCP consente agli assistenti AI come ChatGPT, Claude o Cursor di lavorare con i tuoi dati IT di Factorial. Usalo quando vuoi chiedere informazioni o gestire i tuoi dispositivi, dipendenti e ticket in linguaggio semplice dall'assistente che già utilizzi.
Caratteristiche/Funzionalità
Panoramica
MCP (Model Context Protocol) è uno standard aperto. Consente a un assistente AI di collegarsi direttamente a strumenti e dati esterni, inclusi i dati IT di Factorial.
Una volta connesso, il tuo assistente può leggere e agire sul tuo patrimonio IT quando glielo chiedi: elencare dispositivi, trovare dipendenti, gestire accessori, aprire ticket e altro ancora.
Cosa ti serve:
- Un account IT di Factorial con accesso allo spazio di lavoro della tua azienda.
- Un assistente AI che supporta MCP, come ChatGPT, Claude o Cursor.
Il login utilizza OAuth. Quando aggiungi il server, l'assistente ti invia a effettuare il login con il tuo account IT di Factorial. Non è necessaria alcuna chiave API.
URL del server
Il server si trova all'indirizzo:
https://api.getprimo.com/mcpDi default la connessione è sola lettura: l'assistente può visualizzare i dati ma non può modificarli.
Per accesso in scrittura (apertura di ticket, aggiornamento accessori e così via), utilizza invece questo URL:
https://api.getprimo.com/mcp?readOnly=false
Come usare: ChatGPT
- Apri ChatGPT. Il tuo piano deve supportare connettori MCP personalizzati.
- Vai a Impostazioni → App collegate, oppure utilizza il menu "Collega".
- Seleziona Aggiungi server MCP.
- Inserisci
https://api.getprimo.com/mcp. - Effettua il login con il tuo account IT di Factorial quando si apre la pagina OAuth.
- Autorizza la connessione.
Prompt da provare:
- "Elenca tutti i dispositivi gestiti in Factorial IT"
- "Mostrami i dipendenti che si sono uniti questo mese"
- "Quali ticket sono attualmente in attesa?"
Come usare: Claude Desktop
- Apri l'app Claude Desktop.
- Vai a Impostazioni → Sviluppatore → Server MCP.
- Clicca su Aggiungi server.
- Assegna un nome (ad esempio "Factorial IT") e inserisci
https://api.getprimo.com/mcp. - Completa il login OAuth con il tuo account IT di Factorial.
- Salva e riconnetti. Gli strumenti IT di Factorial ora appaiono nella toolbox di Claude.
Come usare: Cursor
- Apri le impostazioni di Cursor.
- Vai a Server MCP.
- Aggiungi un server con l'URL
https://api.getprimo.com/mcp. - Completa il login OAuth con il tuo account IT di Factorial. L'assistente di Cursor potrà quindi utilizzare gli strumenti IT di Factorial.
Come usare: altri assistenti
Qualsiasi app che segue lo standard MCP può connettersi. Puntala a https://api.getprimo.com/mcp e accedi con il tuo account IT di Factorial tramite OAuth.
Più aziende su un solo account
Se il tuo account può accedere a più di un tenant, il server utilizza l'azienda scelta in Azienda MCP predefinita. La trovi nella scheda Aziende di Il mio account, che appare solo quando appartieni a due o più aziende.
Quando non è impostato alcun predefinito, aggiungi il parametro x-company-id all'URL:
https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_IDI parametri possono essere combinati:
https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID&readOnly=falsePer ottenere il tuo ID tenant, elenca le tue aziende tramite l'API o controlla l'URL nella console.
Cosa può fare l'assistente
L'assistente vede solo gli strumenti consentiti dal tuo ruolo. È limitato alle operazioni di lettura fino a quando non ti connetti con readOnly=false.
| Categoria | Operazioni di lettura | Operazioni di scrittura |
|---|---|---|
| Accessori | Elenca e visualizza accessori e i loro campi personalizzati | Crea, aggiorna, assegna e archivia accessori; imposta valori dei campi personalizzati |
| Amministratori | Elenca gli amministratori dell'azienda | Invia email agli amministratori dell'azienda |
| Agenti AI | Elenca agenti e le loro esecuzioni; leggi il rapporto e la trascrizione di un'esecuzione | Crea un agente personalizzato; sostituisci le istruzioni di un agente |
| Dashboard AI | Visualizza un dashboard e le sue istruzioni | Ricompone un dashboard; sostituisce le sue istruzioni |
| Strumenti AI | Visualizza gli strumenti AI trovati sui dispositivi, le scoperte di rischio e le impostazioni degli strumenti AI | Approva o blocca strumenti AI; aggiorna le impostazioni |
| Utilizzo AI | Visualizza l'utilizzo dei crediti AI dell'azienda | — |
| Profili di fatturazione | Elenca profili di fatturazione | — |
| Catalogo | Cerca nel catalogo e visualizza prodotti, preferiti, paesi di spedizione e indirizzi aziendali; visualizza le politiche di attrezzature e acquisti | Fissa e rimuovi i preferiti; aggiorna e pubblica le politiche di attrezzature e acquisti |
| Azienda | Visualizza l'azienda e il suo rapporto sulle metriche | — |
| Conformità | Elenca e cerca avvisi di conformità con il loro contesto di rimedio; visualizza regole di avviso, impostazioni e la politica di rimedio | Crea e aggiorna regole di avviso; aggiorna le impostazioni; aggiorna, pubblica e rimuovi la politica di rimedio |
| Campi personalizzati | Elenca e visualizza campi personalizzati | Crea, aggiorna e archivia campi personalizzati |
| Gruppi di dispositivi | Elenca e visualizza gruppi di dispositivi e come vengono utilizzati; controlla un obiettivo prima di creare un gruppo | Crea, aggiorna ed elimina gruppi di dispositivi |
| Dispositivi | Cerca, conta e visualizza dispositivi con le loro attività, comandi MDM, account locali e campi personalizzati; esporta dispositivi e inventario come CSV | Crea, aggiorna ed elimina dispositivi; blocca, sblocca, cancella (⚠️), riavvia, ritira e disiscrivi; sposta in stock o in uso; esegui uno script; reinvia un profilo; imposta tag e valori dei campi personalizzati |
| Dipendenti | Elenca, cerca e visualizza dipendenti e i loro campi personalizzati | Crea, aggiorna, nascondi e mostra di nuovo dipendenti; invia una richiesta di iscrizione; imposta valori dei campi personalizzati |
| Base di conoscenza | Elenca e visualizza articoli della base di conoscenza | Crea, aggiorna, pubblica, rimuovi e elimina articoli |
| Controlli MDM | Elenca, visualizza e sfoglia il catalogo dei tipi; elenca i controlli che si applicano a un dispositivo | Crea, aggiorna, elimina e aggiorna tag |
| Offboardings | Elenca e visualizza offboarding | — |
| Onboardings | Elenca e visualizza onboarding e le impostazioni di onboarding | Crea, completa e ignora onboarding; esegui i passaggi per dipendenti, account email, attrezzature e SaaS; aggiorna le impostazioni |
| Ordini | Elenca e visualizza ordini e i loro campi personalizzati | Crea ordini e ordini di attrezzature; imposta valori dei campi personalizzati |
| SaaS | Elenca e visualizza SaaS, i loro problemi e le identità di ciascun dipendente; visualizza in anteprima cosa concedono le regole | Provisiona, deprovisiona, crea, collega, archivia ed elimina identità; reimposta una password; gestisci gruppi, ruoli, licenze e unità organizzative; aggiorna contratti, proprietari, stato di approvazione e regole |
| Script | Elenca script salvati e le loro esecuzioni, con il risultato su ciascun dispositivo | Esegui uno script su un obiettivo |
| Spedizioni | Elenca e visualizza spedizioni | Crea una spedizione |
| Software | Visualizza il catalogo software, il software su un dispositivo, stato di installazione e registri, e vulnerabilità CVE | Installa, disinstalla, aggiorna ed elimina software; aggiorna script di installazione; sincronizza il catalogo o un dispositivo |
| Attività | Elenca attività | Crea e programma attività; aggiorna il loro stato e assegnatario |
| Ticket | Elenca, conta e visualizza ticket con i loro abbonati; elenca tag dei ticket | Crea ed elimina ticket; aggiungi commenti; aggiorna stato, priorità, assegnatario e agente AI; gestisci abbonati, oggetti collegati e tag dei ticket |
Fai attenzione con la modalità di scrittura. Alcune azioni non possono essere annullate: cancellare un dispositivo, eliminare permanentemente un'identità SaaS con la sua storia, o eliminare un ticket insieme alle sue attività. Se vuoi mantenere la storia di un ticket, chiedi all'assistente di chiuderlo piuttosto che eliminarlo.
Consigli e migliori pratiche
-
Inizia in sola lettura. Aggiungi
readOnly=falsesolo quando hai realmente bisogno che l'assistente modifichi qualcosa. - Chiudi i ticket invece di eliminarli. Eliminare rimuove il ticket e le sue attività per sempre.
- Controlla due volte prima di una cancellazione. L'assistente può cancellare dispositivi in modalità di scrittura, e una cancellazione non può essere annullata.
-
Imposta un'azienda predefinita se gestisci più aziende. Questo evita di aggiungere
x-company-ida ogni URL e previene risposte dal tenant sbagliato. - Assegna il ruolo corretto. L'assistente ottiene solo gli strumenti consentiti dal tuo ruolo, quindi l'accesso è limitato dalle stesse regole della console.
Risoluzione dei problemi e FAQ
Risoluzione dei problemi
- L'URL mostra "404 Not Found" in un browser. Ciò è previsto. Il server non è una pagina web; è un endpoint per assistenti AI. Aggiungilo come server MCP nel tuo assistente invece.
- Autenticazione non riuscita. Completa il login OAuth quando l'assistente lo richiede. Il tuo account IT di Factorial deve essere attivo e avere accesso all'azienda che vuoi interrogare.
-
L'assistente mostra dati dell'azienda sbagliata. Imposta Azienda MCP predefinita nella scheda Aziende di Il mio account, oppure aggiungi il parametro
x-company-idall'URL. -
L'assistente non può modificare nulla. La connessione è di sola lettura per impostazione predefinita. Riconnettiti con
readOnly=false.
FAQ
-
Ho bisogno di una chiave API?
No. Effettui il login con il tuo account IT di Factorial tramite OAuth.
-
L'assistente può apportare modifiche immediatamente?
No. Inizia in modalità di sola lettura. L'accesso in scrittura richiede l'URLreadOnly=false.
-
L'assistente vedrà tutto nella console?
No. Vede solo gli strumenti consentiti dal tuo ruolo.
-
Dove trovo il mio ID tenant?
Elenca le tue aziende tramite l'API, oppure controlla l'URL nella console.
-
Chi contatto per ricevere aiuto con la configurazione?
Contatta il supporto IT di Factorial o utilizza la chat in-app. La documentazione API è disponibile su api.getprimo.com/apidoc.