--- title: "Client Kurulumu" description: "Minds MCP'yi ChatGPT, Claude Desktop, Cursor ve diğer client'larla kurun." canonical_url: "https://getminds.ai/mcp/tr/setup" last_updated: "2026-09-30T12:20:32.710Z" --- # 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](/mcp/overview) 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](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt) bakın. 1. **Plugins**'i açın ve **Add → Create MCP App**'i seçin. Seçenek yoksa geliştirici modunu açın veya çalışma alanı yöneticinizden özel MCP uygulamalarına izin vermesini isteyin. 2. Adını `Minds` koyun, **Server URL** alanına `https://getminds.ai/mcp` yazın, **Authentication** için **OAuth**'u seçin, risk uyarısını onaylayın ve **Create**'e tıklayın. 3. **Continue to Minds**'a tıklayın, Minds hesabınıza giriş yapın ve **Allow**'u seçin. 4. Yeni bir sohbette `@Minds` yazın ve Audience listesini isteyin. Kapsamlı Studies, çalıştırılmadan önce inceleme ve açık onay gerektirir. [ChatGPT kurulum kılavuzu](/guide/integration-chatgpt), eklenti dizini seçeneği dahil her ekranı gösterir. 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 ### Uzak bağlayıcı (widget desteği istemciye bağlıdır) 1. Claude Desktop'ı açın → **Customize** → **Connectors** (veya **Settings** → **Connections**) 2. `https://getminds.ai/mcp` adresini yeni bir remote connector olarak ekleyin 3. İstendiğinde OAuth ile yetkilendirin — Minds hesabınıza giriş yapın 4. 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`): ```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. ### Claude'da Widget Desteği 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) ```bash 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: ```bash 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: ```json { "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 1. Cursor Settings → **MCP** bölümünü açıp yeni bir sunucu ekleyin veya `~/.cursor/mcp.json` dosyasına ekleyin: ```json { "mcpServers": { "minds": { "url": "https://getminds.ai/mcp" } } } ``` 1. Cursor istediğinde **Login** seçin ve Minds'a oturum açın. ## VS Code (GitHub Copilot) 1. 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: ```json { "servers": { "minds": { "type": "http", "url": "https://getminds.ai/mcp" } } } ``` 1. 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](https://developers.openai.com/api/docs/guides/tools-connectors-mcp) 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ı](/settings/api-keys) 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. ```python 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: 1. Minds'ta [Settings → API Keys](/settings/api-keys) yolunu açın 2. Yeni bir API key oluşturun (`minds_` ile başlar) 3. 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ü](/guide/integration-n8n) 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.