Panoramica di MCP

Shayan TaslimAggiornato

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:

text
https://api.userjot.com/v1/mcp

Autenticazione

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)

Configurazione comune

Claude Code

OAuth (o token API)

Claude Code

Cursor

OAuth (in un clic da Settings → MCP & API) o token API

Cursor

Codex

OAuth (o token API)

Codex

ChatGPT

OAuth (o token API su desktop)

ChatGPT

VS Code (Copilot)

OAuth (in Altro in Impostazioni → MCP & API)

Configurazione comune

Gemini CLI

OAuth (in Altro in Impostazioni → MCP & API)

Configurazione comune

Windsurf e strumenti headless/CI

Intestazione con token API

Windsurf / Configurazione comune

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.

Note

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:

text
Authorization: Bearer YOUR_USERJOT_API_TOKEN

Cosa 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 (createConversation richiede 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

Ha risposto alla tua domanda?