FormaTeX

\usepackage{mcp}

يستطيع ذكاؤك الاصطناعي تجميع
LaTeX الآن.

FormaTeX يتحدث MCP. امنح Claude أو Cursor أو VS Code أو Codex أو أي عميل MCP وصولًا مباشرًا إلى منظومة تجميع LaTeX كاملة. بلا تبديل للسياق وبلا بنية تحتية.

عرض الإعدادالحصول على مفتاح API
يعمل مع
  • Claude Desktop
  • Claude Code
  • Cursor
  • VS Code
  • OpenAI Codex
  • Windsurf
  • Zed
  • Gemini CLI
  • n8n
  • Cline

كيف يعمل

  1. تطلب من ذكائك الاصطناعي

    اطلب من Claude أو Cursor أو أي عميل MCP كتابة مستند LaTeX أو تجميعه.

  2. MCP يستدعي FormaTeX

    يستدعي المساعد أداة من FormaTeX مع كود LaTeX الخاص بك. نجمّعه نيابةً عنك، فلا حاجة إلى تثبيت TeX Live.

  3. تحصل على رابط تنزيل

    يتضمن الرد تفاصيل التجميع ورابط Download PDF موثّقًا. وعندما يحتاج الوكيل إلى الملف نفسه يستدعي fetch_pdf_bytes.

\begin{tools}

13 أداة يستطيع ذكاؤك الاصطناعي استدعاءها

جمّع LaTeX وتحقق منه وافحصه وأدر قوالبك المحفوظة من داخل المحادثة. وتأتي معها موارد وPrompt موجَّه لإصلاح الأخطاء.

  • compile_smart
    يستهلك الحصة

    يجمّع LaTeX مع اكتشاف المحرك تلقائيًا وإصلاح الأخطاء الشائعة، ويجرّب محركات بديلة عند الحاجة. لا يحتوي على معامل للمحرك. يعيد تفاصيل التجميع ورابط تنزيل لملف PDF.

    جرّب أن تطلب

    جمّع كود LaTeX هذا إلى PDF وأعطني رابط التنزيل

  • compile_latex
    يستهلك الحصة

    يجمّع LaTeX بالمحرك الذي تختاره (pdflatex أو xelatex أو lualatex أو latexmk). يعيد تفاصيل التجميع ورابط تنزيل لملف PDF، وليس محتوى الملف.

    جرّب أن تطلب

    جمّع هذا المستند باستخدام xelatex

  • check_syntax
    لا يستهلك الحصة

    يتحقق من أخطاء الصياغة والأوامر المحظورة والبنية في LaTeX دون تجميع، ويوصي بمحرك مناسب. لا يستهلك الحصة.

    جرّب أن تطلب

    تحقق من صياغة كود LaTeX هذا قبل التجميع

  • list_engines
    لا يستهلك الحصة

    يعرض محركات التجميع المتاحة ومتى يُستخدم كل منها. لا يستهلك الحصة.

    جرّب أن تطلب

    اعرض محركات LaTeX المتاحة

  • get_usage
    لا يستهلك الحصة

    يعرض تجميعات هذا الشهر وحد خطتك وتوزيعها حسب المحرك والحالة لمفتاح API المستخدم. لا يستهلك الحصة.

    جرّب أن تطلب

    كم تجميعة تبقّت لي هذا الشهر؟

  • compile_async
    يستهلك الحصة

    يرسل مهمة تجميع ويعيد معرّف المهمة فورًا. استعلم عنها بـ get_job. مناسب للمستندات الكبيرة والمعالجة الدفعية.

    جرّب أن تطلب

    جمّع هذا المستند بشكل غير متزامن

  • get_job
    لا يستهلك الحصة

    يعيد حالة مهمة غير متزامنة. المهمة المكتملة تعيد رابط تنزيل لملف PDF، والفاشلة تعيد سجل الأخطاء. لا يستهلك الحصة.

    جرّب أن تطلب

    تحقق من حالة المهمة abc123 وأحضر ملف PDF إن كان جاهزًا

  • list_templates
    لا يستهلك الحصةPro أو أعلى

    يعرض قوالبك المحفوظة مع المعرّفات والأسماء والمتغيرات. يتطلب خطة Pro أو أعلى. لا يستهلك الحصة.

    جرّب أن تطلب

    اعرض قوالب LaTeX المحفوظة لدي

  • get_template
    لا يستهلك الحصةPro أو أعلى

    يعيد قالبًا محفوظًا بمعرّفه مع كود LaTeX الكامل وتعريفات متغيراته. استخدمه قبل التحديث لتعديل الكود الحالي. يتطلب خطة Pro أو أعلى. لا يستهلك الحصة.

    جرّب أن تطلب

    أرني كود قالب الفاتورة لدي

  • create_template
    لا يستهلك الحصةPro أو أعلى

    يحفظ قالبًا جديدًا قابلًا لإعادة الاستخدام مع عناصر نائبة للمتغيرات ومحرّك وفئة. تُدرج القيم كما هي، لذا يجب أن تكون LaTeX صالحًا أصلًا. تُضاف الصور والملفات الأخرى من لوحة التحكم. يتطلب خطة Pro أو أعلى، ضمن حد القوالب في خطتك. لا يستهلك الحصة.

    جرّب أن تطلب

    احفظ كود LaTeX هذا كقالب باسم فاتورة مع المتغيرين client وamount

  • update_template
    لا يستهلك الحصةPro أو أعلى

    يعدّل قالبًا محفوظًا. لا يتغير إلا ما تمرّره من حقول؛ ويحل الكود أو قائمة المتغيرات الجديدة محل السابقة، ولا يمكن استرجاع النسخة السابقة. يتطلب خطة Pro أو أعلى. لا يستهلك الحصة.

    جرّب أن تطلب

    غيّر محرّك قالب الفاتورة لدي إلى xelatex وأضف متغير تاريخ الاستحقاق

  • compile_template
    يستهلك الحصةPro أو أعلى

    يجمّع قالبًا محفوظًا بمعرّفه مع استبدال متغيرات اختياري. يعيد تفاصيل التجميع ورابط تنزيل لملف PDF. يتطلب خطة Pro أو أعلى.

    جرّب أن تطلب

    جمّع قالب الفاتورة لدي مع name=Acme Corp وamount=$500

  • fetch_pdf_bytes
    لا يستهلك الحصة

    يجلب ملف PDF المجمّع كبايتات خام (base64) بمعرّف المهمة. هو الأداة الوحيدة التي تعيد محتوى الملف: استخدمه حين يحتاج الوكيل إلى حفظ الملف أو فحصه، وإلا فرابط التنزيل يكفي. لا يستهلك الحصة.

    جرّب أن تطلب

    اجلب بايتات PDF للمهمة abc123 لتحفظها على القرص

