اتصال کلاینت‌ها به MCP نشان

کلاینت MCP برنامه‌ای است که ایجنت هوش مصنوعی در آن اجرا می‌شود، مثل Claude Desktop یا Cursor. هر کلاینتی که از استاندارد MCP پشتیبانی کند، با یکی از تنظیمات زیر به سرور نشان وصل می‌شود. در همه‌ی نمونه‌ها <YOUR_API_KEY> را با کلید خود جایگزین کنید.

اتصال به سرور آماده‌ی نشان

این روش برای همه‌ی کلاینت‌هایی که اتصال HTTP را پشتیبانی می‌کنند یکسان است و نصب چیزی لازم ندارد:

{
  "mcpServers": {
    "neshan": {
      "url": "https://api.neshan.org/mcp",
      "headers": {
        "Api-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

نکته

کلید این روش باید به سرویس MCP دسترسی داشته باشد. برای دریافت آن، از طریق ارسال تیکت در پنل کاربری نشان با پشتیبانی تماس بگیرید.

اتصال Claude Desktop به سرور محلی (stdio)

اگر سرور را طبق راهنمای اجرا روی سرور خودتان نصب کرده‌اید، فایل تنظیمات Claude Desktop را باز کنید و این بخش را اضافه کنید:

{
  "mcpServers": {
    "neshan": {
      "command": "neshan-mcp",
      "env": { "NESHAN_API_KEY": "<YOUR_API_KEY>" }
    }
  }
}

سپس Claude Desktop را دوباره اجرا کنید. از این به بعد می‌توانید مستقیم درباره‌ی نقشه، مسیر و آدرس از آن بپرسید.

یادداشت

در این حالت، کلاینت خودش برنامه‌ی neshan-mcp را اجرا می‌کند. اگر این دستور پیدا نشد، مطمئن شوید پکیج در همان محیط Python نصب شده که در PATH سیستم قرار دارد.

اتصال Cursor یا کلاینت‌های دیگر از طریق HTTP

اگر سرور را با دستور neshan-mcp-http (یا با Docker) اجرا کرده‌اید، کلاینت را به آدرس محلی آن وصل کنید:

{
  "mcpServers": {
    "neshan": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": { "Neshan-Api-Key": "<YOUR_API_KEY>" }
    }
  }
}

در حالت HTTP، کلید در هدر هر اتصال ارسال می‌شود و به فایل .env نیازی نیست.

هدرهای کلید در حالت HTTP

سرور، کلید را به این ترتیب از هدرهای درخواست می‌خواند و اولین مقدار موجود را استفاده می‌کند:

هدر	توضیحات
Neshan-Api-Key-<service>	کلید اختصاصی یک سرویس، مثلاً Neshan-Api-Key-routing. فقط برای همان سرویس استفاده می‌شود.
Neshan-Api-Key	کلید پیش‌فرض برای همه‌ی سرویس‌ها.
Api-Key	نام جایگزین برای کلید پیش‌فرض؛ همان هدری که در سرور آماده‌ی نشان استفاده می‌شود.

اگر هیچ‌کدام از این هدرها ارسال نشود، سرور سراغ متغیرهای محیطی می‌رود (جدول متغیرها در صفحه‌ی اجرا روی سرور خودتان آمده است).

نام سرویس‌ها در هدر و متغیرهای محیطی یکی است: search، geocoding، routing، historical، matrix، tsp، static، static_arc، isochrone، map_matching، traffic، vrp و point.