DE
API & MCPDokumentation

Mariner GPS Tools Entwicklerplattform

Mit einem KI-Client verbinden

Verbinden Sie den Mariner Tools MCP-Server mit einem KI-Assistenten und autorisieren Sie ihn mit Ihrem Konto. Keine MCP-Vorkenntnisse erforderlich.

Was Ihr Agent erhält

Mariner Tools stellt einen MCP-Server bereit. MCP, das Model Context Protocol, ist ein offener Standard, der KI-Assistenten die Nutzung externer Tools ermöglicht. Wenn Sie ihn verbinden, erhält ein kompatibler KI-Assistent oder Agent Zugriff auf die Navigationsfunktionen von Mariner Tools und kann diese Tools finden und aufrufen, wenn eine Unterhaltung sie benötigt, zum Beispiel um Koordinaten umzurechnen oder eine Entfernung zu berechnen.

Server-URLhttp
https://marinergps.tools/mcp

Manuelle Einrichtung

Die meisten KI-Clients folgen demselben Muster. Die Formulierungen unterscheiden sich je nach Produkt, aber die Schritte sind:

  1. Öffnen Sie die MCP-, Connector- oder Integrationseinstellungen in Ihrem KI-Client.
  2. Wählen Sie, einen benutzerdefinierten oder Remote-MCP-Server hinzuzufügen.
  3. Geben Sie die oben angezeigte Mariner Tools MCP-URL ein.
  4. Fahren Sie fort oder stellen Sie die Verbindung her.
  5. Ihr Browser öffnet die Mariner Tools-Autorisierungsseite.
  6. Melden Sie sich bei Ihrem Mariner Tools-Konto an oder erstellen Sie kostenlos eines.
  7. Prüfen Sie die angeforderten Berechtigungen und wählen Sie Zugriff erlauben.
  8. Kehren Sie zu Ihrem KI-Client zurück.
  9. Bestätigen Sie, dass Mariner Tools als verbunden angezeigt wird.
  10. Stellen Sie eine Navigationsfrage, zum Beispiel nach der Entfernung zwischen zwei Positionen, um die Verbindung zu prüfen.

Fehlerbehebung

Die Autorisierungsseite im Browser wurde nicht geöffnet
Suchen Sie im Client nach einem Link oder einer Schaltfläche wie Verbinden, Autorisieren oder Anmelden und prüfen Sie, ob ein Pop-up blockiert wurde. Den Server zu entfernen und erneut hinzuzufügen startet den Ablauf in der Regel neu.
Der Client meldet, dass eine Authentifizierung erforderlich ist
Die Verbindung wurde hinzugefügt, aber noch nicht autorisiert. Lösen Sie die Anmelde- oder Neuverbindungsaktion des Clients aus, damit die Autorisierungsseite geöffnet wird.
Die Autorisierung wurde abgelehnt
Wenn Sie Ablehnen gewählt haben, kann der Client Mariner Tools nicht verwenden. Verbinden Sie sich erneut und wählen Sie Zugriff erlauben, um den Zugriff zu gewähren.
Der Zugriff wurde widerrufen
Wenn Sie die Anwendung auf Ihrer Kontoseite entfernt haben, funktioniert ihre Verbindung nicht mehr. Verbinden Sie sich vom Client aus erneut und autorisieren Sie sie noch einmal.
Der Client unterstützt keine automatische Autorisierung
Einige Clients können den Anmeldeablauf im Browser nicht ausführen. Verwenden Sie die manuelle Einrichtung mit einem API-Schlüssel unten.
Der Client erfordert eine manuelle Konfiguration
Clients, die über eine JSON-Datei statt über einen Einstellungsbildschirm konfiguriert werden, können die manuelle Einrichtung unten verwenden.
Verbunden, aber keine Tools werden angezeigt
Aktualisieren Sie die Toolliste des Clients oder starten Sie den Client neu. Wenn weiterhin keine Tools angezeigt werden, entfernen Sie den Server und verbinden Sie sich erneut.

Erweitert: manuelle Einrichtung mit einem API-Schlüssel

Für programmatische Clients, Skripte oder Clients ohne Browser-Autorisierung akzeptiert Mariner Tools auf dem MCP-Server auch API-Schlüssel. Erstellen Sie einen Schlüssel auf Ihrer Kontoseite und verweisen Sie in der Client-Konfiguration darauf:

Erstellen Sie einen API-Schlüssel
Manuelle MCP-Konfigurationjson
{
  "mcpServers": {
    "mariner-tools": {
      "url": "https://marinergps.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Beide Anmeldemethoden erreichen dieselben Tools mit demselben Berechtigungsmodell.

API- und MCP-Dokumentation