Logs LLM dans Claude : connecteur MCP OAuth, sans clé API

Ajoutez une passerelle LLM à Claude, connectez-vous, autorisez la lecture du journal des requêtes et posez vos questions. Trois questions, 14 appels d’outils, vérifiés.

11 octobre 2026

« Quelle session a coûté le plus cher ce matin, et pourquoi ? » Pour répondre, vous pouvez parcourir la console ou poser la question à Claude dans une conversation qui a accès aux mêmes données. Ce guide ajoute la passerelle Synthorai à Claude via un connecteur MCP, le protocole qui permet de fournir des outils à un modèle. On se connecte sans coller de clé API, on autorise uniquement la lecture du journal des requêtes, puis on pose trois questions sur les sessions des guides précédents de cette série. Tous les chiffres des réponses correspondaient aux données de facturation.

TL;DR

• Claude se connecte au serveur MCP de la passerelle Synthorai via un connecteur personnalisé et une connexion OAuth, sans clé API à coller.
• En autorisant uniquement le journal des requêtes, nous avons donné à Claude quatre outils en lecture seule et une clé avec le scope logs.read, qui expire au bout de 7 jours.
• Claude Fable 5.1 a répondu à trois questions sur les logs en 14 appels d’outils. Tous les chiffres correspondaient aux données de facturation.
• Les outils de consultation des logs renvoient les coûts, les tokens et les statuts, jamais le texte des prompts ni des réponses.

La connexion utilise MCP (Model Context Protocol), le protocole standard pour fournir des outils à un assistant : un serveur décrit les outils disponibles, puis l’assistant les appelle. La passerelle expose ce serveur à l’adresse https://synthorai.io/v1/mcp. Dans Claude, un connecteur désigne un serveur MCP ajouté à votre compte. Cette page ne contient aucun code et vous n’avez rien à installer.

Nous avons configuré la connexion le 10 octobre 2026, puis posé les questions le lendemain sur claude.ai, dans un navigateur, avec Claude Fable 5.1 comme modèle de conversation. L’ajout d’un connecteur personnalisé se fait de la même façon dans Claude Desktop.

Comment ajouter la passerelle à Claude ?

Pour ajouter un connecteur personnalisé, il suffit de lui donner un nom et l’URL du serveur. Dans Claude, ouvrez Personnaliser, puis Connecteurs, sélectionnez Ajouter et choisissez « Ajouter un connecteur personnalisé » :

Sélectionnez Continuer. Claude vérifie le serveur, puis affiche le mode de connexion. Deux options sont déjà renseignées à partir des informations fournies par le serveur :

• Authentification : « Se connecter maintenant ». Chaque utilisateur se connecte au serveur avant d’utiliser ses outils. C’est le fonctionnement d’OAuth : le serveur vous demande d’autoriser la connexion dans votre navigateur, puis fournit un token d’accès à Claude. Aucune clé API n’est saisie ni stockée dans un fichier.
• Client OAuth : « Enregistrer automatiquement ». Claude s’enregistre auprès du serveur lors de la connexion. Vous n’avez aucun identifiant client à créer.

Conservez ces deux options et sélectionnez Ajouter. Claude vous redirige vers Synthorai pour autoriser la connexion. Si la page du connecteur indique plutôt que la connexion a expiré, sélectionnez Reconnecter : c’est ce qui nous a permis d’accéder à la page d’autorisation.

Qu’autorisez-vous lors de la connexion ?

Vous choisissez l’espace de travail, l’usage de la connexion, les données accessibles et la date d’expiration de l’accès. Cette page est servie par la passerelle. Si vous n’êtes pas connecté à sa console, elle vous demande d’abord de vous connecter :

• Espace de travail. La connexion accède à un seul espace de travail. Choisissez celui qui contient les requêtes sur lesquelles vous voulez poser des questions.
• Usage de cette connexion. « Exécuter des modèles » permet à Claude d’appeler des modèles via la passerelle, aux frais de l’espace de travail. Pour ce guide, nous choisissons « Lire et gérer l’espace de travail ». Cette option n’autorise que les éléments cochés en dessous.
• Données accessibles à Claude. Cinq groupes sont proposés : utilisation et solde, journal des requêtes, bibliothèque de prompts, clés API (en lecture seule), et membres avec journal d’audit et paramètres. Nous avons coché uniquement le journal des requêtes.
• Accès. Lecture seule. Un paramètre de notre espace de travail interdit les modifications via MCP. La page ne propose donc aucune autre option.
• Expiration de l’accès. 1, 7, 30 ou 90 jours. Nous avons conservé 7.

Sélectionnez Autoriser. Le navigateur revient dans Claude, qui indique que le connecteur est connecté et affiche ses outils :

Le connecteur dispose de quatre outils, tous en lecture seule : search_requests, get_request, list_sessions et list_traces. Ils renvoient les détails de l’appel et de son exécution (modèle, statut, tokens, coût, durées, session, trace et labels), jamais le prompt ni la réponse. Cette page permet aussi de régler chaque outil sur Toujours autoriser, Demander d’abord ou Bloquer.

