English Français العربية

io.github.Dan-Cleary/convalytics

السجل الرسمي التسويق والمبيعات

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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_...'\''.>'
إعداد 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_...'.>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو io.github.Dan-Cleary/convalytics؟

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

كيف أثبّت io.github.Dan-Cleary/convalytics؟

يعمل كخادم بعيد. في 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_...'\''.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Dan-Cleary/convalytics إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل io.github.Dan-Cleary/convalytics مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون io.github.Dan-Cleary/convalytics؟

ينشره Dan-Cleary. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.