كيف تبدأ مع خادم PostHog MCP

هل أنت مستعد لتعزيز تجربة بياناتك باستخدام الذكاء الاصطناعي؟ يتيح لك **خادم PostHog MCP** إدارة تحليلات PostHog—مثل إنشاء التعليقات التوضيحية أو استعلام اتجاهات المستخدم—باستخدام اللغة الطبيعية في أدوات مثل Cline أو Cursor. لقد قمت بتشغيله في بضع دقائق فقط، وهو يغير قواعد اللعبة تمامًا! في هذا البرنامج التعليمي، سنقوم بتثبيت **خادم PostHog MCP** على Cline في VS Code و Cursor، ونستكشف ميزاته القاتلة، ونرى لماذا يتفوق PostHog على Google Analytics في التحليلات مفتوحة المصدر. دعنا نغوص في سحر **خادم PostHog MCP**!

💡

هل تريد أداة رائعة لاختبار واجهات برمجة التطبيقات (API) تولد وثائق API جميلة؟

هل تريد منصة متكاملة وشاملة لفريق المطورين لديك للعمل معًا بأقصى إنتاجية؟

يلبي Apidog جميع متطلباتك، ويحل محل Postman بسعر أكثر بأسعار معقولة!

زر

ما هو خادم PostHog MCP؟

إن **خادم PostHog MCP** هو خادم بروتوكول سياق النموذج (MCP) مفتوح المصدر يربط مساعدي الذكاء الاصطناعي (مثل Cline أو Cursor) بمنصة تحليلات PostHog عبر أوامر اللغة الطبيعية. إنه يمكّن من أداء مهام مثل إنشاء التعليقات التوضيحية، وإدارة المشاريع، واستعلام الرؤى، وتبديل علامات الميزات—كل ذلك دون الحاجة إلى لمس واجهة مستخدم PostHog. تشمل الميزات الرئيسية:

**إدارة المشاريع**: سرد وإدارة مشاريع PostHog.
**التعليقات التوضيحية**: إضافة ملاحظات موقوتة للأحداث (مثل إطلاق المنتجات).
**استعلامات الرؤى**: تحليل سلوك المستخدم (مثل اتجاهات التسجيل).
**علامات الميزات**: التحكم في علامات الميزات والاستعلام عنها ديناميكيًا.
**تتبع الأخطاء**: تصحيح الأخطاء مباشرة في بيئة التطوير المتكاملة (IDE) الخاصة بك.

إنه "لا غنى عنه" لأتمتة التحليلات، مع أكثر من 34 نجمة على GitHub تظهر حب المجتمع له. هل أنت مستعد لتجربته؟ لنبدأ

لماذا تستخدم خادم PostHog MCP؟

يعمل **خادم PostHog MCP** على تبسيط سير عمل التحليلات باستخدام الأتمتة المدعومة بالذكاء الاصطناعي. إليك سبب روعته:

**اللغة الطبيعية**: إدارة التحليلات بأوامر بسيطة.
**التكامل**: يعمل مع Claude Desktop، و VS Code، و Cursor، والمزيد.
**مفتوح المصدر** (الجزء الأفضل): مجاني، قابل للتخصيص، ومدعوم من المجتمع.
**الخصوصية أولاً**: على عكس Google Analytics، يقدم PostHog خيارات استضافة ذاتية للتحكم الكامل في البيانات.

مقارنةً بـ Google Analytics، يتألق PostHog بشفافيته مفتوحة المصدر، ومرونة الاستضافة الذاتية، ومجموعة منتجاته الشاملة (التحليلات، إعادة تشغيل الجلسات، علامات الميزات). غالبًا ما يتطلب Google Analytics تكاملات من جهات خارجية ويفتقر إلى تركيز PostHog على الخصوصية، مما يجعل **خادم PostHog MCP** بديلاً صديقًا للمطورين للفرق الحديثة.

لقد استخدمته لتدوين ملاحظات حول إطلاق منتج في ثوانٍ—أسرع بكثير من النقر عبر لوحات المعلومات!

كيفية تثبيت واستخدام خادم PostHog MCP: دليل خطوة بخطوة

دعنا نثبت **خادم PostHog MCP** على Cline في VS Code و Cursor، ثم نختبره بأمثلة. ستحتاج إلى Python، ومفتاح PostHog API، وبيئة تطوير متكاملة (IDE). لا يتطلب الأمر أن تكون خبيرًا في التحليلات—فقط اتبع الخطوات!

1. المتطلبات الأساسية

