Entegrasyonlar

AI asistanlarını Searchestra'ya bağlayın (MCP)

Searchestra'nın uzak bir Model Context Protocol (MCP) sunucusu var. Bunu Claude'a ya da başka bir MCP istemcisine bağlayıp AI görünürlüğünüzü doğal dille sorabilirsiniz: asistan markalarınızı, pazarlarınızı, Prompt Evrenlerinizi, AI yanıtlarını, atıfları, duygu analizini ve Action Center verisini, Searchestra'daki erişiminizle birebir aynı yetkiyle okur.

MCPhttps://panel.searchestra.com/mcp

Claude'a ekle → Claude'u ad ve adres dolu olarak açar. Eklenmeden önce bilgileri siz kontrol edersiniz.

Genel bakış

Taşıma: Streamable HTTP; tüm organizasyonlar için tek adres.
Oturum açma: PKCE ile OAuth 2.1. Herkes kendi Searchestra hesabıyla oturum açıp bağlantıyı onaylar; API anahtarı paylaşılmaz.
Erişim: asistan yalnız sizin görebildiğiniz markaları, pazarları ve Prompt Evrenlerini görür; veriyi yalnız rolünüzün izin verdiği yerde değiştirebilir.
Araçlar: 43 araç: 36'sı veri okur, 7'si veri değiştirir. Araç listesine bakın.

Başlamadan önce

Planında API erişimi bulunan bir organizasyonda Searchestra hesabı. Atıf, duygu analizi ve Action Center araçları yalnız bu modüller planınızdaysa veri döndürür.
Organizasyonunuzda AI asistanı bağlantılarına izin verilmiş olması. Varsayılan olarak açıktır; bir sahip bunu Settings > Security > AI assistants altından kapatabilir.
Araçların döndürecek verisi olması için yanıtları toplanmış en az bir Prompt Evreni.
Organizasyonunuz erişimi IP adresine göre sınırlıyorsa, web, masaüstü ve mobil Claude için Anthropic'in çıkış aralığı 160.79.104.0/21'e izin verin. Claude Code sizin bilgisayarınızdan bağlanır.

Claude'u bağlayın

Searchestra; web, masaüstü ve mobil Claude uygulamalarında ve Cowork'te özel (custom) connector olarak çalışır. En hızlı yol, ad ve adresi sizin için dolduran Claude'a ekle bağlantısıdır.

Pro ve Max planları

Claude'da Customize > Connectors sayfasını açıp Add custom connector seçin.
Ad olarak Searchestra, adres olarak https://panel.searchestra.com/mcp girin. OAuth client ID ve secret alanlarını boş bırakın; Claude kendini otomatik tanıtır.
Add, ardından Connect seçin. İstenirse Searchestra'ya giriş yapın.
Searchestra ekranında erişimin claude.ai'ye gittiğini kontrol edin, asistanın neler yapabileceğini okuyun ve Allow access seçin.

Team ve Enterprise planları

Bir Claude organizasyon sahibi (Owner) Organization settings > Connectors sayfasını açar, Add ve ardından Custom seçer (sorulursa Web), aynı ad ve adresi girer.
Ardından her üye Searchestra'yı Customize > Connectors altında Custom etiketiyle bulur ve kendi Searchestra hesabıyla oturum açmak için Connect seçer.

Sohbette kullanın

Bir sohbet için connector'ı + > Connectors menüsünden açın ve sorunuzu sorun. Claude, veri değiştiren bir aracı çalıştırmadan önce onayınızı ister.

Claude Code

Sunucuyu terminalden ekleyin, sonra Claude Code içinden oturum açın:

Terminal

claude mcp add --transport http searchestra https://panel.searchestra.com/mcp

Claude Code'u başlatın, /mcp komutunu çalıştırın, searchestra'yı seçip kimlik doğrulayın. Tarayıcınız Searchestra onay ekranını açar; erişim bilgisayarınızdaki localhost'a geri döner.

Diğer MCP istemcileri

Streamable HTTP ve OAuth destekleyen her MCP istemcisi aynı adresle çalışır. Sunucu standart keşif belgelerini yayımlar; istemciler oturum açma akışını kendileri bulur:

Korunan kaynak metadata'sı: https://panel.searchestra.com/.well-known/oauth-protected-resource/mcp
Yetkilendirme sunucusu metadata'sı: https://panel.searchestra.com/.well-known/oauth-authorization-server
İstemci kaydı: Client ID Metadata Document veya Dynamic Client Registration. PKCE (S256) ile public client; https yönlendirme adresleri ya da masaüstü uygulamalar için herhangi bir porttaki loopback adresleri.
Kapsamlar: veri okumak için mcp:read, veri değiştirmek için ayrıca mcp:write.

