Collega un client IA

Cosa ottiene il tuo agente

Mariner Tools offre un server MCP. MCP, il Model Context Protocol, è uno standard aperto che permette agli assistenti IA di usare strumenti esterni. Quando lo colleghi, un assistente o agente IA compatibile ottiene accesso alle funzionalità di navigazione di Mariner Tools e può trovare e chiamare quegli strumenti quando una conversazione ne ha bisogno, per esempio per convertire coordinate o calcolare una distanza.

https://marinergps.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 Mariner Tools mostrato sopra.
4. Continua o avvia la connessione.
5. Il browser apre la pagina di autorizzazione di Mariner Tools.
6. Accedi al tuo account Mariner Tools oppure creane uno gratuitamente.
7. Esamina i permessi richiesti e scegli Consenti l'accesso.
8. Torna al tuo client IA.
9. Verifica che Mariner Tools risulti connesso.
10. Fai una domanda di navigazione, per esempio la distanza tra due posizioni, 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 Mariner 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, Mariner Tools accetta anche chiavi API sul server MCP. Crea una chiave nella pagina del tuo account e inseriscila nella configurazione del client:

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

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