Configurazione comune

Shayan TaslimAggiornato

UserJot non richiede un pacchetto MCP locale. Connetti il tuo client direttamente all’URL del server MCP remoto di UserJot, quindi accedi con OAuth o inserisci un token API.

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

Accedi con OAuth (consigliato)

Apri Impostazioni → MCP & API nella dashboard di UserJot per trovare i pulsanti di installazione in un clic e i comandi da copiare. Quando il client ti chiede di accedere, il browser apre UserJot per consentirti di scegliere uno spazio di lavoro e fare clic su Consenti.

  • Claude (web, desktop e dispositivi mobili): seleziona Claude in Impostazioni → MCP & API e fai clic su Aggiungi a Claude. Claude si apre con il connettore già configurato; conferma con Aggiungi e accedi.

  • VS Code (modalità agente di Copilot): apri Altro → VS Code in Impostazioni → MCP & API e fai clic su Aggiungi a VS Code, quindi conferma Installa e accedi.

  • Gemini CLI: apri Altro → Gemini CLI in Impostazioni → MCP & API, oppure esegui questo comando nel terminale, quindi esegui /mcp auth userjot all’interno di Gemini CLI per accedere:

Bash
gemini mcp add --transport http --scope user userjot https://api.userjot.com/v1/mcp

Le app connesse vengono visualizzate in App connesse in Impostazioni → MCP & API, insieme al nome del proprietario o dell’amministratore che le ha autorizzate. Un’app connessa rimane attiva solo finché quella persona è proprietaria o amministratrice dell’area di lavoro. Usa Tieni premuto per revocare per disconnettere subito l’accesso.

Usa un token API

Per i client che richiedono un’intestazione personalizzata (come Windsurf) o per gli ambienti headless, crea un token in Impostazioni → MCP & API e inserisci:

text
Server URL:    https://api.userjot.com/v1/mcp
Authorization: Bearer YOUR_USERJOT_API_TOKEN

La maggior parte dei client MCP HTTP remoti accetta una configurazione JSON simile a questa (per i client OAuth, ometti il blocco headers):

JSON
{
  "mcpServers": {
    "userjot": {
      "type": "http",
      "url": "https://api.userjot.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_USERJOT_API_TOKEN"
      }
    }
  }
}

Verifica la connessione

Dopo la connessione, chiedi al client di esaminare il server userjot o di chiamare getWorkspace. Se la connessione funziona, il client mostrerà i dettagli del tuo spazio di lavoro e gli strumenti disponibili, senza bisogno di configurazioni locali.

Risoluzione dei problemi

Se la connessione non riesce, controlla prima questi elementi:

  • Se hai effettuato l’accesso con OAuth, verifica che l’app sia ancora elencata in App connesse in Impostazioni → MCP & API e che tu sia ancora proprietario o amministratore dello spazio di lavoro.

  • Se usi un token API, verifica che non sia stato revocato e che l’intestazione Authorization inizi con Bearer.

  • Verifica che il client supporti i server MCP HTTP remoti (Streamable HTTP).

  • Verifica che il file di configurazione si trovi nella posizione corretta e riavvia il client dopo averlo modificato.

  • Controlla se hai raggiunto il limite di richieste API previsto dal tuo piano.

Passaggi successivi

  • Consulta tutti i 98 strumenti disponibili e i dettagli sulla sicurezza in Panoramica MCP.

  • Usa la REST API se stai scrivendo codice backend diretto.

Ha risposto alla tua domanda?