Bir AI Ajanı Bağlayın

Herhangi bir AI ajanına tek bir cümle verin, sizin için mindzieStudio'da çalışabilir. Claude Cowork, Claude Code, Codex, Cursor veya herhangi biri: projeleri ve kullanıcıları kurar, verileri yükler ve sadece düz dil ile sorulduğunda AI Süreç Zekası ve BPM Studio'da çalışır.

Bu cümle ajanınıza verdiğiniz tek şeydir. Yönlendirdiği sayfa ajan için yazılmıştır: ajan hangi mindzieStudio’ya giriş yaptığınızı ve ne yapılmasını istediğinizi sorar, nasıl bağlanacağını hesaplar ve anahtarınızı nerede oluşturacağınızı söyler. Anahtar asla sohbete girmez: onu ajanınızın bağlantı ayarlarına veya ajanın tarayıcınızda açtığı bir sayfaya koyarsınız.

Ajanınızın Neler Yapabileceği ve Neye İhtiyacı Olduğu

Ajanın yapmasını istediğiniz şey...	Hangi ajanlar	Anahtar
mindzieStudio'da çalışmak: projeler oluşturmak, kullanıcı eklemek ve kimin hangi projeyi göreceğine karar vermek, veri yüklemek	Claude Cowork ve claude.ai dahil herhangi bir ajan	Tenant anahtarı
AI Süreç Zekası ve BPM Studio'da çalışmak: projeler oluşturmak, başlatmak ve durdurmak, veri yüklemek, bir proje içinde çalışmak, AI raporları, zamanlamalar ve uyarılar yapmak, diyagramları düzenlemek	Hepsi, herhangi bir ajanla: Claude Cowork ve claude.ai MCP barındırılan sunucu üzerinden, komut çalıştırabilen ajanlar (Claude Code, Codex gibi) ise mz aracı veya barındırılan sunucu üzerinden	Tenant anahtarı
Diğer şirketler için tenant oluşturmak	Herhangi bir ajan	Küresel anahtar: sadece sunucu yöneticileri ve ortakları

Bu cümlenin ardında iki giriş yolu vardır ve ajan doğru olanı seçer: her mindzieStudio sunucusunun çalıştırdığı barındırılan MCP sunucusu (kurulum yok) ve komut çalıştırabilen bir ajanın kendisi için kurduğu mz aracı. Seçim yapmak zorunda değilsiniz. mz ayrıntıları için bkz. Kendi Ajanınızı Bağlamak.

Anahtarınız

Bir tenant anahtarı yukarıdaki her şeyi karşılar. mindzieStudio'da adınızın altındaki menüyü açın, sonra Yönetim > Ayarlar > API Anahtarları sekmesine gidin ve Yeni Gizli Anahtar Oluştur düğmesine tıklayın. Tenant içinde Yönetici rolüne ihtiyacınız vardır. Anahtar bir kez gösterilir, hemen kopyalayın.

Bir Küresel API anahtarı sunucudaki her tenant’ı açar ve yeni tenant’lar oluşturabilir. Sadece sunucu yöneticileri oluşturabilir (adınızın altındaki menüden, Sunucu Ayarları > Küresel API Anahtarları) ve sadece müşterileri için tenant kuran ortaklar buna ihtiyaç duyar. Bkz. Bir Müşteriyi Tek Adımda Kurmak.

Barındırılan MCP Sunucusunu Elle Kurmak

Ajan bunu sizin için adım adım yapar. Bu bölüm, ajan yardımını almadan yapmak istediğiniz zamandır.

URL

Sunucu	MCP URL
mindzieStudio (ABD)	https://www.mindziestudio.com/mcp
mindzieStudio Avrupa	https://europe.mindziestudio.com/mcp
Kendi sunucunuz	https://<sunucunuz>/mcp

Anahtarı iletmenin iki yolu vardır:

Ajanınız şunu yapabilir...	Giriniz
Bir URL ile başlık gönderir (Claude Cowork, Claude Code, Cursor, VS Code, ajan API’leri)	URL https://www.mindziestudio.com/mcp ve başlık Authorization: Bearer <API anahtarınız>
Sadece bir URL alır	https://www.mindziestudio.com/mcp/k/<API anahtarınız>

İkinci formu bir şifre gibi kullanın. Anahtar URL’nin bir parçasıdır, dolayısıyla URL’yi gören herkes anahtarı kullanabilir. Paylaşılan belgeler veya sohbetlere yapıştırmayın. Sızarsa, mindzieStudio’da anahtarı silip yenisini oluşturun.

Ajanınıza Ekleme

Claude Cowork / Claude masaüstü uygulaması

