الإعداد في دقيقة واحدة

انسخ رمز API الخاص بك من إعدادات حسابك.
اختر أداتك أدناه والصق المقطع البرمجي، مع استبدال رمز العنصر النائب برمزك.
أعد تشغيل أداة الذكاء الاصطناعي واسألها شيئًا مثل: «ما هو النوع المحتمل للاسم Andrea في إيطاليا؟»

شغّل هذا الأمر الواحد في الطرفية — هذا هو الإعداد بالكامل.

claude mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" gender-api https://mcp.gender-api.com

أضف --scope user لجعل Gender-API متاحًا في جميع مشاريعك وليس في المشروع الحالي فقط.

يتصل Claude Desktop عبر جسر npm صغير يتم تنزيله تلقائيًا. أضف هذا إلى ملف الإعدادات — لا حاجة إلى تثبيت يدوي.

{
  "mcpServers": {
    "gender-api": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.gender-api.com",
        "--header",
        "Authorization:Bearer YOUR_API_TOKEN"
      ]
    }
  }
}

موقع ملف الإعدادات:

macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json

اكتب Authorization:Bearer دون مسافة بعد النقطتين — هكذا يتوقعها الجسر.

أضف هذا في ~/.cursor/mcp.json لجميع المشاريع، أو في .cursor/mcp.json داخل مشروع واحد.

