MCP Sunucusu

Model Context Protocol Entegrasyonu

mindzieAPI MCP sunucusu, yapay zeka kodlama asistanlarının mindzieStudio ile programatik olarak etkileşim kurmasını sağlar. MCP (Model Context Protocol), yapay zeka araçlarının dış yeteneklere erişimi için standartlaştırılmış bir yöntem sunar.

Mevcut Araçlar

MCP sunucusu, yapay zeka asistanları için aşağıdaki araçları sunar:

mindzie_list_block_types

Mevcut blok türleri (filtreler, hesaplayıcılar, zenginleştirmeler) hakkında bilgi alır.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
`category`	String	Hayır	Kategoriye göre filtrele: "filters", "calculators", "unified" veya sadece filtreler için boş bırakın

Kategori Seçenekleri

Değer	Döner
`"filters"`	Sadece filtre blok türleri (varsayılan)
`"calculators"`	Sadece hesaplayıcı blok türleri
`"unified"`	Zenginleştirmeler dahil tüm blok türleri, kategoriye göre gruplanmış

Örnek: Tüm Blok Türlerini Al (Önerilen)

mindzie_list_block_types category="unified"

Tüm blok türleri için eksiksiz meta veriyi döner:

{
  "BlockTypes": [
    {
      "OperatorName": "CaseAttributeFilter",
      "DisplayName": "Vaka Öznitelik Filtresi",
      "Description": "Öznitelik değerlerine göre vakaları filtrele",
      "Category": "Öznitelik Filtreleri",
      "BlockType": "Filter",
      "DocumentationUrl": "/mindzie_studio/filters/case-attribute-filter",
      "UsageFrequency": "High",
      "CommonUseCases": ["Müşteri segmentine göre filtrele", "Belirli bölgelere odaklan"]
    },
    {
      "OperatorName": "CaseDurationCalculator",
      "DisplayName": "Vaka Süresi Hesaplayıcı",
      "Description": "Vakaların toplam süresini hesaplar",
      "Category": "Zaman Hesaplayıcıları",
      "BlockType": "Calculator",
      "DocumentationUrl": "/mindzie_studio/calculators/case-duration-calculator",
      "UsageFrequency": "High",
      "CommonUseCases": ["Döngü sürelerini analiz et", "Yavaş vakaları belirle"]
    },
    {
      "OperatorName": "CaseStageCalculator",
      "DisplayName": "Vaka Aşaması Hesaplayıcı",
      "Description": "Aktivite kalıplarına göre vakalara aşama etiketleri atar",
      "Category": "Aşama Analizi",
      "BlockType": "Enrichment",
      "DocumentationUrl": "/mindzie_studio/enrichments/case-stage-calculator",
      "UsageFrequency": "Medium",
      "CommonUseCases": ["Vaka ilerlemesini takip et", "Aşama geçişlerini izle"]
    }
  ],
  "Categories": ["Öznitelik Filtreleri", "Zaman Filtreleri", "Zaman Hesaplayıcıları", "Aşama Analizi"],
  "TotalCount": 45,
  "ByBlockCategory": {
    "Filter": [...],
    "Calculator": [...],
    "Enrichment": [...]
  }
}

Örnek: Sadece Filtreleri Al

mindzie_list_block_types category="filters"

Örnek: Sadece Hesaplayıcıları Al

mindzie_list_block_types category="calculators"

mindzie_list_projects

Mevcut kiracıdaki projeleri listeler.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
`tenant_id`	String	Evet	Kiracı tanımlayıcısı

mindzie_get_project

Belirli bir proje hakkında detayları alır.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
`tenant_id`	String	Evet	Kiracı tanımlayıcısı
`project_id`	String	Evet	Proje tanımlayıcısı

mindzie_execute_block

Bir bloğu çalıştırır ve sonuçları döner.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
`tenant_id`	String	Evet	Kiracı tanımlayıcısı
`project_id`	String	Evet	Proje tanımlayıcısı
`block_id`	String	Evet	Çalıştırılacak blok

mindzie_generate_url

mindzieStudio sayfalarına ve varlıklarına yönelik gezinme veya paylaşım için URL'ler üretir.

Parametreler

Parametre	Tür	Zorunlu	Açıklama
`type`	String	Evet	URL türü (aşağıdaki URL Türlerine bakınız)
`entity_id`	String	Koşullu	Varlığa özgü sayfalar için varlık ID'si
`parent_id`	String	Koşullu	Üst ID (projectId veya notebookId)