**بايثون (Python)**: 3.8+ (`python3 --version`).
**uv**: مدير حزم بايثون (`pip install uv`).
**VS Code/Cursor**: أحدث إصدار مع إضافة Cline.
**مفتاح PostHog API**: احصل عليه من app.posthog.com/settings (مفتاح API شخصي).
**دوكر (Docker)**: اختياري للإعداد في حاويات (`docker --version`).
**مساحة القرص**: حوالي 500 ميجابايت للمستودع والتبعيات.

2. استنساخ مستودع PostHog MCP

افتح الطرفية الخاصة بك واستنسخ المستودع:

git clone https://github.com/PostHog/mcp.git
cd mcp

هذا يسحب مشروعًا بحجم 5 ميجابايت تقريبًا. استغرق مني بضع ثوانٍ على Wi-Fi.

3. تثبيت خادم PostHog MCP باستخدام Cline في VS Code

**إعداد بيئة افتراضية**:

uv venv
source .venv/bin/activate  # macOS/Linux
.venv\Scripts\activate  # Windows
uv pip install .

**تكوين مفتاح API**:
أنشئ ملف `.env` في جذر المشروع:

echo "PERSONAL_API_KEY=your-personal-api-key" > .env

استبدل `your-personal-api-key` بمفتاح PostHog API الخاص بك (الذي يمكنك الحصول عليه من موقعهم الرسمي).

**تثبيت Cline**:
في VS Code، اذهب إلى الإضافات (Ctrl+Shift+X)، ثبّت **Cline**، وافتح لوحة دردشة Cline (Ctrl+Shift+P، "Cline: Open Chat").

**إضافة خادم MCP**:
اطلب من Cline:

Install the PostHog MCP Server using uv and configure it with my API key.

يقوم Cline بتشغيل `uv run posthog_mcp` ويحدث `~/.aws/amazonq/mcp.json`:

{
  "mcpServers": {
    "posthog": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp", "run", "posthog_mcp"],
      "env": {
        "PERSONAL_API_KEY": "your-personal-api-key"
      }
    }
  }
}

استبدل `/path/to/mcp` بمسار المستودع الخاص بك (على سبيل المثال، `/home/user/mcp`).

يمكن العثور على خادم MCP أيضًا في سوق MCP الخاص بـ Cline. ما عليك سوى التوجه إلى هناك والبحث عن "PostHog"، ثم النقر على تثبيت.

سيقوم Cline تلقائيًا بإجراء التثبيت لك

**التحقق**: قم بتشغيل `/tools` في دردشة Cline لسرد الأدوات (مثل `create_annotation`، `list_projects`). هل ترى أيقونة خوادم MCP في Cline؟ أنت جاهز.

4. تثبيت خادم PostHog MCP باستخدام Cursor

**الاستنساخ والتثبيت**: كرر إعداد الاستنساخ والبيئة الافتراضية للخطوة 2.
**تكوين Cursor**:
افتح Cursor، اذهب إلى الإعدادات > الأدوات والتكاملات > أدوات MCP > إضافة خادم MCP مخصص، وأضف تكوين الخادم إلى `.cursor/mcp.json`:

{
  "mcpServers": {
    "posthog": {
      "command": "/path/to/uv",
      "args": ["--directory", "/path/to/mcp", "run", "posthog_mcp"],
      "env": {
        "PERSONAL_API_KEY": "your-personal-api-key"
      }
    }
  }
}

ابحث عن مسار `uv` باستخدام `which uv` (macOS/Linux) أو `where uv` (Windows).

**إعادة تشغيل Cursor**: انقر على زر التحديث في الإعدادات > الأدوات والتكاملات > أدوات MCP.
**التحقق**: اسأل Cursor: "سرد أدوات خادم PostHog MCP المتاحة." يجب أن يعرض `create_annotation`، `list_projects`، إلخ.

5. اختبار ميزات خادم PostHog MCP

**إنشاء تعليق توضيحي**:
في Cline (VS Code) أو Cursor، اطلب:

Create a PostHog annotation in project 53497 for March 20th, 2025, with the description 'Launched new user onboarding flow' using the PostHog MCP Server.

يقوم الخادم باستدعاء واجهة برمجة تطبيقات PostHog، ويضيف التعليق التوضيحي. تحقق من app.posthog.com للتأكيد.

**استعلام الرؤى**:
اطلب:

Show the trend of user sign-ups in project 98765 over the last 30 days using 
the PostHog MCP Server.

يقوم الخادم بجلب بيانات منظمة (مثل JSON مع اتجاهات التسجيل). مثال على المخرجات:

