كل التوثيق

خادم MCP

امنح Claude ووكلاء الذكاء الاصطناعي الآخرين بحثًا للقراءة فقط في قنوات تيليجرام العامة.

عنوان الخادم https://mcp.opentg.ai/mcp

المصادقة

أرسل مفتاح API في ترويسة Authorization. إنه المفتاح نفسه والحصة اليومية نفسها كما في REST API.

Authorization: Bearer otg_live_...

سجّل الدخول لإنشاء مفتاح API مجاني

الربط

تطبيقات Claude وموقع claude.ai

  1. افتح Settings ← Connectors واختر "Add custom connector".
  2. سمّه OpenTG والصق عنوان الخادم.
  3. اختر الاتصال دون تسجيل دخول، ثم أضف ترويسة طلب باسم Authorization وقيمتها Bearer متبوعة بمسافة ثم مفتاحك.
  4. احفظ، ثم اطرح سؤالًا في محادثة. يستدعي Claude الأدوات عندما يحتاج إلى منشورات من تيليجرام.

Claude Code

claude mcp add --transport http opentg https://mcp.opentg.ai/mcp \
  --header "Authorization: Bearer $OPENTG_API_KEY"

عملاء MCP آخرون

أي عميل يدعم خوادم Streamable HTTP البعيدة مع ترويسات مخصصة:

{
  "mcpServers": {
    "opentg": {
      "type": "http",
      "url": "https://mcp.opentg.ai/mcp",
      "headers": { "Authorization": "Bearer ${OPENTG_API_KEY}" }
    }
  }
}

الأدوات وتكلفتها

تكلّف استدعاءات الأدوات المدفوعة بالضبط ما يكلّفه طلب REST المقابل. تنتهي كل نتيجة بعدد الوحدات المخصومة والمتبقية.

الأداةالتكلفةالوصف
get_usageمجانيةتاريخ اليوم (UTC) والحصة المتبقية والخطة. يستدعيها الوكلاء أولًا.
check_queryمجانيةتفحص استعلام البحث بحثًا عن أخطاء دون تنفيذه.
search_posts1بحث في النص الكامل خلال آخر 30 يومًا، الأحدث أولًا. يجري البحث الأطول من 7 أيام أسبوعًا بأسبوع، بوحدة واحدة لكل أسبوع، لذا تكلّف 30 يومًا 4 وحدات. اطلب أسبوعًا واحدًا للحصول على أحدث المنشورات فقط مقابل وحدة واحدة.
channel_posts1منشورات قناة مفهرسة واحدة، الأحدث أولًا، بما فيها الأقدم من 30 يومًا.
find_channels1تجد القنوات المفهرسة حسب الموضوع أو اللغة أو الحجم.
get_channel1ملف قناة واحدة.
get_post1النص الكامل لمنشور واحد من رابطه.
live_channel2تقرأ قناة عامة مباشرة من تيليجرام، حتى 100 منشور.
read_postsمجانيةالنص الكامل لصفوف مختارة من صفحة جُلبت مسبقًا.
more_resultsمجانيةبقية صفحة أطول من أن تتسع لنتيجة واحدة.

معلومات مفيدة

  • كل الأدوات للقراءة فقط. لا يُنشر أي شيء ولا يُغيَّر.
  • نص المنشورات محتوى من أطراف ثالثة. يُنظَّف ويُعلَّم كبيانات لا كتعليمات، لكن على الوكيل أن يعامله كمحتوى غير موثوق.
  • "لم يُعثر على شيء" تعني أنه لم يُعثر عليه في القنوات المفهرسة خلال آخر 30 يومًا، لا أنه لم يحدث قط.
  • في خطتي Starter وPro تظهر استدعاءات الأدوات في سجل طلباتك مع علامة MCP.

البروتوكول

Streamable HTTP عديم الحالة: JSON-RPC عبر POST دون جلسات. إصدارات البروتوكول المدعومة: 2026-07-28 و2025-11-25 و2025-06-18 و2025-03-26.