Collega un client IA

Cosa ottiene il tuo agente

Road User Tools fornisce un server MCP. MCP, il Model Context Protocol, è uno standard aperto che consente agli assistenti IA di usare strumenti esterni. Quando lo colleghi, un assistente o agente IA compatibile ottiene accesso ai calcolatori di Road User Tools e può trovare e richiamare quegli strumenti quando una conversazione ne ha bisogno, ad esempio per convertire il consumo di carburante o calcolare un tempo di viaggio.

https://roaduser.tools/mcp

Configurazione manuale

La maggior parte dei client IA segue lo stesso schema. La terminologia varia da prodotto a prodotto, ma i passaggi sono:

1. Apri le impostazioni MCP, connettori o integrazioni nel tuo client IA.
2. Scegli di aggiungere un server MCP personalizzato o remoto.
3. Inserisci l'URL MCP di Road User Tools mostrato sopra.
4. Continua o avvia la connessione.
5. Il browser apre la pagina di autorizzazione di Road User Tools.
6. Accedi al tuo account Road User Tools oppure creane uno gratuitamente.
7. Esamina i permessi richiesti e scegli Consenti l'accesso.
8. Torna al tuo client IA.
9. Verifica che Road User Tools risulti connesso.
10. Fai una domanda stradale, ad esempio il costo del carburante di un viaggio, per verificare la connessione.

Risoluzione dei problemi

La pagina di autorizzazione del browser non si è aperta

Cerca nel client un link o un pulsante come Collega, Autorizza o Accedi e controlla che non sia stato bloccato un popup. Rimuovere e riaggiungere il server di solito riavvia la procedura.

Il client segnala che è richiesta l'autenticazione

La connessione è stata aggiunta ma non è ancora autorizzata. Avvia l'azione di accesso o riconnessione del client in modo che si apra la pagina di autorizzazione.

L'autorizzazione è stata rifiutata

Se hai scelto Rifiuta, il client non può usare Road User Tools. Ricollegalo e scegli Consenti l'accesso per concedere l'accesso.

L'accesso è stato rimosso

Se hai rimosso l'applicazione dalla pagina del tuo account, la sua connessione smette di funzionare. Ricollegala dal client e autorizzala di nuovo.

Il client non supporta l'autorizzazione automatica

Alcuni client non possono eseguire l'accesso tramite browser. Usa la configurazione manuale con una chiave API descritta qui sotto.

Il client richiede una configurazione manuale

I client configurati tramite un file JSON anziché una schermata di impostazioni possono usare la configurazione manuale qui sotto.

Connesso, ma non compare nessuno strumento

Aggiorna l'elenco degli strumenti del client o riavvia il client. Se gli strumenti continuano a non comparire, rimuovi il server e collegalo di nuovo.

Avanzato: configurazione manuale con una chiave API

Per client programmatici, script o client senza autorizzazione tramite browser, Road User Tools accetta anche chiavi API sul server MCP. Crea una chiave nella pagina del tuo account e inseriscila nella configurazione del client:

{
  "mcpServers": {
    "roaduser-tools": {
      "url": "https://roaduser.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Entrambi i metodi di accesso raggiungono gli stessi strumenti con lo stesso modello di permessi.