URL Türleri

Liste Sayfaları (entity_id gerekmez):

Tür	parent_id	Açıklama
`projects`	-	Projeler listesi
`apps`	-	Uygulamalar listesi
`investigations`	projectId	Bir proje için incelemeler
`dashboards-list`	projectId	Proje için panolar listesi
`datasets`	projectId	Projeye ait veri setleri
`actions`	projectId	Projede yapılan eylemler
`bpmn`	projectId	Proje için BPMN editörü

Varlık Sayfaları (entity_id gerekli):

Tür	entity_id	parent_id	Açıklama
`dashboard`	dashboardId	-	Tek bir pano
`analysis`	notebookId	-	Defter/analiz sayfası
`block`	blockId	notebookId	Belirli bir blok
`enrichment`	enrichmentId	projectId (opsiyonel)	Zenginleştirme defteri

Örnek: Pano URL'si Alma

mindzie_generate_url type="dashboard" entity_id="{dashboardId}"

Döner:

{
  "url": "https://host/navigate?type=dashboard&id=...",
  "entityType": "dashboard",
  "entityId": "...",
  "tenantId": "..."
}

Örnek: Blok URL'si Alma

mindzie_generate_url type="block" entity_id="{blockId}" parent_id="{notebookId}"

Örnek: İncelemeler Listesi URL'si Alma

mindzie_generate_url type="investigations" parent_id="{projectId}"

Ön Koşullar

MCP sunucusunu kurmadan önce aşağıdakilere sahip olduğunuzdan emin olun:

Node.js 18 veya üzeri - İndirmek için nodejs.org
Bir mindzie API tokenı - mindzieStudio hesap ayarlarından oluşturun
mindzieStudio örnek URL'niz - Bulut için https://www.mindziestudio.com veya kurum içi URL'niz

Kurulum

mindzie MCP sunucusu, npx ile otomatik kurulur - manuel kurulum gerekmez:

npx -y @mindzie/mcp-server

Ortam Değişkenleri

Değişken	Zorunlu	Açıklama
`MINDZIE_API_URL`	Evet	mindzieStudio örnek URL'niz
`MINDZIE_API_TOKEN`	Evet	API kimlik doğrulama tokenı

Uygulama Bazında Kurulum

Claude Desktop

Claude Desktop, Anthropic’in Claude AI için masaüstü uygulamasıdır.

Windows Konfigürasyonu

Aşağıdaki dosyayı düzenleyin:

%APPDATA%\Claude\claude_desktop_config.json

mindzie MCP sunucusunu ekleyin:

