GhostCrab Telemetry Collector

English — What this service collects

This host runs an opt-in telemetry webhook for Mindflight products (for example GhostCrab MCP). It exists to understand aggregate adoption: approximate environment dimensions such as product line, optional GhostCrab edition (personal vs pro), software version, operating system family, deployment mode (standalone, Docker, etc.), and broad categories of agent host when declared by the emitter.

We do not use this endpoint to collect personal data. The design goal is anonymous, minimal, high-level usage statistics:

No prompts, MCP payloads, workspace contents, repository names, file paths, hostnames, or usernames.
No storage of full client IP addresses in application payloads (reverse proxies should avoid logging raw bodies).
A pseudonymous installation identifier (telemetry_id) may be generated locally by the emitter only when telemetry is enabled, to deduplicate installs—not to identify individuals.

Detailed JSON contracts are documented in the repository under docs/openapi.yaml. Ingestion for compatible clients is via POST /v1/ping using schema versions described there.

Français — Usage de la télémétrie

Ce service expose une URL de télémétrie facultative pour les produits Mindflight (par exemple GhostCrab MCP). Elle sert à mesurer l’adoption agrégée : lignée produit, éventuelle édition GhostCrab (perso vs pro), version logicielle, famille de système d’exploitation, mode d’exécution (standalone, Docker, etc.), et grandes catégories d’hôte agent lorsque l’émetteur les déclare.

Aucune donnée personnelle n’est visée. Seules des statistiques d’usage anonymes et minimales sont attendues :

Pas de prompts, charges MCP, chemins fichiers, noms de dépôt, noms de machine ou noms d’utilisateur.
Pas de conservation d’adresses IP complètes dans les données applicatives (éviter aussi les journaux de corps de requête bruts).
Un identifiant d’installation pseudonyme (telemetry_id), créé localement par l’émetteur uniquement si la télémétrie est activée, pour dédoublonner les installations — pas pour identifier une personne.

Le contrat JSON précis figure dans le dépôt (docs/openapi.yaml). Les clients compatibles envoient les pings via POST /v1/ping selon les versions de schéma décrites.