Claude

Claude Code

أضف الخادم المستضاف من الطرفية. يجعل الخيار --scope user الخادم متاحًا في كل المشاريع؛ احذفه لإضافته إلى المشروع الحالي فقط.

claude mcp add --transport http --scope user jokerprice https://jokerprice.com/mcp --header "Authorization: Bearer ss_your_key_here"

تحقق منه باستخدام claude mcp list، أو /mcp داخل الجلسة.

ولاستخدام الخادم المحلي بدلًا من ذلك:

claude mcp add jokerprice --scope user --env JOKERPRICE_API_KEY=ss_your_key_here -- node /absolute/path/to/mcp/index.mjs

شاركه مع مشروع

لمشاركة الإعداد مع فريقك دون مشاركة المفتاح، أضف ملف .mcp.json إلى جذر المشروع، ودع كل شخص يحتفظ بمفتاحه في JOKERPRICE_API_KEY ضمن بيئته الخاصة. يوسّع Claude Code المراجع بصيغة ${VAR}، بما في ذلك داخل الترويسات.

{
  "mcpServers": {
    "jokerprice": {
      "type": "http",
      "url": "https://jokerprice.com/mcp",
      "headers": {
        "Authorization": "Bearer ${JOKERPRICE_API_KEY}"
      }
    }
  }
}

Claude Desktop

تسجّل الموصلات المخصصة في Claude Desktop (Settings → Connectors → Add custom connector) الدخول إلى الخوادم البعيدة عبر OAuth، ولا تتضمن حقلًا لترويسة مفتاح API، لذا لا يمكنها الاتصال بجوكر برايس بعد. استخدم الخادم المستضاف عبر الجسر mcp-remote، أو شغّل الخادم المحلي:

1. افتح Settings → Developer → Edit Config، فيُفتح الملف claude_desktop_config.json (في macOS داخل ~/Library/Application Support/Claude/، وفي Windows داخل %APPDATA%\Claude\).
2. أضف الخادم واحفظ الملف.
3. أغلق Claude Desktop وأعد فتحه، فتظهر أدوات جوكر برايس في قائمة الأدوات عند بدء محادثة جديدة.

الخادم المستضاف عبر mcp-remote (حزمة npm من طرف ثالث تمرّر الترويسة، وتحتاج إلى Node.js):

{
  "mcpServers": {
    "jokerprice": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://jokerprice.com/mcp",
        "--header",
        "Authorization:${JOKERPRICE_AUTH}"
      ],
      "env": {
        "JOKERPRICE_AUTH": "Bearer ss_your_key_here"
      }
    }
  }
}

الخادم المحلي:

{
  "mcpServers": {
    "jokerprice": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp/index.mjs"
      ],
      "env": {
        "JOKERPRICE_API_KEY": "ss_your_key_here"
      }
    }
  }
}

جرّبه

اسأل: «باستخدام جوكر برايس، ما المدن الخمس الأعلى في الإيراد لكل عقار، وكم عدد العقارات المتتبَّعة في كل منها؟» سيطلب Claude إذنك قبل أول استدعاء لأداة.

Claude على الويب

يضيف Claude على الويب الخوادم البعيدة موصلاتٍ مخصصة تسجّل الدخول عبر OAuth، بينما يستخدم جوكر برايس مفاتيح API، لذا استخدم Claude Code أو Claude Desktop حاليًا.