English Français العربية

io.github.Dan-Cleary/convalytics

Registre officiel Marketing et ventes

Read-only analytics for Convex apps, queryable via MCP from Claude, Cursor, and other clients.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http convalytics 'https://api.convalytics.dev/mcp' --header 'Authorization: <Convalytics API token. Create at https://convalytics.dev/tokens. Paste as '\''Bearer cnv_...'\''.>'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "convalytics": {
            "type": "http",
            "url": "https://api.convalytics.dev/mcp",
            "headers": {
                "Authorization": "<Convalytics API token. Create at https://convalytics.dev/tokens. Paste as 'Bearer cnv_...'.>"
            }
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Convalytics
  2. What is Convalytics?
  3. Quick start
  4. Packages
  5. Project structure
  6. Tech stack
  7. Development
  8. Links

Convalytics

Web analytics and product event tracking built for Convex apps.

Dashboard: convalytics.dev

What is Convalytics?

Convalytics gives Convex apps two things:

  1. Web analytics — automatic page views, sessions, bounce rate, referrers, and device/browser breakdowns via a lightweight script tag.
  2. Product event tracking — track signups, payments, feature usage, and any custom event directly from Convex mutations and actions. Server-side events can't be blocked by ad blockers.

Everything flows into a single dashboard. Projects auto-provision on first event — no account required to start tracking.

Quick start

npx convalytics init

This auto-provisions a project, installs the Convex component, patches convex/convex.config.ts, creates convex/analytics.ts with the write key inlined, inserts the browser script tag into index.html, and installs a skill file for AI agents. Works with Cursor, Claude Code, and other AI coding agents out of the box.

Packages

PackageDescription
convalytics-devConvex component for server-side event tracking
convalyticsCLI for zero-config project setup

Project structure

convalytics/
  convex/          # Convex backend — dashboard API, ingest, billing, auth
  src/             # React frontend — dashboard UI
  cli/             # CLI (published as convalytics on npm)

The Convex component (convalytics-dev on npm) lives in its own repo: Dan-Cleary/convalytics-convex-component

Tech stack

  • Backend: Convex — database, server functions, scheduled jobs, real-time queries
  • Frontend: React 19, React Router v7, TailwindCSS v4, Vite, Recharts
  • Hosting: Vercel (frontend), Convex Cloud (backend)
  • Billing: Stripe (usage-based tiers)
  • Email: Resend + React Email

Development

npm install
npm run dev

This starts both the Vite frontend and convex dev in parallel.

Questions fréquentes

Qu'est-ce que io.github.Dan-Cleary/convalytics ?

Read-only analytics for Convex apps, queryable via MCP from Claude, Cursor, and other clients.

Comment installer io.github.Dan-Cleary/convalytics ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http convalytics 'https://api.convalytics.dev/mcp' --header 'Authorization: <Convalytics API token. Create at https://convalytics.dev/tokens. Paste as '\''Bearer cnv_...'\''.>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.Dan-Cleary/convalytics ?

Oui. Il attend Authorization, à renseigner dans sa configuration.

io.github.Dan-Cleary/convalytics est-il open source ?

Oui. Son code est sur GitHub sous licence Apache-2.0.

Qui maintient io.github.Dan-Cleary/convalytics ?

Il est publié par Dan-Cleary. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.