{
  "insight": "user_signups",
  "project_id": 98765,
  "data": [
    {"date": "2025-06-01", "count": 120},
    {"date": "2025-06-02", "count": 135}
  ]
}

لقد قمت بتشغيل هذا وحصلت على بيانات نظيفة في حوالي 5 ثوانٍ—سلس للغاية

6. الإعداد في حاويات (اختياري)

لإعداد Docker:

docker run -i --rm -e PERSONAL_API_KEY=your-personal-api-key ghcr.io/metorial/mcp-container--posthog--posthog-mcp--posthog-mcp posthog-mcp

أضف إلى ملف `mcp.json` الخاص بـ Cline/Cursor:

{
  "mcpServers": {
    "posthog": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/metorial/mcp-container--posthog--posthog-mcp--posthog-mcp", "posthog-mcp"],
      "env": {
        "PERSONAL_API_KEY": "your-personal-api-key"
      }
    }
  }
}

أعد التشغيل وتحقق كما هو موضح أعلاه. عملية تنظيف Docker (`--rm`) وفرت لي مساحة على القرص.

7. استكشاف الأخطاء الشائعة وإصلاحها

**لا توجد أيقونة مطرقة**:
تحقق من السجلات: `~/Library/Logs/Claude/mcp*.log` (macOS) أو `%APPDATA%\Claude\logs` (Windows).
تأكد من المسارات المطلقة في `mcp.json`.
**أخطاء مفتاح API**:
تحقق من أذونات المفتاح في app.posthog.com/settings.
استخدم متغيرات البيئة، وليس المفاتيح المكتوبة مباشرة.
**الخادم لا يعمل**:
قم بتشغيل `uv run posthog_mcp` يدويًا للتحقق من الأخطاء.
تأكد من وجود Python 3.8+ والتبعيات (`uv pip install .`).
**هل تحتاج مساعدة؟** تحقق من github.com/PostHog/mcp أو X للحصول على نصائح.

لماذا يتفوق PostHog على Google Analytics

يتكامل **خادم PostHog MCP** من PostHog مع منصته، التي تتفوق على Google Analytics في:

**مفتوح المصدر**: استضافة ذاتية مجانية، على عكس قيود Google Analytics الاحتكارية.
**الخصوصية**: التحكم في البيانات باستخدام مثيلات مستضافة ذاتيًا؛ Google Analytics يشارك البيانات مع Google.
**شامل**: تحليلات، إعادة تشغيل الجلسات، علامات الميزات، والتجارب في منصة واحدة، مقابل أدوات Google المجزأة.
**الأتمتة**: يمكّن **خادم PostHog MCP** من استعلامات اللغة الطبيعية، على عكس لوحات معلومات Google Analytics اليدوية.
**المجتمع**: أكثر من 1,500 نجمة على GitHub ودعم نشط، ينافس Google ولكن بمرونة مفتوحة المصدر.

لقد قمت بتحويل مشروع جانبي إلى PostHog وأحببت التحكم في الخصوصية وعلامات الميزات—لا يوجد انتفاخ من Google Analytics!

تخصيص وتوسيع خادم PostHog MCP

ارفع مستوى إعدادك:

**أدوات مخصصة**: أضف أدوات جديدة إلى الخادم (مثل رؤى SQL المخصصة) عبر github.com/PostHog/mcp.
**مشاريع متعددة**: استعلم عن جميع المشاريع باستخدام "سرد جميع المشاريع في مؤسسة PostHog الخاصة بي".
**علامات الميزات**: توليد كود لتبديل العلامات:

Generate a Python snippet to toggle feature flag 'new-ui' in project 12345
using the PostHog MCP Server.

**المساهمة**: أرسل طلبات السحب (PRs) لتحسين الخادم—PostHog يرحب بها

لماذا يعد خادم PostHog MCP ضروريًا للمطورين

يجعل **خادم PostHog MCP** أتمتة التحليلات تبدو وكأنها محادثة مع خبير بيانات. تتفوق واجهته باللغة الطبيعية وميزة PostHog مفتوحة المصدر على Google Analytics للفرق المهتمة بالخصوصية. قد يكون الإعداد دقيقًا (مشاكل مفتاح API!)، لكن وثائق PostHog والمجتمع منقذون.

هل أنت مستعد لاستخدام **خادم PostHog MCP**؟ قم بتشغيل Cline أو Cursor، واستعلم عن تلك الرؤى، وشارك نجاحاتك التحليلية—أنا متحمس لرؤية إعدادك يتألق!

💡

زر