سرویس MCP هُما
اتصال دستیار
روش ۱ (پیشنهادی): اتصال مستقیم بدون نصب
جدیدترین و سادهترین راه: MCP هُما یک ترنسپورت Streamable HTTP روی POST /mcp دارد. کافی است آدرس سرویس و توکن را در کانفیگ دستیار بگذارید — نه Node.js لازم است، نه نصب پکیج.
{
"mcpServers": {
"homa": {
"url": "https://www.HomaCRM.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
آدرس سرویس MCP
توکن در هدر Authorization: Bearer هر درخواست فرستاده میشود؛ سرویس stateless است (بدون session) و همان توکن پنل هُماست.
اگر نسخهٔ دستیار شما فیلد url برای MCP را پشتیبانی نکند، از روش پکیج محلی (پایین) استفاده کنید.
روش ۲: اتصال Cursor با پکیج محلی
راه نصبی: از پنل هُما دکمهٔ «کپی کانفیگ با توکن» را بزنید و محتوا را در فایل کانفیگ Cursor بچسبانید.
فایل کانفیگ معمولاً اینجاست: ~/.cursor/mcp.json (یا .cursor/mcp.json در ریشهٔ پروژه). بعد Cursor را یکبار ببندید و دوباره باز کنید؛ سرور homa باید در فهرست MCP ظاهر شود.
آدرس سرویس 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 |
در همهٔ اینها همان کانفیگی را که از پنل کپی کردید قرار دهید.
نکات
- با دستیار بپرسید توکن به چه چیزهایی دسترسی دارد.
- توکن ثانویه با دسترسی متناسب بسازید — برخی ابزارها (ارسال پیامک، ثبت مخاطب و تیکت) نوشتنی هستند.