MCP

Araçlar

Solk MCP sunucusunun okuma, yazma ve kalıcı silme araçları, parametreleri ve örnek istemleri.

Araçlar REST API'nin üzerinde çalışır: her araç çağrısı ilgili API ucunu sizin hesabınızla çağırır ve aynı kurallar (yetki, görünürlük, aşama kapıları, mükerrer koruması) geçerlidir. İstemciye yalnız sizin kullanabildiğiniz araçlar listelenir:

  • crm.read kapsamı yoksa okuma, crm.write yoksa yazma araçları listede görünmez. Silme araçları yalnız onay ekranında ayrıca Kalıcı silme (crm.delete) kutusu işaretlendiyse gelir.
  • Bağlı olmayan entegrasyonların araçları (WhatsApp Business, santral, SMS, görüşme kaydı) ve yönetici araçları (iş akışı taslağı, abonelik özeti, birleştirme, pasife alma, fırsat silme) satışçıya listelenmez.
  • Lisansta ya da kullanıcınızda kapalı modüllerin araçları (ör. Fuar leadleri modülü kapalıysa ilgili araçlar) listelenmez.

Araçların adları ve açıklamaları modellerin daha iyi anlaması için İngilizcedir; asistanla Türkçe konuşabilirsiniz.

Okuma araçları

Okuma araçları istemciye readOnlyHint: true olarak bildirilir — Claude bunlar için "her zaman izin ver" seçeneği sunar.

