---
title: "Entegrasyonlar - Minds'ı Her Yere Bağlayın"
description: "Minds'ı MCP üzerinden ChatGPT, Claude, Cursor ve diğer AI asistanlarından kullanın; web sitenize bir sohbet widget'ı gömün."
canonical_url: "https://getminds.ai/guide/tr/integrations"
last_updated: "2026-10-11T04:52:07.636Z"
---

# Entegrasyonlar

Minds'ı AI asistanlarına ve web sitenize bağlayın. Mind'larınızı ChatGPT, Claude, Cursor, Langdock veya MCP uyumlu herhangi bir istemciden kullanın ya da doğrudan sitenize gömün.

Kullanılabilirlik, planınıza ve çalışma alanınızda etkinleştirilen entegrasyonlara bağlıdır. “Yakında” olarak işaretlenen entegrasyonlar planlanmaktadır ve henüz bağlanamaz.

<integrations-catalog>



</integrations-catalog>

## Marketplace listeleri

Minds entegrasyonlarını zaten çalıştığınız marketplace'ten yükleyin:

- **Chrome Web Store:** [Minds Research Companion](https://chromewebstore.google.com/detail/minds-research-companion/focicdfpkgjgdnbmidpgkcokbipndjap), bir web sayfasında seçtiğiniz metni bir sohbete veya Çalışmaya yapıştırılmaya hazır şekilde Minds'a gönderir. [Chrome uzantısı kılavuzuna](/guide/integration-chrome-extension) bakın.
- **GitHub Marketplace:** [Minds Research Review](https://github.com/marketplace/actions/minds-research-review), bir GitHub iş akışından incelenebilir Çalışmalar planlar, bir Kitleye soru sorar ve sonuçları okur. [GitHub Action kılavuzuna](/guide/integration-github-action) bakın.
- **npm:** [n8n-nodes-minds](https://www.npmjs.com/package/n8n-nodes-minds), kendi kendine barındırılan n8n için Minds topluluk düğümüdür ve *Ayarlar → Topluluk Düğümleri* (*Settings → Community Nodes*) üzerinden yüklenir. [n8n kılavuzuna](/guide/integration-n8n) bakın.

## 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.

## AI Asistanları (MCP)

Minds'ı doğrudan AI asistanınızdan kullanın. Mind oluşturun, panel araştırması çalıştırın ve sonuçları analiz edin; hepsi doğal bir konuşma üzerinden.

**MCP Server URL:** `https://getminds.ai/mcp`

### ChatGPT

ChatGPT web sohbetinde Minds ile Audiences bulun, önerilen Study’yi inceleyin ve sonuçlarını okuyun. OAuth ve özel uygulama kurulumu için [Minds’ı ChatGPT’ye bağlama](/mcp/setup) rehberine bakın; erişim ChatGPT çalışma alanınıza bağlıdır.

Asistan çalıştırmadan önce araştırma planını onaylamanızı ister. Desteklenen mobil ortamda widget Minds çalışma alanına bağlantı verir. Sonuçları orada incelemek için döndürülen Study bağlantısını açın.

### Claude (claude.ai ve Claude Desktop)

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

1. **Customize** → **Connectors**'ı açın, **+**'ya tıklayın ve **Add custom connector**'ı seçin
2. `https://getminds.ai/mcp`'yi ekleyin
3. İstendiğinde OAuth üzerinden Minds'a oturum açın

**Local connector (API key, yalnızca metin):** Yapılandırmanıza (`~/Library/Application Support/Claude/claude_desktop_config.json`) ekleyin:

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

### Claude Code (CLI)

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

OAuth ile oturum açmak için `/mcp` komutunu çalıştırın ve **Authenticate**'i seçin. API key isteğe bağlıdır: bunun yerine bir key kullanmak için `--header "Authorization: Bearer minds_YOUR_API_KEY"` ekleyin.

### Cursor

1. `~/.cursor/mcp.json` içinde `mcpServers` altına `"minds": { "url": "https://getminds.ai/mcp" }` ekleyin
2. Cursor istediğinde kimliğinizi doğrulayın
3. Minds'a oturum açın ve **Allow**'u seçin

Widget desteği istemciye ve sürümüne bağlıdır.

### Langdock

1. **Langdock** → **Integrations** → **Add MCP Integration**'ı açın
2. URL'yi girin: `https://getminds.ai/mcp`
3. Kimlik doğrulama yöntemi olarak **OAuth**'u seçin
4. **"+ Add connection"**'a tıklayın ve yetkilendirin
5. Araçları doğrulamak için **"Test connection"**'a tıklayın

Duyurulan tüm araçlar kullanılabilir. Tıklanabilir bağlantılar içeren metin yanıtları (etkileşimli widget yok).

### VS Code (GitHub Copilot)

1. Komut Paleti'nden **MCP: Add Server** çalıştırın ve **HTTP**'yi seçin
2. `https://getminds.ai/mcp` girin
3. İstendiğinde Minds'a oturum açın; araçlar agent modunda Copilot Chat'te görünür

### Diğer MCP İstemcileri

OpenRouter ve Open WebUI dahil, MCP uyumlu herhangi bir istemci `https://getminds.ai/mcp`'ye bağlanabilir. OAuth'u destekleyen istemciler yetkilendirme akışını otomatik olarak keşfeder. OAuth'u olmayan istemciler için Bearer token olarak bir API key (Settings → API Keys) kullanın.

Tam araç referansı ve kurulum ayrıntıları için [MCP belgelerine](/mcp/overview) bakın.

---

## Google Workspace ve analiz

- [Google Sheets için Minds](/guide/google-sheets): seçili soruları mevcut bir Audience'a gönderin ve yanıtları sayfaya yazın.
- [Looker Studio için Minds Panel Analytics](/guide/looker-studio): mevcut bir Panel'in analizlerini raporlar ve panolar için kullanın.

Bu entegrasyonların Marketplace kullanılabilirliği Google incelemesine bağlıdır.

---

## Sohbet Entegrasyonları

### Slack

*Yakında* - Kanallarda ve DM'lerde Minds ile sohbet edin.

### Microsoft Teams

*Yakında* - Minds'ı Teams çalışma alanınıza getirin.

---

## Kurumsal Tek Oturum Açma (SAML)

Kurumsal müşteriler Microsoft Entra ID veya Okta gibi müşteri tarafından yönetilen bir kimlik sağlayıcısıyla oturum açabilir. Giriş veya kayıt ekranında e-posta / SSO seçeneğini kullanıp iş e-postanızı yazın. Minds kayıtlı SSO alan adlarını otomatik tanır, parola alanlarını gizler, yapılandırılmış kimlik sağlayıcısına yönlendirir ve mevcut PKCE dönüşü `/auth/confirm` oturumu tamamlar.

### Yönetici kurulumu

1. Microsoft Entra ID'de (veya başka bir kimlik sağlayıcısında) bir SAML 2.0 kurumsal uygulaması oluşturun. [Minds metadata](https://auth.getminds.ai/auth/v1/sso/saml/metadata) dosyasını doğrudan içe aktarabilirsiniz.
2. Değerleri elle giriyorsanız şunları kullanın:

  - **Identifier / Entity ID:** `https://auth.getminds.ai/auth/v1/sso/saml/metadata`
  - **Reply URL / ACS:** `https://auth.getminds.ai/auth/v1/sso/saml/acs`
  - **Logout URL (isteğe bağlı):** `https://auth.getminds.ai/auth/v1/sso/saml/slo`
3. Claim olarak en az e-posta adresini ve sabit bir kullanıcı kimliğini gönderin; görünen ad isteğe bağlıdır. Ardından gerekli kullanıcıları veya grupları uygulamaya atayın.
4. Kimlik sağlayıcınızın **Federation Metadata URL** veya **Federation Metadata XML** bilgisini ve doğrulanmış giriş alan adlarını Minds'a gönderin. SAML için client ID veya client secret gerekmez.
5. Minds bağlantıyı etkinleştirir; iki taraf bir test hesabıyla IdP ve Minds tarafından başlatılan girişleri doğrular.

MFA, cihaz güveni, giriş riski ve konum kuralları tamamen müşterinin kimlik sağlayıcısında kalır. SAML kimlikleri mevcut parola, Google, Apple veya Microsoft girişleriyle otomatik birleşmediğinden mevcut Minds hesapları etkinleştirmeden önce birlikte incelenir.

---

## Bulut Depolama (Google Drive & OneDrive)

Google Drive veya OneDrive'dan dosya ekleyin. Google Drive dosya bazlı `drive.file` kapsamını kullanır. OneDrive, **oturum açmış kullanıcının kişisel OneDrive'ı** için devredilmiş `Files.Read` ve `offline_access` izinlerini kullanır. Minds seçicisi yalnızca kullanıcının açıkça seçtiği dosyaları içe aktarır ve saklar. Minds sürücüyü taramaz veya eşitlemez; OneDrive dosyalarını yazamaz, değiştiremez ya da silemez.

Mevcut OneDrive bağlayıcısı kişisel OneDrive dışındaki paylaşılan klasörleri veya SharePoint ve Teams belge kitaplıklarını desteklemez. Bu kaynaklar daha geniş Microsoft Graph izinlerine sahip ayrı bir entegrasyon gerektirir.

**Kurulum:** "+" ekleme menüsünde Google Drive veya OneDrive simgesine tıklayın ya da **Settings** → **Integrations**'a gidin. Bir kez yetkilendirin, sonra ihtiyaç duydukça dosya seçin. Bağlantı bir sonraki sefer için hatırlanır.

### Kuruluş yöneticileri için

Kuruluşunuz üçüncü taraf uygulama erişimini kısıtlıyorsa, ekibiniz bağlanabilmeden önce bir yöneticinin Minds'ı onaylaması gerekebilir.

**Google Workspace.** Google Admin console'da *Security* → *Access and data control* → *API controls* → *App access control* → *Manage third-party app access*'e gidin. Minds'ı OAuth istemci kimliğiyle ekleyin ve erişimi **Trusted** olarak ayarlayın:

`686849389800-f4ef6g5a2icmm7dhcdonuombqfncl2u8.apps.googleusercontent.com`

Minds yalnızca `drive.file` kapsamını ister; bu kapsam, bir kullanıcının seçici üzerinden açtığı tek tek dosyalara erişim verir, tüm Drive'ına değil.

**Microsoft 365 / Entra ID.** Bir yönetici, bu bağlantıyı açıp yönetici olarak oturum açarak kuruluş genelinde onay verebilir:

`https://login.microsoftonline.com/common/adminconsent?client_id=fcf09c38-f994-4f8f-aab0-5eb8e6434271`

Ya da Microsoft Entra admin center'da: *Enterprise applications* → *Minds* → *Permissions* → *Grant admin consent*. Yönetici onayı devredilmiş `Files.Read` ve `offline_access` izinlerini kuruluş için kabul eder; Minds'a kuruluştaki tüm OneDrive'lara uygulama düzeyinde erişim vermez. Ardından her kullanıcı **Settings** → **Integrations** → **OneDrive** bölümünde kendi hesabını bağlar ve içe aktarılacak dosyaları seçer.

---

## Kurumsal entegrasyon mimarisi

```text
Çalışanlar ── SAML ──> Kimlik sağlayıcı ── assertion ──> Supabase Auth
    │                                                   │
    └──────────────── Minds web/API <── oturum ─────────┘
                         ├── Files.Read ──> Microsoft Graph
AI asistanları ── OAuth 2.1/API anahtarı ──> Minds MCP ──> yetkili API'ler
```

Kimlik sağlayıcı kimlikleri, MFA'yı ve Conditional Access'i yönetir. Supabase Auth SAML assertion'ını doğrular ve Minds oturumunu oluşturur. Microsoft Graph yalnızca bağlı kullanıcının kişisel OneDrive'ı ve seçilen dosyaların içe aktarılması için kullanılır. MCP istemcileri PKCE'li OAuth 2.1 veya Minds API anahtarı kullanır. SSO, OneDrive ve MCP, kendi onay ve iptal yollarına sahip ayrı entegrasyonlardır.

---

## Gömülü Widget

Müşteri desteği, ürün demoları veya etkileşimli deneyimler için web sitenize bir sohbet widget'ı ekleyin.

**Özellikler:**

- Destek sohbeti stilinde açılır pencere arayüzü
- Otomatik açık/koyu tema algılama
- Mobil ve masaüstü uyumlu
- Sayfa yüklemeleri arasında oturum kalıcılığı

**Kurulum:**

1. **Settings** → **Integrations** → **Embed Widget**'a gidin
2. Widget'ınız için en fazla 3 Mind seçin
3. Script etiketini kopyalayıp web sitenize ekleyin

**Temel kullanım:**

```html
<script
  src="https://getminds.ai/embed/chat-widget.js"
  data-widget-id="your-widget-id"
  async
></script>
```

<embed-widget-preview>



</embed-widget-preview>

**Yapılandırma seçenekleri:**

<table>
<thead>
  <tr>
    <th>
      Öznitelik
    </th>
    
    <th>
      Açıklama
    </th>
    
    <th>
      Varsayılan
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        data-widget-id
      </code>
    </td>
    
    <td>
      Widget ID'niz (zorunlu)
    </td>
    
    <td>
      -
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-language
      </code>
    </td>
    
    <td>
      Dili zorla: <code>
        en
      </code>
      
      , <code>
        de
      </code>
      
      , <code>
        es
      </code>
      
      , <code>
        fr
      </code>
      
      , <code>
        zh
      </code>
      
      , <code>
        tr
      </code>
      
      , <code>
        ar
      </code>
      
      , <code>
        ja
      </code>
      
      , <code>
        ko
      </code>
      
      . Hem widget arayüzünü hem de AI yanıt dilini kontrol eder.
    </td>
    
    <td>
      Otomatik algıla
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-position
      </code>
    </td>
    
    <td>
      <code>
        bottom-left
      </code>
      
       veya <code>
        bottom-right
      </code>
    </td>
    
    <td>
      <code>
        bottom-left
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-theme
      </code>
    </td>
    
    <td>
      <code>
        light
      </code>
      
       veya <code>
        dark
      </code>
    </td>
    
    <td>
      Otomatik algıla
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-max-messages
      </code>
    </td>
    
    <td>
      Kayıt istemi öncesi maksimum kullanıcı mesajı (1–10)
    </td>
    
    <td>
      <code>
        3
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-greeting-delay
      </code>
    </td>
    
    <td>
      İlk karşılama öncesi ms cinsinden gecikme
    </td>
    
    <td>
      <code>
        0
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-persist-session
      </code>
    </td>
    
    <td>
      Konuşmayı sayfalar arasında koru
    </td>
    
    <td>
      <code>
        true
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-size
      </code>
    </td>
    
    <td>
      Widget boyutu: <code>
        standard
      </code>
      
       veya <code>
        large
      </code>
    </td>
    
    <td>
      <code>
        standard
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-primary-color
      </code>
    </td>
    
    <td>
      Launcher kenarlığı / ana renk için hex değer
    </td>
    
    <td>
      <code>
        #000000
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-accent-color
      </code>
    </td>
    
    <td>
      Sohbet ikonu vurgu rengi için hex değer
    </td>
    
    <td>
      <code>
        #00E14F
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-surface-color
      </code>
    </td>
    
    <td>
      Launcher yüzey rengi için hex değer
    </td>
    
    <td>
      Sayfa teması
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-launcher-label
      </code>
    </td>
    
    <td>
      Kapalı launcher'da Mind adının altında gösterilen metin
    </td>
    
    <td>
      <code>
        Bir Mind ile sohbet et
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        data-z-index
      </code>
    </td>
    
    <td>
      Widget için CSS z-index
    </td>
    
    <td>
      <code>
        999999
      </code>
    </td>
  </tr>
</tbody>
</table>

**JavaScript API:**

```javascript
// Control the widget
ArtOfXChatWidget.open();
ArtOfXChatWidget.close();
ArtOfXChatWidget.toggle();

// Events
ArtOfXChatWidget.on('message', (data) => {
  console.log(data.role, data.content);
});

// Clear history
ArtOfXChatWidget.clearHistory();
```

Kendi launcher'ınızı kullanmak istiyorsanız sitenizdeki butondan `ArtOfXChatWidget.open()` çağırın.

`ArtOfXWidget`, aynı API için geriye dönük uyumluluk takma adı olarak korunur.

---

## Sorun Giderme

**MCP araçları istemcinizde görünmüyor**
Bağlayıcıyı kaldırıp yeniden ekleyin, ardından OAuth akışını yeniden tamamlayın. Bazı istemciler, başarısız bir ilk bağlantıdan kalan boş araç listesini önbelleğe alır.

**API key ile "401 Unauthorized"**
Anahtarın Bearer token olarak gönderildiğini ve `minds_` ile başladığını kontrol edin (Settings → API Keys).

**Widget sitenizde görünmüyor**`data-widget-id` değerinin Settings → Integrations → Embed Widget'taki değerle eşleştiğini ve script etiketinin bir çerez onay yöneticisi tarafından engellenmediğini doğrulayın.

---

*Entegrasyonlar, Minds'ı zaten çalıştığınız yere getirir. Bir kez kurun, her yerde kullanın.*