Le connecteur Claude (MCP)

Posez vos questions de veille à Claude, en français, et laissez-le interroger vos données O'Gérant pendant la conversation. « Quels AO de travaux publiés cette semaine dépassent 5 MDH ? », « Qui a remporté la consultation 2024-45 ? », « Où en est mon marché avec la commune de Salé ? ». Claude va chercher la réponse chez nous et vous la rend citée.

À quoi ça sert

MCP (Model Context Protocol) est la prise standard qui permet à un assistant IA d'interroger un service extérieur. Le connecteur O'Gérant en est un : une fois branché, Claude sait consulter votre veille sans que vous quittiez la conversation.

Interroger sans filtrer à la main

Décrivez ce que vous cherchez en une phrase. Claude traduit en filtres (secteur, acheteur, montant, date limite) et vous rend la liste, au lieu de vous faire cliquer dans dix menus.

Croiser plusieurs sources d'un coup

« Cette entreprise a-t-elle déjà gagné chez cet acheteur ? » demande une recherche, une fiche entreprise et un historique d'adjudications. Claude enchaîne les trois et vous rend la synthèse.

Travailler vos marchés en langage courant

Vos marchés en exécution, vos décomptes et vos échéances sont accessibles à la conversation : « quels décomptes attendent une validation ? » n'est plus un rapport à construire.

Ce qu'il vous faut

1. Une formule Veille, Business ou Enterprise Le connecteur en fait partie. Sur Découverte, et pendant un essai gratuit, chaque appel répond que la fonctionnalité n'est pas incluse, et vous dit ce qui l'active.
2. De quoi vous authentifier Soit rien du tout si vous passez par le connecteur personnalisé (Claude vous redirige vers notre page de connexion), soit une clé d'API pour les clients qui n'en gèrent pas : Paramètres → votre organisation → API & webhooks → Créer une clé. Réservé au propriétaire, elle ne s'affiche qu'une fois.
3. Un client compatible MCP Claude Code, Claude Desktop, ou tout client acceptant un en-tête d'authentification.

Installer le connecteur

Le serveur vit à une seule adresse, et il parle le transport Streamable HTTP :

https://app.ogerant.com/api/mcp

Claude Code

Une commande, depuis votre terminal :

claude mcp add --transport http ogerant https://app.ogerant.com/api/mcp \
  --header "Authorization: Bearer ts_live_…"

Vérifiez ensuite que le serveur répond avec /mcp dans Claude Code : O'Gérant doit apparaître connecté, avec ses huit outils.

Claude.ai et Claude Desktop : connecteur personnalisé

Dans Claude, Réglages → Connecteurs → Ajouter un connecteur personnalisé, puis collez l'adresse ci-dessus. Pas de clé à saisir : Claude vous redirige vers O'Gérant, vous vous connectez avec votre compte habituel, et un écran vous demande d'approuver.

Cet écran fait deux choses qui méritent votre attention :

• Il vous dit ce que le connecteur pourra consulter, et rappelle qu'il est en lecture seule.
• Il vous fait choisir l'organisation. Le connecteur ne verra que celle-là, définitivement : changer d'organisation dans l'application ne change pas ce qu'il lit. Pour en partager une autre, ajoutez une seconde connexion.

Fichier de configuration (Claude Desktop, autres clients)

Déclarez le serveur dans la configuration de votre client. La clé voyage dans l'en-tête Authorization, jamais dans l'URL :

{
  "mcpServers": {
    "ogerant": {
      "type": "http",
      "url": "https://app.ogerant.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ts_live_…"
      }
    }
  }
}

Ce que Claude peut consulter

Huit outils, tous en lecture. Vous n'avez pas à les connaître : Claude choisit celui qui répond à votre question. Ils sont listés ici pour que vous sachiez exactement ce qui est exposé.

Lecture seule, par construction

Aucun de ces outils ne modifie quoi que ce soit chez vous. Claude ne peut pas créer un radar, envoyer une alerte, changer un marché, supprimer un document. Ce n'est pas une consigne donnée au modèle : c'est ce que le serveur sait faire, et il ne sait rien faire d'autre.

Ça compte parce qu'un assistant lit ce qu'on lui donne : le texte d'un règlement de consultation, un PV, un e-mail collé. Si ce texte contenait une instruction déguisée, un connecteur capable d'écrire deviendrait un moyen d'agir sur votre compte. Le nôtre n'a pas ce pouvoir : le pire qu'une consigne cachée puisse obtenir, c'est une lecture que vous étiez déjà autorisé à faire.

Jetons et quotas

Le connecteur ne crée pas de compteur à part : il dépense sur vos quotas habituels, exactement comme l'application.

Vos dépenses via le connecteur apparaissent séparément dans le suivi de consommation : vous voyez ce que la conversation a coûté, distinctement de ce que l'application a coûté.

Ce que la clé donne, et ne donne pas

La clé est celle de l'organisation, pas la vôtre. Elle ouvre exactement ce que votre organisation voit déjà dans l'application, jamais les données d'une autre. L'organisation n'est pas un paramètre que Claude peut changer : elle est déduite de la clé, côté serveur, à chaque appel.

• Une clé lecture seule suffit. Le connecteur n'a aucun besoin d'une clé en écriture : n'en créez pas une pour ça.
• Par le connecteur personnalisé, le jeton est lié à l'organisation que vous avez choisie à l'écran d'approbation, et à personne d'autre : ni vos autres organisations, ni celles de vos collègues.
• Si vous quittez l'organisation, le connecteur cesse de répondre au premier appel suivant, sans intervention.
• Votre mot de passe ne transite jamais par Claude, et le connecteur ne peut pas s'authentifier avec votre session de navigateur.
• Chaque appel est journalisé (date, outil, code de réponse), jamais le contenu de vos questions ni des réponses.
• Le changement de formule s'applique immédiatement : un connecteur installé sur une formule qui perd l'accès cesse de répondre au premier appel suivant.

Déconnecter

Selon la façon dont vous vous êtes connecté :

1. Connecteur personnalisé Retirez-le dans Réglages → Connecteurs. Le jeton cesse d'être renouvelé et expire dans les minutes qui suivent.
2. Clé d'API Retirez le serveur de votre client (claude mcp remove ogerant), puis révoquez la clé : c'est ce qui compte vraiment, tant qu'elle vit elle vaut accès. Paramètres → API & webhooks → Révoquer, effet immédiat.

Dépannage

Pour aller plus loin

• Démarrer avec l'API : le même accès, pour du code plutôt qu'une conversation.
• Codes d'erreur : le vocabulaire complet des refus.
• Entreprise, équipe & paramètres : où vivent les clés d'API.