آموزش اتصال سرور MCP تیشتر به Cursor، Claude Desktop و Windsurf

پروتکل Model Context Protocol (MCP) استاندارد باز جهانی برای اتصال دستیاران هوش مصنوعی و ادیتورهای کد به ابزارهای بیرونی، دیتابیس‌های زنده و موتورهای اجرای پس‌زمینه است.

با اتصال سرور Tishtar MCP به محیط توسعه خود، دستیار هوش مصنوعی شما (درون Cursor، Claude Desktop یا Windsurf) توانمندی‌های بی‌نظیری پیدا می‌کند:

• استعلام زنده تغییرات وب، رقبا و قیمت‌ها مستقیماً از داخل محیط کدنویسی.
• اجرای روتین‌های ابری تیشتر بدون نیاز به ترک ادیتور.
• دریافت بولتن‌های صبحگاهی و گزارش‌های تغییرات در طول برنامه‌نویسی.

---

۱. تنظیم برای Claude Desktop

برنامه Claude Desktop تنظیمات MCP را از یک فایل محلی JSON می‌خواند.

مسیر فایل کانفیگ:

• مک (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
• ویندوز (Windows): %APPDATA%\Claude\claude_desktop_config.json

افزودن کانفیگ تیشتر:

{
  "mcpServers": {
    "tishtar": {
      "command": "npx",
      "args": [
        "-y",
        "@tishtar/mcp-server"
      ],
      "env": {
        "TISHTAR_API_KEY": "YOUR_TISHTAR_API_KEY"
      }
    }
  }
}

پس از ذخیره فایل، برنامه Claude Desktop را ببندید و مجدداً باز کنید. آیکون چکش تیشتر در گوشه پایین کادر پرامپت ظاهر خواهد شد.

---

۲. تنظیم برای ادیتور Cursor

محیط Cursor پروتکل MCP را مستقیماً درون قابلیت Composer و پنل Chat پشتیبانی می‌کند.

مراحل راه‌اندازی:

1. در Cursor وارد Settings شوید (Cmd+, در مک یا Ctrl+, در ویندوز).
2. به بخش Features -> MCP Servers بروید و روی Add New MCP Server کلیک کنید.
3. مقادیر زیر را وارد کنید:
   • Name: tishtar
   • Type: command
   • Command: npx -y @tishtar/mcp-server
   • Environment Variables: TISHTAR_API_KEY=YOUR_API_KEY
4. همچنین می‌توانید مستقیماً فایل .cursor/mcp.json را در ریشه پروژه خود بسازید:

   {
     "mcpServers": {
       "tishtar": {
         "command": "npx",
         "args": ["-y", "@tishtar/mcp-server"],
         "env": {
           "TISHTAR_API_KEY": "YOUR_TISHTAR_API_KEY"
         }
       }
     }
   }

5. اکنون در چت Cursor بنویسید: «با تیشتر آخرین تغییر قیمت رقیب را بررسی کن» تا ابزار فراخوانی شود.

---

۳. تنظیم برای Windsurf (Codeium Cascade)

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

مسیر فایل کانفیگ:

• ~/.codeium/windsurf/mcp_config.json

افزودن کانفیگ تیشتر:

{
  "mcpServers": {
    "tishtar": {
      "command": "npx",
      "args": ["-y", "@tishtar/mcp-server"],
      "env": {
        "TISHTAR_API_KEY": "YOUR_TISHTAR_API_KEY"
      }
    }
  }
}

در محیط Cascade دستور /tools را تایپ کنید تا لیست ابزارهای فعال تیشتر را مشاهده نمایید.

---

عیب‌یابی و رفع خطاهای رایج

خطای ۱: spawn ENOENT

• دلیل: برنامه نمی‌تواند فایل اجرایی npx یا node را در متغیرهای مسیر سیستم (PATH) شما پیدا کند.
• راهکار: به جای کلمه "npx"، آدرس دقیق و کامل آن را وارد کنید (مثلاً "/usr/local/bin/npx" یا "/opt/homebrew/bin/npx"). با اجرای دستور which npx در ترمینال می‌توانید این مسیر را بیابید.

خطای ۲: SSE / Connection Timeout

• دلیل: فایروال محلی یا اتصال VPN مانع برقراری ارتباط با پورت شبکه شده است.
• راهکار: اطمینان حاصل کنید دسترسی خروجی HTTPS به دامنه https://api.tishtar.app در سیستم یا شبکه فعال است.

خطای ۳: Invalid API Key (401)

• دلیل: کلید API وارد نشده یا فاصله اضافی در ابتدا یا انتهای آن وجود دارد.
• راهکار: از بخش تنظیمات تیشتر -> کلیدهای API یک کلید جدید دریافت کرده و به دقت در فایل کانفیگ قرار دهید.