Mariner GPS Tools-ontwikkelaarsplatform

Overzicht en snelstart

Gebruik via een JSON REST-API of Model Context Protocol-server dezelfde geteste navigatierekenhulpen waarop Mariner GPS Tools draait.

Kies REST of MCP

Beide interfaces gebruiken dezelfde rekenengine en hetzelfde rechtenmodel. Gebruik REST met een API-sleutel voor applicaties en scripts waarbij u elk verzoek beheert. Gebruik MCP wanneer een AI-assistent of agent de beschikbare tools moet ontdekken, hun schema's moet begrijpen en zelf de juiste berekening moet kiezen.

REST-API

Directe verzoeken met versiebeheer

Roep navigatieberekeningen op vanuit applicaties, services, automatiseringen en scripts.

https://marinergps.tools/api/v1

MCP-server

Hulpmiddelen voor AI-agenten

Laat MCP-compatibele agenten de beschikbare mogelijkheden ontdekken en de juiste berekening kiezen.

https://marinergps.tools/mcp

Authenticatie

Twee aanmeldmethoden bereiken dezelfde rekenengine. Interactieve AI-clients verbinden met de MCP-server en autoriseren de toegang in de browser met OAuth. Applicaties, services, scripts en handmatige integraties gebruiken een Mariner GPS Tools API-sleutel die als Bearer-token wordt verzonden. Sleutels kunnen gratis worden aangemaakt en op elk moment worden geroteerd of ingetrokken.

Maak een API-sleutel

Authorization-kopteksthttp

Authorization: Bearer mrt_live_...

REST-snelstartgids

Stuur een JSON-verzoek naar elk REST-eindpunt met versienummer met behulp van uw API-sleutel. Reacties gebruiken een consistenteok, data, enerrorstructuur in alle rekenhulpmiddelen.

Bereken een peilingshell

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-snelstartgids

Voeg de server-URL toe aan een compatibele AI-client en sta toegang toe in uw browser wanneer de autorisatiepagina van Mariner Tools wordt geopend. De client ontdekt de aanmeldinstellingen en de beschikbare tools automatisch, zonder sleutels of tokens om te kopiëren.

Server-URLhttp

https://marinergps.tools/mcp

Stapsgewijze installatiehandleiding

Alternatief: handmatige configuratie met een API-sleutel

Clients zonder browserautorisatie en programmatische integraties kunnen in plaats daarvan een API-sleutel sturen:

MCP-clientconfiguratiejson

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

REST-antwoordformaat

Succesvolle REST-antwoorden retourneren het berekende resultaatdata. Validatie- en verzoekfouten retourneren een stabiele, machinaal leesbare foutcode naast een voor mensen leesbaar bericht.

JSON

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

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