Panoramica e avvio rapido

Scegli REST o MCP

Entrambe le interfacce usano lo stesso motore di calcolo e lo stesso modello di permessi. Utilizza REST con una chiave API per applicazioni e script in cui controlli ogni richiesta. Utilizza MCP quando un assistente o agente IA deve scoprire gli strumenti disponibili, comprenderne gli schemi e scegliere da solo il calcolo corretto.

Autenticazione

Due metodi di accesso raggiungono lo stesso motore di calcolo. I client IA interattivi si collegano al server MCP e autorizzano l'accesso nel browser con OAuth. Applicazioni, servizi, script e integrazioni manuali usano una chiave Mariner GPS Tools API inviata come token Bearer. Le chiavi possono essere create gratuitamente e possono essere ruotate o revocate in qualsiasi momento.

Authorization: Bearer mrt_live_...

REST avvio rapido

Invia una richiesta JSON a qualsiasi endpoint REST con versione utilizzando la chiave API. Le risposte utilizzano un metodo coerenteok, data, eerrorstruttura in tutti gli strumenti di calcolo.

curl -X POST https://marinergps.tools/api/v1/bearing \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "from": { "lat": 50.1, "lng": -4.2 },
    "to": { "lat": 49.8, "lng": -3.1 }
  }'

MCP avvio rapido

Aggiungi l'URL del server a un client IA compatibile e approva l'accesso nel browser quando si apre la pagina di autorizzazione di Mariner Tools. Il client scopre automaticamente la configurazione di accesso e gli strumenti disponibili, senza chiavi o token da copiare.

https://marinergps.tools/mcp

Alternativa: configurazione manuale con una chiave API

I client senza autorizzazione tramite browser e le integrazioni programmatiche possono inviare invece una chiave API:

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

Formato di risposta REST

Le risposte REST riuscite restituiscono il risultato calcolatodata. Gli errori di convalida e di richiesta restituiscono un codice di errore stabile leggibile dalla macchina insieme a un messaggio leggibile dall'uomo.

{
  "ok": true,
  "data": {
    "degrees": 112.7,
    "compass": "ESE"
  }
}

{
  "ok": false,
  "error": {
    "code": "invalid_request",
    "message": "Invalid bearing input."
  }
}