Documentation menu

ربط Claude

الخطوات

  1. في Claude، انتقل إلى Settings → Connectors → Add custom connector.
  2. الصق https://mailinapp.com/api/mcp رابطًا لخادم MCP البعيد.
  3. يفتح Claude شاشة موافقة OAuth الخاصة بـ MailInApp في متصفحك. سجّل الدخول إن لزم الأمر، واختر الحساب الذي ينبغي أن يعمل باسمه إن كنت تنتمي إلى أكثر من حساب، واختر نطاقاتك، ثم وافق.
  4. يعيد Claude الاتصال تلقائيًا وتظهر الأدوات في دردشتك التالية.

تعمل الخطوات نفسها من الاتصالات في لوحة تحكم MailInApp (/dashboard/connections)، التي تتضمن زرًا لنسخ الرابط ولصقه والمخطط نفسه ذا الخطوات الثلاث لكل منصة.

Claude Desktop: التثبيت بدلًا من اللصق

إن كنت تستخدم تطبيق سطح المكتب، فلا حاجة إلى كتابة الرابط إطلاقًا — بل ثبّت إضافة سطح المكتب .mcpb من Settings → Extensions بدلًا من ذلك. فهي تشير إلى خادم MCP البعيد نفسه تمامًا وشاشة موافقة OAuth نفسها الموضّحين في الخطوات أعلاه؛ والفرق الوحيد أن Claude Desktop يتولى الاتصال وإعادة التشغيل نيابة عنك بدلًا من أن تلصق رابطًا في Connectors. ويظل أول استدعاء لأداة يفتح متصفحك للموافقة على شاشة الموافقة واختيار النطاقات، ويظل الإلغاء من الاتصالات في لوحة التحكم ساريًا فورًا، أيًّا كانت الطريقة التي ربطت بها.

ما ستراه في شاشة الموافقة

كل نطاق للقراءة فقط، إضافة إلى إدارة جهات الاتصال/القوالب، محدّد مسبقًا. أما campaigns:send — الذي يتيح لـ Claude مراسلة جهات اتصالك فعلًا — فهو معطّل افتراضيًا ويُعرض بمعالجة تحذيرية مميّزة؛ حدّده صراحةً إن أردت أن تتمكن دردشة من إطلاق إرسال حقيقي. راجع النطاقات والصلاحيات لمعرفة ما يتيحه كلٌّ منها بالضبط.

الأدوات المرئية في Claude

يدعم Claude تطبيقات MCP Apps، فتعرض ثلاث من الأدوات بطاقة تفاعلية مباشرة في المحادثة بدلًا من نص عادي: تعرض preview_email/أدوات التعديل معاينة حيّة لسطح المكتب/الهاتف للرسالة قيد البناء، وتعرض get_campaign_results لوحة نتائج، وتعرض prepare_send بطاقة بعدد المستلمين الدقيق والمعاينة مع زر Confirm & Send الخاص بها — فتكون الموافقة على الإرسال نقرةً على تلك البطاقة، لا شيئًا يستطيع Claude إقناع نفسه به نيابة عنك.

إن توقف الاتصال عن العمل

  • رسالة «Couldn't reach the MCP server» عند الربط الأول تكون عابرة في الغالب تقريبًا — أعد المحاولة مرة واحدة. وإن استمرت، فتحقق من الاتصالات في لوحة التحكم للتأكد من عدم وجود اتصال قديم لديك من العميل نفسه يحتاج إلى إلغائه أولًا.
  • فشل استدعاء أداة بخطأ في الصلاحيات — فالنطاق الذي تحتاجه لم يُمنح. ألغِ الاتصال في لوحة التحكم وأعد الربط، مختارًا ذلك النطاق في شاشة الموافقة هذه المرة.
  • غيّرت فريقك، أو ألغى زميل وصولك — يُعاد التحقق من رمز الموصّل مقابل عضويتك الحيّة في الحساب مع كل استدعاء، لذا فإن فقدان الوصول إلى شركة (كأن يزيلك مالك الفريق) يعطّل استدعاءات ذلك الاتصال فورًا، دون أن تحتاج إلى فعل أي شيء من جهة Claude.

الإلغاء

تعرض الاتصالات في لوحة التحكم كل مساعد وافقت عليه، بما فيه Claude، مع زر إلغاء بنقرة واحدة — يسري فورًا، بمعزل عن أي شيء تفعله داخل Claude نفسه.