Client Kurulumu

Araç sayısı dağıtım yapılandırmasına bağlıdır: normal keşif 23 araç, list_model_connections etkinken 24 araç sunar; kayıtlı kanonik araç sayısı sırasıyla 42 veya 43’dir. Bağlı sunucunun tools/list yanıtını esas alın.

Bu rehber, pazar araştırması için Minds MCP sunucusunu uzak araçları destekleyen AI client’larına bağlar. Sunucu URL’si olarak https://getminds.ai/mcp kullanın.

ChatGPT

ChatGPT’yi web üzerinden kullanın. Kullanılabilirlik ve izinler hesaba ve çalışma alanına bağlıdır; OpenAI’ın güncel MCP yönergelerine bakın.

Settings → Apps bölümünü açın ve hesabınızda varsa Minds’ı bağlayın.
Özel bağlantı için izin veriliyorsa Developer mode’u etkinleştirin, Apps → Create seçin ve https://getminds.ai/mcp girin.
OAuth seçip Minds’a giriş yapın. Araç taramasını ve kurulumu tamamlayın.
Yeni sohbette Minds’ı seçip Audiences listesini isteyin. Kapsamlı Studies, çalıştırılmadan önce inceleme ve açık onay gerektirir.

Uyumlu web ortamları sonuçları sohbet içinde gösterir. Mobil ortamda görüntülenen Minds widget’ı, etkileşimli kontroller yerine Minds’da devam etme bağlantısı sunar.

Claude Desktop

Claude Desktop'ı açın → Customize → Connectors (veya Settings → Connections)
https://getminds.ai/mcp adresini yeni bir remote connector olarak ekleyin
İstendiğinde OAuth ile yetkilendirin — Minds hesabınıza giriş yapın
Yetkilendirmenin ardından araçlar otomatik olarak görünür

Seçenek B: Local Connector (API key, yalnızca metin)

Yapılandırma dosyanıza ekleyin (macOS'ta ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mindsai": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://getminds.ai/mcp",
        "--header",
        "Authorization: Bearer minds_YOUR_API_KEY"
      ]
    }
  }
}

Claude Desktop'ı yeniden başlatın. Araçlar anında çalışır ancak local connector'larla interaktif widget'lar kullanılamaz.

Duyurulan 23–24 araç yapılandırılmış metin ve tıklanabilir bağlantılar döndürür. Açıkça yapılandırılmış entegrasyonlar için ayrıca 19 kanonik yaşam döngüsü aracı kayıtlıdır. Widget gösterimi istemciye ve sürümüne bağlıdır; bu nedenle entegrasyon yalnızca yapılandırılmış ve metin sonuçlarıyla da tamamen kullanılabilir kalmalıdır.

Claude Code (CLI)

claude mcp add --transport http minds https://getminds.ai/mcp

Claude Code'da /mcp komutunu çalıştırın ve OAuth ile oturum açmak için Authenticate seçin. Bunun yerine API anahtarı kullanmak için --header "Authorization: Bearer minds_YOUR_API_KEY" ekleyin.

Codex

Codex uygulamasında Settings → MCPs bölümünü açın, https://getminds.ai/mcp ekleyin ve Authenticate seçin. OAuth kullanmak için bearer token ve header alanlarını boş bırakın.

Codex CLI ile:

codex mcp add minds --url https://getminds.ai/mcp
codex mcp login minds

Bunun yerine API anahtarı kullanmak için Authorization: Bearer minds_YOUR_API_KEY header'ını ekleyin.

Gemini CLI

Sunucuyu ~/.gemini/settings.json dosyasına ekleyin:

{
  "mcpServers": {
    "minds": { "httpUrl": "https://getminds.ai/mcp" }
  }
}

Gemini CLI, OAuth'u sunucudan keşfeder ve ilk kullanımda oturum açma sayfasını açar. Ayrıca /mcp auth minds komutunu da çalıştırabilirsiniz.

Cursor

