---
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-08-25T20:21:07.061Z"
---

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

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

1. **ChatGPT** → **Settings** → **Connected Apps**'e gidin
2. "Minds" aratın veya MCP URL'sini ekleyin: `https://getminds.ai/mcp`
3. **Connect**'e tıklayın ve OAuth üzerinden yetkilendirin
4. ChatGPT'den Mind oluşturmasını ve panel araştırması çalıştırmasını istemeye başlayın

ChatGPT, etkileşimli widget'ları satır içinde render eder: gruplanmış yanıtlar, çubuk grafikler ve tıklanabilir Mind avatarları içeren panel sonuçları.

### Claude Desktop

**Remote connector (önerilen, etkileşimli widget'ları etkinleştirir):**

1. Claude Desktop → **Customize** → **Connectors**'ı açın
2. `https://getminds.ai/mcp`'yi ekleyin
3. İstendiğinde OAuth üzerinden yetkilendirin

**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 mindsai https://getminds.ai/mcp \
  --header "Authorization: Bearer minds_YOUR_API_KEY"
```

### Cursor

1. **Cursor Settings** → **MCP**'yi açın
2. Sunucu URL'sini ekleyin: `https://getminds.ai/mcp`
3. İstendiğinde yetkilendirin

Cursor v2.6'dan itibaren widget desteği.

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

13 aracın tamamı kullanılabilir. Tıklanabilir bağlantılar içeren metin yanıtları (etkileşimli widget yok).

### VS Code (GitHub Copilot)

1. VS Code Settings → **Extensions** → **GitHub Copilot** → **MCP Servers**
2. `https://getminds.ai/mcp`'yi ekleyin
3. İstendiğinde yetkilendirin

### 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 Group'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.*