Minds Team

Client Kurulumu

Minds MCP sunucusunu ChatGPT, Claude, Claude Code, Codex, Gemini CLI, Cursor, VS Code, Windsurf, OpenRouter, Open WebUI ve API key kimlik doğrulamasıyla kurun.

Aşağıdaki her client, canlı sunucudan okunan aynı 31 duyurulan aracı görür. 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.

  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.

Minds hesabınızın eklenti dizininde görünüyorsa, onu Plugins üzerinden de ekleyip aynı şekilde oturum açabilirsiniz.

ChatGPT masaüstü uygulamasında Plugins'i açın ve Add → Add MCP server'ı seçin. Türü Streamable HTTP, URL'yi https://getminds.ai/mcp olarak ayarlayın, Save'e ve ardından Restart'a tıklayın, sonra Minds'a oturum açmak için Authenticate'i seçin.

ChatGPT kurulum kılavuzu, eklenti dizini ve masaüstü uygulaması seçenekleri 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 (claude.ai ve Claude Desktop)

Uzak bağlayıcı (widget desteği istemciye bağlıdır)

Özel bağlayıcılar claude.ai'de ve Claude Desktop'ta aynı şekilde çalışır ve ikisi arasında senkronize edilir.

  1. Customize → Connectors bölümünü açın, +'ya tıklayın ve Add custom connector'ı seçin
  2. Uzak MCP sunucu URL'si olarak https://getminds.ai/mcp girin ve Add'e tıklayın
  3. Connect'e tıklayın, Minds hesabınıza giriş yapın ve Allow'u seçin
  4. Bir sohbette Minds'ı + → Connectors üzerinden etkinleştirin

Team ve Enterprise planlarında önce bir sahip bağlayıcıyı Organization settings → Connectors altında ekler; ardından üyeler kendi Minds hesaplarını Customize → Connectors altında bağlar.

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.

Claude'da Widget Desteği

Duyurulan araçlar, sonuçları Minds webapp'inde açmak için yapılandırılmış metin ve tıklanabilir bağlantılar döndürür. Sunucu, açık entegrasyonlar için başka kanonik yaşam döngüsü araçlarını da çağrılabilir tutar; araç referansına bakın. 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, minds'ı seçin ve OAuth ile oturum açmak için Authenticate seçin. API anahtarı isteğe bağlıdır: bunun yerine bir anahtar kullanmak için komuta --header "Authorization: Bearer minds_YOUR_API_KEY" ekleyin.

Codex

Codex CLI ile:

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

codex mcp login, Minds oturum açma sayfasını açar. Codex kendini bir Client ID Metadata Document ile kaydeder; bu nedenle client ID veya secret gerekmez.

Codex uygulamasında veya IDE eklentisinde Settings → MCP servers bölümünü açın, Add server'ı seçin, Streamable HTTP'yi seçin ve https://getminds.ai/mcp girin. Kaydedin, yeniden başlatın ve Authenticate'i seçin.

Bunun yerine API anahtarı kullanmak için ~/.codex/config.toml içinde [mcp_servers.minds] altına bearer_token_env_var = "MINDS_API_KEY" ekleyin ve anahtarı bu değişkende dışa aktarın.

Gemini CLI

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

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

Veya gemini mcp add --transport http minds https://getminds.ai/mcp komutunu çalıştırın. 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.

Google Antigravity

Sunucuyu ~/.gemini/config/mcp_config.json dosyasına (veya bir çalışma alanında .agents/mcp_config.json dosyasına) ekleyin. Antigravity serverUrl gerektirir; url veya httpUrl kabul etmez:

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

Ya da agy mcp add --type http minds https://getminds.ai/mcp komutunu çalıştırın. Giriş yapmak için Settings → Customizations bölümünü açın, minds yanındaki Authenticate seçeneğini seçin ve girişten sonra gösterilen kodu yapıştırın. Eklenti kurulumu ve API anahtarları için Google Antigravity'de Minds rehberine bakın.

Cursor

  1. Sunucuyu ~/.cursor/mcp.json dosyasına veya bir projedeki .cursor/mcp.json dosyasına ekleyin:
{
  "mcpServers": {
    "minds": { "url": "https://getminds.ai/mcp" }
  }
}
  1. Cursor istediğinde kimliğinizi doğrulayın 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:
{
  "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. Ardından Minds araçları agent modunda Copilot Chat'te görünür.

Windsurf

Cascade panelinde … menüsünü açın ve Open MCP config file'ı seçin. Minds'ı mcpServers altına ekleyin:

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

Dosyayı kaydedin, ardından Windsurf istediğinde Minds'a oturum açın. Bunun yerine API anahtarı kullanmak için girdiye "headers": { "Authorization": "Bearer ${env:MINDS_API_KEY}" } ekleyin.

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:

  1. Minds'ta 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

Scopes

OAuth client'ları temel OpenID izinlerini (openid, email, profile) ve aşağıdaki Minds scope'larını ister. Minds onay ekranı, Allow'u seçmenizden önce her scope'u ürün diliyle açıklar. Hiç scope istemeyen bir client hepsini alır.

ScopeErişim
openidConfirm who you are
emailSee your email address
profileSee your name and profile picture
sparks:readSee your Minds and Audiences
sparks:writeCreate and edit Minds and Audiences
sparks:chatAsk your Minds and Audiences questions
flows:readSee your Studies and their results
flows:writeCreate Studies and run research in them

OAuth Discovery

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

EndpointAçıklama
/.well-known/oauth-protected-resourceKorumalı kaynak meta verileri (RFC 9728)
/.well-known/oauth-authorization-serverYetkilendirme sunucusu meta verileri (RFC 8414)
/oauth/registerDynamic 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.

Minds© 2026 Minds. Hedef kitleniz. Yapay zekâ destekli ve şeffaf kanıtlara dayalı. Dakikalar içinde hazır.
Minds şunların parçasıdır
ESOMARGreenBookInsight PlatformsCapterraG2CSSDA Best UX Design AwardCSSDA Best Innovation AwardCSSDA Best UI Design Award