التوثيق
Grok: ربط AutoPSEO عبر MCP
استخدم خادم MCP الخاص بـ AutoPSEO من Grok: أضفه كموصّل مخصّص على grok.com، أو سجّله في Grok Build، أو أرفقه كأداة بعيدة في xAI API.
يصل Grok إلى AutoPSEO عبر خادم MCP نفسه الذي تستخدمه بقية المساعدات، على العنوان https://app.autopseo.com/mcp. لا يلزم تثبيت أي شيء خاص بـ Grok: تتيح xAI إرفاق خوادم MCP البعيدة في ثلاثة أماكن، هي grok.com ووكيل الطرفية Grok Build وxAI API، ويعمل AutoPSEO في كل منها بالأدوات والصلاحيات والخطة المرتبطة بحسابك. تعرض هذه الصفحة خطوات كل طريقة، وما يجب التحقق منه عند فشل الاتصال.
Grok على الويب
يوضح دليل الموصّلات من xAI إعداد الموصّلات المخصّصة في ثلاث خطوات:
- انتقل إلى grok.com/connectors.
- اختر New Connector ثم Custom.
- أدخل
https://app.autopseo.com/mcpبوصفه عنوان خادم MCP، ثم أكمل تسجيل الدخول. ستُفتح صفحة تسجيل الدخول والموافقة الخاصة بـ AutoPSEO؛ وافق بالحساب الذي يضم مواقعك.
تذكر xAI أن الموصّلات متاحة لجميع مستخدمي Grok، وأنه في خطتي Business وEnterprise يجب أن يفعّل مسؤول الفريق الموصّل أولًا قبل أن يتمكن الأعضاء من استخدامه. بعد الاتصال، اطلب من Grok «عرض خصائص Search Console في حسابي» للتأكد من أنه وصل إلى الحساب الصحيح وتعرّف على الأسماء الدقيقة للخصائص.
Grok Build
يضيف Grok Build، وهو وكيل الطرفية من xAI، خادمًا بعيدًا بأمر واحد (دليل MCP من xAI):
grok mcp add --transport http autopseo https://app.autopseo.com/mcp
عند أول استخدام لأي أداة، يفتح Grok Build صفحة تسجيل الدخول في المتصفح ويحفظ الرمز بنفسه. وعلى جهاز لا يتوفر فيه متصفح، مرّر مفتاح API بدلًا من ذلك واحتفظ به في متغير بيئة:
grok mcp add --transport http autopseo https://app.autopseo.com/mcp --header "Authorization: Bearer ${AUTOPSEO_API_KEY}"
كما يحمّل Grok Build الخوادم المهيأة لـ Claude Code (~/.claude.json) ولـ Cursor (.cursor/mcp.json) وفي ملف .mcp.json الخاص بالمشروع، فإذا كنت قد أضفت خادم AutoPSEO في أيٍّ منها فسيظهر دون أي خطوة إضافية. وفي واجهته، يعرض الأمر /mcps قائمة الخوادم ويتيح لك المصادقة على أيٍّ منها.
xAI API
يمكن للوكلاء المبنيين على xAI API استدعاء AutoPSEO بوصفه أداة MCP بعيدة. تدعم xAI ذلك في حزمة SDK الأصلية لديها وفي Responses API المتوافقة مع OpenAI عبر Streamable HTTP، باستخدام server_url وserver_label وقيمة authorization اختيارية للرمز (أدوات MCP البعيدة). يبدو أحد عناصر المصفوفة tools على النحو التالي:
{
"type": "mcp",
"server_label": "autopseo",
"server_url": "https://app.autopseo.com/mcp",
"authorization": "apk_live_..."
}
لا تدعم xAI المعامل require_approval الخاص بـ Responses API، ولذلك لا يتوقف شيء لطلب الموافقة قبل تشغيل الأداة. امنح الوكلاء مفتاح Read only ما لم يكن عليهم تغيير شيء: يرفض AutoPSEO المفتاح للقراءة فقط في كل أداة تكتب أو تستهلك رصيد البحث.
أي وصول تمنحه لـ Grok
| الاستخدام | طريقة الاتصال |
|---|---|
| أسئلة في محادثات grok.com | تسجيل الدخول |
| Grok Build على جهازك الشخصي | تسجيل الدخول، أو مفتاح على جهاز بلا متصفح |
| وكلاء يعملون دون إشراف على xAI API | مفتاح Read only، أو Read & write عندما يحتاج الوكيل إلى تنفيذ إجراءات |
تظهر الاتصالات التي أُجريت بتسجيل الدخول في صفحة MCP & API ضمن Signed-in tools، حيث يمكنك تسجيل الخروج من أي منها، وتُلغى المفاتيح في الصفحة نفسها. تُشرح مجموعات الأدوات وفئات الوصول والحدود في MCP & ChatGPT، ويتضمن دليل الربط مع Grok أمثلة على الطلبات.
استكشاف الأخطاء وإصلاحها
- لا يستطيع Grok الوصول إلى الخادم. تشترط xAI أن يكون الخادم متاحًا عبر الإنترنت العام، وهذا ما ينطبق على خادم AutoPSEO، فتحقق من العنوان: أدخل
https://app.autopseo.com/mcpكما هو تمامًا، بما في ذلك/mcp. - لا تظهر أي خصائص. اطلب الأداة
whoamiلمعرفة حساب AutoPSEO الذي يستخدمه الاتصال. فإن كان الحساب صحيحًا، اربط Search Console به أولًا. - رُفضت إحدى الأدوات. لا يستطيع المفتاح للقراءة فقط الكتابة أو استهلاك الرصيد، ولا يستطيع عضو الفريق الذي لديه صلاحية Read سوى القراءة.
- HTTP 429. الحدود هي 60 استدعاءً في الدقيقة لكل مفتاح و1,000 في الساعة لكل حساب.
- الاشتراك مطلوب. انتهت الفترة التجريبية للحساب؛ اختر خطة من الاشتراك والفوترة.
تُحتسب الزيارات التي يرسلها Grok إلى موقعك في تقرير LLM Traffic ضمن GA4.