Araç Açıklama Parametreler Örnek istem
search Ad, şehir, telefon ya da e-postayla firma, kişi, fırsat ve fuar leadi arar (en az 2 karakter); 15 karakterlik kayıt kimliğini de çözer. query* Kumsal Plastik'i bul
list_companies Firmaları süzgeçlerle listeler: durum (AC / Prospect), sorumlu, şehir, ziyaret durumu ve sayaçlar. page, query, scope (mine · all), sort (name · visit · priority), status (AC · Prospect), visit (overdue · soon · ok · none) Ziyareti geciken aktif müşterilerimi listele
get_company Firma kartının tamamı: kişiler, fırsatlar, son ziyaret ve denemeler, açık aksiyonlar, teklifler, notlar ve e-posta yazışmaları. company_id* Alize Paketleme'nin kartını özetle
list_contacts Firmalardaki kişileri listeler. query, scope (mine · all) Satın alma müdürü unvanlı kişileri göster
list_opportunities Fırsatları listeler: açık (varsayılan), kapalı, müşteri takibi ya da bir aşama; güncelleme, sağlık, değer ya da SLA'ya göre sıralı. page, query, scope (mine · all), sort (update · health · value · sla), stage Negotiation'daki fırsatları değere göre sırala
get_opportunity Fırsatın tamamı: aşama, değer, olasılık, sağlık, kontrol listesi, BANT, kapı sorunları, ziyaretler, denemeler, teklifler, aşama geçmişi. opportunity_id* Streç film fırsatı bir sonraki aşama için neyi bekliyor?
list_actions Açık işler: görevler, ziyaret ve denemelerin sonraki aksiyonları, tarihli proje adımları; her satırda tür + kimlik. company_id, scope (mine · all), state (today · overdue · soon · open · week) Bu hafta geciken aksiyonlarım neler?
get_action Tek aksiyon ya da görev, bağlamıyla (firma, proje, geçmiş). id, kind (visit · demo · task · step) Fiyat listesi görevinin ayrıntısını aç
list_calendar Tarih aralığındaki toplantılar ve aksiyonlardan türeyen takvim girişleri. from, to Gelecek hafta takvimimde neler var?
list_email_threads Kullanıcıların posta kutularından eşitlenen yazışmalar: bir kaydınkiler ya da gelen kutusu. filter (all · waiting · replied · mine), query, record_id, record_type (customer · opp · visit · demo · task · offer · ticket · contract) Yanıt bekleyen müşteri e-postalarını göster
get_email_thread Bir yazışmanın iletileri (görme izni yoksa gizli) ve bağlı kayıtları. thread_id* Kuzey Plastik'le son yazışmayı özetle
get_dashboard Pano: aşamalara göre sayı ve değer (ana dövizde), haftalık ziyaret hedefleri, SLA aşımları, sıradaki adımlar. scope Satış hattının özetini çıkar
get_today Günüm: bugünün toplantıları ve işleri, gecikenler, son açılan kayıtlar ve bu haftanın aktivitesi. — Bugün ne yapmam gerekiyor?
list_team Etkin kullanıcılar (kimlik, ad, rol, departman) — atama ve sorumlu alanları için. — Ekipte kimler var?
list_comments Yorum konuları (ekip içi tartışma, not değil): bir kaydınkiler (record_type + record_id; açık | tümü) ya da kayıtsız 'gelen kutum' — benden bahsedenler, katıldıklarım, tüm açık konular. filter (open · all · mentions · mine), record_id, record_type (customer · opp · contact · thread · lentry · canvas) Benden bahsedilen açık yorumları göster
list_lists Amaç listeleri (ör. '4. çeyrek hedefleri'): nesne, liste aşamaları, listeye özel alanlar, giriş sayısı, düzenleme izni. object (customer · contact · opp) Hangi listeler var?
get_list_entries Listedeki kayıtlar, liste aşaması ve liste alanı değerleriyle (sayfa başına 100). list_id*, page, stage Fuar takip listesinde 'Teklif' aşamasındakileri göster
list_reports Görebildiğiniz kayıtlı raporlar ve hazır rapor kalıpları (huni, aşamada geçen süre, aşama değişimleri, geçmiş değerler) ile tarih aralıkları. — Hangi raporları çalıştırabilirim?
run_report Kayıtlı raporu ya da hazır kalıbı çalıştırır; range dönemini ezer. Etiketler, seriler, toplamlar ve tablo döner (huni dönüşüm ve kazanma oranı da verir). Tutarlar ana dövizde. range, report_id, template Bu çeyreğin satış hunisini ve kazanma oranını çıkar
get_relations Firma, kişi ya da fırsatın ilişkileri (ana firma ↔ şubeler, kişinin diğer firmaları, fırsattaki ortak) ve eklenebilir ilişki anahtarları (relation = 'anahtar:a|b'). record_id, record_type (customer · contact · opp) Kuzey Plastik'in bağlı şirketleri hangileri?
list_canvases Görebildiğiniz tuvaller (bir firma / fırsatınkiler ya da adla) ve tuval kalıpları. query, record_id, record_type (customer · opp) Kuzey Plastik'in tuvallerini listele
read_canvas Tuvali okur: ana hat (çerçeveler ve içindeki notlar, şekiller, kartlar, oylar, bağlantılar — varsayılan), json (tüm öğeler konum ve kimlikleriyle) ya da svg (görüntü). canvas_id*, format (outline · json · svg) Fuar sonrası beyin fırtınası tuvalini özetle, en çok oy alanlar hangileri?
list_products Teklif için ürün kataloğu: kod, ad, grup, birim, döviz ve birim liste fiyatı. company_id verilirse firmanın anlaşmalı fiyatları, include_stock ile ilk 5 ürünün ERP'deki anlık stoğu (stok okuyan bağlantı varsa). company_id, group, include_inactive, include_stock, limit, query Film grubundaki ürünleri liste fiyatlarıyla göster
list_offers Teklifler: durum (taslak, onay bekliyor, onaylandı, sunuldu, kabul = kazanıldı, red, süresi doldu, revize edildi), tutarlar ve onay işareti. status=open (varsayılan) = henüz sonuçlanmamış. Tutarlar teklif dövizinde aylık ve yıllık, ayrıca ana dövizde yıllık. company_id, opportunity_id, page, query, scope (mine · all), status (open · all · draft · review · approved · denied · presented · expired) Onay bekleyen teklifleri listele
get_offer Tek teklif: kalemler (ürün, aylık miktar, birim, liste fiyatı, net birim fiyat, iskonto %), toplamlar, onay nedenleri ve durumu, sürümler, vade, geçerlilik ve PDF bağlantısı. offer_id* TKL-2026-0044 teklifinin kalemlerini ve iskontolarını göster
list_orders Müşteri siparişleri: PO numarası, ürün, miktar, sevk edilen / kalan miktar, durum, termin ve ERP'ye gönderim durumu. company_id, opportunity_id, page, query, status (open · late · partial · closed · all) Termini geçen açık siparişler hangileri?
get_company_finance Bağlı muhasebe / ERP sisteminden cari (salt okunur): bakiye, vadesi geçen tutar, kredi limiti ve risk %, açık ve vadesi geçen faturalar, 12 aylık ciro, ortalama vade ve fatura listesi. Faturalar Solk'ta değil ERP'de kesilir. company_id*, limit, status (all · open · overdue · paid) Kuzey Plastik'in vadesi geçen faturaları ve bakiyesi ne?
list_tickets Destek talepleri (şikâyet, teknik destek, soru, iade…) öncelik, durum, görevli ve SLA durumuyla. status=open (varsayılan: gelen, devam ediyor, beklemede) SLA hedefine göre sıralı. assigned (me · unassigned · all), company_id, page, priority (Düşük · Normal · Yüksek · Acil), query, sla (overdue · soon), status (open · all · new · in_progress · on_hold · resolved · closed) SLA'sı geçen açık destek taleplerini göster
get_ticket Tek destek talebi: ayrıntı, çözüm, SLA zamanları, bağlı ürün / lot, sipariş ve fırsat, zaman çizelgesi (iç notlar, müşteriye yanıtlar, durum ve görevli değişiklikleri). ticket_id* Yırtılma şikâyetinde şu ana kadar ne yapıldı?
list_contracts Müşteri sözleşmeleri (tedarik / hizmet / abonelik): tarihler, kalan gün, yenileme (otomatik yenileme, ihbar süresi), tutar ve durum. status=active (varsayılan) = imzalı ve yürürlükte; expiring = ihbar süresinde. company_id, expiring_within_days, page, query, status (active · expiring · draft · awaiting_signature · signed · completed · terminated · all) Önümüzdeki 60 günde biten sözleşmeleri listele
list_automations Çalışma alanında kendiliğinden çalışanlar: iş akışları (tetikleyici, koşul, adımlar, çalışma sayısı) ve tepki verdikleri kayıt olayları; yöneticiye ayrıca bağlı uygulamalar (Slack, Teams, web kancaları…) ve olayları ile ERP'ye sipariş gönderimi. Bu araçlarla yapılan değişiklikler de bunları tetikler. — Bir fırsat kazanılınca hangi otomasyonlar çalışıyor?
list_phone_calls Santral aramaları (Netgsm, Verimor, Bulutfon, AloTech, Tegsoft ya da diğer santral): yön, durum (görüşüldü, cevapsız, cevap yok), firma / kişi, kullanıcı ve dahili, konuşma süresi, kuyrukta bekleme, görüşme kaydı, ses kaydı ve cevapsız aramaya geri dönülüp dönülmediği. Toplamlar: cevaplanma oranı, cevapsız / geri dönülen, ortanca geri dönüş süresi, konuşma süresi. company_id, days, direction (in · out), limit, mine, status (missed · answered), unreturned Dün geri dönmediğimiz cevapsız aramalar hangileri?
get_activity Bir firmanın ya da fırsatın etkinlik akışı (yeni önce, sayfalı): e-posta, arama, SMS, WhatsApp, görüşme, teklif, sipariş, not, değişiklikler; her satırda nereden girildiği. before, company_id, group (all · mail · call · wa · meet · deal · note · task), limit, opportunity_id Kuzey Plastik'te son iki haftada neler oldu?
search_activities Tüm kayıtlarda etkinlik arar: ziyaret, deneme, santral araması, SMS, tek tek e-postalar, WhatsApp, not, görüşme kaydı, tamamlanan görev, teklif, sipariş. Tür, firma, fırsat, kişi, tarih, metin ve yönle süzülür; imleçle sayfalanır. before, company_id, date_from, date_to, direction (in · out), limit, mine, opportunity_id, query, types, user_id Bu hafta ekibin gönderdiği e-postaları listele
aggregate Kayıtları en çok iki boyutta sayar, toplar ya da ortalar: sorumlu, aşama, yön, şehir… ve gün / hafta / ay / çeyrek / yıl. Yalnız görebildiğiniz kayıtlar sayılır; tutarlar ana dövizde. company_id, date_field, date_from, date_to, field, filters, group_by, limit, metric (count · sum · avg · min · max), mine, object* (companies · opportunities · visits · demos · tasks · offers · orders · emails), opportunity_id Bu çeyrek satışçı başına kaç ziyaret yapıldı?
get_fields aggregate'in kullanabileceği nesneler, boyutlar, tarih ve sayı alanları; nesne verilirse boyutların değerleri ve özel alanlar. name_contains, object Fırsatları hangi alanlara göre gruplayabilirim?
search_help Çalışma alanının kullanım kılavuzunda, turlarda ve ipuçlarında arar; bağlantıyla döner. limit, query* Fırsat aşaması nasıl değiştirilir?
get_workspace Çalışma alanı ve oturum: sürüm, ana döviz, açık modüller, aşamalar (yeniden adlandırılmış etiketler, olasılık, öngörü kategorisi), görünürlük, lisans, bağlı entegrasyonlar. — Satış aşamalarımız ve olasılıkları neler?
get_contact Tek kişi: firma, unvan, e-posta, telefon, özel alanlar, son e-postalar ve ziyaretler. contact_id* Merve Ak'la son temasımız ne zamandı?
list_call_recordings Görüşme ve toplantı kayıtları (not alıcı, tarayıcı kaydı, santral, Google Meet / Microsoft Teams dökümleri): başlık, firma, süre, özet durumu. company_id, filter (all · mine), query Kuzey Plastik'le yapılan toplantı kayıtlarını getir
get_call_recording Tek kayıt: konuşmacılar ve konuşma payı, özet bölümleri, yapılacaklar, bölümler ve konuşmacılı döküm. recording_id* Dünkü toplantının yapılacaklarını çıkar
list_notes Firma, fırsat, talep ve sözleşmelerdeki notlar: benim, bahsedildiğim, favoriler ya da bir kaydınkiler. filter (all · mine · mentions · favs), limit, query, record_id, record_type (customer · opp · ticket · contract) Beni etiketleyen notları göster
get_note Tek not: kaydı, yazanı, etiketleri ve bahsedilenleri. note_id* Bu notun tamamını aç
list_email_templates Kullanabildiğim e-posta şablonları (ortak ve kendi şablonlarım). query Teklif takibi için şablonumuz var mı?
get_email_template Tek şablon: konu ve gövde (değişkenler süslü parantezde). template_id* Teklif takip şablonunu göster
render_email_template Şablonun değişkenlerini firma / kişi / fırsat için doldurur; hazır konu ve gövde döner (kaydetmez, göndermez). company_id, contact_id, opportunity_id, template_id* Teklif takip şablonunu Merve Ak için doldur
list_notifications Bildirimlerim: son 50 (bahsetme, atama, onay, gelen WhatsApp, gecikenler…) okundu durumuyla. — Okumadığım bildirimler neler?
list_saved_views Kayıtlı liste görünümleri (fırsat, talep, sözleşme, sipariş) — benim ve ortak — açan bağlantıyla. kind (opp · ticket · contract · order) Kayıtlı görünümlerimi listele
list_custom_fields Firma, kişi ve fırsat özel alanları: anahtar, etiket, tür, seçenekler, döviz, yapay zekâ alanları. record_type (customer · contact · opp) Fırsatlarda hangi özel alanlar var?
list_object_types Çalışma alanının özel nesne türleri (ör. üretim hattı, şube, ekipman) ve kayıt sayıları. — Hangi özel nesnelerimiz var?
list_object_records Bir özel nesne türünün kayıtları (sayfa başına 40), isteğe bağlı bir firmanınkiler. archived (1), company_id, object_key*, page, query Kuzey Plastik'in üretim hatlarını listele
get_object_record Tek özel nesne kaydı: tüm alan değerleri ve bağlantıları. object_key, record_id 3 numaralı hattın ayrıntısını aç
get_workflow Tek iş akışı: tetikleyici, koşullar, adımlar, açık / kapalı, çalışma sayısı (yönetici). workflow_id* 'Teklif hatırlatma' akışı ne yapıyor?
list_roles Roller ve modül erişimi, kayıt görünürlüğü ve her etkin üyenin rolü. — Kim hangi role sahip?
get_billing_summary Paket, dönem, kullanılan / lisanslı koltuk, lisans bitişi ve son Solk faturaları (yönetici). — Kaç koltuğumuz boşta?
list_whatsapp_chats WhatsApp Business yazışmaları: kişi, firma, son ileti, okunmamış sayısı, 24 saatlik yanıt penceresinin açık olup olmadığı (beta). company_id, filter (all · unread · open · unlinked), query Yanıt bekleyen WhatsApp mesajları var mı?
get_whatsapp_chat Bir yazışmanın son 50 iletisi, iletim durumları ve şu an kullanılabilecek onaylı şablonlar (beta). chat_id* Merve Ak'la WhatsApp yazışmasını özetle

