Bu rehber, EQLEM CRM'i kullandığınız AI ajanına sağlayıcı sağlayıcı nasıl bağlayacağınızı anlatır. Bağlantı OAuth ile kurulur ve ajan yalnızca sizin EQLEM yetkilerinizle çalışır. Genel bakış için CRM modülü sayfasına bakın.
Başlamadan önce
- EQLEM'de AI bağlantıları ekranını açın ve MCP URL'sini kopyalayın. Ajanını bağla panelinde ajanınızı seçerseniz o sağlayıcıya özel adımlar ve kopyalanabilir hazır komut/yapılandırma gösterilir. Aşağıdaki her sağlayıcıda bu URL kullanılır. Adres her zaman
https://ile başlar (ör.https://api.firmaniz.com/api/v2/mcp). Komutlarda ve ayarlarda geçenhttpise MCP'nin taşıma türünün (Streamable HTTP) adıdır, adresin şeması değildir. - İlk bağlantıda tarayıcıda EQLEM giriş ve onay ekranı açılır. Giriş yapın, ajanın isteyeceği izinlere bakıp onaylayın.
- Bağlantıyı istediğiniz an AI bağlantıları ekranından iptal edebilirsiniz.
- Kurumsal istemci gereken kurulumlarda (Gemini Enterprise, Copilot Studio Manual) işi Admin yapar: AI bağlantıları ekranında kurumsal OAuth istemcisi oluşturur,
client idveclient secretdeğerlerini oradan alır.
Bağlandıktan sonra ajanınıza "EQLEM'de kim olarak bağlıyım?" diye sorarak bağlantıyı deneyebilirsiniz.
Sürüm notu: Araç adları güncellendi. Daha önce bağlanmış ajanlarda araç listesini yenileyin (bağlayıcıyı yeniden yükleyin ya da yeniden bağlanın). Kişi grubu araçları (
crm_contact_group_read,crm_contact_group_write) eklendi.
Ajanınız neler yapabilir?
Ajan CRM'in tüm süreçlerini kapsar; her işlemde kendi EQLEM yetkiniz geçerlidir.
- Satış: adaylar ve müşteriler (arama, oluşturma, güncelleme, aday aşaması, etiket ve grup), kişiler ve kişi grupları (üye sayısı, toplu ekleme / çıkarma), notlar, aktiviteler, fırsatlar (kazanıldı / kaybedildi işaretleme), takvim, grup panosu, bölge, sözleşmeler ve yenileme takibi.
- Servis: servis talepleri (satır, atama, yeniden planlama, memnuniyet, SLA değerlendirmesi), varlıklar, gelen çağrılar, dönemsel işlemler, bilgi bankası.
- İletişim: şablonlar, gönderilen mesajlar ve takip olayları, gelen kutusu, kampanyalar (taslak, hedef kitle, varyant, karşılaştırma).
- Sequence: iletişim akışları, adayı akışa kaydetme, aday iletişim listesi, etkileşimde olan cariler, gönderim planı, adım bazlı performans, temas kuyruğu, yanıt işaretleme, sonuç ve aşama, AI yanıt taslakları, vadesi gelmiş mailleri gönderme.
- İçgörü: satış, iletişim, servis ve yönetici raporları, sağlık skorları, uyumluluk durumunu okuma ve ayarları okuma.
- Ortak: Projeler (
common_project_read) ve Masraf merkezleri (common_cost_center_read) için liste, arama ve detay (belge yetkisi "Proje & Maliyet Merkezi"); Mail gönder (cari dışı) (common_mail_send).
Onay ekranında izin gruplarını seçin
- Giriş yaptıktan sonra onay ekranında izin gruplarını görürsünüz: Satış, Servis, İletişim, Sequence, İçgörü; her grup okuma, yazma ve (varsa) gönderim olarak ayrılır. Bunların yanında iki ortak izin vardır:
common.definitions.read(Ortak tanımlar: proje ve masraf merkezi okuma) vecommon.mail.send(Mail gönderimi: doğrudan mail). - Ajanın yapmasını istediğiniz grupları tek tek seçin; istemediklerinizin işaretini kaldırın (varsayılan olarak hepsi seçilidir; Onayla için en az bir izin seçili olmalıdır).
- Ajan yalnız seçtiğiniz gruplardaki, lisansınızın kapsadığı ve EQLEM belge yetkinizin izin verdiği araçları görür. Sonradan kapsamı değiştirmek için bağlantıyı iptal edip yeniden onaylayın.
- Onay ekranındaki güven rozetine bakın: Doğrulanmış (firmanızın kurumsal istemcisi), Alan adı doğrulandı (ör.
claude.ai; uygulama kendini bu alan adından tanıtıyor) veya Doğrulanmamış (otomatik kayıt; yalnız tanıdığınız uygulamaya izin verin). Yönlendirme adresi tanıdığınız sağlayıcıya ait değilse onaylamayın.
AI bağlantıları sayfası
- Bağlantılarım: her bağlantı bir kart (uygulama, güven rozeti, izinler, son yenileme, bitiş). Kullanıcı başına en fazla 5 bağlantı; sayaç limite yaklaşınca uyarır.
- İptal: uygulama yeni istek yapamaz ve oturumunu yenileyemez; elindeki erişim anahtarı en fazla 15 dakika daha geçerli kalabilir.
- Ajan yetenekleri: ajanın kullanabileceği araçlar modül sekmelerinde listelenir; arama ve tür filtresi vardır. Lisansınızda veya yetkinizde olmayan araçlar "Lisansınızda yok" / "Yetkiniz yok" rozetiyle gösterilir.
- Araçlar ajanınızda kullanıcı dilinde başlıklarla görünebilir; bu, ajanın başlıkları göstermesine bağlıdır (bazı ajanlar teknik araç adını gösterir).
İki adımlı onay isteyen işlemler
Dışarıya etki eden işlemlerde ajan önce ön izlemeyi ve uyumluluk sonucunu gösterir; siz onaylayınca yapılır: mail ve WhatsApp gönderimi, sequence kaydı, bekleyen sequence maillerini gönderme, AI taslak onayı, servis bildirimi, gelen kutusu yanıtı, kampanya planlama ve cari dışı mail.
Gönderen mail hesabı
MCP ile yapılan tüm mail gönderimleri yalnız size tanımlı mail hesabından gider. Kapsanan araçlar: common_mail_send, crm_outreach_send (mail), crm_inbox_reply (mail), sequence yanıt taslağı onayı, crm_sequence_enroll, crm_sequence_send_pending, crm_campaign_schedule ve servis talebi bildirimi. WhatsApp ve web'den gönderim değişmez.
- Hesap tanımlı değilse gönderim yapılmaz. Ajan şu mesajı iletir: "Firmanızda size tanımlı bir mail hesabı yok. Mail gönderebilmek için yöneticinizden hesap tanımlamasını isteyin."
- Tek hesap varsa otomatik seçilir. Birden çok hesap varsa ajan
eqlem_whoamiile hesaplarınızı görür ve birini seçer. - Yönetici için: hesap, "Mail ayarları" ekranındaki Personel alanından kişiye atanır. Personelin kullanıcı bağlantısı personel kartından kurulur.
Mail gönder (cari dışı)
Cari kaydı olmayan kişilere ajanınız üzerinden bireysel mail gönderir.
- Kullanım koşulu: firma özelliği "Email Gönderim Aracını Kullanabilir" açık olmalı ve CRM Outreach ekleme yetkiniz bulunmalıdır. Değilse araç görünmez; Ajan yetenekleri ekranında "Lisansınızda yok" yazar.
- İki adımlı gönderim: önce önizleme gelir (alıcılar, atlananlar, konu, gövde, bağlantılar, ekler). Onaylarsınız, sonra gönderilir. Onaydan sonra alıcı, içerik ya da ek değişirse onay geçersiz olur.
- Alıcı: serbest e-posta adresi; cari kaydı gerekmez. Her alıcıya ayrı ileti gider, alıcılar birbirini görmez. CC/BCC, şablon ve açılma takibi yoktur.
- Bireysel gönderim kaydı: alıcının onay kaydı yoksa "MCP – bireysel gönderim" kaynaklı bir kayıt otomatik açılır. Bu kayıt yalnız bu araçla bireysel gönderime izin verir; kampanya, sequence ve outreach gibi ticari gönderimlerde onay sayılmaz. Önizlemede "X alıcı için bireysel gönderim kaydı oluşturulacak" yazar.
- Engelli alıcı: opt-out ya da engel listesindeki alıcıya gönderilmez; önizlemede ve sonuçta nedeniyle listelenir, diğer alıcılara gönderim sürer.
- Gönderen: mail size tanımlı hesaptan gider (bkz. "Gönderen mail hesabı"); önizlemede gönderen adres görünür.
- Gönderim aralığı: aralığı ajan çağrıda belirler (
sendIntervalSeconds, 5–600 sn; verilmezse 15 sn). Değer önizlemede görünür ve onayınıza bağlıdır. Amaç spamı önlemektir; aynı posta kutusundan art arda gönderimlerde aralık korunur. - Günlük sınır: posta kutusunun mail ayarlarında tanımlı mevcut günlük gönderim limitidir; sequence ve kampanya ile ortak tüketilir. Limit tanımlı değilse sınır yoktur. Kotayı aşan alıcılar atlanır ve "günlük limit" nedeniyle listelenir.
- Sonuç: araç hemen "kuyruğa alındı: N alıcı, tahmini bitiş" döner. İletiler outreach mesaj listesinde "Sırada" görünür; gönderilenler gönderildi olur, atlananlar "Atlandı", başarısızlar "Başarısız" durumuna geçer.
- Sınırlar: çağrı başına en fazla 200 alıcı; gövde en fazla 4.000 karakter; en fazla 2 ek (yalnız daha önce EQLEM CRM'e yüklenmiş dosyalar). Posta kutusu kuyruğu 24 saatten fazla doluysa yeni gönderim reddedilir. Sistem yeniden başlatılırsa henüz gönderilmemiş iletiler kaybolabilir; outreach listesinden kontrol edin.
Hukuki uyarı: Araç bireysel ve işlemsel yazışma içindir. 6563 sayılı Kanun ve İYS gereği onaysız alıcıya ticari elektronik ileti (reklam, kampanya, toplu tanıtım) gönderilemez; sorumluluk gönderen kullanıcı ve firmadadır. Ticari gönderimler için CRM kampanya ve sequence kullanın.
Sequence verisini okuma
Sequence performansını ve adayları ajanınıza sorarak çıkarabilirsiniz. Her modda yalnız yetkinizin gördüğü kayıtlar gelir.
- Aday iletişim listesi (
crm_sequence_enrollment_read,contacts): sequence adaylarının cari, kişi, e-posta, telefon, aşama ve etkileşim bilgisi; sayfa başına en çok 30. - Etkileşimde olan cariler (
crm_sequence_read,engaged_accounts): maili açan, tıklayan, yanıtlayan veya geri dönen (bounce) cariler, cari başına tek satır. - Gönderim planı (
crm_sequence_read,send_schedule): Gönderim Planı ekranındaki veri, alıcı telefonu dahil; yalnız mail, sayfa başına en çok 30. - Gönderim partisi durumu (
crm_sequence_read,send_batch): aşağıdaki bekleyen mail gönderiminin sonucu. - Adım bazlı performans (
crm_sequence_read,metrics): her adım için gönderilen, açılan, tıklanan, yanıtlanan ve geri dönen sayısı (byStep). - Bugünkü temaslar (
crm_sequence_read,due_touches): satırlarda alıcının e-postası,overdueDaysveblockedReasonda gelir.ownerUserIdboşsa oturum kullanıcınızın temasları gelir. - Kanal çalışma listesi (
crm_sequence_read,due_worklist):channelzorunlu; gecikmişler en eskiden yeniye sıralanır; sayfa başına en çok 6 (aşağıdaki akış). - Mesaj hazırlama (
crm_sequence_enrollment_read,compose):enrollmentId+touchIdile gönderilecekbody,whatsAppLinkvelinkedInUrl. - Mesaj araması (
crm_outreach_message_read,search):sequenceId,enrollmentIdve tarih süzgeci (sequence ile birlikte);view=compactile kısa satır görünümü.
Örnek istemler:
- "Bu sequence'te linke tıklayan firmaları telefonlarıyla listele."
- "Bugünkü temaslarımın e-posta ve telefonlarını ver."
- "Vadesi geçmiş gönderilmemiş mailleri önizle ve gönder."
Bekleyen sequence maillerini gönderme
crm_sequence_send_pending, vadesi gelmiş otomatik sequence maillerini zamanlayıcıyı beklemeden önizleyip gönderime almanızı sağlar.
- Kapsam: yalnız vadesi gelmiş otomatik mailler; hata ile takılmış olanlar da vadesi gelmişse dahildir. Manuel temas bekleyen, duraklatılmış ve planlı başlangıçlı kayıtlar işlenmez. Yalnız mail ve yalnız temas tabanlı (playbook) sequence'ler.
- İki adımlı onay: ilk çağrı gönderim yapmaz; kuyruğa alınacak adedi, atlananları ve nedenlerini gösterir. Onaylarsanız ikinci çağrı onay koduyla yapılır. Kod tek kullanımlıktır, 5 dakika geçerlidir ve aday kümesine bağlıdır; küme değişirse geçersiz olur. Tek çağrıda en fazla 500 temas kuyruğa alınır; fazlası ayrı olarak raporlanır ve parti bitince aracı yeniden çağırarak gönderilebilir.
- Günlük sınır: kuyruğa alınan adet tanımlı günlük gönderim sınırlarını aşmaz; aşan kısım sonraki günlerde zamanlayıcıyla gider.
- Gönderim ve izleme: mailler sırayla kuyruktan gönderilir; sonucu
crm_sequence_readsend_batchile izlersiniz. Aynı sequence için aynı anda tek parti çalışır. - Zaman aşımı: çağrı zaman aşımına uğrarsa ajan aynı çağrıyı hemen tekrarlamamalı; önce
crm_sequence_readmode=send_batchile açık bir gönderim partisi olup olmadığını kontrol etmelidir. Açık parti varken yeni onayerror.crm-sequence.send-pending-in-progressile reddedilir (parti tamamlanınca veya 2 saat sonra serbest kalır); sistem aynı temasın iki kez gönderilmesini engeller. - Planlı başlangıçlı kayıtlar: "Başlangıç planlandı" durumundaki kayıtların başlangıçları günlük gönderim sınırına göre günlere yayılır. Bunları web arayüzünde Şimdi başlat ile elle başlatabilirsiniz; sequence başlangıç tarihi henüz gelmediyse başlatılamaz. MCP'den elle başlatma yoktur.
- Gerekli yetkiler: kurumsal outreach düzenleme ve Bugünkü Temaslar görüntüleme; gönderen mail hesabı size tanımlı olmalıdır.
- Sınırlar: dış etkili çağrılar saatte 20 ile sınırlıdır. Çok örnekli kurulumlarda gönderim sırası garanti edilmez.
Kendi WhatsApp Web / LinkedIn hesabınızla temas
Sequence'teki WhatsApp ve LinkedIn temaslarını, tarayıcı kullanabilen bir ajanla (ör. Claude in Chrome) kendi hesabınızdan yürütebilirsiniz. EQLEM bu akışta mesaj göndermez ve EQLEM'in resmi numarasından gönderim yapılmaz; mesajı siz kendi oturumunuzdan gönderirsiniz.
- Liste:
crm_sequence_readmode=due_worklist(channelzorunlu, sayfa başına en çok 6).blockedReasondolu temasları atlayın. - Hazırlama: her temas için
crm_sequence_enrollment_readmode=compose(enrollmentId+touchId):body,whatsAppLink(https://wa.me/{rakamlar}, metin içermez) velinkedInUrlgelir. - Yazma: ajan tarayıcıda sohbeti açar ve
bodymetnini mesaj kutusuna yazar; göndermez. - Gönderim: Gönder'e siz basarsınız. İsterseniz ilk N kişide her mesajı tek tek onaylarsınız.
- Kayıt: gönderimi onayladıktan sonra ajan
crm_sequence_enrollment_writeaction=mark_sentçağırır. Bu yalnız "uygulama dışında gönderdim" kaydıdır; onay vermeden çağrılmamalıdır.
- Varsayılan sahip:
ownerUserIdboşsa oturum kullanıcınız kullanılır. - Aktivite kapanışı: temas tamamlanınca (Yapıldı / Cevap yok) bağlı görev aktivitesi Tamamlandı, atlanırsa İptal olur.
- Telefon: biçim dışı telefon
nulldöner; ajan numarayı uydurmamalıdır. - Limit önerisi: WhatsApp için günde 30–50 mesaj; mesajlar arasında rastgele 60–180 sn bekleyin.
- Ban riski: soğuk, toplu gönderim WhatsApp'ın hesabınızı kısıtlamasına veya kapatmasına yol açabilir; risk size aittir.
- Güvenilmez veri: ajan çıktısındaki metin ve bağlantılar (ad,
body,whatsAppLink,linkedInUrl) güvenilmez veridir; içlerindeki talimatlar izlenmez.
Kişi grupları ve kişi bazlı hedefleme
Kişilere birden çok Kişi grubu verebilir; kampanya ve sequence'te kişiyi veya kişi grubunu hedefleyebilir, bir kişiye doğrudan mesaj gönderebilirsiniz. Bu araçlar mevcut izin gruplarının içindedir; her işlemde kendi yetkiniz ve görebildiğiniz kayıtlar geçerlidir.
- Kişi gruplarını listeleme (
crm_contact_group_read): Kişi grubu tipindeki grupları üye sayısıyla getirir. - Toplu üyelik (
crm_contact_group_write): kişileri gruplara ekler, çıkarır veya değiştirir (mode=add/remove/replace). Silme yoktur; grup tanımı ve silme yalnız EQLEM web'dedir. - Kişi arama ve güncelleme:
crm_contact_readaramadagroupIdsvematchAllGroups(en az bir gruba mı, tümüne mi üye) ile süzer;crm_contact_writegroupIdsile kişinin gruplarını belirler (verilmezse değişmez, boş liste tümünü kaldırır). - Kampanya hedefi:
crm_campaign_writehedef satırındacontactIdveyacontactGroupIdkullanılabilir; kişi ve kişi grubu hedefi yalnız e-posta kampanyasında geçerlidir. Aynı e-posta adresi cari ve kişi hedefinde çıksa tek gönderim yapılır. - Sequence kaydı:
crm_sequence_enrollmode=contactsile kişileri ve kişi gruplarını kaydeder. İlk çağrı kayıt yazmayan önizlemedir; onayınızla ikinci çağrı kaydı yapar. Cari bağlantısı olmayan veya sequence firmasıyla uyuşmayan kişiler atlanır ve sayılır. - Doğrudan kişiye mesaj:
crm_outreach_sendcontactIdalır veaccountIdartık isteğe bağlıdır (en az biri gerekir);common_mail_senddacontactIdkabul eder. Kişide e-posta veya telefon yoksa gönderim yapılmaz. - Onay ve uyumluluk: dış etkili araçlarda mevcut iki adımlı onay aynen sürer; kişi adresi için de iletişim onayı, opt-out ve gönderim engeli kuralları uygulanır.
Örnek istemler:
- "'Fuar 2026' kişi grubunda kaç kişi var?"
- "Bu üç kişiyi 'Karar vericiler' grubuna ekle."
- "'Karar vericiler' grubunu bu e-posta kampanyasının hedefine ekle ve planlama önizlemesini göster."
Toplu aday içe aktarma
Yüzlerce satırlık bir aday listesini ajanınıza vererek tek seferde içe aktarabilirsiniz. Web'deki içe aktarma ekranıyla aynı işlem yapılır ve aynı sonuçlar çıkar. Mevcut crm_lead_source_read ve crm_lead_source_write araçlarına modlar eklenmiştir; yeni bağlantı onayı gerekmez.
- Listeyi verin: CSV dosyasını ajana verin. Küçük listelerde metin
csvContentile gönderilebilir; büyük dosyalarda dosya yüklenir. - Dosya yükleme: ajan
crm_lead_source_writeimport_upload_initmodunu çağırır; 10 dakika geçerli, tek kullanımlıkuploadUrldöner. Ajan CSV'yi bu adrese HTTPPUTile yükler (ör.curl -T dosya.csv "<uploadUrl>", UTF-8). Komut çalıştırabilen bir ajan gerekir. - Yürütme: ajan
import_executemodunuuploadId(veyacsvContent) vesourceFileNameile çağırır. Önizleme ve ayrı rıza/onay kodu adımı yoktur; veri işleme rızası sunucuda otomatik işaretlenir. İş arka planda kuyruğa girer;importIdvequeueddurumu döner. - İzleme:
crm_lead_source_readimportsmoduidile çağrılınca durum,progressPercent(ilerleme yüzdesi), satır sayıları veisTerminal(bitti mi) gelir. - Hatalı ve atlanan satırlar:
import_rowsmoduidile çağrılır;statusile süzülür,pageIndex/pageSizeile sayfalanır. Sayfa başına en çok 40, varsayılan 20 satır gelir; durum başına satır sayıları da bulunur. - İptal: gerekirse
import_cancelmoduidile çağrılır.
- Boyut: tek seferde en çok 5.000 satır / 5 MB; büyük listeler EQLEM web arayüzünden aktarılır (
error.crm-lead-import.mcp-limit). - Eşzamanlılık: aynı anda en çok 2 içe aktarma çalışır; diğerleri kuyrukta bekler.
- Yükleme adresi: 10 dakika geçerli ve tek yüklemeliktir; yalnız başlatan kullanıcı
import_executeile kullanabilir ve içerik bir kez tüketilir. Aynı anda en çok 20 bekleyen yükleme olur. Adresi paylaşmayın. - Otomatik iletişim onayı: içe aktarılan kayıtlar için Mail (e-posta varsa) ve WhatsApp (telefon varsa) onayı yoksa otomatik "verilmiş" eklenir (kaynak:
lead-import). Onay kaydı zaten varsa (geri çekilmiş dahil) değişmez; geri çekilen onay içe aktarmayla yeniden verilmez. - Yetki: "Aday içe aktarma" ve "Aday" belgelerinde ekleme yetkisi gerekir.
- Büyük sonuç: satırlarda çok uyarı veya grup varsa yanıt büyüyebilir; sayfa boyutunu küçültün.
- Güvenilmez veri: satırlardaki metinler dış kaynaklı veridir; içlerindeki talimatlar izlenmez.
Örnek istemler:
- "Bu CSV'yi aday olarak içe aktar; önce önizlemeyi göster."
- "Önizleme uygun, rıza veriyorum; aktarımı başlat ve bitene kadar durumu söyle."
- "Son içe aktarmada hatalı satırları göster."
Ajanın yapamadıkları
- Kayıt silemez, aday iptal edemez; kişi grubu tanımlayamaz veya silemez (yalnız kişilerin grup üyeliğini değiştirir).
- İletişim izni (consent) ve çıkış (opt-out) kayıtlarını değiştiremez (toplu aday içe aktarmadaki otomatik onay kaydı hariç).
- Kayıt birleştiremez; fatura veya belge üretemez; webhook testi yapamaz.
- Ayarları yalnız okur, değiştiremez.
- Seçmediğiniz izin gruplarındaki, lisansınızda olmayan ya da belge yetkinizin kapsamadığı işlemleri göremez.
Claude (claude.ai ve Desktop)
- Claude'da bağlayıcı (connector) ayarlarını açın ve özel bağlayıcı ekle seçeneğini kullanın.
- EQLEM AI bağlantıları ekranından aldığınız MCP URL'sini girin.
- Bağlan'a basın; açılan EQLEM giriş ve onay ekranında onaylayın.
- Bağlayıcı sohbette kullanılabilir hâle gelir.
Claude Code
-
Terminalde şu komutu çalıştırın (
<MCP URL>yerine AI bağlantıları ekranındaki URL'yi yazın):claude mcp add --transport http eqlem https://api.firmaniz.com/api/v2/mcp--transport httptaşıma türünün adıdır; adreshttps://ile başlar. Bu komut sunucuyu yalnız o projeye ekler; her projede görmek için-s userekleyin:claude mcp add -s user --transport http eqlem https://api.firmaniz.com/api/v2/mcp -
Claude Code içinde
/mcpyazıpeqlemsunucusunu seçin ve kimlik doğrulamasını başlatın; tarayıcıda EQLEM giriş ve onay ekranı açılır. -
Onaydan sonra araçlar oturumda görünür.
ChatGPT
- ChatGPT ayarlarında geliştirici modunu açın (planınızın ve çalışma alanı yöneticinizin izin verdiği ölçüde).
- Yeni bir uygulama veya bağlayıcı ekleyin ve EQLEM AI bağlantıları ekranındaki MCP URL'sini girin.
- Kimlik doğrulamada OAuth'u seçin; EQLEM giriş ve onay ekranında onaylayın.
- Sohbette uygulamayı etkinleştirip kullanın.
Gemini CLI
-
Gemini CLI
settings.jsondosyasındamcpServersaltına sunucuyu ekleyin:{ "mcpServers": { "eqlem": { "httpUrl": "https://api.firmaniz.com/api/v2/mcp" } } } -
Gemini CLI'yi başlatıp MCP kimlik doğrulamasını çalıştırın. Aynı makinede tarayıcı gerekir; EQLEM giriş ve onay ekranı orada açılır.
-
Gemini CLI istemcisini otomatik kayıtla tanıtır. Bağlantı kurulamazsa EQLEM yöneticinize bildirin.
Gemini Enterprise (Admin kurulumu)
Gemini Enterprise istemciyi kendiliğinden kaydetmez; kurulumu bir yönetici yapar.
- EQLEM'de AI bağlantıları ekranında (Admin) bir kurumsal OAuth istemcisi oluşturun.
- İstemcinin yönlendirme (redirect) adresi olarak şunu girin:
https://vertexaisearch.cloud.google.com/oauth-redirect - Oluşan
client idveclient secretdeğerlerini not edin. - Gemini Enterprise yönetim ekranında Custom MCP Server veri deposu ekleyin; MCP URL'sini,
client idileclient secretdeğerlerini ve EQLEM'in yetkilendirme ile token adreslerini girin (adresler için AI bağlantıları ekranındaki sağlayıcı kurulum linkine bakın). - Kullanıcılar ilk kullanımda EQLEM giriş ve onay ekranını görür.
Microsoft Copilot Studio
- Copilot Studio'da ajanınıza bir MCP aracı ekleyin ve MCP URL'sini girin (yalnız Streamable HTTP desteklenir).
- Kimlik doğrulamada önce Dynamic discovery seçeneğini deneyin. Bağlantı kurulursa EQLEM giriş ve onay ekranında onaylayın.
- Olmazsa Manual seçin:
- Admin, EQLEM'de kurumsal OAuth istemcisi oluşturur.
- Copilot Studio'nun gösterdiği tam yönlendirme (callback) adresini (
https://global.consent.azure-apim.net/redirect/...biçiminde, bağlayıcı adıyla biten tam yol) EQLEM'deki istemciye ekler. client idveclient secretCopilot Studio'ya girilir.
VS Code / GitHub Copilot
-
mcp.jsondosyasına (çalışma alanında.vscode/mcp.jsonya da kullanıcı düzeyinde) HTTP sunucusunu ekleyin:{ "servers": { "eqlem": { "type": "http", "url": "https://api.firmaniz.com/api/v2/mcp" } } } -
Sunucuyu başlatın; VS Code kimlik doğrulama ister ve tarayıcıda EQLEM giriş ve onay ekranı açılır.
-
Copilot sohbetinde (ajan modu) EQLEM araçlarını seçin.
Cursor
-
Cursor'un
mcp.jsondosyasına sunucuyu ekleyin:{ "mcpServers": { "eqlem": { "url": "https://api.firmaniz.com/api/v2/mcp" } } } -
Cursor'da sunucuyu etkinleştirin; EQLEM giriş ve onay ekranı açılır.
-
Cursor istemcisini otomatik kayıtla tanıtır. Bağlantı kurulamazsa EQLEM yöneticinize bildirin.
B2B alıcı (satın alma asistanı)
Tedarikçinizin B2B portalında alıcı hesabınız varsa AI ajanınızı kendi alıcı kimliğinizle bağlayabilirsiniz. Ajan, portalda yaptıklarınızın bir bölümünü sizin adınıza yapar: katalogda arama, sepet hazırlama, sipariş, cari ve ekstre kontrolü, durum takibi. Bu bağlantı CRM bağlantısından ayrıdır: alıcı oturumu yalnız b2b_* araçlarını görür, CRM araçları alıcı oturumuna kapalıdır. Kullanım, tedarikçinin B2B Yönetimi lisansına ve B2B portal erişiminize bağlıdır.
Alıcı asistanı neler yapabilir?
- Okuma: katalog (ürün arama ve detay, kategori, marka, kayıtlı listeler), siparişler ve sevkiyatlar, cari bakiye ve kredi limiti özeti, ekstre özeti (toplamlar ve son 25 hareket), faturalar (PDF yok), adres seçenekleri, bekleyen onaylar, teklif talepleri ve sözleşmeler.
- Yazma: sepete satır ekleme/güncelleme/çıkarma ve kayıtlı listeyi sepete ekleme (
b2b_cart_write), sipariş oluşturma (b2b_order_write), teklif talebi, kabul ve iptal (b2b_rfq_write), iade talebi (b2b_return_write). b2b_whoamihangi alıcı / firma olarak bağlı olduğunuzu gösterir.- Portalın sipariş kuralları (onay zinciri, bütçe, kredi limiti, asgari tutar, çalışma saati) aynen uygulanır. Onay gerektiren sipariş "onay bekliyor" durumunda açılır.
Nasıl bağlanılır?
- Tedarikçinizden MCP adresini alın. Ajan sağlayıcınızdaki ekleme adımları yukarıdaki sağlayıcı bölümleriyle aynıdır; fark kimlik doğrulama adımındadır.
- Bağlantıyı başlattığınızda tarayıcıda alıcı izin ekranı açılır.
- B2B portalındaki e-posta ve parolanızı girin. Ajan parolanızı görmez.
- İzinleri seçin. Okuma izinleri (katalog, sipariş, cari) istemcinin istediği kadarıyla sunulur; yazma izinleri (sepet, sipariş, iade, teklif talebi) varsayılan olarak kapalıdır, ayrıca işaretlemeniz gerekir.
- Onayla'ya basın (en az bir izin seçili olmalı). Reddetmek için kimlik girmeniz gerekmez.
- Ajanınıza "EQLEM'de hangi firma adına bağlıyım?" diye sorarak bağlantıyı doğrulayın.
Birden fazla firma üyeliğiniz varsa ajan ilk alıcı üyeliğinizle çalışır; araçla firma değiştirilemez.
Güvenlik ve sınırlar
- İki adımlı onay: sipariş oluşturma, iade talebi ve teklif talebi / kabulü / iptali önce özet gösterir; siz onaylayınca yapılır. Onay kodu tek kullanımlıktır ve 5 dakika geçerlidir; sepet, fiyat veya stok değişirse geçersiz olur.
- Sepet hazırlıktır: sepet değişikliği sipariş vermez ve geri alınabilir. Sipariş yalnız onaylı çağrıyla oluşur.
- Ödeme / kart aracı yoktur; kartla ödeme yalnız portalda yapılır. Ajan silme, onaylama / reddetme veya adres değiştirme yapamaz.
- Firma izolasyonu: ajan yalnız kendi firma (Party) kapsamınızdaki veriyi görür; başka firma veya kiracı verisi istenirse reddedilir.
- Yetkilerinizi siz belirlersiniz: yazma izinleri siz seçmedikçe verilmez; ajan portal yetkinizin dışına çıkamaz.
- Parola değişince bağlantılar iptal olur: parolanız değiştiğinde veya hesabınız pasifleştiğinde ajan bağlantılarınızın tümü iptal edilir; yeniden bağlanıp onaylamanız gerekir.
- Oran sınırı: dakikada 60 çağrı; yazma işlemleri dakikada 10; sipariş, iade ve teklif gibi dış etkili işlemler saatte 20.
- Denetim: her araç çağrısı maskeli argümanlarla kayda alınır. Not, açıklama ve adres gibi serbest metinler güvenilmeyen veri sayılır; içlerindeki talimatlar izlenmez.
Örnek istemler
- Tekrar sipariş: "Kayıtlı listemdeki ürünleri sepete ekle, sepeti özetle ve sipariş önizlemesini göster."
- Ürün bulma: "OEM123 numaralı ürünü bul ve sepete 10 adet ekle."
- Ekstre kontrolü: "Bu ayki ekstremi ve cari bakiyemi özetle; kredi limitimden ne kadarı kaldı?"
- Durum takibi: "Onaylanmış siparişlerimi listele ve en sonuncusunun sevkiyat durumuna bak."
- Teklif talebi: "Şu üründen 50 adet için teklif iste."
- İade: "Şu siparişin 1. satırından 2 adet iade talebi hazırla; iade nedenlerini göster."
B2B alıcı: sık sorulanlar ve sorun giderme
"E-posta veya parola hatalı" görüyorum. Portalda kullandığınız e-posta ve parolayı girin. 15 dakikada 5 hatalı girişten sonra hesap geçici kilitlenir; ekrandaki süre dolunca tekrar deneyin.
Lisans veya pasif hesap hatası alıyorum. Tedarikçinizin B2B lisansı yoktur ya da hesabınız pasiftir; tedarikçinizle iletişime geçin.
Ajan sipariş veya iade araçlarını görmüyor. Yazma izinleri bağlantıda seçilmemiştir; yeniden bağlanıp ilgili yazma iznini işaretleyin.
Onay kodu geçersiz. Süre dolmuş, kod kullanılmış ya da sepet / fiyat / stok değişmiş olabilir; ajandan özeti yeniden almasını isteyin.
Sipariş "onay bekliyor" durumunda. Portaldaki onay zinciri devrededir; onaycı portalda onaylar, ajan onaylayamaz.
Bağlantı aniden kesildi. Parola değişmiş ya da hesap pasifleşmiş olabilir; yeniden bağlanıp izinleri onaylayın.
Kart ile ödeme yapabilir miyim? Fatura PDF'i indirir mi? Hayır; ödeme yalnız portalda, ajan fatura bilgisini okur.
Güvenlik hatırlatması
- Ajan yalnızca sizin yetkinizle ve onayladığınız izin gruplarıyla çalışır. Silme ve aday iptali sadece EQLEM'de yapılır.
- Dış etkili işlemler onayınıza bağlıdır; CRM uyumluluk kuralları her gönderimde uygulanır.
- Kurumsal istemcinin
client secretdeğerini kimseyle paylaşmayın. Yenilemek için Admin, AI bağlantıları ekranını kullanır. - Ajan bağlantısını kaldırmak için AI bağlantıları ekranından iptal edin.
Sık sorulanlar
MCP URL'sini nereden alırım? EQLEM'de AI bağlantıları ekranından.
Bağlanamıyorum, ne yapmalıyım? Önce URL'yi ve tarayıcıdaki giriş ve onay adımını kontrol edin. Sorun sürerse EQLEM yöneticinize bildirin. Gemini Enterprise ve Copilot Studio (Manual) için yönetici kurumsal istemci oluşturur.
Sağlayıcı arayüzündeki adlar farklı görünüyor. Sağlayıcılar menü adlarını değiştirebilir; yukarıdaki adımlar genel akışı anlatır.
Sonraki adım
CRM modülünü inceleyin ya da Ücretsiz Dene ile başlayın.