Où apparaît la connexion côté passerelle ?

Elle apparaît sous la forme d’une clé distincte, dans Clés API, onglet Clés d’administration :

La clé s’appelle MCP: Claude, possède le seul scope que vous avez coché (logs.read) et expire à la date choisie. Un scope est une permission attachée à une clé. Vous ne voyez ni ne manipulez cette clé, mais vous pouvez la désactiver ou la supprimer ici. Cela coupe immédiatement la connexion, quelles que soient les informations conservées par Claude.

Qu’avons-nous demandé, et les réponses étaient-elles justes ?

Nous avons posé trois questions sur les requêtes que les démonstrations de cette série venaient d’envoyer. Tous les chiffres des réponses correspondaient aux données de facturation affichées par les scripts de démonstration. Chaque question précise une plage horaire et un label pour délimiter la recherche. Un label est une paire clé-valeur que l’application envoie avec chaque requête dans l’en-tête X-Synthorai-Metadata. Les démonstrations ajoutent à chaque requête les labels feature, case (le problème reproduit) et variant (before pour l’exécution défectueuse, after pour son équivalent corrigé). Le cache de prompts, évoqué dans les réponses, réduit le coût d’un préfixe de prompt réutilisé : il est facturé comme une écriture au premier envoi, puis comme une lecture aux envois suivants.

Utilise le connecteur Synthorai. Examine uniquement les requêtes entre 2026-10-11T11:24:00Z et 2026-10-11T11:32:00Z portant le label feature = support-agent. Parmi les sessions portant le label case = cache-miss, case = context-growth ou case = replay-mismatch, laquelle a coûté le plus cher, et quels nombres de tokens expliquent ce coût ?

Les réponses ne se limitaient pas à restituer les chiffres :

• Claude a utilisé les labels sans qu’on lui explique comment. En ouvrant un appel d’outil dans la conversation, on peut voir ses arguments. Le premier appel à list_sessions contenait les labels case = cache-miss et feature = support-agent, la plage horaire et une limite de 50. Il y avait un appel de ce type par cas. Pour la troisième question, Claude a d’abord recherché le champ contenant l’utilisateur, trouvé le label _user, puis filtré sur ce label.
• Il a trouvé la comparaison pertinente. La première réponse concerne la session du guide Pourquoi mon agent LLM coûte-t-il si cher ? dans laquelle un message avait été enregistré sous une forme différente de celle envoyée. Claude a retrouvé la session corrigée grâce au label variant = after, constaté que les volumes de prompts étaient presque identiques et attribué l’écart de 2.5x aux tokens écrits dans le cache plutôt que lus depuis celui-ci. Il a aussi détaillé chaque tour de la session coûteuse : le coût double environ entre le premier et le sixième tour à mesure que le prompt grossit.
• Il a précisé ce que les chiffres permettent de conclure, et leurs limites. La deuxième réponse indique que la session corrigée a produit davantage de tokens de sortie (1,750 contre 1,599). L’économie sur l’entrée seule est donc supérieure à l’écart net de 25.6%. La première précise que le connecteur ne renvoie pas le contenu des prompts et ne permet donc pas de voir ce qui a empêché la correspondance avec le cache.

Nous avons vérifié l’explication de la première réponse, pas seulement ses chiffres. Ces sessions utilisent GPT-6 Luna, qui facture, par million de tokens, $0.10 pour l’entrée, $0.01 pour l’entrée lue depuis le cache, $0.125 pour l’entrée écrite dans le cache et $0.50 pour la sortie. À ces tarifs, les 24,539 tokens écrits en cache, les 18 autres tokens d’entrée et les 1,523 tokens de sortie de la session coûteuse reviennent à $0.003831. Pour la session corrigée, les 5,840 tokens écrits, les 18,844 tokens lus, les 18 autres tokens d’entrée et les 1,204 tokens de sortie reviennent à $0.001522. Ces deux montants correspondent à la facturation : l’explication par les écritures et les lectures du cache est donc correcte.

Que faut-il vérifier dans une réponse ?

Vérifiez d’abord le périmètre des appels d’outils, puis les explications qui dépendent des tarifs ou de votre configuration. Les chiffres de nos trois réponses étaient justes. Ceux qui sont repris directement d’un résultat d’outil sont les plus fiables. Les pourcentages et les ratios sont calculés par le modèle : refaites ces calculs. Quatre points peuvent encore induire en erreur :

• Le périmètre de la réponse dépend des appels d’outils. Chaque appel a une plage horaire, des labels et une limite. La conversation affiche tous les appels avec leurs arguments. Vous pouvez donc vérifier si « la session la plus chère » a été choisie parmi toutes les sessions ou seulement les 50 premières.
• Les explications reposent sur les connaissances générales du modèle. Les données indiquent ce qui s’est passé. L’explication vient du raisonnement du modèle et peut ne pas correspondre à vos modèles ou à vos tarifs. Recalculez un montant, comme nous l’avons fait plus haut, avant d’agir sur la base d’une explication.
• Les heures sont affichées dans votre fuseau horaire. Le journal est en UTC et nos questions utilisaient l’UTC. Les réponses donnaient les heures du Pacifique, le fuseau associé à notre compte dans Claude. Comparez-les donc à la plage UTC de la question.
• Les outils ne renvoient jamais le contenu. Claude peut indiquer qu’une requête a échoué avec un 404 et donner le message d’erreur. Il ne peut pas dire ce que l’utilisateur a demandé et le précise lorsqu’une question nécessite cette information.