Cursor Settings → MCP bölümünü açıp yeni bir sunucu ekleyin veya ~/.cursor/mcp.json dosyasına ekleyin:

{
  "mcpServers": {
    "minds": { "url": "https://getminds.ai/mcp" }
  }
}

Cursor istediğinde Login seçin ve Minds'a oturum açın.

VS Code (GitHub Copilot)

Komut Paleti'nden MCP: Add Server çalıştırın, HTTP seçin ve https://getminds.ai/mcp girin. Veya .vscode/mcp.json dosyasına ekleyin:

{
  "servers": {
    "minds": { "type": "http", "url": "https://getminds.ai/mcp" }
  }
}

Sunucuyu başlatın ve istendiğinde VS Code'un Minds'a oturum açmasına izin verin.

OpenRouter, Open WebUI ve OpenAI uyumlu ağ geçitleri

Kimlik doğrulama, MCP isteğini yürüten istemciye ve ilettiği kimlik bilgisine bağlıdır. Model sağlayıcısının API anahtarı Minds kimlik doğrulaması sağlamaz.

OAuth belirtecini iletme

OpenAI Responses API, MCP aracının authorization alanında mevcut bir OAuth erişim belirtecini kabul eder. Uygulamanız yetkilendirme ve yenilemeyi ayrıca yönetir ve her istekte belirteci sağlar. OpenAI MCP kimlik doğrulama kılavuzuna bakın.

Open WebUI / OpenRouter

https://getminds.ai/mcp adresine Streamable HTTP bağlantısı kurun. İstemci veya yürütme modu OAuth işlemini tamamlayıp belirteci iletemiyorsa Ayarlar → API Anahtarları bölümünde bir Minds anahtarı oluşturun ve istemcinin güvenli deposundan Bearer kimlik doğrulamasını ayarlayın. list_audiences ile test edin. OpenRouter ve diğer ağ geçitlerinin güncel MCP desteğini ve tanımlayıcı biçimini kontrol edin; OpenAI Chat Completions uyumluluğu tek başına uzak MCP desteği garantilemez.

OpenAI Responses API örneği

Örnek, Minds API anahtarını ortamdan okur. OAuth için uygulamanız geçerli bir Minds belirteci aldıktan sonra headers yerine "authorization": os.environ["MINDS_OAUTH_ACCESS_TOKEN"] kullanın.

import os
from openai import OpenAI

client = OpenAI()
response = client.responses.create(
    model="gpt-5.2",
    input="List my Audiences",
    tools=[{
        "type": "mcp",
        "server_label": "minds",
        "server_url": "https://getminds.ai/mcp",
        "headers": {"Authorization": f"Bearer {os.environ['MINDS_API_KEY']}"},
        "allowed_tools": ["list_audiences"],
        "require_approval": "never",
    }],
)
print(response.output_text)

API Key Kimlik Doğrulaması

Programatik erişim veya OAuth desteklemeyen client'lar için:

Minds'ta Settings → API Keys yolunu açın
Yeni bir API key oluşturun (minds_ ile başlar)
Bunu Bearer token olarak gönderin: Authorization: Bearer minds_your_key_here

OAuth Discovery

MCP entegrasyonları geliştirenler için OAuth meta verileri şu adreslerde mevcuttur:

Endpoint	Açıklama
`/.well-known/oauth-protected-resource`	Korumalı kaynak meta verileri (RFC 9728)
`/.well-known/oauth-authorization-server`	Yetkilendirme sunucusu meta verileri (RFC 8414)
`/oauth/register`	Dynamic Client Registration (RFC 7591)

OAuth 2.1 ile PKCE (S256) gereklidir. Public client'lar (token_endpoint_auth_method: "none") desteklenir.