Örnek istemler

Kendi cümlelerinizle sorun. Asistan önce markanızı, pazarınızı ve Prompt Evreninizi bulur, sonra doğru araçları çağırır.

“Ana pazarımızda son 30 günün AI görünürlüğünü, atıflarını ve duygu durumunu özetle; neyin değiştiğini belirt.”
Keşif araçlarını, ardından gösterge özetini ve raporları kullanır.
“Prompt Evrenimizdeki hangi promptlarda markamız görünmüyor ve onun yerine hangi rakipler çıkıyor?”
Marka boşluğu fırsatlarını ve bu promptların yanıtlarını kullanır.
“Rakiplerimize atıf verip bize vermeyen yüksek otoriteli sayfalar hangileri? Alan adına göre grupla ve nereden başlamamız gerektiğini öner.”
Atıf fırsatlarını ve atıf alan alan adlarını kullanır.
“AI platformları markamızı nasıl farklı anlatıyor? Platforma göre duygu dağılımını ve ana temaları göster.”
Platforma göre duygu ve duygu temalarını kullanır.
“Prompt Evrenimize şu üç promptu ekle: ‘yeni başlayanlar için en uygun fiyatlı seçenek’, ‘pazar liderine alternatifler’, ‘bu yıl yükseltmeye değer mi’.”
Veri değiştirdiği için Claude önce çağrıyı onaylamanızı ister.

İpucu. Birden çok markanız ya da pazarınız varsa hangisini kastettiğinizi belirtin, örneğin “Almanya pazarımızda”. Aksi halde asistan önce sorar ya da hepsini listeler.

İzinler ve güvenlik

Yalnız sizin rolünüz: her çağrı, Searchestra uygulamasıyla aynı şekilde güncel rolünüze göre denetlenir. Viewer yalnız okuyabilir. Prompt, konu ve etiket değiştirmek için Prompt Evrenini yapılandırabilen bir rol gerekir; örneğin Editor ya da Brand admin.
Okuma ve yazma erişimi: onay ekranı asistanın veri değiştirme izni isteyip istemediğini gösterir. Veri değiştiren araçlar mcp:write ister.
Her değişiklik için onay: veri değiştiren yedi araç yıkıcı (destructive) olarak işaretlidir; Claude her çağrıdan önce size sorar. Salt okuma araçları onay sormadan çalışabilir.
Planlar veri değiştirmez: execute_plan yalnız salt okuma araçlarını çalıştırır. Veri değiştirecek bir adım reddedilir ve ayrıca çağrılması gerekir.
Her kullanımda denetim: organizasyonunuzun üyelik, tek oturum açma (SSO), çok faktörlü doğrulama ve ağ politikaları yalnız bağlanırken değil, asistan Searchestra'yı her çağırdığında uygulanır. Erişim belirteçleri 30 dakika geçerlidir ve kendiliğinden yenilenir; bir bağlantı en çok 90 gün sürer, ardından yeniden bağlanırsınız.

Veri ve gizlilik

Searchestra yalnız asistanın gönderdiği araç isteklerini alır. Asistanla yaptığınız sohbeti almaz ve saklamaz.
Bir aracın döndürdüğü veri bağladığınız asistana gönderilir ve ardından o sağlayıcının koşullarına tabidir. Claude için Anthropic'in gizlilik politikasına bakın.
Searchestra her bağlantıyı kimin kurduğu, ne zaman oluşturulduğu ve en son ne zaman kullanıldığıyla kaydeder; böylece sahipler bağlantıları inceleyip kesebilir.
Organizasyonunuzun Searchestra ile açıkça onaylanmış bir işleme düzenlemesi yoksa özel nitelikli ya da son derece hassas kişisel veri göndermeyin.

Kişisel verileri nasıl işlediğimiz Gizlilik Bildirimi'nde anlatılır.

Araç listesi

Her aracın asistanınızda görünen kısa bir başlığı ve protokolde kullanılan bir adı vardır. Araçların çoğu bir pazar ya da Prompt Evreni kimliği ister; bunları keşif araçları döndürür.

Keşif

