بازگشت به فهرست

سرویس MCP هُما

اتصال دستیار

روش ۱ (پیشنهادی): اتصال مستقیم بدون نصب

جدیدترین و ساده‌ترین راه: MCP هُما یک ترنسپورت Streamable HTTP روی POST /mcp دارد. کافی است آدرس سرویس و توکن را در کانفیگ دستیار بگذارید — نه Node.js لازم است، نه نصب پکیج.

{
  "mcpServers": {
    "homa": {
      "url": "https://www.HomaCRM.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

توکن در هدر Authorization: Bearer هر درخواست فرستاده می‌شود؛ سرویس stateless است (بدون session) و همان توکن پنل هُماست.

اگر نسخهٔ دستیار شما فیلد url برای MCP را پشتیبانی نکند، از روش پکیج محلی (پایین) استفاده کنید.

روش ۲: اتصال Cursor با پکیج محلی

راه نصبی: از پنل هُما دکمهٔ «کپی کانفیگ با توکن» را بزنید و محتوا را در فایل کانفیگ Cursor بچسبانید.

فایل کانفیگ معمولاً اینجاست: ~/.cursor/mcp.json (یا .cursor/mcp.json در ریشهٔ پروژه). بعد Cursor را یک‌بار ببندید و دوباره باز کنید؛ سرور homa باید در فهرست MCP ظاهر شود.

اگر می‌خواهید دستی تنظیم کنید، نمونهٔ ساختار کانفیگ:

{
  "mcpServers": {
    "homa": {
      "command": "node",
      "args": ["/app/packages/homa-mcp-server/dist/index.js"],
      "env": {
        "HOMA_API_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Claude Desktop و Cline

محتوای کانفیگ در همهٔ برنامه‌ها یکی است؛ فقط محل فایل فرق می‌کند:

برنامه کجا فایل کانفیگ است؟
Cursor~/.cursor/mcp.json
Claude Desktop (mac)~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows)%APPDATA%\Claude\claude_desktop_config.json
Cline (VS Code)تنظیمات افزونه ← MCP Servers

در همهٔ این‌ها همان کانفیگی را که از پنل کپی کردید قرار دهید.

نکات

  • با دستیار بپرسید توکن به چه چیزهایی دسترسی دارد.
  • توکن ثانویه با دسترسی متناسب بسازید — برخی ابزارها (ارسال پیامک، ثبت مخاطب و تیکت) نوشتنی هستند.