{
  "mcpServers": {
    "mindzie": {
      "command": "npx",
      "args": ["-y", "@mindzie/mcp-server"],
      "env": {
        "MINDZIE_API_URL": "https://www.mindziestudio.com",
        "MINDZIE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

macOS Konfigürasyonu

Aşağıdaki dosyayı düzenleyin:

~/Library/Application Support/Claude/claude_desktop_config.json

Yukarıdaki Windows konfigürasyonu ile aynı ayarları ekleyin.

Konfigürasyon Sonrası

Konfigürasyon dosyasını kaydedin
Claude Desktop’ı tamamen yeniden başlatın (kapatıp açın)
Sohbet arayüzünde çekiç ikonunu arayın - bu MCP araçlarının kullanılabilir olduğunu gösterir

Claude Code (CLI)

Claude Code, Anthropic’in Claude AI için komut satırı arayüzüdür.

MCP Sunucusunu Ekle

mindzie MCP sunucusunu kaydetmek için şu komutu çalıştırın:

claude mcp add mindzie -- npx -y @mindzie/mcp-server

Ortam Değişkenlerini Ayarlama

Windows (PowerShell):

$env:MINDZIE_API_URL = "https://www.mindziestudio.com"
$env:MINDZIE_API_TOKEN = "your-api-token-here"

Windows (Komut İstemi):

set MINDZIE_API_URL=https://www.mindziestudio.com
set MINDZIE_API_TOKEN=your-api-token-here

macOS/Linux:

export MINDZIE_API_URL="https://www.mindziestudio.com"
export MINDZIE_API_TOKEN="your-api-token-here"

Kalıcı Konfigürasyon

Ortam değişkenlerini kalıcı hale getirmek için shell profilinize (.bashrc, .zshrc veya PowerShell profili) ekleyin.

Cursor IDE

Cursor, VS Code tabanlı yapay zeka destekli kod editörüdür.

Konfigürasyon Dosyası Konumu

Ev dizini veya proje kök dizininde .cursor/mcp.json dosyasını oluşturun veya düzenleyin:

{
  "mcpServers": {
    "mindzie": {
      "command": "npx",
      "args": ["-y", "@mindzie/mcp-server"],
      "env": {
        "MINDZIE_API_URL": "https://www.mindziestudio.com",
        "MINDZIE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Alternatif: Ayarlar UI

Cursor'u açın
Ayarlar bölümüne gidin (Ctrl/Cmd + ,)
"MCP" araması yapın
settings.json'da Düzenleye tıklayın
mindzie sunucu konfigürasyonunu ekleyin

Kurulumu Doğrulama

Konfigürasyon sonrasında Cursor'u yeniden başlatın ve yapay zeka asistanının kullanılabilir araçlarında mindzie araçlarının göründüğünü kontrol edin.

Windsurf (Codeium)

Windsurf, Codeium’un yapay zeka destekli IDE'sidir.

Konfigürasyon Dosyası Konumu

Windows:

%USERPROFILE%\.codeium\windsurf\mcp_config.json

macOS/Linux:

~/.codeium/windsurf/mcp_config.json

Konfigürasyon

{
  "mcpServers": {
    "mindzie": {
      "command": "npx",
      "args": ["-y", "@mindzie/mcp-server"],
      "env": {
        "MINDZIE_API_URL": "https://www.mindziestudio.com",
        "MINDZIE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Kurulumu Doğrulama

Windsurf’u yeniden başlatın
Cascade panelini açın
mindzie araçlarının süreç madenciliği sorguları için mevcut olduğunu doğrulayın

VS Code ile Continue Eklentisi

Continue, VS Code için açık kaynaklı yapay zeka kodlama asistanıdır.

Continue Kurulumu

VS Code'u açın
Uzantılar bölümüne gidin (Ctrl/Cmd + Shift + X)
"Continue" araması yapın ve yükleyin

MCP Sunucusunu Konfigüre Etme

Continue yapılandırma dosyasını düzenleyin:

Windows:

%USERPROFILE%\.continue\config.json

macOS/Linux:

~/.continue/config.json

mcpServers bölümüne MCP sunucusunu ekleyin:

{
  "mcpServers": [
    {
      "name": "mindzie",
      "command": "npx",
      "args": ["-y", "@mindzie/mcp-server"],
      "env": {
        "MINDZIE_API_URL": "https://www.mindziestudio.com",
        "MINDZIE_API_TOKEN": "your-api-token-here"
      }
    }
  ]
}

Kurulumu Doğrulama

VS Code'u yeniden başlatın
Continue panelini açın
/tools yazın ve mindzie dahil mevcut MCP araçlarını görün

Sorun Giderme

MCP Sunucusu Bağlanmıyor

Node.js kurulumunu doğrulayın: node --version çalıştırın (18+ olmalı)
Sunucuyu manuel test edin: Terminalde npx -y @mindzie/mcp-server çalıştırın
Ortam değişkenlerini kontrol edin: MINDZIE_API_URL ve MINDZIE_API_TOKEN doğru ayarlı mı?
Uygulamayı yeniden başlatın: Tamamen kapatıp yeniden açın

Kimlik Doğrulama Hataları

API tokenınızı doğrulayın: Tokenlar süresi dolabilir veya iptal edilebilir
Token izinlerini kontrol edin: Gerekli kaynaklara erişim izni var mı?
URL’yi kontrol edin: MINDZIE_API_URL doğru örneğe işaret ediyor mu?

Araçlar Görünmüyor

Konfigürasyon söz dizimini kontrol edin: JSON doğru mu, son virgül var mı?
Dosya konumunu doğrulayın: Konfigürasyon dosyası doğru dizinde mi?
Uygulama kayıtlarını inceleyin: MCP ile ilgili hata var mı?
Tamamen yeniden başlatın: Bazı uygulamalar MCP konfigürasyonlarını önbellekleyebilir

Yaygın Konfigürasyon Hataları

Hata	Çözüm
npx argümanlarında `-y` bayrağı eksik	Onay atlama için `-y` ekleyin: `["-y", "@mindzie/mcp-server"]`
JSON’da son virgül	JSON nesnelerinden son virgülleri kaldırın
Yanlış konfigürasyon dosyası konumu	İşletim sistemi için yoldan emin olun
Token özel karakterler içeriyor	Token JSON içinde doğru şekilde tırnak içine alınmalı

Güvenlik En İyi Uygulamaları

Tokenları versiyon kontrolüne asla koymayın - Ortam değişkenleri veya gizli yönetim araçları kullanın
Proje bazlı tokenlar kullanın - Farklı projeler için ayrı tokenlar oluşturun
Tokenları düzenli döndürün - Özellikle üretim ortamında
Token izinlerini kısıtlayın - Sadece gereken erişimleri verin
Token kullanımını izleyin - API erişim kayıtlarını düzenli kontrol edin

Yapay Zeka Asistanları için Birleşik Keşif

unified kategori parametresi özellikle yapay zeka asistanları için tasarlanmıştır. Bir yapay zeka, hangi analiz yeteneklerinin mevcut olduğunu anlamak istediğinde tek bir MCP çağrısı yapabilir:

mindzie_list_block_types category="unified"

Bu, yapay zekanın şunları yapması için gereken her şeyi döner:

Mevcut yetenekleri anlama: Tüm filtreler, hesaplayıcılar ve zenginleştirmeler
Uygun blok türlerini seçme: UsageFrequency ve CommonUseCases bazında
Dokümantasyona bağlantı verme: Her blok türü DocumentationUrl içerir
İlişkileri belirleme: RelatedBlocks alanı tamamlayıcı blokları önerir

Örnek Yapay Zeka İş Akışı

Bir yapay zeka asistanı, kullanıcıya süreç süresi analizinde yardımcı olmak için:

mindzie_list_block_types category="unified" çağrısı yapar
CommonUseCases içerisinde "duration" geçen blok türlerini bulur
CaseDurationCalculator ve WaitTimeCalculator’ı önerir
Uygun blokları API ile oluşturur
Çalıştırır ve sonuçları yorumlar

Yanıt Alanı Referansı

category="unified" kullanıldığında, her blok türü aşağıdaki alanları içerir:

Alan	Açıklama	Yapay Zeka Kullanımı
`OperatorName`	Teknik tanımlayıcı	API ile blok oluştururken kullanılır
`DisplayName`	İnsan tarafından okunabilir isim	Kullanıcılara gösterilir
`Description`	Kısa açıklama	Amacı anlamaya yardımcı olur
`Category`	Fonksiyonel gruplayıcı	Önerileri organize eder
`BlockType`	Filtre/Hesaplayıcı/Zenginleştirme	Kullanım bağlamını belirler
`DocumentationUrl`	Dokümantasyon bağlantısı	Detaylı bilgi getirilir
`UsageFrequency`	Yüksek/Orta/Düşük	Yaygın bloklar önceliklendirilir
`CommonUseCases`	Örnek senaryolar	Kullanıcı hedeflerine uyum sağlar
`RelatedBlocks`	İlişkili blok türleri	Tamamlayıcı bloklar önerilir
`UsageNotes`	Ek rehberlik	Kullanıcıya bağlam sağlar

En İyi Uygulamalar

Yapay Zeka Asistanları için

Birleşik keşifle başlayın: Önce her zaman category="unified" çağrısı yapın
Sonuçları önbelleğe alın: Blok meta verileri seyrek değişir
Kullanım senaryolarına uyun: İlgili blokları CommonUseCases ile bulun
İlişkili blokları önerin: RelatedBlocks ile tamamlayıcı analizler sunun

Geliştiriciler için

Tokenlarınızı güvenle saklayın: API tokenlarını istemci tarafı koda asla koymayın
Uygun yetkilendirme kapsamları kullanın: Sadece gerekli izinleri talep edin
Hız sınırlamalarını yönetin: Yeniden denemeler için üssel bekleme uygulayın
Yanıtları doğrulayın: Sonuçları işlemeye başlamadan önce hataları kontrol edin

Sonraki Adımlar

Birleşik Blok Türleri API - Doğrudan API dokümantasyonu
URL Üretim API'si - Gezinme URL’leri oluşturma
AI Kodlama Araçları Genel Bakış - Genel yapay zeka araç entegrasyonu
Kimlik Doğrulama - API kimlik doğrulama detayları