* zorunlu parametre.

Yazma araçları

Yazma araçları kayıt oluşturur ya da değiştirir; hiçbiri kayıt silmez. Var olan veriyi değiştiren araçlar destructiveHint: true olarak bildirilir: update_* araçları, postpone_action, fill_ai_field, send_whatsapp, update_company, change_opportunity_stage, complete_action, log_activity (açık aksiyonları kapatabilir), resolve_comment, upsert_list_entries, add_relation (tekil ilişkide eskisinin yerine geçer), remove_relation, update_canvas, create_offer (birincil teklif olur, fırsatın fiyatını günceller), update_offer_status, create_order (firmayı müşteri yapabilir, siparişi ERP'ye gönderebilir), update_ticket, run_workflow. Yalnız ekleme yapanlar (diğer create_*, add_note, add_comment) false. create_order, run_workflow ve send_whatsapp ayrıca openWorldHint: true — dış bir sisteme (ERP'niz, iş akışındaki HTTP adımı, müşterinin WhatsApp'ı) gidebilir. create_email_draft yalnız taslak kaydeder, e-posta göndermez; create_workflow akışı kapalı taslak olarak açar. Claude her yazma çağrısından önce onay ister. Yönetici yalnız okuma kuralını açtıysa yazma araçları listelenmez.

Araç Açıklama Parametreler Örnek istem
create_company Firma açar (verilmezse Prospect). Aynı ad varsa reddedilir; benzer adlarda confirm_new gerekir. İsteğe bağlı ilk kişi. address, city, confirm_new, contact_email, contact_name, contact_phone, contact_title, name*, note, owner_id, phone, sector, status (AC · Prospect), website Anadolu Gıda Ambalaj adında Konya'da yeni bir aday firma aç
update_company Firma alanlarını günceller (yalnız verilenler değişir). address, city, company_id*, name, note, owner_id, phone, sector, status (AC · Prospect), visit_period_days, website Kuzey Plastik'i aktif müşteri yap ve 30 günde bir ziyaret ayarla
create_contact Firmaya kişi ekler. company_id, department, email, is_main, name, note, phone, title Kuzey Plastik'e Emre Yıldız'ı üretim şefi olarak ekle
create_opportunity Firma için yeni satış projesi açar (ilk aşamadan başlar). company_id*, competitor, name, note, type, value Kuzey Plastik için 'Streç film tedariki' fırsatı aç
change_opportunity_stage Fırsatı başka aşamaya taşır; aşama kapıları uygulanır, reddedilirse nedenleri döner. note, opportunity_id, reason, stage (Lead · In Progress · Win · Lost · Cancel) Streç film fırsatını Viable'a taşı
create_task Görev açar (verilmezse bana atanır). Firma bağlamak isteğe bağlı; kendiliğinden proje açılmaz. assigned_to, company_id, company_name, detail, due_date, due_time, opportunity_id, priority (Düşük · Normal · Yüksek · Acil), title* Yarın 10:30'a Kuzey Plastik'i arama görevi oluştur
complete_action Aksiyonu tamamlar (görev, ziyaret / deneme aksiyonu, proje adımı); done_on tamamlanma günü. done_on, id, kind (visit · demo · task · step), result Fiyat listesi görevini tamamlandı yap
log_activity Telefon görüşmesi, online toplantı ya da yüz yüze ziyaret kaydeder (Hızlı Giriş): not, sonuç, sonraki aksiyon ve tarihi; uygun açık aksiyonları kapatır. action_date, company, confirm_new, contact, next_action, note, opportunity_id, result, topic, visit_date, visit_type (F2F · Online · Call) Kuzey Plastik'le az önceki telefon görüşmesini kaydet, perşembeye teklif aksiyonu aç
add_note Firma, fırsat, destek talebi ya da sözleşmeye not ekler. body, record_id, record_type* (customer · opp · ticket · contract) Alize Paketleme'ye 'fiyat revizyonu istendi' notu düş
add_comment Kayıtta yeni yorum konusu açar ya da bir konuya yanıt yazar (reply_to = konudaki herhangi bir yorum). mention_user_ids ile ekip arkadaşına bahsetme bildirimi gider; çözülmüş konu yanıtla yeniden açılır. body, mention_user_ids, record_id, record_type* (customer · opp · contact · thread · lentry · canvas), reply_to Kuzey Plastik'e 'numune ne zaman gidiyor?' diye yorum yaz, Ayşe'den bahset
resolve_comment Yorum konusunu çözüldü yapar (resolved=false yeniden açar). comment_id*, resolved Numune konusundaki yorumu çözüldü yap
upsert_list_entries Anahtarla ekle / güncelle: her satırdaki kayıt (record_id ya da adı) listede yoksa eklenir, sonra liste aşaması ve liste alanları yazılır. En çok 200 satır; satır bazında hata döner. list_id, rows Bu beş firmayı 4. çeyrek hedeflerine ekle, aşama 'İlk temas'
add_relation Kaydı başka bir kayda bağlar (get_relations.available'dan ilişki, hedef kimliği). Tekil ilişkide eski bağ değişir; ana firma zincirinde döngü reddedilir. note, record_id, record_type (customer · contact · opp), relation, target_id Kuzey Plastik Bursa'yı Kuzey Plastik'in şubesi yap
remove_relation Bir ilişki bağını kaldırır (get_relations'tan relation_id). Kayıtlar silinmez. relation_id* Bayi ilişkisini kaldır
create_canvas 62 şablondan biriyle (anahtarlar list_canvases'ta; kayıt şablonları: paydaş haritası, organizasyon şeması, hesap planı — firma; fırsat planı — fırsat; diğerleri ör. kanban, müşteri yolculuğu, zihin haritası, yol haritası (zaman çizelgesi), OKR takipçisi (akıllı tablo), SWOT, retro, akış şeması, slaytlar), Mermaid akış şemasından (kendiliğinden yerleşir) ya da öğelerden (not, şekil, çizgi, kalem, tablo, akıllı tablo — tipli sütunlar ve gruplar, zaman çizelgesi, emoji, kart, bağlantı; st alanıyla yazı tipi, boyut, renk, dolgu, kenarlık) tuval açar. Kayıt şablonları kişileri, fırsatları, riskleri ve sonraki adımları CRM'den doldurur. access (edit · read · private), elements, mermaid, name, record_id, record_type (customer · opp), template (blank · stakeholders · orgchart · account_plan · deal_plan · swot · retro · pipeline) Kuzey Plastik için hesap planı tuvali aç
update_canvas Tuvali fark olarak değiştirir: öğe ekle (tablo, akıllı tablo, zaman çizelgesi, çizgi, kalem, emoji dahil; st ile stil), kimlikle güncelle (yalnız verilen alanlar), sil (bağlantıları da gider) ve / veya mevcut içeriğin yanına Mermaid akış şeması ekle. add, canvas_id*, delete, mermaid, update Hesap planına 'Riskler' çerçevesine üç yapışkan not ekle
create_offer Fırsat için kalemli teklif açar; birincil teklif olur ve fırsatın fiyat, miktar ve yıllık değerini (miktar × fiyat × 12) günceller. Sınırı aşan iskonto ya da taban fiyat altı yönetici onayı bekler ('review'). Toplamlar, onay nedenleri ve PDF bağlantısıyla döner. currency, lines, note, opportunity_id, payment_days, terms, valid_until Streç film fırsatına 1.000 kg film (2,40 €) ve 50 kg etiket kalemli teklif hazırla
update_offer_status Onay bekleyen teklifi onaylar / reddeder (yönetici), müşteriye sunuldu yapar ya da birincil yapar (fırsatı bu teklif besler). Reddedilen değişiklik nedeniyle döner. action (approve · deny · mark_presented · make_primary), note, offer_id TKL-2026-0044'ü onayla
create_order Sipariş açar: kabul edilen tekliften (offer_id — fırsat kazanılmış olmalı; her kalem bir sipariş) ya da doğrudan (company_id + ürün + miktar). customer_po = müşterinin satınalma sipariş numarası. Çalışma alanı siparişleri ERP'ye kendiliğinden gönderiyorsa yeni sipariş oraya gider (faturayı ERP keser). company_id, currency, customer_po, due_date, kind (İlk Sipariş · Yeni Sipariş · Geri Kazanım), offer_id, product, product_id, quantity, unit_price Kabul edilen tekliften PO 4500123 ile sipariş oluştur
create_ticket Firma için (ya da CRM'de olmayan kişi / firma adıyla) destek talebi açar. Çalışma alanının talep şablonu SLA hedefini, varsayılan görevliyi ve ilk görevleri belirler; görevliye bildirim gider. assigned_to, category (Ürün kalitesi · Uygulama / proses · Teslimat / lojistik · Ambalaj / etiket · Doküman (TDS / SDS / CoA) · Fatura / ödeme · Diğer), company_id, company_name, contact_id, contact_name, detail, kind (Şikâyet · Teknik destek · Soru / bilgi · Numune / deneme · İade · Öneri), lot_no, opportunity_id, order_id, priority (Düşük · Normal · Yüksek · Acil), product, source (Telefon · E-posta · Ziyaret · WhatsApp · Web · Mobil), subject* Kuzey Plastik için 'film yırtılıyor' şikâyeti aç, öncelik yüksek, lot L-2291
update_ticket Talebin durumunu (çözüldü için çözüm metni gerekir), önceliğini (SLA hedefi yenilenir), görevlisini değiştirir ve / veya yorum ekler (iç not ya da müşteriye yanıt — yanıt ilk yanıt sayılır). assigned_to, comment, comment_type (note · reply), priority (Düşük · Normal · Yüksek · Acil), resolution, status (new · in_progress · on_hold · resolved · closed), ticket_id* Yırtılma şikâyetini çözüldü yap: sarım gerginliği ayarlandı
run_workflow Elle çalıştırılan iş akışını (list_automations: manual=true) en çok 200 fırsat ya da firmada çalıştırır; adımlar hemen yürür (görev, bildirim, alan güncelleme, uygulama / HTTP çağrısı). Koşula uymayan ya da düzenleyemediğiniz kayıtlar atlanır. record_ids, record_type (opp · customer), workflow_id* 'Kazanılan fırsatı devret' akışını bu üç fırsatta çalıştır
send_sms Kişiye ya da firma telefonuna, çalışma alanının SMS sağlayıcısından tek SMS. kind=info (varsayılan; sipariş, sevkiyat, randevu, ödeme — kampanya içermez) ya da tacir (şirketin kurumsal hattına ticari ileti; kimlik ve ret satırı eklenir; yalnız İYS süzgeçli sağlayıcıda). Ret listesindeki numaraya ve kampanya içeren bilgilendirme metnine gönderilmez. SMS firmanın zaman tünelinde not olarak görünür. Göndermeden önce kullanıcıdan onay alın. company_id, contact_id, kind (info · tacir), phone, text* Can Bey'e numunenin yarın kargoda olduğunu SMS'le bildir
update_contact Kişiyi günceller (yalnız verilen alanlar). Ayrılan kişi için silmek yerine is_former=true. contact_id*, department, email, is_former, is_main, name, note, phone, title Merve Ak'ın unvanını satın alma uzmanı yap
update_opportunity Fırsat alanlarını günceller: ad, tür, ürün hattı, aylık miktar, birim fiyat, vade, kapanış ve sonraki adım tarihi, not, öngörü kategorisi. Aşama change_opportunity_stage ile. close_date, forecast_cat (Pipeline · Best Case · Commit · Omitted), line, name, next_step_date, note, offer_price, opportunity_id*, payment_days, potential_kg, product_id, type Streç film fırsatının kapanışını 15 Aralık yap
update_task Görevi değiştirir: başlık, ayrıntı, tarih / saat, öncelik, durum, görevli. assigned_to, detail, done_on, due_date, due_time, priority (Düşük · Normal · Yüksek · Acil), status (Açık · Devam Ediyor · Tamamlandı), task_id*, title Fiyat listesi görevini Ozan'a ata, yarına al
postpone_action Açık aksiyonu gün sayısıyla ya da bir tarihe öteler; neden geçmişte kalır. date, days, id, kind (visit · demo · task · step), note Numune takibini bir hafta ertele: müşteri izinde
update_note Yazdığım notun metnini (ve başlığını) değiştirir; yönetici her notu. body, note_id, title Son notumu 'numune pazartesi gidiyor' diye düzelt
create_email_template Yeni e-posta şablonu kaydeder; değişkenler {firma}, {kişi_ad}, {fırsat}, {ben_ad} …, yedekli {kişi_ad|Merhaba}. body, name, shared, subject Numune takibi için ortak bir şablon oluştur
update_email_template Şablonumu (yönetici: her şablonu) değiştirir; yalnız verilen alanlar. body, name, shared, subject, template_id* Teklif takip şablonunun konusunu kısalt
create_email_draft E-postayı TASLAK olarak kaydeder — asla göndermez; kullanıcı E-postalar › Taslaklar'dan kontrol edip gönderir. Konu + gövde ya da şablon; yazışmaya yanıt da olabilir. bcc, body, cc, company_id, contact_id, in_reply_to_email_id, opportunity_id, subject, template_id, to Merve Ak'a teklif takibi için taslak hazırla
update_email_draft Gönderilmemiş taslağımı değiştirir; göndermez. bcc, body, cc, draft_id*, subject, to Taslağa teslim tarihini ekle
mark_notifications_read Verilen bildirimleri ya da okunmamışların hepsini okundu yapar. ids Bildirimlerimin hepsini okundu yap
create_object_record Özel nesne kaydı açar; isteğe bağlı firmaya bağlı, alan değerleriyle. company_id, fields, links, name, object_key Kuzey Plastik'e 4 numaralı hattı ekle
update_object_record Özel nesne kaydının adını, sorumlusunu, durumunu, alanlarını ya da bağlantılarını değiştirir. active, fields, links, name, object_key, owner_id, record_id 3 numaralı hattın kapasitesini 1.200 kg yap
create_workflow İş akışını KAPALI taslak olarak açar (yönetici) — hazır şablondan ya da düz anlatımdan; kullanıcı web'de inceleyip açar. description, name, template (contract_service · cross_sell · deal_nudge · email_followup · health_check · install_anniv · lead_triage · lost_retry) 7 gündür bekleyen teklif için sorumluya arama görevi açan bir akış taslağı hazırla
create_calendar_event Takvimime etkinlik ekler, isteğe bağlı firmaya bağlı. all_day, company_id, company_name, end, location, note, start, title Perşembe 14:00'e Kuzey Plastik toplantısı ekle
fill_ai_field Firma, kişi ya da fırsattaki yapay zekâ alanını kaydın kendi verisinden doldurur ve kaydeder. field_key, record_id, record_type* (customer · contact · opp) Kuzey Plastik'in 'segment' alanını doldur
start_whatsapp_chat Numaranın ya da kişinin WhatsApp yazışmasını bulur / açar ve firmaya bağlar; bir şey göndermez (beta). company_id, contact_id, phone Merve Ak'la WhatsApp yazışması aç
send_whatsapp WhatsApp Business'tan ileti gönderir (gerçek gönderim): müşteri son 24 saatte yazdıysa serbest metin, değilse onaylı şablon; pazarlama şablonu yalnız izni olan kişiye (beta). chat_id*, template, text, variables Merve Ak'a teklif hatırlatma şablonunu gönder
add_to_call_list Kişinin ya da firmanın numarasını çalışma alanının çağrı merkezi bağlantısının (Solveline / Mantis ya da kayıt ekleme adresi olan başka bir çağrı merkezi) arama listesine (kampanyasına) ekler; çağrı merkezi numarayı arar — isteğe bağlı belirli bir saatte, temsilcinin dahilisine bağlayarak (randevu). Aranmasın listesindeki numara reddedilir; tekrar ekleme süresi içinde aynı kampanyaya eklenen numara force=true olmadan eklenmez. Firmanın Etkinlik akışında görünür. Eklemeden önce kullanıcıdan onay alın. at, campaign, company_id, contact_id, force, link_id, note, phone, user_id Lale Metal'in satın almacısını yarın 14:30'da beni arayacak şekilde arama listesine ekle

* zorunlu parametre.

Kalıcı silme araçları

Silme ve birleştirme araçları ayrı bir izindir: Claude bağlanırken onay ekranında Kalıcı silme (isteğe bağlı) kutusu çıkar, varsayılan olarak işaretsizdir. İşaretlemezseniz bağlantı yalnız okur, oluşturur ve günceller; bu araçlar listelenmez, çağrılırsa açıklamalı hata döner. Sonradan açmak için bağlantıyı kaldırıp yeniden kurun ve kutuyu işaretleyin. Kişisel API anahtarlarıyla (sk_…) silme yapılamaz.

Her silme aracı confirm: true ister — yalnız kullanıcı açıkça istediğinde. archive_company firmayı silmez, pasife alır (geçmiş korunur); kalıcı firma silme yalnız web'den, otomatik yedekle yapılır. merge_companies önce yedek alır. delete_opportunity, archive_company ve merge_companies yalnız yöneticiye listelenir. Her çağrı denetim günlüğüne yazılır.

Araç Açıklama Parametreler Örnek istem
delete_task Görevi kalıcı siler. Yalnız kullanıcı açıkça isterse, confirm=true ile. confirm, task_id Mükerrer açılan görevi sil
delete_note Yazdığım notu (yönetici: her notu) kalıcı siler; confirm=true. confirm, note_id Yanlış firmaya yazdığım notu sil
delete_contact Kişiyi kalıcı siler; ayrılan kişi için update_contact is_former=true önerilir; confirm=true. confirm, contact_id Mükerrer Merve Ak kaydını sil
delete_opportunity Fırsatı ve aşama geçmişini kalıcı siler (yönetici). Kaybedildi / iptal olarak kapatmak çoğu zaman doğrusudur; confirm=true. confirm, opportunity_id Test için açılan fırsatı sil
archive_company Firmayı pasife alır (yönetici): geçmiş korunur, listelerden ve hatırlatıcılardan çıkar. Kalıcı silme yalnız web'den, otomatik yedekle; confirm=true. company_id, confirm Faaliyetini durduran Kumsal Plastik'i pasife al
merge_companies Mükerrer firmaları birleştirir (yönetici): bağlı her kayıt korunan firmaya geçer, boş alanlar doldurulur, önce yedek alınır; confirm=true. confirm, duplicate_company_ids, keep_company_id* Kuzey Plastik ve Kuzey Plastik A.Ş. kayıtlarını birleştir
delete_object_record Özel nesne kaydını kalıcı siler; confirm=true. confirm, object_key, record_id* Sökülen 2 numaralı hattı sil
delete_email_template Şablonumu (yönetici: her şablonu) kalıcı siler; bir iş akışı kullanıyorsa reddedilir; confirm=true. confirm, template_id Eski kampanya şablonunu sil
delete_calendar_event Solk'ta eklenen takvim etkinliğini siler (Google / Outlook'tan gelenler silinmez); confirm=true. confirm, event_id Perşembe toplantısını takvimden kaldır
delete_saved_view Kayıtlı görünümümü (yönetici: ortak olanları da) siler; confirm=true. confirm, view_id Eski 'Ekim fırsatları' görünümünü sil

* zorunlu parametre.

Yanıt biçimi

Araçlar sonucu hem metin (content[0].text, JSON) hem yapısal içerik (structuredContent) olarak döndürür. İş kuralı hatalarında (ör. aşama kapısı, benzer firma adı) isError: true ve nedeni açıklayan metin gelir; asistan bunu kullanıcıya aktarır ya da düzeltip yeniden dener.

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [{ "type": "text", "text": "{\"counts\": {\"overdue\": 8, \"soon\": 0, \"today\": 0}, \"rows\": [ … ]}" }],
    "structuredContent": { "counts": { "overdue": 8, "soon": 0, "today": 0 }, "rows": [ "…" ] },
    "isError": false
  }
}