HubSpot MCP Sunucu Entegrasyonu

“HubSpot” MCP Sunucusu ne işe yarar?

HubSpot MCP (Model Context Protocol) Sunucusu, AI asistanlarının doğrudan HubSpot CRM verileriyle etkileşime geçmesini sağlamak üzere tasarlanmıştır. AI modelleri ile HubSpot hesabınız arasında bir köprü görevi gören bu sunucu, kişilere, şirketlere ve etkileşim metriklerine sorunsuz erişim imkanı tanır. Dahili vektör depolama (FAISS kullanarak) ile semantik arama ve önbellekleme mekanizmaları içerir; bu da HubSpot API sınırlamalarını aşmanıza yardımcı olur ve daha hızlı, güvenilir yanıtlar almanızı sağlar. Odak noktası, yüksek değerli ve sık kullanılan CRM işlemleridir; sağlam hata yönetimi ve AI dostu optimizasyon ile birlikte gelir. Bu sayede karmaşık çok adımlı CRM iş akışları daha verimli hale gelir ve AI geliştirme iş akışlarının doğrudan, bağlama zengin erişim ile iş verilerine ulaşmasını kolaylaştırır.

Prompt Listesi

• (Depoda açıkça tanımlanmış prompt şablonları bulunamadı. README’deki “Örnek Prompts” bölümü yalnızca kullanıcıya yönelik örnekler içeriyor, yeniden kullanılabilir şablonlar yok.)

Kaynak Listesi

(Depoda veya belgelerde açıkça tanımlanmış kaynaklar bulunmamaktadır. MCP kaynak primitifleri listelenmemiştir.)

Araç Listesi

• hubspot_create_contact
  Çakışmayı önleyici mantık ile HubSpot kişisi oluşturur.

• hubspot_create_company
  Çakışmayı önleyici mantık ile HubSpot şirketi oluşturur.

• hubspot_get_company_activity
  Belirli şirketlerin aktivitelerini getirir.

• hubspot_get_active_companies
  En son aktif olan şirketleri getirir.

• hubspot_get_active_contacts
  En son aktif olan kişileri getirir.

• hubspot_get_recent_conversations
  Mesajlarla birlikte son konuşma dizilerini getirir.

• hubspot_search_data
  Daha önce alınan HubSpot verileri üzerinde semantik arama yapar.

Bu MCP Sunucusunun Kullanım Senaryoları

• Otomatik Kişi Oluşturma
  AI asistanlarının, doğrudan konuşmalar, e-postalar veya LinkedIn profil metninden HubSpot’ta yeni kişi oluşturmasını sağlayarak potansiyel müşteri alımını hızlandırır ve manuel veri girişi ihtiyacını azaltır.

• Şirket Verisi Yönetimi
  HubSpot’ta şirket profillerinin AI tabanlı iş akışları ile oluşturulmasını ve güncellenmesini kolaylaştırır; doğru ve güncel CRM kayıtlarını garanti eder.

• Aktivite ve Etkileşim Takibi
  Şirketler ve kişiler üzerindeki en son aktiviteleri getirerek satış ekiplerinin ve AI ajanlarının etkileşim trendlerini izlemesine ve daha etkili takip yapmasına olanak tanır.

• Konuşma Analizi
  Son konuşma dizilerine erişim ve analiz imkanı sunar; AI’nın etkileşimleri özetlemesine veya takip fırsatlarını belirlemesine imkan tanır.

• Semantik CRM Araması
  Dahili vektör depolama kullanarak HubSpot verilerinde semantik arama yapılabilir; AI’nın geçmiş etkileşimlerde ve CRM kayıtlarında ilgili bilgiyi kolayca bulmasını sağlar.

Kurulum Nasıl Yapılır

Windsurf

1. Docker’ın kurulu olduğundan emin olun.
2. Gerekli kapsamlarla HubSpot erişim belirtecinizi edinin.
3. Windsurf yapılandırmasında MCP sunucuları bölümünü bulun.
4. HubSpot MCP sunucusunu aşağıdaki JSON ile ekleyin:

   {
     "mcpServers": {
       "hubspot": {
         "command": "docker",
         "args": [
           "run", "-i", "--rm",
           "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
           "-v", "/path/to/storage:/storage",
           "buryhuang/mcp-hubspot:latest"
         ]
       }
     }
   }
   

