Indietro

Collega un assistente AI al server Primo MCP

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/mcp

Di 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

  1. Apri ChatGPT. Il tuo piano deve supportare connettori MCP personalizzati.
  2. Vai a Impostazioni → App collegate, oppure utilizza il menu "Collega".
  3. Seleziona Aggiungi server MCP.
  4. Inserisci https://api.getprimo.com/mcp.
  5. Effettua il login con il tuo account IT di Factorial quando si apre la pagina OAuth.
  6. 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

  1. Apri l'app Claude Desktop.
  2. Vai a Impostazioni → Sviluppatore → Server MCP.
  3. Clicca su Aggiungi server.
  4. Assegna un nome (ad esempio "Factorial IT") e inserisci https://api.getprimo.com/mcp.
  5. Completa il login OAuth con il tuo account IT di Factorial.
  6. Salva e riconnetti. Gli strumenti IT di Factorial ora appaiono nella toolbox di Claude.

 

Come usare: Cursor

  1. Apri le impostazioni di Cursor.
  2. Vai a Server MCP.
  3. Aggiungi un server con l'URL https://api.getprimo.com/mcp.
  4. 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_ID

I parametri possono essere combinati:

https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID&readOnly=false

Per 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=false solo 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-id a 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-id all'URL.
  • L'assistente non può modificare nulla. La connessione è di sola lettura per impostazione predefinita. Riconnettiti con readOnly=false.

 

FAQ

  1. Ho bisogno di una chiave API?
    No. Effettui il login con il tuo account IT di Factorial tramite OAuth.
     
  2. L'assistente può apportare modifiche immediatamente?
    No. Inizia in modalità di sola lettura. L'accesso in scrittura richiede l'URL readOnly=false.
     
  3. L'assistente vedrà tutto nella console?
    No. Vede solo gli strumenti consentiti dal tuo ruolo.
     
  4. Dove trovo il mio ID tenant?
    Elenca le tue aziende tramite l'API, oppure controlla l'URL nella console.
     
  5. 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.

Questo articolo è stato utile?

Give feedback about this article

Non trovi quello che stai cercando?

Il nostro team di assistenza clienti è qui per te.

Contattaci

Knowledge Base Software powered by Helpjuice