1. Ayarlar > Bağlayıcılar’ı açın (claude.ai’de: Özelleştir > Bağlayıcılar), Ekle seçeneğini seçip sonra Özel bağlayıcı ekle’yi tıklayın. Bağlayıcılar Claude hesabınıza aittir, dolayısıyla Cowork, masaüstü uygulama ve claude.ai hepsi bağlayıcıyı alır.
2. Adını mindzie koyun ve URL’ye https://www.mindziestudio.com/mcp yapıştırın.
3. Kimlik Doğrulama altında Giriş yok seçeneğini seçin. Claude önce “Şimdi giriş yap” önerir; mindzieStudio API anahtarı kullanır ve yetkilendirme başlığı sadece Giriş yok seçildikten sonra eklenebilir.
4. İstek başlıklarına authorization başlığını Bearer <API anahtarınız> olarak ekleyin (Bearer kelimesi, boşluk, sonra anahtar).
5. Kaydedin. Claude mindzie araçlarını listeler. Yeni bir sohbet başlatın ve sorun: "mindzie kullanarak, kim olarak bağlıyım?" Claude her araç çağrısından önce izin ister.

Claude sürümünüz başlık seçeneği göstermiyorsa, URL olarak https://www.mindziestudio.com/mcp/k/<API anahtarınız> kullanın.

Claude Code

claude mcp add --transport http mindzie https://www.mindziestudio.com/mcp --header "Authorization: Bearer <your API key>"

Cursor / VS Code

MCP yapılandırmanıza (.cursor/mcp.json veya .vscode/mcp.json) ekleyin:

{
  "mcpServers": {
    "mindzie": {
      "url": "https://www.mindziestudio.com/mcp",
      "headers": { "Authorization": "Bearer <your API key>" }
    }
  }
}

Grok, OpenAI ve diğer ajan API’leri

Uzak MCP sunucu destekleyen ajan API’leri bir sunucu URL’si ve yetkilendirme değeri alır. URL olarak https://www.mindziestudio.com/mcp ve kimlik doğrulama için Bearer <your API key> kullanın. Eğer API sadece URL alıyorsa, /mcp/k/<your API key> formunu kullanın.

Bağlantıyı Kontrol Etme

Ajanınızdan mindzie_whoami komutunu çalıştırmasını isteyin. Ulaşılan sunucu ve anahtarın global olup olmadığı (canManageTenants: true) veya sadece tek tenant (açılan tenant keyTenantId) için olup olmadığını cevap olarak verir.

Bir Müşteriyi Tek Adımda Kurmak

Bu işlem için Küresel API anahtarı gerekir ve müşteriler için tenant kuran ortaklar içindir. Tenant anahtarı ile ajanınız kendi tenant’ınız içinde çalışır.

mindzie_provision_tenant aracı tek bir çağrıda müşteriyi tamamen kurar:

• tenant oluşturur,
• modülleri açar veya kapatır (Süreç Madenciliği, Veri Tasarımcısı, BPM Studio, AI Süreç Zekası),
• yönetici kullanıcısına erişim verir (var olan bir hesap kullanılır veya yeni bir hesap yaratılır),
• projeleri oluşturur, yönetici sahibi olarak atanır, böylece yönetici onları hemen görür.

Örnek komut:

mindzie kullanarak, adı acme-corp ve gösterim adı "Acme Corporation" olan bir tenant kur, 5 kullanıcı ve 2 analist ekle. Süreç Madenciliği ve Veri Tasarımcısını aç, BPM Studio ve AI Süreç Zekasını kapat. Yönetici jane@acme.com (Jane Smith). "Purchase to Pay" ve "Order to Cash" projelerini oluştur.

E-posta gönderilmez. Yeni yönetici hesabı şifresiz oluşturulur; yönetici giriş sayfasında Şifremi Unuttumu seçerek giriş yapar veya ilk şifresini siz bildirirsiniz.

Aynı Anda Birden Fazla Müşteri

Ajana liste verin (örneğin şirket isimleri, yönetici e-postaları ve modüller içeren bir tablo) ve her birini kurmasını, sonuçları müşteriye göre raporlamasını isteyin. Bir işlem yarıda kesilirse, mevcut müşteriler için resumeExisting ile tekrar çalıştırın: yapılan adımlar mevcut olarak rapor edilir ve hiçbir şey tekrar edilmez.

Veri Yükleme

1 GB’a kadar CSV dosyası için https bağlantısı ile mindzie_upload_dataset_from_url kullanın; örneğin bulut depolamada okuma token’lı bağlantı. mindzieStudio sunucusu dosyayı kendisi indirir, böylece büyük dosyalar sohbet üzerinden geçmez. Bağlantı herkese açık olmalıdır; özel veya iç ağ adreslerine yönlendiren bağlantılar kabul edilmez.

Birkaç bin satır için CSV metnini mindzie_upload_dataset_csv_text ile yapıştırabilirsiniz.

Kullanılabilir Araçlar

Araç	Ne yapar	Gerekli anahtar
mindzie_whoami	Sunucu ve anahtar bilgisi	Herhangi
mindzie_provision_tenant	Tenant, modüller, yönetici ve projeler tek çağrıda	Küresel
mindzie_list_projects, mindzie_get_project, mindzie_create_project, mindzie_update_project, mindzie_delete_project	mindzieStudio projeleri	Küresel veya tenant
mindzie_list_project_members, mindzie_add_project_member	Bir projeyi kimin görebileceği	Küresel veya tenant
mindzie_list_datasets, mindzie_upload_dataset_csv_text, mindzie_upload_dataset_from_url	Veri setleri	Küresel veya tenant

