Platform Agen & API Mariner GPS Tools

Ikhtisar & mulai cepat

Bawa kemampuan navigasi Mariner GPS Tools ke aplikasi, otomasi, dan agen AI Anda melalui REST atau MCP.

Pilih REST atau MCP

Kedua antarmuka menggunakan mesin kalkulasi dan model izin yang sama. Gunakan REST dengan kunci API untuk aplikasi dan skrip tempat Anda mengontrol setiap permintaan. Gunakan MCP ketika asisten atau agen AI harus menemukan alat yang tersedia, memahami skemanya, dan memilih sendiri perhitungan yang tepat.

REST API

Permintaan langsung dan berversi

Memanggil perhitungan navigasi dari aplikasi, layanan, otomatisasi, dan skrip.

https://marinergps.tools/api/v1

Server MCP

Alat untuk agen AI

Biarkan agen yang kompatibel dengan MCP menemukan kemampuan yang tersedia dan memilih perhitungan yang sesuai.

https://marinergps.tools/mcp

Otentikasi

Dua metode masuk menjangkau mesin kalkulasi yang sama. Klien AI interaktif terhubung ke server MCP dan mengotorisasi akses di browser dengan OAuth. Aplikasi, layanan, skrip, dan integrasi manual menggunakan kunci API Mariner GPS Tools yang dikirim sebagai token Bearer. Kunci dapat dibuat secara gratis dan dapat dirotasi atau dicabut kapan saja.

Buat kunci API

Tajuk Authorizationhttp

Authorization: Bearer mrt_live_...

Mulai cepat REST

Kirim permintaan JSON ke titik akhir REST berversi apa pun menggunakan kunci API Anda. Tanggapan menggunakan yang konsistenok, data, danerrorstruktur di semua alat perhitungan.

Hitung arahshell

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 }
  }'

Mulai cepat MCP

Tambahkan URL server ke klien AI yang kompatibel dan setujui akses di browser Anda saat halaman otorisasi Mariner Tools terbuka. Klien menemukan penyiapan masuk dan alat yang tersedia secara otomatis, tanpa kunci atau token yang perlu disalin.

URL serverhttp

https://marinergps.tools/mcp

Panduan penyiapan langkah demi langkah

Alternatif: konfigurasi manual dengan kunci API

Klien tanpa otorisasi browser dan integrasi programatik dapat mengirim kunci API sebagai gantinya:

Konfigurasi klien MCPjson

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

Format respons REST

Respons REST yang berhasil mengembalikan hasil terhitung dalamdata. Kegagalan validasi dan permintaan mengembalikan kode kesalahan stabil yang dapat dibaca mesin bersama dengan pesan yang dapat dibaca manusia.

JSON

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

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