Serveur MCP pour assistants IA

api-maree.fr expose un serveur MCP distant pour permettre à ChatGPT et aux clients compatibles d'interroger les données de marée sans copier de clé API dans l'outil tiers.

Endpoint MCP

Le serveur MCP est disponible à cette adresse : 

https://mcp.api-maree.fr/mcp

Les clients compatibles découvrent l'authentification OAuth à partir de la metadata de ressource protégée : 

https://mcp.api-maree.fr/.well-known/oauth-protected-resource/mcp

Connexion avec ChatGPT

Dans ChatGPT, activez le mode développeur puis ajoutez un connecteur MCP distant avec l'URL https://mcp.api-maree.fr/mcp. ChatGPT lance ensuite le flux OAuth vers api-maree.fr.

  1. Ajouter le serveur MCP distant dans ChatGPT.
  2. Se connecter à son compte api-maree.fr si nécessaire.
  3. Autoriser l'accès demandé.
  4. Utiliser les outils MCP depuis la conversation.

La disponibilité de l'ajout de connecteurs MCP dépend du compte ChatGPT et des fonctionnalités activées.

Outils disponibles

list_sitesListe les sites et ports disponibles.
find_siteRecherche un site à partir d'un nom approximatif, par exemple "Port en Bessin".
get_tide_extremaRetourne les pleines mers, basses mers, hauteurs et coefficients pour une période.
get_water_levelsRetourne les hauteurs d'eau sur une plage horaire avec un pas de temps choisi.

Exemples de demandes

  • Génère un tableau des pleines mers et basses mers à Port-en-Bessin pour demain.
  • Crée un calendrier Excel des marées à Saint-Malo sur la semaine à venir.
  • Trouve le site api-maree.fr correspondant au port du Croisic.
  • Prépare une série de hauteurs d'eau toutes les heures pour Brest demain matin.

Authentification et révocation

L'accès MCP utilise OAuth. L'utilisateur autorise le client depuis api-maree.fr, puis le client reçoit des jetons limités dans le temps. La clé API du compte n'est pas copiée dans ChatGPT.

Les autorisations peuvent être révoquées depuis la page du compte : gérer les autorisations OAuth.

Limites et statut des données

  • Les quotas restent ceux du compte api-maree.fr.
  • Les périodes demandées doivent rester dans la fenêtre autorisée par l'API.
  • Les réponses conservent les champs source.attribution et source.status_notice.
  • Les données sont fournies à titre indicatif et ne remplacent pas les informations officielles du SHOM.
Voir la documentation API Gérer mes autorisations