Bunların yanı sıra, sunucu aynı zamanda mz komut satırıyla sunulan araçları da sağlar, aynı spesifikasyonlardan üretilir, böylece ikisi asla birbirinden sapmaz. Her biri bir komut grubudur, method ve params ile çağrılır; describe yöntemi bir yöntemin parametrelerini listeler.

Araç	Ne yapar	Gerekli anahtar
projects, projects_backups, projects_keys, projects_reports	AI Süreç Zekası projeleri: oluşturma, başlatma, durdurma, yeniden adlandırma, boyut değiştirme, silme, dosyadan içe aktarma; yedekleme ve geri yükleme; yayınlanmış raporu tekrar çalıştırma	Tenant
cube_log, cube_files, cube_data, cube_eventlogs, cube_schema, cube_build, cube_filters, cube_enrichments, cube_rules, cube_calendar, cube_costs, cube_jobs, cube_reports, cube_schedules, cube_alerts, cube_styles ve diğerleri	Bir projenin küpü içindeki her şey: veri yükleme ve alma, olay günlüğüne sorma, filtreler, zenginleştirmeler, kurallar, şema, AI rapor işleri, yayınlanmış raporlar, zamanlamalar ve uyarılar. Her biri pi_project_id alır; proje çalışıyor olmalıdır	Tenant
bpmn_diagrams, bpmn_comments, bpmn_approvals, bpmn_audit, bpmn_ai, bpmn_ai_files	BPM Studio: modeller, revizyonlar, yorumlar, onaylar, denetim günlüğü, resim veya SOP’den AI incelemeleri	Tenant veya tenant_id ile global
studio_projects, studio_projects_members	BPM Studio projeleri ve üyeleri	Tenant veya tenant_id ile global
tenants, tenants_settings, users, users_tenant	Tenantlar, ayarları ve modülleri, kullanıcılar	Küresel

Silme işlemleri tam adı ister. AI işlemleri - bir AI raporu, raporu yeniden çalıştırma, BPM Studio AI incelemesi - tenant’ın AI kredi miktarını kullanır.

Her araç, tam olarak REST API ile aynı kuralları izler: aynı izinler, doğrulama ve hata mesajları.

Bilinmesi İyi Olanlar

• Boş bir tenant sunucunun varsayılan modüllerine sahiptir, bu müşterinin beklediği olmayabilir. mindzie_provision_tenant kullanın veya tenants_settings yönteminde update ile modülleri açıkça ayarlayın.
• Bir proje yalnızca üyeleri tarafından görünür. mindzie_create_project ile yapılan proje, siz mindzie_add_project_member ile üye ekleyene kadar üyesizdir. mindzie_provision_tenant bunu sizin için yapar.
• Silme kalıcıdır. İyi bir ajan önce sizden onay alır; silme araçları tam ad ister.
• Her araç çağrısı sunucuda, çağrıyı yapan API anahtarı adı ile kaydedilir.

Sorun Giderme

Gördüğünüz	Neden	Ne yapmalı
Bağlanırken HTTP 401 / "yetkisiz"	Anahtar yanlış, silinmiş veya farklı bir sunucu için (her bölgenin anahtarı farklı)	Bağlanmaya çalıştığınız sunucuda yeni bir anahtar oluşturun
"Global API anahtarı gerekir"	Tenant anahtarı tenantlar arası çalışan (listeme, oluşturma, değiştirme veya silme tenant, ayar veya modül araçları) için kullanılmış	Bu araçlar sunucu yöneticileri ve tenant kuran ortaklar içindir. Kendi tenant’ınızda proje, kullanıcı ve veri seti araçlarıyla çalışın. Başkaları için tenant yaratıyorsanız, bkz. Bir Müşteriyi Tek Adımda Kurmak
"TENANT API anahtarı ile çalıştırılır, asla global ile değil"	AI Süreç Zekası veya cube_ aracı için global anahtar kullanıldı	Projenin olduğu tenant’ta bir tenant anahtarı oluşturun ve onunla bağlanın
"Tenant’a erişim yok"	Tenant ID anahtarın tenant’ı değil	mindzie_whoami den keyTenantId kullanın
Yönetici giriş yapıyor ama proje görmüyor	Projelerin üyesi değil	mindzie_add_project_member veya mindzie_provision_tenant ile sağlayın
Kurulumdan "zaten var" hatası	Tenant adı alınmış	Aynı müşteri ise resumeExisting ile yeniden çalıştırın; değilse farklı isim seçin
Veri yüklerken "genel olmayan adres"	Bağlantı özel veya iç ağ adresine işaret ediyor	Genel erişilebilir https bağlantısı kullanın