--- 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-08-13T13:01:12.374Z" --- # Client Kurulumu 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 1. **ChatGPT** → **Settings** → **Connected Apps** yolunu açın 2. "Minds" arayın veya MCP URL'sini ekleyin: `https://getminds.ai/mcp` 3. **Connect** tıklayın ve OAuth ile yetkilendirin (Minds hesabınıza giriş yapın) 4. Sohbete başlayın — ChatGPT'den Mind oluşturmasını, panel yürütmesini ve sonuçları analiz etmesini isteyin ChatGPT interaktif widget'ları satır içinde render eder — gruplanmış yanıtları içeren panel sonuçları, bar chart'lar ve tıklanabilir Mind avatarları doğrudan sohbette görünür. ## Claude Desktop ### Seçenek A: Remote Connector (önerilir — interaktif widget'ları etkinleştirir) 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 15 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 18 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 mindsai https://getminds.ai/mcp \ --header "Authorization: Bearer minds_YOUR_API_KEY" ``` ## Cursor 1. Cursor Settings → **MCP** yolunu açın 2. Yeni bir server ekleyin, URL: `https://getminds.ai/mcp` 3. İstendiğinde erişimi yetkilendirin ## VS Code (GitHub Copilot) 1. VS Code Settings → **Extensions** → **GitHub Copilot** → **MCP Servers** yolunu açın 2. `https://getminds.ai/mcp` adresini yeni bir server olarak ekleyin 3. İstendiğinde yetkilendirin ## OpenRouter, Open WebUI ve OpenAI uyumlu ağ geçitleri **Model sağlayıcısı** (host değil) MCP çağrısını sunucu tarafında çalıştırıyorsa — örneğin OpenRouter üzerinden bir `openai/*` modeli, OpenAI Responses API’yi doğrudan veya Open WebUI’yi *Native function-calling* modunda kullanıyorsanız — **API key kimlik doğrulaması kullanmalısınız**. OAuth bu yolda çalışmaz. ### Burada OAuth neden çalışmaz Open WebUI, `openai/gpt-5.2` agent’ını Native modda çalıştırdığında MCP aracı deskriptörünü isteğin parçası olarak OpenAI/OpenRouter’a gönderir. OpenAI’nin sunucu tarafındaki MCP runner’ı (Azure’da çalışır, `User-Agent: python-httpx/*` ile tanımlanabilir) `/mcp` endpoint’imizi doğrudan çağırır. Bu runner yalnızca aracı kaydı sırasında yapılandırılan **statik** başlıkları ekler — MCP OAuth el sıkışmasını (RFC 9728 / 8414 / 7591) gerçekleştir**mez**. Open WebUI’nin *OAuth — sistem kullanıcısının erişim token’ını iletir* modu bu nedenle burada etkisizdir: kullanıcının token’ı Open WebUI’yi asla terk etmez. Sonuç: Minds, isteği `Authorization` başlığı olmadan alır ve şu yanıtı döner: ```text 401 Unauthorized www-authenticate: Bearer resource_metadata="https://getminds.ai/.well-known/oauth-protected-resource" {"error":{"code":-32001,"message":"Authentication required. Connect your Minds account via OAuth or provide an API key."}} ``` ### Open WebUI kurulumu 1. [Settings → API Keys](/settings/api-keys) sayfasında bir API key oluşturun (format `minds_…`). 2. Open WebUI’de: **Admin → Ayarlar → Araçlar → + Bağlantı**. 3. Ayarlar: - **Tür**: `Streamable HTTP (MCP)` - **URL**: `https://getminds.ai/mcp` - **Kimlik doğrulama**: `Bearer` *(OAuth değil)* - **Token**: `minds_…` anahtarınız 4. Bağlantıyı kaydedin. 5. Agent’ınızın *Araçlar* sekmesinde **Get Minds** aracını etkinleştirin. 6. Agent’a Minds’lerinizi listelemesini isteyerek test edin. `Kimlik doğrulama: OAuth` ile bırakırsanız, çağrılar yalnızca aracı Open WebUI’nin kendisi çalıştırdığında (yani *Function calling = Default*, *Native* değil) başarılı olur. Çoğu kullanıcı Native modu ister — bu nedenle Bearer key kullanın. ### OpenRouter doğrudan (programatik) OpenRouter’ın chat completions API’sini Minds MCP server’ı ekli olarak çağırırken API key’i araç deskriptörünün statik `headers` alanında geçirin: ```json { "type": "mcp", "server_label": "minds", "server_url": "https://getminds.ai/mcp", "headers": { "Authorization": "Bearer minds_API_KEY_INIZ" } } ``` Doğrudan OpenAI Responses API için de aynısı geçerlidir: ```python from openai import OpenAI client = OpenAI() client.responses.create( model="gpt-5.2", input="Minds’leri listele", tools=[{ "type": "mcp", "server_label": "minds", "server_url": "https://getminds.ai/mcp", "headers": {"Authorization": f"Bearer {os.environ['MINDS_API_KEY']}"}, }], ) ``` ## 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. ## 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. Minds'i **OpenRouter, Native moddaki Open WebUI veya doğrudan OpenAI Responses API** üzerinden çağırıyorsanız, bu yolda OAuth desteklenmez — model sağlayıcısının sunucu tarafındaki MCP runner'ı OAuth el sıkışmasını yapamaz. MCP bağlantınızı `minds_…` anahtarıyla **Bearer / API key kimlik doğrulamasına** geçirin. Yukarıdaki [OpenRouter, Open WebUI ve OpenAI uyumlu ağ geçitleri](#openrouter-open-webui-ve-openai-uyumlu-a%C4%9F-ge%C3%A7itleri) bölümüne bakı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ı `sparkName` 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. ### Panel soru timeout'u Çok sayıda grubu olan panel soruları 2 dakikadan fazla sürebilir. Grup sayısını azaltmayı veya soruyu basitleştirmeyi deneyin. ### PDF export hazır değil PDF raporları asenkron olarak oluşturulur. Export durumunu kontrol etmek için `get_panel_status` kullanın. Oluşturma genellikle 30-60 saniye sürer.