Araç	Ne yapar	Kapsam
List brands `list_brands`	Kullanıcının erişebildiği markaları listeler. Diğer araçların istediği pazar ve Prompt Evreni kimliklerine marka kimliğinden ulaşılır.	Organizasyon
List markets `list_markets`	Bir markanın ya da tüm markaların pazarlarını (ülke ve dil) listeler; pazar kapsamlı araçların istediği market_id'yi döndürür.	Organizasyon
List Prompt Universes `list_universes`	Bir pazardaki Prompt Evrenlerini listeler; prompt, konu ve etiket araçlarının istediği universe_id'yi döndürür.	Pazar
List AI models `get_all_models`	Takip edilen AI modellerini (platformları) listeler.	Organizasyon

Prompt Evreni içeriği ve yanıtlar

Araç	Ne yapar	Kapsam
List prompts `get_all_prompts`	Bir Prompt Evrenindeki izlenen sorguları (promptları) listeler.	Prompt Evreni
List keywords `get_all_keywords`	Bir Prompt Evrenindeki izlenen promptların metinlerini listeler.	Prompt Evreni
List topics `get_all_topics`	Bir Prompt Evrenindeki konuları listeler.	Prompt Evreni
List tags `get_all_tags`	Bir Prompt Evrenindeki etiketleri listeler.	Prompt Evreni
Prompt answers `get_prompt_answers`	Bir sorgu için toplanan AI yanıtlarını döndürür.	Prompt Evreni
Prompt result details `get_prompt_result_details`	Bir promptun AI yanıtlarını ayrıntılı döndürür; isteğe bağlı olarak tek bir AI platformuyla sınırlanır.	Prompt Evreni
List AI answers `get_all_ai_answers`	Bir Prompt Evreninde toplanan tüm AI yanıtlarını listeler.	Prompt Evreni

Performans ve göstergeler

Araç	Ne yapar	Kapsam
KPI summary `get_kpi_summary`	Pazarın ana göstergelerini (görünürlük, atıf, duygu) tek çağrıda özetler.	Pazar
Performance report `query_performance_report`	Bir pazarın ya da tek bir Prompt Evreninin görünürlük ve atıf performansını, toplanan AI yanıtlarından hesaplayarak döndürür.	Pazar

Atıflar ve kaynaklar

Araç	Ne yapar	Kapsam
Citation report `query_citation_report`	Atıf raporunun özetini döndürür (toplam, sizin payınız, benzersiz alan adı).	Pazar
List citations `get_all_citations`	Pazardaki AI yanıtlarında verilen atıfları listeler.	Pazar
Market citations `get_prompt_citations`	Bir pazarın yanıtlarında verilen atıfları döndürür.	Pazar
List cited domains `get_all_domains`	Atıf verilen alan adlarını ve paylarını listeler.	Pazar
Cited pages of a domain `get_domain_pages_cited`	Bir alan adının atıf alan sayfalarını listeler.	Pazar
Platforms citing a domain `get_domain_citation_platforms`	Bir alan adına hangi AI platformlarının atıf verdiğini döndürür.	Pazar
Most cited pages `get_industry_cited_pages`	Pazarda en çok atıf alan sayfaları (kendinizinkiler dâhil) listeler.	Pazar
Citation opportunities `get_citation_opportunities`	Rakiplere atıf verip markanıza vermeyen yüksek otoriteli sayfaları listeler.	Pazar
External mentions `get_external_mentions`	Markanızdan üçüncü taraf/sosyal kaynaklarda söz eden dış bahisleri listeler.	Pazar

Duygu analizi

Araç	Ne yapar	Kapsam
Sentiment report `query_sentiment_report`	Duygu analizi raporunu döndürür (skor ve dağılım).	Pazar
Sentiment by platform `get_sentiment_by_platform`	Duygu skorunu AI platformu bazında kırar.	Pazar
Sentiment by competitor `get_sentiment_by_competitor`	Duygu skorunu rakip bazında kırar.	Pazar
Sentiment themes `get_sentiment_themes`	Duygu temalarını (algıyı sürükleyen başlıklar) listeler.	Pazar
Sentiment theme keywords `get_sentiment_keywords`	Bir temanın altındaki anahtar kelimeleri listeler.	Pazar

Action Center ve Prompt Explorer

