Panoramica di MCP
Il server MCP di UserJot consente agli strumenti di IA di collegarsi direttamente al tuo spazio di lavoro UserJot tramite HTTP remoto, senza dover installare pacchetti locali o processi bridge.
URL del server
UserJot mette a disposizione un endpoint MCP remoto:
https://api.userjot.com/v1/mcpAutenticazione
La maggior parte dei client MCP moderni supporta direttamente l'accesso tramite OAuth. Incolla l'URL del server (oppure usa il pulsante o il comando di installazione con un clic in Impostazioni → MCP & API; VS Code e Gemini CLI si trovano nel menu Altro), accedi a UserJot, scegli la tua area di lavoro e fai clic su Consenti.
Client | Autenticazione consigliata | Guida alla configurazione |
|---|---|---|
Claude (web, desktop, mobile) | OAuth (in un clic da Settings → MCP & API) | |
Claude Code | OAuth (o token API) | |
Cursor | OAuth (in un clic da Settings → MCP & API) o token API | |
Codex | OAuth (o token API) | |
ChatGPT | OAuth (o token API su desktop) | |
VS Code (Copilot) | OAuth (in Altro in Impostazioni → MCP & API) | |
Gemini CLI | OAuth (in Altro in Impostazioni → MCP & API) | |
Windsurf e strumenti headless/CI | Intestazione con token API |
Le app connesse tramite OAuth vengono visualizzate in App connesse in Impostazioni → MCP & API, con l'indicazione di chi ha connesso ciascuna app. Usa Tieni premuto per revocare per interrompere l'accesso di un'app alla sua prossima richiesta.
Solo i proprietari e gli amministratori dello spazio di lavoro possono collegare un’app OAuth; un’app collegata continua a funzionare solo finché la persona che l’ha collegata rimane proprietaria o amministratrice.
Per i client che richiedono un’intestazione statica o per gli script automatizzati, crea un token API in Settings → MCP & API e passalo:
Authorization: Bearer YOUR_USERJOT_API_TOKENCosa può fare il server MCP
Il server MCP remoto mette a disposizione 98 strumenti che coprono i dati e i flussi di lavoro della tua area di lavoro (due operazioni REST, il caricamento multipart createAsset e la cancellazione ai sensi del GDPR deleteMember, sono disponibili solo tramite REST):
Spazio di lavoro e bacheche: Esamina i metadati dello spazio di lavoro e crea, elenca, aggiorna o elimina le bacheche.
Richieste, commenti, voti e tag: Elenca, crea, aggiorna, sposta e unisci le richieste, annulla le unioni, trova richieste simili, gestisci le iscrizioni, pubblica o fissa commenti, aggiungi o rimuovi voti, gestisci i tag e allega immagini.
Changelog: Elenca, crea, aggiorna ed elimina le voci e gestisci le richieste collegate, gli autori e i tag.
Conversazioni: Elenca, leggi e avvia conversazioni in uscita (
createConversationrichiede un piano a pagamento: 5 al giorno con Starter, 15 al giorno con Professional), leggi le cronologie, pubblica risposte e note interne e aggiorna lo stato o l'assegnatario.Membri e aziende: Cerca, elenca, sincronizza e aggiorna membri e aziende e gestisci le appartenenze alle aziende.
Centro assistenza: Crea, aggiorna, elimina, pubblica, ritira dalla pubblicazione e cerca raccolte e articoli.
Risorse: Importa immagini remote o crea caricamenti con URL prefirmato da usare nei changelog e negli articoli del centro assistenza.
Tutti gli strumenti di scrittura ed eliminazione dispongono di autorizzazioni complete sullo spazio di lavoro e sono contrassegnati come distruttivi, così che i client chiedano conferma prima di modificare i dati.
Limiti di frequenza e disponibilità nei piani
MCP è disponibile con tutti i piani, incluso Free. Le chiamate agli strumenti condividono i limiti di frequenza dell’API REST del tuo spazio di lavoro: 10 req/min (150/hr) con Free, 60 req/min (1.500/hr) con Starter e 120 req/min (5.000/hr) con Professional. Le sessioni intensive con agenti possono raggiungere rapidamente il limite di Free.
MCP e API REST
Usa MCP per collegare un assistente IA o uno strumento di programmazione che supporta il Model Context Protocol. Usa l’API REST per realizzare un’integrazione con un tuo backend, uno script o il codice di un’applicazione.
Gestione dei token
Se usi un token API invece di OAuth, trattalo come qualsiasi altro segreto:
Non inserirlo direttamente nei file di configurazione di cui esegui il commit.
Preferisci le variabili d’ambiente o un gestore locale di segreti.
Usa token distinti per ambienti o collaboratori diversi.
Revoca i token inutilizzati da Impostazioni → MCP & API usando Tieni premuto per revocare.
Passaggi successivi
Segui la Configurazione comune per OAuth, Claude web/desktop, VS Code, Gemini CLI o una configurazione JSON generica.
Vai direttamente alle guide per Claude Code, Cursor, Codex, ChatGPT o Windsurf.