{
  "mcpServers": {
    "gender-api": {
      "url": "https://mcp.gender-api.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

أضف هذا في .vscode/mcp.json داخل مشروعك، أو في mcp.json على مستوى المستخدم لتمكينه في كل مكان.

{
  "servers": {
    "gender-api": {
      "type": "http",
      "url": "https://mcp.gender-api.com",
      "requestInit": {
        "headers": {
          "Authorization": "Bearer YOUR_API_TOKEN"
        }
      }
    }
  }
}

يستخدم VS Code كلمة servers بدلًا من mcpServers، ويتوقع الترويسات داخل requestInit. ونفس الشكل يعمل في Visual Studio وبيئات JetBrains.

أي عميل يدعم MCP عن بُعد يحتاج إلى هذه القيم الثلاث فقط:

Endpoint:  https://mcp.gender-api.com
Transport: streamable-http
Header:    Authorization: Bearer YOUR_API_TOKEN

إذا كان عميلك يدعم خوادم MCP المحلية فقط، فاستخدم جسر npx mcp-remote الموضح في تبويب Claude Desktop — فهو يعمل مع أي عميل يتحدث stdio فقط.

استخدم Gender-API مباشرة داخل أدوات الذكاء الاصطناعي

يتيح لنا MCP Server لأدوات الذكاء الاصطناعي المتوافقة مع MCP استدعاء Gender-API مباشرة. هذا يعني أن مساعدك يمكنه إثراء الأسماء الأولى، والأسماء الكاملة، والأسماء المستخرجة من البريد الإلكتروني، وبيانات بلد المنشأ من خلال استدعاءات أدوات منظمة بدلاً من التعليمات القائمة على الأوامر فقط.

لا شيء لتثبيته ولا شيء لاستضافته: وجّه أداتك إلى https://mcp.gender-api.com وتحقّق من هويتك بنفس رمز Gender-API الذي تستخدمه بالفعل لواجهة API.

ما يمكن للعملاء القيام به باستخدامه

استخدم بيانات Gender-API المباشرة: يمكن لأداتك المدعومة بالذكاء الاصطناعي الاستعلام عن نتائج Gender-API المباشرة بدلاً من اختراع تنسيقات طلبات أو ردود.
أعد استخدام الرمز المميز (token) الحالي الخاص بك: يعمل خادم MCP بنفس الرمز المميز (bearer token) الخاص بـ Gender-API الذي تستخدمه بالفعل للواجهة البرمجية (API).
قم بتوصيل العملاء المتوافقين مع MCP: يمكنك استخدامه في Claude أو Cursor أو أدواتك وعوامل التشغيل الداخلية الخاصة بك المتوافقة مع MCP والتي تدعم روابط MCP المستضافة.
حافظ على بساطة الفواتير: لا يزال استهلاك رصيد Gender-API العادي سارياً، لذا لا يوجد نظام فواتير ثانٍ لتتعلمه.

الأدوات المدعومة

أدوات MCP المضمنة

query_first_name – الاستعلام عن الجنس المحتمل من خلال الاسم الأول.
query_full_name – الاستعلام عن الجنس المحتمل من خلال الاسم الكامل.
query_email – استخراج وإثراء الاسم من عنوان البريد الإلكتروني.
get_country_of_origin – الحصول على بلدان الأصل المحتملة.
get_statistics – التحقق من الرصيد المتبقي وإحصائيات الحساب.

النقل المستضاف

استخدم نقطة النهاية المستضافة Streamable HTTP على https://mcp.gender-api.com وتحقّق من هويتك برمز Gender-API الحالي من نوع bearer.

حالات استخدام MCP في العالم الحقيقي

إثراء بيانات العملاء المحتملين داخل المساعد الذكي (AI copilots)

اسمح لـ Claude أو Cursor أو وكيل مبيعات داخلي بمراجعة قائمة العملاء المحتملين، واستدعاء Gender-API عبر MCP، وإضافة الاسم الأول والجنس وسياق بلد المنشأ المحتمل قبل التواصل.

تخصيص إدارة علاقات العملاء والدعم

يمكن لمساعد الدعم الخاص بك فحص عناوين البريد الإلكتروني الواردة، واستخراج الأسماء الأولى المحتملة باستخدام `query_email` ، وإنشاء مسودات ردود مخصصة وأكثر طبيعية للوكلاء.

وكلاء تنظيف وجداول البيانات والبحث

يمكن لوكلاء تنظيف البيانات المدعومين بـ MCP مراجعة ملفات CSV أو جداول البيانات، وتوحيد أعمدة الاسم الأول، وإثراء الصفوف بنتائج Gender-API دون الحاجة إلى كتابة كود API مخصص في كل سير عمل.

أتمتة التسويق وتجزئة الجمهور

استخدم MCP في مساعدي بناء الحملات لإنشاء التحيات، وإثراء بيانات الاتصال، والتحقق من الرصيد المتبقي قبل إطلاق سير عمل التخصيص.

هل تبني عميل MCP خاصًا بك؟

الاتصال عبر حزمة MCP SDK الرسمية

إذا كنت تكتب وكيلك الخاص بدلًا من استخدام أداة جاهزة، فاتصل بنقل Streamable HTTP مباشرةً:

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const transport = new StreamableHTTPClientTransport(new URL('https://mcp.gender-api.com'), {
  requestInit: {
    headers: {
      Authorization: 'Bearer YOUR_API_TOKEN',
    },
  },
});

الأسئلة الشائعة

01

هل يستخدم هذا رصيد Gender-API العادي الخاص بي؟

نعم. يعد خادم MCP طبقة تكامل رقيقة فوق نقاط نهاية Gender-API الحالية، لذا فإن أذونات الرمز المميز العادية واستهلاك الرصيد لا يزالان ساريين.

02

هل يمكنني استخدامه في أداة MCP الداخلية الخاصة بي؟

نعم. إذا كانت أداتك تدعم MCP المستضاف، فاوصلها بـ https://mcp.gender-api.com وأرسل رمز Gender-API من نوع bearer.

03

هل أحتاج إلى تثبيت أي شيء؟

لا. نحن نستضيف خادم MCP، لذا لا يوجد ما تنزّله أو تبقيه قيد التشغيل. أما العملاء الذين يدعمون خوادم MCP المحلية فقط فيستخدمون جسر npx mcp-remote، الذي ينزّل نفسه عند أول تشغيل.

04

أداة الذكاء الاصطناعي لا تُظهر أدوات Gender-API. ماذا أفعل؟

أعد تشغيل الأداة بعد تعديل إعداداتها، وتأكّد مرة أخرى من أنك استبدلت العنصر النائب للرمز برمز API الحقيقي. وإذا تم رفض الاتصال فإن رمزك غير صالح أو نفدت أرصدته — وكلتا الحالتين تظهران كخطأ في المصادقة.

خادم MCP مستضاف