Présentation et démarrage rapide

Choisissez REST ou MCP

Les deux interfaces utilisent le même moteur de calcul et le même modèle d'autorisations. Utilisez REST avec une clé API pour les applications et les scripts dans lesquels vous contrôlez chaque requête. Utilisez MCP lorsqu'un assistant ou agent IA doit découvrir les outils disponibles, comprendre leurs schémas et choisir lui-même le bon calcul.

Authentification

Deux méthodes de connexion donnent accès au même moteur de calcul. Les clients IA interactifs se connectent au serveur MCP et autorisent l'accès dans le navigateur avec OAuth. Les applications, services, scripts et intégrations manuelles utilisent une clé API Mariner GPS Tools envoyée sous forme de jeton Bearer. Les clés peuvent être créées gratuitement, renouvelées ou révoquées à tout moment.

Authorization: Bearer mrt_live_...

Démarrage rapide REST

Envoyez une requête JSON à n’importe quel point de terminaison REST versionné à l’aide de votre clé API. Les réponses utilisent un modèle cohérentok, data, eterrorstructure à travers tous les outils de calcul.

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

Démarrage rapide MCP

Ajoutez l'URL du serveur à un client IA compatible et approuvez l'accès dans votre navigateur lorsque la page d'autorisation de Mariner Tools s'ouvre. Le client découvre automatiquement la configuration de connexion et les outils disponibles, sans clés ni jetons à copier.

https://marinergps.tools/mcp

Alternative : configuration manuelle avec une clé API

Les clients sans autorisation via le navigateur et les intégrations programmatiques peuvent envoyer une clé API à la place :

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

Format de réponse REST

Les réponses REST réussies renvoient le résultat calculé dansdata. Les échecs de validation et de demande renvoient un code d’erreur stable lisible par machine ainsi qu’un message lisible par l’homme.

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

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