Araç	Ne yapar	Kapsam
Action Center summary `get_actionables_dashboard`	Action Center özetini döndürür: toplam aksiyon, açık sayısı ve potansiyel görünürlük kazancı.	Pazar
Brand gap opportunities `get_all_brand_gap_opportunities`	Markanızın AI yanıtlarında görünmediği sorgu fırsatlarını (yeni içerik) listeler.	Pazar
New content opportunities `get_all_new_content_opportunities`	Üretilmesi önerilen yeni içerik fırsatlarını listeler.	Pazar
Optimization opportunities `get_all_optimization_opportunities`	Mevcut sayfalar için iyileştirme önerilerini listeler.	Pazar
Broken pages `get_all_broken_pages`	AI botlarının hata aldığı kırık sayfaları listeler.	Pazar
Action details `get_action_info`	Tek bir aksiyonun ayrıntılarını (örnek yanıtlar, ilgili bahisler) döndürür.	Pazar
Prompt Explorer overview `get_prompt_explorer_overview`	Prompt Explorer korpusunu hacim, zorluk ve niyet bilgisiyle döndürür.	Pazar

Planlama

Araç	Ne yapar	Kapsam
Plan tools for a question `tools_info`	Doğal dilde bir soruyu çalıştırılacak Searchestra araçları listesine ve gerekçesine çevirir. Hiçbir aracı çalıştırmaz.	Yok
Run a read-only tool plan `execute_plan`	Salt okuma araçlarından oluşan bir listeyi sırayla çalıştırır ve tüm sonuçları tek yanıtta döndürür. Veri değiştirecek adımlar reddedilir.	Yok

Veri değiştiren araçlar

Araç	Ne yapar	Kapsam
Create prompt `create_prompt`	Bir Prompt Evrenine yeni izlenen sorgu ekler.	Prompt Evreni
Delete prompts `bulk_delete_prompts`	Birden çok sorguyu tek çağrıda siler.	Prompt Evreni
Create topic `create_topic`	Bir Prompt Evrenine yeni konu ekler.	Prompt Evreni
Archive topic `delete_topic`	Bir Prompt Evrenindeki konuyu arşivler.	Prompt Evreni
Create tag `create_tag`	Bir Prompt Evrenine yeni etiket ekler.	Prompt Evreni
Delete tag `delete_tag`	Bir Prompt Evreninden etiketi siler.	Prompt Evreni
Generate optimization fix plan `get_optimization_fixes`	Bir aksiyon için adım adım düzeltme önerileri üretir ve aksiyona kaydeder; daha önce kaydedilmiş önerilerin yerini alır.	Pazar

Liste araçları varsayılan olarak sayfa başına en çok 25 kayıt döndürür. Tarih aralıkları YYYY-MM-DD biçiminde start_date ve end_date ile verilir.

Bağlantıları yönetin

Kendi bağlantılarınız: Searchestra'da Settings > Profile sayfasını açın. Connected AI assistants bağladığınız her asistanı, en son ne zaman kullanıldığını ve bir Disconnect düğmesini gösterir.
Organizasyonunuz: sahipler tüm bağlantıları görmek, herhangi birini kesmek ya da AI asistanı bağlantılarını herkes için kapatmak üzere Settings > Security > AI assistants sayfasını açar. Kapatmak tüm asistanların bağlantısını hemen keser.
Claude'da: connector'ı Customize > Connectors altından kaldırın ya da yeniden bağlayın; Claude'un hiç kullanmasını istemediğiniz bir aracı Blocked olarak ayarlayın.

Sorun giderme

“Your organization's plan does not include …”

Bağlantı API erişimi gerektirir; bazı araçlar ayrıca atıf, duygu analizi ya da Action Center modüllerini ister. Planınıza eklemek için bizimle iletişime geçin.

Onay ekranı bağlantıların kapalı olduğunu söylüyor

Bir sahip AI asistanı bağlantılarını kapatmış. Settings > Security > AI assistants altındaki Allow members to connect AI assistants seçeneğini açmasını isteyin.

Çağrılar bir süre sonra başarısız oluyor ya da Claude Reconnect gösteriyor

Bağlantının 90 günlük süresi dolmuş, bağlantı kesilmiş ya da oturum açma politikanız değişmiş olabilir; örneğin yeni bir çok faktörlü doğrulama şartı. Reconnect seçip yeniden onaylayın.

Claude'dan erişim reddediliyor ama Searchestra'da çalışıyor

Organizasyonunuz büyük olasılıkla erişimi IP adresine göre sınırlıyor. Anthropic'in çıkış aralığı 160.79.104.0/21'e izin verin.

Bir araç veri döndürmüyor

Prompt Evreninde o dönem için henüz toplanmış yanıt olmayabilir ya da o markaya erişiminiz olmayabilir. Searchestra'da bir tarama başlatın ya da asistandan görebildiğiniz markaları ve pazarları listelemesini isteyin.

Hâlâ sorun mu var? team@searchestra.com adresine yazın. Güvenlik sorunlarını security@searchestra.com adresine bildirin.