Skip to main content

Cos’è MCP?

Il Model Context Protocol (MCP) è uno standard aperto che permette agli assistenti IA di connettersi a strumenti e fonti di dati esterni. Jarvi espone un server MCP così puoi usare assistenti IA per cercare, leggere e aggiornare i tuoi dati Jarvi direttamente.

Client compatibili

Qualsiasi client compatibile con MCP può connettersi a Jarvi, tra cui:

Configurazione

Claude

  1. In Claude, sul web o nell’app desktop, apri Customize > Connectors.
  2. Fai clic su + Add e poi su Add custom connector.
  3. Inserisci il nome Jarvi e l’URL https://mcp.jarvi.tech, poi fai clic su Continue e Add mantenendo le impostazioni di autenticazione predefinite.
  4. Accedi con il tuo account Jarvi nella finestra che si apre (OAuth2).
  5. In una conversazione, fai clic su + poi su Connectors e attiva Jarvi.
Piani Team ed Enterprise: un proprietario dell’organizzazione aggiunge prima il connettore in Organization settings > Connectors (Add > Custom > Web). Ogni membro fa poi clic su Connect accanto a Jarvi in Customize > Connectors. Il piano gratuito di Claude consente un solo connettore personalizzato.

ChatGPT

  1. In ChatGPT sul web, apri Impostazioni > Sicurezza e accesso e attiva la Modalità sviluppatore.
  2. In Plugins, fai clic su + e crea un’app che punta a https://mcp.jarvi.tech, con autenticazione OAuth.
  3. Autorizza l’accesso con il tuo account Jarvi.
  4. In una conversazione, attiva Jarvi dal menu Modalità sviluppatore.
Disponibile sui piani Plus, Pro, Business, Enterprise ed Edu, solo sul web. ChatGPT usa solo OAuth: la chiave API privata non funziona con lui.

Altri client

Per i client che non supportano OAuth2, utilizza una chiave API privata:
  • Trasporto: Streamable HTTP
  • URL: https://mcp.jarvi.tech
  • Autenticazione: header x-api-key con la tua chiave API privata
La tua chiave privata garantisce accesso completo ai tuoi dati Jarvi. Non condividerla mai pubblicamente.

Strumenti disponibili

Una volta connesso, i seguenti strumenti sono disponibili per il tuo assistente IA:
Tutte le operazioni vengono eseguite con i tuoi permessi. Si applica la sicurezza a livello di riga — puoi accedere solo ai dati a cui il tuo account ha accesso.

Esempi di prompt

Una volta connesso, prova a chiedere al tuo assistente IA:
  • “Chi sono?”
  • “Cerca sviluppatori React a Parigi”
  • “Mostrami i dettagli del progetto X”
  • “Crea un profilo per Jean Dupont, sviluppatore”
  • “Posiziona questo candidato sul progetto X”
  • “Imposta lo stato dell’azienda Acme su Qualificato”
  • “Quali campi personalizzati esistono sui profili?”
  • “Annota una chiamata con Jean Dupont: discusso della sua disponibilità”
  • “Ricordami di ricontattare Acme lunedì prossimo”
  • “Aggiorna il titolo di Jean Dupont in Sviluppatore Senior”

Limitazioni

  • Si applicano gli stessi limiti di utilizzo, calcolati sul tempo di esecuzione cumulato. Se ti serve di più, contatta il nostro supporto.
  • Le operazioni di eliminazione sono bloccate — usa l’eliminazione soft (aggiornamento di deletedAt) invece.
  • Le risposte troppo voluminose vengono automaticamente troncate. Usa argomenti limit nelle tue richieste.
  • Gli strumenti distruttivi (mutazioni, lancio di campagne, reinvio di messaggi) richiedono una conferma dell’assistente IA prima dell’esecuzione.