Yerel (native) client'lar loopback yönlendirme URI'leri kaydedebilir (http://127.0.0.1, http://localhost, http://[::1]); port karşılaştırılmaz, bu yüzden bir client herhangi bir boş portta dinleyebilir (RFC 8252). Bir client ayrıca Client ID Metadata Document kullanabilir: meta verilerini yayınlayan bir https client_id URL'si (client_id_metadata_document_supported: true). Token endpoint'i client_id'yi istek gövdesinde veya boş secret ile HTTP Basic kimlik doğrulamasıyla kabul eder.

Sorun Giderme

"Authentication required" hatası

OAuth yetkilendirme akışını tamamladığınızdan emin olun. MCP client'ınızı bağlantısını kesip yeniden bağlayarak yeniden yetkilendirin.

MCP çağrılarını yürüten bileşenin geçerli Minds Bearer kimlik bilgilerini ilettiğini doğrulayın. OAuth’u yeniden bağlayın veya belirteci sahibi olan istemci üzerinden yenileyin; OAuth belirteci iletilemiyorsa API anahtarı kullanın. Sağlayıcı anahtarı veya host oturumu Minds kimlik bilgisinin yerini almaz.

Minds'ta açabildiğiniz bir Study, Audience veya Mind için "Not authorized"

MCP client'ı, öğenin sahibi olandan farklı bir Minds hesabıyla oturum açmış; hata mesajı bağlı hesabı belirtir. Client'ı sahip hesapla yeniden bağlayın veya öğeyi bağlı hesapla paylaşın.

Claude Desktop OAuth tamamlanmıyor

OAuth popup'ı açılıyor ancak tamamlanmıyorsa, API key yaklaşımını (yukarıdaki Seçenek B) deneyin. Claude Desktop'ın remote connector OAuth'u aralıklı olarak sorun çıkarabilir.

Mind bulunamadı

mindName kullanırken, adın Mind'ınızla yakın eşleştiğinden emin olun. Sistem fuzzy matching kullanır ancak makul bir benzerlik skoru gerektirir.

Mind hâlâ eğitiliyor

Yeni Mind'ların eğitimi tamamlanması biraz zaman alabilir. Sohbet etmeden önce eğitimin tamamlanıp tamamlanmadığını kontrol etmek için get_mind_status kullanın.

Study soru timeout'u

Çok sayıda grubu olan study soruları 2 dakikadan fazla sürebilir. Audience sayısını azaltmayı veya soruyu basitleştirmeyi deneyin.

PDF export hazır değil

Dışa aktarımlar asenkrondur. Aynı studyId ve export_study tarafından döndürülen tam exportKind, exportFormat, exportJobId değerleriyle get_study_status sorgulayın. İş durumunu ve indirme URL’sini kontrol edin; süre değişir. Sorgulama zaman aşımı yinelenen dışa aktarıma izin vermez.

Sonuçlar yüklenmeye devam ediyor veya eksik görünüyor

Widget’lar istemci güncellemelerini alır ve izin verilen ortamlarda sınırlı süreyle otomatik durum sorgular. Bu, kesintisiz token akışı garantisi değildir. Diğer durumlarda gösterilen Yenile kontrolünü kullanın, mevcut Study’nin durumunu sorun veya döndürülen Minds bağlantısını açın.

Doğrudan soru için get_study_status, onaylanmış plan için get_study_run kullanın. Aynı studyId korunmalıdır; yükleme veya zaman aşımı yeniden çalıştırma nedeni değildir. Kısmi yanıtları ve eksik yanıt kapsamını belirtin. Soruların tamamlanmış olması tüm Minds’ın yanıtladığını kanıtlamaz.

n8n iş akışları

Çalışmalar oluşturmak, araştırma planlarını önizlemek, Çalışmaları ve kaydedilmiş özetleri almak veya bir işlemi bir Yapay Zeka Ajanına sunmak için n8n için Minds topluluk düğümünü kullanın. Kendi kendine barındırılan n8n'e n8n-nodes-minds yükleyin ve bir Minds API anahtarı bağlayın. Paket npm üzerinde yayınlanmıştır; n8n doğrulaması inceleme aşamasındadır, bu nedenle n8n Cloud üzerinde henüz mevcut değildir. Araştırmayı Minds içinde ayrıca inceleyip başlatın.