Un label et une plage horaire restreinte rendent la réponse plus précise et plus courte, puisque chaque ligne renvoyée par un outil est ajoutée à la conversation.

Combien cela coûte-t-il, et comment limiter les risques ?

Les appels aux outils de consultation des logs sont gratuits. Le travail du modèle est inclus dans votre abonnement Claude : ces questions n’ajoutent donc rien à la facture de la passerelle. Une longue investigation consomme toutefois le quota de votre abonnement, car les résultats d’outils font partie de la conversation.

La connexion reste limitée aux autorisations accordées :

• Un seul groupe de données. Seul le journal des requêtes était coché. La connexion ne dispose donc d’aucun outil pour les soldes, les prompts, les clés ou les membres.
• Lecture seule. Aucun outil ne modifie de données ni n’appelle de modèle.
• Une date d’expiration. La clé expire au terme de la période choisie, et vous pouvez la supprimer avant.
• Aucun texte de prompt ni de réponse. Les outils ne renvoient que des métadonnées.
• Permissions des outils dans Claude. Chaque outil peut demander une autorisation avant de s’exécuter. C’est le réglage par défaut sur la page du connecteur. Notre conversation utilisait le mode d’autorisation Auto de Claude : il utilise les connecteurs de façon autonome et ne s’interrompt que si une opération lui semble risquée. Les appels en lecture seule ont donc été exécutés sans demande de confirmation.

Soyez prudent si vous partagez une conversation de ce type. Une réponse peut citer des identifiants de session, des identifiants utilisateur issus du label _user et des noms de modèles.

FAQ

Claude peut-il lire mes journaux de requêtes LLM ?

Oui, via un connecteur vers un serveur MCP qui les expose. Une fois la passerelle Synthorai ajoutée comme connecteur personnalisé et l’accès au journal des requêtes autorisé lors de la connexion, Claude peut rechercher des requêtes, lister les sessions et les traces, et lire les coûts, les tokens, les statuts et les labels. Il ne peut pas lire les prompts ni les réponses, car les outils ne les renvoient pas.

Faut-il une clé API pour connecter Claude à un serveur MCP ?

Non, si le serveur prend en charge la connexion OAuth. L’ajout de https://synthorai.io/v1/mcp comme connecteur personnalisé vous redirige vers une page d’autorisation. La passerelle crée elle-même une clé pour la connexion, avec uniquement les scopes cochés et une durée de validité de 1 à 90 jours. Cette clé figure dans Clés API, où vous pouvez la supprimer.

Claude analyse-t-il les logs avec précision ?

Lors de notre test avec Claude Fable 5.1, tous les chiffres des trois réponses correspondaient aux données de facturation : coûts, nombres de tokens, nombres de requêtes et codes de statut. Son explication de la session la plus chère s’est aussi confirmée lorsque nous avons recalculé la facture à partir des tarifs du modèle. Vérifiez tout de même les appels d’outils sur lesquels repose la réponse.

Combien coûte l’analyse des logs de la passerelle avec Claude ?

Elle n’ajoute rien à la facture de la passerelle : les outils de consultation des logs sont gratuits, et les trois questions de cette page ont généré 14 appels d’outils. Le travail du modèle est décompté de votre abonnement Claude. Un programme qui pose ces questions via l’API paie en revanche les tokens de son modèle. Le guide Donner des outils de consultation des logs à votre agent mesure ce coût.

Est-il sûr de connecter Claude à un journal de requêtes ?

La sécurité dépend des autorisations accordées. Cette connexion avait accès à un seul groupe de données, le journal des requêtes, en lecture seule, pour 7 jours, sans accès au texte des prompts ni des réponses. Elle ne peut ni modifier l’espace de travail ni appeler un modèle. Supprimer sa clé dans Clés API coupe la connexion.

À lire aussi

• Tracer un agent LLM : comment les requêtes reçoivent les identifiants de session et les labels utilisés pour filtrer ces questions.
• Pourquoi mon agent LLM coûte-t-il si cher ? : les sessions concernées par les deux premières questions.
• Pourquoi mon agent LLM est-il lent ? et Déboguer un agent LLM : le même type d’investigation, effectué manuellement dans la console.
• Coût de Claude Code par sous-agent : à quoi ressemblent les sessions de Claude Code dans ce même journal.
• Donner des outils de consultation des logs à votre agent : les mêmes outils utilisés depuis un programme avec une clé API, et le coût des tokens du modèle.
• Référence du serveur MCP : tous les outils, les scopes des clés et les moyens de limiter une connexion.

← Cas d'usage