5. Yapılandırmayı kaydedin ve Windsurf’u yeniden başlatın.
6. Windsurf üzerinden HubSpot verilerinizi sorgulayarak kurulumu doğrulayın.

Claude

1. Node.js kurulmamışsa yükleyin.
2. HubSpot erişim belirtecinizi edinin.
3. Claude yapılandırmasını düzenleyin ve MCP sunucusunu ekleyin.
4. HubSpot MCP sunucusunu aşağıdaki gibi ekleyin:

   {
     "mcpServers": {
       "hubspot": {
         "command": "docker",
         "args": [
           "run", "-i", "--rm",
           "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
           "-v", "/path/to/storage:/storage",
           "buryhuang/mcp-hubspot:latest"
         ]
       }
     }
   }
   

5. Kaydedin ve Claude’u yeniden başlatın.
6. MCP sunucusunun listelendiğini ve yanıt verdiğini doğrulayın.

Cursor

1. Docker ve Node.js’i yükleyin.
2. HubSpot erişim belirtecinizi edinin.
3. Cursor’un yapılandırma dosyasını açın.
4. mcpServers altında şunu ekleyin:

   {
     "mcpServers": {
       "hubspot": {
         "command": "docker",
         "args": [
           "run", "-i", "--rm",
           "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
           "-v", "/path/to/storage:/storage",
           "buryhuang/mcp-hubspot:latest"
         ]
       }
     }
   }
   

5. Değişiklikleri kaydedin ve Cursor’u yeniden başlatın.

Cline

1. Docker’ın kurulu olduğundan emin olun.
2. HubSpot erişim belirtecinizi edinin.
3. Cline ortamınızda ilgili yapılandırma dosyasını açın.
4. Şunu ekleyin:

   {
     "mcpServers": {
       "hubspot": {
         "command": "docker",
         "args": [
           "run", "-i", "--rm",
           "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
           "-v", "/path/to/storage:/storage",
           "buryhuang/mcp-hubspot:latest"
         ]
       }
     }
   }
   

5. Kaydedin ve Cline’ı yeniden başlatın.

API Anahtarlarınızı Güvenli Tutun
HubSpot erişim belirtecinizi sabit kodlamak yerine ortam değişkenleri ile güvenli şekilde saklamanız önerilir. Örnek:

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "HUBSPOT_ACCESS_TOKEN=${HUBSPOT_ACCESS_TOKEN}",
        "-v", "/path/to/storage:/storage",
        "buryhuang/mcp-hubspot:latest"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your_token"
      }
    }
  }
}

Bu MCP’yi akışlarda nasıl kullanabilirsiniz

FlowHunt’ta MCP Kullanımı

MCP sunucularını FlowHunt iş akışınıza entegre etmek için, öncelikle MCP bileşenini akışınıza ekleyin ve AI ajanınıza bağlayın:

MCP bileşenine tıklayarak yapılandırma panelini açın. Sistem MCP yapılandırması bölümüne aşağıdaki JSON formatında MCP sunucu bilgilerinizi girin:

{
  "hubspot": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Yapılandırdıktan sonra, AI ajanın artık bu MCP’yi bir araç olarak, tüm fonksiyon ve yeteneklerine erişerek kullanabilir. “hubspot” ismini kendi MCP sunucunuzun adıyla (örn. “github-mcp”, “weather-api” vb.) değiştirip URL’yi de kendi MCP sunucu URL’nizle değiştirmeyi unutmayın.

Genel Bakış

HubSpot MCP sunucusu için genel değerlendirmem:
Sunucu, kurulum ve araçları açısından sağlam bir dokümantasyona sahip olsa da, açıkça tanımlanmış prompt şablonlarının ve MCP kaynak primitiflerinin eksikliği, gelişmiş AI iş akışları için esnekliğini sınırlandırıyor. Sampling ve roots desteğinden bahsedilmemiş. Pratik CRM kullanımı için uygun, ancak daha kapsamlı MCP özellikleriyle güçlendirilebilir.

MCP Skoru

MCP Tablo Skoru: 7/10