Explorer l'utilisation des outils MCP

Tout serveur MCP instrumenté avec le SDK @posthog/mcp émet un événement $mcp_tool_call chaque fois qu'un agent invoque un outil. Cette skill est la porte d'entrée pour un utilisateur qui sait qu'il veut examiner son utilisation des outils MCP mais n'a pas encore posé une question spécifique. Proposez le menu ci-dessous, puis routez vers l'outil — ou la skill ciblée — qui répond à son choix.

Chaque outil par-outil ici est protégé par le flag mcp-analytics, prend un toolName (le nom effectif de l'outil — résolu côté serveur, passez donc le nom que l'agent invoque réellement — sauf posthog:query-mcp-tool-failures, qui correspond aux événements $exception et prend donc le $mcp_tool_name brut enregistré) plus une dateRange, et exécute le même query runner que l'UI de détail d'outil. Les résultats correspondent donc à l'UI, et vous n'écrivez jamais de HogQL à la main.

Questions suggérées

Commencez par celles-ci quand l'utilisateur est indécis :

Posez à l'utilisateur…	Répondu par
« Quels outils échouent le plus, ou sont les plus lents ? »	`exploring-mcp-tool-quality` (classe tous les outils), puis `posthog:query-mcp-tool-stats` pour creuser
« Comment l'outil X va-t-il globalement ? »	`posthog:query-mcp-tool-stats` — appels, erreurs, p50/p95, utilisateurs, sessions, intentions
« Comment l'outil X a-t-il évolué ? »	`posthog:query-mcp-tool-daily-stats` — série jour après jour
« Pourquoi l'outil X échoue-t-il ? »	`posthog:query-mcp-tool-failures` — messages d'erreur principaux, par harness (nom d'outil brut)
« Qui utilise le plus l'outil X ? »	`posthog:query-mcp-tool-top-users` — appelants principaux (incl. email/nom de personne)
« Qu'appelle-t-on juste avant/après l'outil X ? »	`posthog:query-mcp-tool-neighbors` (`neighborDirection: before`/`after`)
« Que tentent de faire les agents avec l'outil X ? »	`posthog:query-mcp-tool-sample-intents` — intentions récentes d'agent
« Avec quelle description l'outil X est-il enregistré ? »	`posthog:query-mcp-tool-descriptions` — descriptions distinctes observées
« Quels harnesses utilisent mon MCP, avec quelle fiabilité ? »	`posthog:query-mcp-harness-breakdown` — appels/erreurs/sessions par client
« Que tentent de faire les agents, dans tous les outils ? »	`exploring-mcp-intent-clusters` — grappes d'objectifs sémantiques
« Qui se connecte, et à quel point sont-ils actifs ? »	`posthog:mcp-analytics-sessions-list` — une ligne par session, avec client et personne
« Qu'a fait cette session ? »	`exploring-mcp-sessions` — la séquence d'outils d'une exécution d'agent unique

Trouver le nom de l'outil

Les outils par-outil ont besoin d'un toolName. Si l'utilisateur a nommé un outil, passez-le. S'il a posé une question large de type « quel outil… », commencez par exploring-mcp-tool-quality pour classer les outils, choisissez celui qui se distingue, puis creusez avec les outils par-outil ci-dessus. Le nom à passer est le nom effectif de l'outil (l'outil interne pour les appels wrapper d'exécution unique) — la même chaîne que le classement par qualité d'outil retourne. La seule exception est posthog:query-mcp-tool-failures, qui correspond aux événements $exception par le $mcp_tool_name brut enregistré, pas l'outil interne effectif.

Comment utiliser un outil par-outil

Appelez-le avec le nom de l'outil et une fenêtre, par exemple pour les chiffres principaux d'un outil :

posthog:query-mcp-tool-stats  { "toolName": "<tool>", "dateRange": { "date_from": "-7d" } }

Proposez ensuite un suivi naturel du menu — par exemple après que posthog:query-mcp-tool-stats affiche un taux d'erreur élevé, utilisez posthog:query-mcp-tool-failures ; après qu'il affiche une portée large, utilisez posthog:query-mcp-tool-top-users ou posthog:query-mcp-tool-neighbors.

Quand passer au SQL

Couvert par un outil typé — n'écrivez pas SQL à la main pour ceux-ci :

Question	Outil
Chiffres principaux d'un outil	`posthog:query-mcp-tool-stats`
Tendance jour après jour d'un outil	`posthog:query-mcp-tool-daily-stats`
Erreurs principales d'un outil	`posthog:query-mcp-tool-failures`
Appelants principaux d'un outil	`posthog:query-mcp-tool-top-users`
Outils appelés avant/après un outil	`posthog:query-mcp-tool-neighbors`
Intentions récentes d'agent d'un outil	`posthog:query-mcp-tool-sample-intents`
Descriptions enregistrées d'un outil	`posthog:query-mcp-tool-descriptions`
Utilisation divisée par harness client	`posthog:query-mcp-harness-breakdown`
Lister les sessions	`posthog:mcp-analytics-sessions-list`
Appels d'outil d'une session	`posthog:mcp-analytics-sessions-tool-calls`

Non couvert — utilisez posthog:execute-sql :

Classements inter-outils (la matrice de qualité d'outil — « quel outil génère le plus d'erreurs ? »)
Filtrage de sessions avec erreur (la liste de sessions n'a pas de filtre d'erreur ou de comptage d'erreur)
Noms d'outils effectifs dans une session (posthog:mcp-analytics-sessions-tool-calls retourne le $mcp_tool_name brut, pas l'outil interne d'un appel wrapper)
N'importe quelle ventilation personnalisée

posthog:execute-sql est aussi le fallback quand le flag mcp-analytics est désactivé — chaque outil du tableau ci-dessus est protégé par lui, execute-sql ne l'est pas. Interrogez $mcp_tool_call directement ; le schéma et les recettes se trouvent dans models-mcp.md.

Skills connexes

exploring-mcp-tool-quality — classez les outils par taux d'erreur / latence / portée, puis creusez
exploring-mcp-sessions — une exécution d'agent unique et sa séquence d'outils
exploring-mcp-intent-clusters — objectifs d'agent groupés par similarité sémantique

exploring-mcp-tool-usage