English Français العربية

HubSpot

السجل الرسمي التسويق والمبيعات

HubSpot CRM: contacts, deals, tickets, line items, properties, marketing, files, workflows, threads

الشيفرة المصدرية

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @mindstone/mcp-server-hubspot
Claude Code 
claude mcp add hubspot -e 'HUBSPOT_CONFIG_DIR=<HUBSPOT_CONFIG_DIR>' -e 'HUBSPOT_ACCOUNT_EMAIL=<HUBSPOT_ACCOUNT_EMAIL>' -e 'MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH>' -e 'HUBSPOT_CLIENT_ID=<HUBSPOT_CLIENT_ID>' -e 'HUBSPOT_CLIENT_SECRET=<your hubspot_client_secret>' -e 'HUBSPOT_SOURCE_LABEL=HubSpot MCP' -e 'HUBSPOT_DISABLE_REFRESH=<HUBSPOT_DISABLE_REFRESH>' -e 'HUBSPOT_ALLOW_CLOUD_REFRESH=<HUBSPOT_ALLOW_CLOUD_REFRESH>' -e 'HUBSPOT_REQUEST_TIMEOUT_MS=60000' -e 'HUBSPOT_REFRESH_LOCK_STALE_MS=<HUBSPOT_REFRESH_LOCK_STALE_MS>' -- npx -y @mindstone/mcp-server-hubspot@0.4.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "hubspot": {
            "command": "npx",
            "args": [
                "-y",
                "@mindstone/mcp-server-hubspot@0.4.1"
            ],
            "env": {
                "HUBSPOT_CONFIG_DIR": "<HUBSPOT_CONFIG_DIR>",
                "HUBSPOT_ACCOUNT_EMAIL": "<HUBSPOT_ACCOUNT_EMAIL>",
                "MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>",
                "HUBSPOT_CLIENT_ID": "<HUBSPOT_CLIENT_ID>",
                "HUBSPOT_CLIENT_SECRET": "<your hubspot_client_secret>",
                "HUBSPOT_SOURCE_LABEL": "HubSpot MCP",
                "HUBSPOT_DISABLE_REFRESH": "<HUBSPOT_DISABLE_REFRESH>",
                "HUBSPOT_ALLOW_CLOUD_REFRESH": "<HUBSPOT_ALLOW_CLOUD_REFRESH>",
                "HUBSPOT_REQUEST_TIMEOUT_MS": "60000",
                "HUBSPOT_REFRESH_LOCK_STALE_MS": "<HUBSPOT_REFRESH_LOCK_STALE_MS>"
            }
        }
    }
}

متغيرات البيئة

  • HUBSPOT_CONFIG_DIR إلزامي Directory containing accounts.json and credentials/*.token.json
  • HUBSPOT_ACCOUNT_EMAIL إلزامي Account selector — one MCP process per HubSpot account
  • MCP_WORKSPACE_PATH Workspace root for local file tools (required only when invoking upload/attach tools)
  • HUBSPOT_CLIENT_ID إلزامي HubSpot OAuth client ID
  • HUBSPOT_CLIENT_SECRET إلزامي سري HubSpot OAuth client secret
  • HUBSPOT_SOURCE_LABEL Source attribution label applied to new records
  • HUBSPOT_DISABLE_REFRESH Set to 1 to disable token refresh on this surface (use on cloud so desktop remains the sole refresh authority)
  • HUBSPOT_ALLOW_CLOUD_REFRESH Set to 1 to allow refresh on the cloud surface even when HUBSPOT_DISABLE_REFRESH=1 (escape hatch)
  • HUBSPOT_REQUEST_TIMEOUT_MS Outbound HTTP request timeout in milliseconds (max 300000 = 5 min)
  • HUBSPOT_REFRESH_LOCK_STALE_MS Stale-lock detection threshold for the credential refresh mutex (advanced)

الأسئلة الشائعة

ما هو HubSpot؟

HubSpot CRM: contacts, deals, tickets, line items, properties, marketing, files, workflows, threads

كيف أثبّت HubSpot؟

يعمل على جهازك. في Claude Code: claude mcp add hubspot -e 'HUBSPOT_CONFIG_DIR=<HUBSPOT_CONFIG_DIR>' -e 'HUBSPOT_ACCOUNT_EMAIL=<HUBSPOT_ACCOUNT_EMAIL>' -e 'MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH>' -e 'HUBSPOT_CLIENT_ID=<HUBSPOT_CLIENT_ID>' -e 'HUBSPOT_CLIENT_SECRET=<your hubspot_client_secret>' -e 'HUBSPOT_SOURCE_LABEL=HubSpot MCP' -e 'HUBSPOT_DISABLE_REFRESH=<HUBSPOT_DISABLE_REFRESH>' -e 'HUBSPOT_ALLOW_CLOUD_REFRESH=<HUBSPOT_ALLOW_CLOUD_REFRESH>' -e 'HUBSPOT_REQUEST_TIMEOUT_MS=60000' -e 'HUBSPOT_REFRESH_LOCK_STALE_MS=<HUBSPOT_REFRESH_LOCK_STALE_MS>' -- npx -y @mindstone/mcp-server-hubspot@0.4.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج HubSpot إلى مفتاح API؟

نعم. يتطلب HUBSPOT_CONFIG_DIR, HUBSPOT_ACCOUNT_EMAIL, HUBSPOT_CLIENT_ID, HUBSPOT_CLIENT_SECRET، وتضبطها في إعداداته.

هل HubSpot مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون HubSpot؟

ينشره mindstone. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.