connecter · docs

Docs.

Dernière mise à jour

Ce qu'est Nausika

Nausika est un serveur MCP qui ancre un assistant IA à des données maritimes réelles : météo, marées, lieux, tracés maritimes et géocodage, pour la navigation de plaisance dans le bassin méditerranéen.

Le serveur est hébergé sur mcp.nausika.app. L'identification utilise OAuth 2.1 via GitHub ou Google. Le transport est Streamable HTTP selon la spécification du Model Context Protocol.

Se connecter en trois étapes

Cinq minutes dans Claude.ai. Aucune clé API, aucun SDK. Un tutoriel plus long avec une URL à copier vit sur la page d'accueil.

  1. Ouvrir la fenêtre du connecteur

    Depuis le menu profil dans Claude.ai, allez à Customize → Connectors et cliquez Add custom connector.

    Stylisé, pas une capture d'écran. Ou utilisez le lien direct pour aller droit au modal.
  2. Ajouter Nausika et s'authentifier

    Définissez un nom d'affichage et collez https://mcp.nausika.app comme URL du serveur MCP distant. Cliquez Add, puis Connect pour lancer OAuth avec GitHub ou Google.

  3. L'activer dans une conversation et demander

    Dans n'importe quelle conversation, ouvrez le menu +, choisissez Connectors, activez Nausika et demandez quelque chose de concret. Les outils de Nausika sont appelés automatiquement quand la question est maritime.

Vérifier l'intégration

Cinq questions qu'un navigateur peut coller telles quelles. Chaque carte montre la chaîne d'outils que Nausika attend de l'assistant.

Planification de traversée

Planifie une traversée de Gênes à Bastia pour demain et donne-moi les conditions.

nausika_geocode nausika_marine_forecast nausika_sea_route nausika_calculator

Recherche POI

Trouve des mouillages abrités près de Portofino avec au moins trois mètres de fond.

nausika_geocode nausika_search_places

Marées, USA et Méditerranée

Compare les marées de demain dans la baie de San Francisco avec celles au large de Cagliari.

Station NOAA pour la baie de San Francisco ; repli Open-Meteo pour Cagliari.

nausika_geocode nausika_tides

Géocodage hors Méditerranée

Où est Lisbonne, et la coordonnée est-elle sur l'eau ?

Le géocodage retombe sur OpenStreetMap Nominatim hors de l'atlas soigné.

nausika_geocode nausika_is_water

Contribution d'un lieu

Je veux ajouter un petit port de plaisance que j'ai visité dans le sud de la Sardaigne. Quels attributs dois-je fournir ?

nausika_describe_place_schema nausika_is_water nausika_submit_proposal

Catalogue des outils

Vingt outils pour les utilisateurs authentifiés : 9 accessibles sans authentification et 11 qui nécessitent une connexion. Les noms sont canoniques ; transmettez-les tels quels depuis n'importe quel client.

Outils de base· 09 auth : anonyme
  1. nausika_marine_forecast Prévision marine et atmosphérique pour toute coordonnée.
  2. nausika_tides Prédictions de marée et recherche de stations NOAA.
  3. nausika_search_places Recherche par proximité, texte et ID avec filtres.
  4. nausika_sea_route Tracé maritime sur le graphe MARNET.
  5. nausika_geocode Géocodage direct et inverse des lieux.
  6. nausika_calculator Calculatrice hors-ligne pour carburant et distance.
  7. nausika_describe_place_schema Introspection du schéma pour un type de lieu donné.
  8. nausika_is_water Vérifie si une coordonnée est sur de l'eau.
  9. nausika_convert_coordinates Convertit entre décimal, DMS et DM.
Utilisateur authentifié· 11 auth : utilisateur connecté
  1. nausika_manage_boat_profile Créer, mettre à jour ou supprimer un profil de bateau.
  2. nausika_get_boat_profile Récupérer le profil de bateau par défaut ou nommé.
  3. nausika_manage_favorite Ajouter ou retirer un lieu des favoris.
  4. nausika_get_favorites Liste des lieux favoris enregistrés avec notes.
  5. nausika_manage_rating Noter un lieu de une à cinq étoiles.
  6. nausika_get_ratings Voir les notes agrégées ou les vôtres.
  7. nausika_manage_route Enregistrer une route simple ou un itinéraire à plusieurs étapes.
  8. nausika_get_routes Liste ou récupération des routes enregistrées par ID.
  9. nausika_submit_proposal Soumettre une proposition de nouveau lieu ou de modification.
  10. nausika_get_proposals Liste de l'état des propositions de l'utilisateur.
  11. nausika_withdraw_proposal Retirer une proposition encore en attente.

Couverture

  • Le jeu de données soigné est le bassin méditerranéen : points d'intérêt, notes, routes et données contribuées.
  • Prévision, marées, vérification de côte et géocodage acceptent toute coordonnée et retombent sur des sources publiques globales (Open-Meteo, NOAA, OpenStreetMap) hors Méditerranée.
  • Les recherches de lieux hors Méditerranée renvoient en général vide tant que les contributeurs n'ont pas étendu l'atlas.

Conventions de domaine

  • Distances : milles marins (nm)
  • Vitesse : nœuds (kt)
  • Profondeurs et hauteurs : mètres
  • Coordonnées : degrés décimaux, (latitude, longitude)
  • Valeurs par défaut : prévision à 3 jours, rayon de recherche 50 km, vitesse de croisière 6 kt

Limites du service

  • Rayon de recherche : maximum 200 km, par défaut 50 km.
  • Résultats de recherche : maximum 100 par appel, par défaut 30.
  • Horizon de prévision : 16 jours sur l'endpoint Forecast, 8 jours sur l'endpoint Marine ; le préréglage par défaut est 3 jours.
  • Plage de marée : configurable. Le seuil de distance à la station NOAA est autour de 200 nm avant que Nausika ne retombe sur les marées modélisées par Open-Meteo.
  • Rate limiting : géré au niveau de la plateforme. Sous charge soutenue le serveur renvoie HTTP 429 avec Retry-After. Restez poli.

Attribution et provenance

Chaque réponse d'outil inclut un tableau _attribution lisible par la machine sur le payload structuredContent et un pied de page Sources: lisible par l'utilisateur, afin que l'assistant puisse afficher le crédit à l'utilisateur final. Les détails de licence par source sont sur /credits.

Problèmes, support, sécurité