الموارد

يمكن للعملاء الداعمين لموارد MCP قراءتها مباشرة.

  • formatex://engines

    محركات LaTeX المتاحة مع إرشادات حول متى يُستخدم كل منها.

  • formatex://usage

    استخدام التجميع لهذا الشهر وحدود الخطة لمفتاح API المستخدم.

fix_latexPrompt

Prompt موجَّه يحلل سجل أخطاء التجميع ويحدد السبب الجذري ويقترح كود LaTeX مصححًا.

استخدم الـ Prompt المسمى fix_latex لمساعدتي في إصلاح هذا الخطأ: [الصق سجل الأخطاء]

\begin{setup}

اربط عميلك

اختر عميلك وطريقة الاتصال ثم انسخ الإعداد. الوضع البعيد لا يحتاج إلى تثبيت أي شيء. الوضع المحلي يشغّل الملف التنفيذي formatex-mcp على جهازك.

العميل

Claude Desktop والموصّلات المخصصة في claude.ai

طريقة الاتصال

يتصل العميل بـ mcp.formatex.io عبر Streamable HTTP. لا شيء لتثبيته. يضيف Claude Desktop وclaude.ai الخوادم البعيدة كموصّلات مخصصة داخل التطبيق، وليس في ملف إعداد.

مفتاح API الخاص بك

أنشئ مفتاحًا من لوحة التحكم. يبدأ بـ fex_ ويُعرض كاملًا مرة واحدة فقط، فانسخه عند إنشائه. يعمل MCP على جميع الخطط بما فيها المجانية.

استبدل YOUR_FORMATEX_API_KEY في المقتطفات بمفتاحك.

أبقِ المفتاح خارج git

ملفات المشروع مثل .mcp.json و.cursor/mcp.json و.vscode/mcp.json تُرفع عادةً إلى المستودع. استخدم متغير البيئة أو ملفًا على مستوى المستخدم، أو أضف الملف إلى .gitignore. وإذا وصل مفتاح إلى مستودع يومًا، فأبطله وأنشئ مفتاحًا جديدًا.

اتبع هذه الخطوات

  1. افتح Customize > Connectors في Claude Desktop أو على claude.ai. في خطط Team وEnterprise يضيفه المالك من Organization settings > Connectors.

  2. اختر Add custom connector وأدخل:

    الاسم
    FormaTeX
    URL
    https://mcp.formatex.io/mcp

  3. صادق على FormaTeX. كلا الخيارين يعمل:

    • تسجيل الدخول. يفتح Claude صفحة FormaTeX لتلصق فيها مفتاح API مرة واحدة. لا شيء آخر لنسخه.

    • ترويسات الطلب. أضف هذه الترويسة بدلًا من تسجيل الدخول:

      الترويسة
      Authorization: Bearer YOUR_FORMATEX_API_KEY

  4. فعّل FormaTeX في محادثتك ثم شغّل الطلب أدناه.

ملاحظات مفيدة

  • الموصّلات المخصصة متاحة في جميع الخطط. يمكن للحسابات المجانية إضافة موصّل واحد.

جرّبه

في Claude Desktop، شغّل هذا الطلب للتحقق من التكامل:

استخدم FormaTeX لتجميع مستند LaTeX من صفحة واحدة يقول Hello, FormaTeX وأعطني رابط التنزيل.

عند نجاح الإعداد يظهر في الرد استدعاء أداة مثل compile_smart ورابط Download PDF.

المصادقة

أرسل مفتاح API (يبدأ بـ fex_) في ترويسة Authorization: Bearer أو X-API-Key. يسجّل موصّل Claude الدخول عبر OAuth، وتطلب صفحة التفويض فيه المفتاح مرة واحدة.

الخطط

يعمل MCP على جميع الخطط بما فيها المجانية، وتُحتسب التجميعات ضمن الحصة الشهرية نفسها لاستدعاءات REST. تتضمن الخطة المجانية pdflatex وxelatex. وتضيف Pro وما فوقها lualatex وlatexmk والقوالب المحفوظة.

وسيلة النقل

Streamable HTTP على https://mcp.formatex.io/mcp. لا توجد نقطة نهاية SSE، لذا ينبغي للعميل الذي يدعم SSE فقط استخدام الملف التنفيذي المحلي. يعرض GET /health حالة الخادم.

\begin{document}

هل أنت مستعد لربط ذكائك الاصطناعي؟

احصل على مفتاح API وأضف الإعداد وسيجمّع مساعدك LaTeX في الرسالة التالية.

توثيق MCPالحصول على مفتاح API