Mariner GPS Tools -agentti- ja API-alusta

Yleiskatsaus ja pikaopas

Tuo Mariner GPS Toolsin navigointiominaisuudet sovelluksiisi, automaatioihisi ja tekoälyagentteihisi REST:n tai MCP:n kautta.

Valitse REST tai MCP

Molemmat rajapinnat käyttävät samaa laskentamoottoria ja oikeusmallia. Käytä RESTiä API-avaimella sovelluksissa ja skripteissä, joissa hallitset jokaista pyyntöä. Käytä MCP:tä, kun tekoälyavustajan tai agentin pitää löytää saatavilla olevat työkalut, ymmärtää niiden skeemat ja valita oikea laskenta itse.

REST API

Suorat, versioidut pyynnöt

Kutsu navigointilaskelmia sovelluksista, palveluista, automaatioista ja skripteistä.

https://marinergps.tools/api/v1

MCP-palvelin

Työkalut tekoälyagenteille

Anna MCP-yhteensopivien agenttien löytää käytettävissä olevat ominaisuudet ja valita sopiva laskelma.

https://marinergps.tools/mcp

Todennus

Kaksi kirjautumistapaa käyttää samaa laskentamoottoria. Vuorovaikutteiset tekoälyasiakkaat muodostavat yhteyden MCP-palvelimeen ja valtuuttavat pääsyn selaimessa OAuthilla. Sovellukset, palvelut, skriptit ja manuaaliset integraatiot käyttävät Mariner GPS Toolsin API-avainta, joka lähetetään Bearer-tunnisteena. Avaimet voi luoda maksutta, ja ne voi vaihtaa tai perua milloin tahansa.

Luo API-avain

Authorization otsikkohttp

Authorization: Bearer mrt_live_...

REST pikakäynnistys

Lähetä JSON-pyyntö mihin tahansa versioituun REST-päätepisteeseen käyttämällä API-avainta. Vastauksissa käytetään johdonmukaisuuttaok, data, jaerrorrakennetta kaikissa laskentatyökaluissa.

Laske suuntimashell

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 pikakäynnistys

Lisää palvelimen URL yhteensopivaan tekoälyasiakkaaseen ja hyväksy pääsy selaimessasi, kun Mariner Toolsin valtuutussivu avautuu. Asiakas löytää kirjautumisasetukset ja saatavilla olevat työkalut automaattisesti, eikä avaimia tai tunnisteita tarvitse kopioida.

Palvelimen URLhttp

https://marinergps.tools/mcp

Vaiheittainen käyttöönotto-opas

Vaihtoehto: manuaalinen määritys API-avaimella

Asiakkaat ilman selainvaltuutusta sekä ohjelmalliset integraatiot voivat lähettää sen sijaan API-avaimen:

MCP-asiakaskokoonpanojson

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

REST vastausmuoto

Onnistuneet REST-vastaukset palauttavat lasketun tuloksen kentässädata. Vahvistus- ja pyyntövirheet palauttavat vakaan koneellisesti luettavan virhekoodin sekä ihmisen luettavissa olevan viestin.

JSON

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

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