105 araç, 5 grup. Bağlanırken grup seçerek yalnızca ihtiyacın olanları yükleyebilirsin:
POST /mcp?scope=hiring,ats. Salt okuma için ?mode=readonly.
Profil, firma özeti, bildirimler, model listesi — her bağlantıda açık.
| Araç | Ne yapar | Ne zaman kullanılmaz |
|---|---|---|
delete_notification |
Bir bildirimi siler (notification trash). Düşük risk. | Okundu yapmak yeterliyse silme — mark_notification_read tercih edilir. |
enable_tool_group |
Bir araç grubunu bu oturuma yükler (hiring / ats / qinsight / talent). Yüklendikten sonra o gruptaki araçlar doğrudan çağrılabilir. | Bütün grupları peşin peşin açma — açtığın her grup bağlamı büyütür ve araç seçme doğruluğunu düşürür. |
get_company_stats |
Firmanın hızlı özeti: kaç test, kaç mülakat, kaç vibe interview, kaç job posting, kaç aktif aday var. | Kayıtların kendisini listelemez — sayıları görüp sonra list_* araçlarına geç. |
get_my_profile |
Authenticated kurumsal hesabın (firma) profilini döndürür: e-posta, ad-soyad, firma adı, telefon, oluşturma tarihi. | Firma istatistikleri için değil (get_company_stats). Çalışan listesi için değil (qi_list_members). |
list_ai_models |
Sistemde kullanılabilir AI değerlendirme modelleri. | Model değiştirmez, yalnızca listeler. |
list_capabilities |
Qalentis MCP'de hangi araç grupları var, her grupta kaç araç bulunuyor ve şu an hangileri açık — hepsini tek çağrıda döner. | Belirli bir aracı arıyorsan search_tools daha doğrudan. |
list_my_mcp_activity |
Firmanın MCP aracılığıyla yaptığı son tool çağrılarının listesi (audit log). Hangi tool ne zaman çağrıldı, başarılı mıydı. | Platform içi kullanıcı hareketlerini göstermez, yalnızca MCP çağrılarını. |
list_notifications |
Firmanın aldığı bildirimleri listeler. unread_only=true ile sadece okunmamışları al. | Q-Insight bildirimleri burada değil — qi_list_notifications ayrı. |
mark_all_notifications_read |
Firmanın tüm okunmamış bildirimlerini "okundu" olarak işaretler. | Kullanıcı hangi bildirimlerin olduğunu görmeden çağırma — önce list_notifications. |
mark_notification_read |
Bildirimi "okundu" olarak işaretler. | Hepsini işaretlemek için tek tek çağırma — mark_all_notifications_read var. |
search_tools |
Yapmak istediğin işi anlatan bir kelimeyle uygun Qalentis aracını bulur. Araç adını bilmediğinde ÖNCE bunu çağır. | Aracı zaten biliyorsan çağırma. |
update_profile |
Firmanın profil bilgilerini günceller: ad-soyad, firma adı, telefon. Yalnızca verilen alanlar değişir. | E-posta ve hesap tipi buradan değişmez; parola hiç değişmez. |
Test oluşturma/yönetme, mülakat, davet linki, aday sonuçları, AI soru üretimi.
| Araç | Ne yapar | Ne zaman kullanılmaz |
|---|---|---|
cancel_vibe_interview yüksek risk |
Aktif bir vibe (AI) mülakatını iptal eder. Adaylar artık katılamaz. | Kayıtları silmez — silmek için request_delete_vibe_interview. |
confirm_delete_interview yüksek risk |
request_delete_interview'den alınan token ile mülakatı siler. | Onaysız çağırma. |
confirm_delete_interview_token yüksek risk |
request_delete_interview_token'dan alınan token ile siler. | Aday sınavın ortasındaysa linki silme. |
confirm_delete_test yüksek risk |
request_delete_test'ten alınan token ile testi kalıcı olarak siler. | Kullanıcı onayı olmadan asla. Token 120 sn sonra ölür — süresi geçtiyse yeniden request çağır. |
confirm_delete_vibe_interview yüksek risk |
request_delete_vibe_interview'den alınan token ile vibe interview'ı kalıcı siler. | Onaysız çağırma. |
create_ai_generated_test yüksek risk |
AI ile sorular üretip direkt yeni bir test oluşturur. Tek adımda hazır test. Sonra düzenleyebilirsin. | Sorular önce onaylanacaksa generate_ai_test_questions kullan. |
create_interview yüksek risk |
Yeni mülakat kaydı oluşturur. Bir test'e bağlı, opsiyonel olarak public link (token) da otomatik üretir. | Yalnızca link lazımsa create_interview_token daha dar. |
create_interview_token yüksek risk |
Bir test için public mülakat linki (token) oluşturur. Adaylar bu link ile teste girer. Default: 30 gün geçerli, 1 kullanımlık. Döner: { id, token, public_url }. | 12 adaya tek link verme — tek kullanımlık link paylaşılırsa ikinci aday giremez. Mülakat kaydı da isteniyorsa create_interview tek adımda yapar. |
create_test yüksek risk |
Yeni test oluşturur. Test başlangıçta boş (soru yok). Soru eklemek için soru API'sini kullan (yakında MCP'de). | Kullanıcı "test oluştur ve soruları da üret" diyorsa bunu KULLANMA — create_ai_generated_test tek adımda yapar. |
create_vibe_interview yüksek risk |
Yeni vibe (AI) mülakat taslağı oluşturur. AI sorular preview ile üretilir, sonra finalize edilir. | Tek başına yetmez — adayların girebilmesi için finalize_vibe_interview çağrılmalı. |
evaluate_text_answer |
AI (GPT-4o) ile bir aday cevabını değerlendirir. Skor, açıklama ve iyileştirme önerileri döner. Tek aday tek cevap. | Toplu değerlendirme için tasarlanmadı — 20 adayı tek tek çağırmak hız limitine takılır. Sınav sonuçları zaten otomatik puanlanır; list_test_results'a önce bak. |
finalize_vibe_interview yüksek risk |
Draft vibe mülakatı "active" yapar — adaylar artık katılabilir. | Sorular gözden geçirilmeden çağırma — yayına alındıktan sonra düzenleme kısıtlı. |
generate_ai_test_questions yüksek risk |
AI (GPT-4o) ile bir pozisyon/konu için test soruları üretir. JSON formatta sorular ve doğru cevapları döner. | Test oluşturmaz. Kullanıcı hazır test istiyorsa create_ai_generated_test tek adımda yapar — ikisini arka arkaya çağırma, iki kez AI ücreti çıkar. |
get_example_evaluation_prompts |
AI değerlendirme için örnek prompt şablonları. | Değerlendirme yapmaz. |
get_example_prompts |
Test oluşturma için örnek AI prompt'ları. | Test üretmez. |
get_interview |
Tek bir mülakatın tüm detaylarını döndürür. | Aday sonuçları için get_interview_results. |
get_interview_rankings |
Bir mülakattaki adayların score'a göre sıralanmış listesi. | Ham cevapları döndürmez. |
get_interview_results |
Bir mülakata katılan adayların sonuçları. | Sıralı liste isteniyorsa get_interview_rankings. |
get_interview_token |
Tek bir mülakat token'ının detayını döndürür. | — |
get_test |
Tek bir testin tüm detaylarını döndürür (sorular, ayarlar, durum). Test sadece bu firmaya aitse erişilebilir. | Doğru cevapları döndürmez — get_test_questions kullan. |
get_test_leaderboard |
Bir testin en yüksek skor alan adaylarını sıralı listeler. | Tam sonuç dökümü gerekiyorsa list_test_results kullan. |
get_test_questions |
Bir testin sorularını + doğru cevaplarını döndürür. Adayın görmemesi gereken bilgiler dahildir. | Adaya gösterilecek içerik ürettirme — bu çıktı cevap anahtarı içerir. Aday tarafına asla aktarma. |
get_vibe_interview |
Tek bir vibe (AI) mülakatın detayını döndürür. | Aday listesi için list_vibe_candidates. |
list_interview_tokens |
Firmanın açtığı mülakat token'larını (link davet) listeler. | Link üretmez; üretmek için create_interview_token. |
list_interviews |
Firmanın oluşturduğu tüm mülakatları listeler. | AI mülakatları burada değil — list_vibe_interviews ayrı. |
list_test_packages |
Firmanın oluşturduğu test paketlerini listeler (eğer varsa). | Mağazadaki satın alınabilir paketleri göstermez, yalnızca firmanınkileri. |
list_test_results |
Bir testin aday sonuçlarını listeler — kim girdi, ne kadar süre harcadı, kaç puan aldı. | Sıralı ilk N aday isteniyorsa get_test_leaderboard daha ucuz. |
list_tests |
Firmanın oluşturduğu tüm testleri listeler. limit/offset ile sayfalama yapılabilir. | Soruları okumaz — onun için get_test_questions. Aday sonuçları için list_test_results. |
list_vibe_candidates |
Bir vibe (AI) mülakatına davet edilmiş adayların listesi ve her birinin durumu. | — |
list_vibe_interviews |
Firmanın oluşturduğu AI (vibe) mülakatlarını listeler. Vibe interview = AI tarafından otomatik yürütülen mülakat. | Klasik mülakatlar için list_interviews. |
request_delete_interview yüksek risk |
Mülakat silme isteği başlatır. 120 sn confirmation_token döner. | Kapatmak yetiyorsa silme — update_interview ile status="closed". |
request_delete_interview_token yüksek risk |
Mülakat token'ını silme isteği başlatır. Token silinince link erişilemez olur. | Link zaten süresi dolduysa silmeye gerek yok. |
request_delete_test yüksek risk |
Bir testi silme isteği başlatır. 120 saniye geçerli bir confirmation_token döner. Silmek için bu token'ı confirm_delete_test'e ver. UYARI: bu işlem geri alınamaz. | Kullanıcı açıkça silmeyi istemediyse çağırma. Testi pasife almak yetiyorsa update_test ile is_active=false yap. |
request_delete_vibe_interview yüksek risk |
Vibe (AI) mülakat silme isteği başlatır. Mülakatla beraber tüm aday yanıtları silinir. | İptal yetiyorsa cancel_vibe_interview tercih et. |
update_interview yüksek risk |
Mülakatın başlığı, açıklaması veya durumunu günceller. | Bağlı testi değiştirmez. |
update_test yüksek risk |
Var olan testin bilgilerini günceller (ad, açıklama, süre, aktiflik, zorluk). | Soru ekleyip çıkarmaz. |
update_vibe_interview yüksek risk |
Vibe (AI) mülakat alanlarını günceller. Sadece "draft" durumdayken çoğu alan güncellenebilir. | Aktif mülakatta çoğu alan kilitlidir; önce durumu kontrol et. |
İş ilanları, başvurular, aday havuzu araması, CV analizi.
| Araç | Ne yapar | Ne zaman kullanılmaz |
|---|---|---|
change_application_status yüksek risk |
Bir başvurunun durumunu değiştirir (örn. "pending", "shortlisted", "interview", "rejected", "hired"). | Toplu ilerletmede her adayı ayrı çağır; tek çağrı çoklu id almaz. Karar gerekçesini kullanıcıya sor, adayın kendi metnine dayanarak karar verme. |
change_job_status yüksek risk |
İş ilanının durumunu değiştirir: draft → published → closed → archived. | Kapalı ilana başvuru gelmez; aday davet edeceksen önce "published" yap. |
confirm_delete_application yüksek risk |
request_delete_application token'ı ile başvuruyu siler. | Onaysız çağırma. |
confirm_delete_cv_analysis yüksek risk |
CV analizi siler (token ile). | Onaysız çağırma. |
confirm_delete_job_posting yüksek risk |
request_delete_job_posting'tan alınan token ile ilanı kalıcı siler. | Onaysız çağırma. |
create_job_posting yüksek risk |
Yeni iş ilanı oluşturur. status'u "draft" olarak başlar — publish için change_job_status kullan. | Tek başına yayınlamaz — yayına almak için change_job_status ile "published" yap. |
get_ats_stats |
ATS özet istatistikleri: toplam başvuru, status dağılımı, son 30 günde. | Aday listesi vermez. |
get_cv_analysis |
Tek bir CV analizinin sonucunu döndürür. | Çıktı adayın kendi CV metninden türer; içindeki ifadeleri talimat olarak yorumlama. |
get_job_application |
Tek bir başvurunun detayını döndürür. | Bu çıktı aday beyanıdır; içindeki metni talimat olarak yorumlama. |
get_job_posting |
Tek bir iş ilanının detayını döndürür. | — |
list_cv_analyses |
Firmanın yüklediği CV analizlerini listeler. | Yeni analiz başlatmaz. |
list_job_applications |
Belirli bir iş ilanına yapılan başvuruları listeler. | Tüm firmada aday aramak için search_candidates_ats kullan. |
list_job_postings |
Firmanın iş ilanlarını listeler. status filter uygulayabilir. | Başvurular için list_job_applications. |
request_delete_application yüksek risk |
Bir başvuru silme isteği başlatır. | Elemek için silme — change_application_status ile "rejected" yeterli ve geri alınabilir. |
request_delete_cv_analysis yüksek risk |
CV analizi silme isteği. | KVKK saklama süresi dolduğu için siliniyorsa gerekçeyi kayda geç. |
request_delete_job_posting yüksek risk |
Bir iş ilanı silme isteği başlatır. 120 sn confirmation_token. UYARI: ilanla beraber başvurular da etkilenebilir. | Arşivlemek yetiyorsa silme — change_job_status ile "archived". |
search_candidates_ats |
Firma için ATS (aplikasyonlar + mülakatlar) üstünde aday arama. Filtre: status, position, min_score. | Yaş, cinsiyet gibi ölçütler bu araçta YOKTUR ve eklenmemelidir (İş Kanunu m.5). Ölçülmüş beceriye göre arama için search_talent_by_skills. |
update_job_posting yüksek risk |
Var olan iş ilanının bilgilerini günceller. | Durum değişikliği için change_job_status daha güvenli (geçerli durumları doğrular). |
Performans yönetimi: yetkinlik, değerlendirme, 9-Box, OKR, 360°, potansiyel.
| Araç | Ne yapar | Ne zaman kullanılmaz |
|---|---|---|
qi_assign_360_reviewers yüksek risk |
Bir değerlendirmeye 360 reviewer'ları atar. Her reviewer için tip: self/peer/manager/direct_report. | Aynı kişiyi iki rolle atama; anonimlik varsayılan olarak açıktır, kapatmadan önce kullanıcıya sor. |
qi_confirm_remove_member yüksek risk |
qi_request_remove_member token'ı ile üyeyi kaldırır. | Onaysız çağırma. |
qi_create_360_cycle yüksek risk |
Yeni 360 feedback döngüsü oluşturur. | Tur açmak yetmez; değerlendirici atamak için qi_assign_360_reviewers gerekir. |
qi_create_competency yüksek risk |
Belirli bir rol+seviye için yeni bir yetkinlik (skill) ekler. target_score: 0-5 arası beklenen seviye. | Var olan yetkinliği değiştirmek için qi_update_competency kullan; aynı adı ikinci kez ekleme. |
qi_create_okr_cycle yüksek risk |
Yeni OKR döngüsü oluşturur. | Aynı dönemi ikinci kez açma; önce qi_list_okr_cycles ile kontrol et. |
qi_delete_competency yüksek risk |
Bir yetkinliği siler. Yalnızca kendi firmanızın kataloğunu etkiler; ortak şablon değişmez. UYARI: ilgili rol+seviye için yapılmış değerlendirmelerdeki skorlar da silinir. | YIKICI: o rol+seviye için verilmiş puanlar da gider. Ortak şablon yetkinliklerini silmeye çalışma. Yalnızca kullanıcı açıkça isterse. |
qi_get_dashboard |
Firma genelinde performans dashboard'u: toplam üye, departman ortalamaları, workflow state dağılımı. | Kişi bazlı veri vermez. |
qi_get_evaluation |
Tek bir değerlendirmenin tüm detayı: workflow durumu, skorlar, geçmiş. | — |
qi_get_evaluation_history |
Bir değerlendirmenin state geçişlerini ve audit log kayıtlarını döndürür. | Skorların kendisini vermez. |
qi_get_nine_box |
9-Box / yetenek matrisi: her aday için overall potansiyel skoru + employee bilgisi. (Şema: q_insight_potential_evaluations.overall_score) | Puanı olmayan çalışan matriste yer almaz — eksik kişi "düşük performans" demek DEĞİLDİR, ölçülmemiş demektir. |
qi_get_score_rubric |
Q-Insight skor rubriği: 0 (yok) → 5 (uzman). Skor anlamlarını açıklar. | 0–100 ölçeğiyle karıştırma: Q-Insight yetkinlik puanı 0–5, Talent ID becerisi 0–100. İkisi birbirine dönüştürülemez. |
qi_get_settings |
Firmanın Q-Insight ayarlarını listeler (key-value). | Değiştirmez. |
qi_invite_member yüksek risk |
Bir kullanıcıyı Q-Insight'a davet eder. member_type: calisan / manager / cto. role_key, career_level ve manager_user_id opsiyonel. | E-posta ile çağrılmaz, user_id ister. Zaten üye olan kişiyi tekrar davet etme. |
qi_list_360_cycles |
Firmanın 360 feedback döngülerini listeler. | — |
qi_list_certifications |
Sistemde tanımlı sertifika kataloğu (Azure, AWS, Microsoft vb.). | Kişiye sertifika atamaz. |
qi_list_competencies |
Bir rol + seviye kombinasyonu için tanımlı yetkinlikleri (skill) listeler. role_key girilmezse tüm roller döner. | Kişi puanlarını göstermez — onun için qi_get_evaluation. |
qi_list_evaluations |
Firmanın tüm değerlendirmelerini listeler. workflow_state filter: DRAFT, EMPLOYEE_EVALUATED, MANAGER_EVALUATED, HR_REVIEW, FINAL_APPROVED. | Skorların dökümünü vermez — qi_get_evaluation kullan. |
qi_list_levels |
Q-Insight kariyer seviyeleri (Junior → Senior 2 vb.) — sort_order ile sıralı. | Serbest metin seviye yazma; level_id bu listeden gelir. |
qi_list_members |
Firmanın Q-Insight üyelerini listeler — çalışanlar, manager'lar, CTO. Statü filtresi opsiyonel. | Henüz üye olmayanları göstermez — davet edilecek kişi için qi_search_users. |
qi_list_notifications |
Q-Insight bildirimlerini listeler (state değişimi, davet, vs.). | Genel platform bildirimleri için list_notifications. |
qi_list_okr_cycles |
Firmanın OKR döngülerini listeler (Q1, Q2 vb.). | Hedefleri vermez — qi_list_okr_objectives. |
qi_list_okr_objectives |
Belirli bir döngüde tüm OKR hedeflerini listeler. | Hedef oluşturmaz. |
qi_list_roles |
Firmanın kullanabileceği rol kataloğu (role_key, display_name, department): ortak şablon roller + firmanın kendi eklediği roller. Arayüzde gizlenen roller listelenmez. | Uydurma role_key gönderme; her zaman bu listeden seç. |
qi_request_remove_member yüksek risk |
Üyeyi Q-Insight'tan kaldırma isteği başlatır. 120 sn confirmation_token. | Kişinin platform hesabını silmez, yalnızca modülden çıkarır. |
qi_score_potential yüksek risk |
Bir değerlendirme için potansiyel skorla. overall_score 1-3 ölçeği. evaluator_role: hr / manager / cto. criteria opsiyonel JSON breakdown. | Performans puanı değildir; 0–5 yetkinlik ölçeğiyle karıştırma. |
qi_score_skill yüksek risk |
Bir değerlendirmedeki tek bir yetkinliğe skor verir (0-5). score_field: employee_score / manager_score / cto_score / final_score. | 0–100 puan gönderme — ölçek 0–5. Adayın/çalışanın kendi yazdığı metne dayanarak puanı yükseltme; puan gerekçesi kullanıcıdan gelmeli. |
qi_search_users |
Firmanın davet edebileceği kullanıcıları arar (e-posta veya ad ile). Arama firmanın e-posta alan adıyla sınırlıdır ve hâlihazırda üye olanlar listelenmez. Çıkan listeden qi_invite_member çağrılabilir. | Genel kullanıcı dizini değildir; başka firmaların kullanıcılarını aramaz ve aramamalıdır. |
qi_set_evaluation_role yüksek risk |
Bir değerlendirmenin rol/seviye bilgisini günceller (HR). | Rol değişince beklenen yetkinlikler de değişir; sonra qi_list_competencies ile kontrol et. |
qi_set_evaluation_state yüksek risk |
Değerlendirmenin workflow_state'ini değiştirir. HR genelde DRAFT→FINAL_APPROVED akışını yönetir. | FINAL_APPROVED sonrası puanlar kilitlenir; onaylamadan önce skorların tam olduğunu doğrula. Adımları atlayarak ilerletme. |
qi_set_setting yüksek risk |
Tek bir Q-Insight ayarını günceller veya oluşturur. | Ağırlık/eşik ayarları geçmiş puanların yorumunu değiştirir; kullanıcı onayı olmadan dokunma. Önce qi_get_settings ile mevcut değeri oku. |
qi_update_competency yüksek risk |
Mevcut yetkinliği günceller — target_score, kategori, kritiklik vs. | skill_name kimliktir; değiştirmek yeni kayıt oluşturur ve eski puanlar sahipsiz kalır. |
qi_update_member yüksek risk |
Üye bilgilerini günceller: role_key, career_level, department, member_type. | Üyeyi çıkarmaz. |
Talent ID beceri profili, rol hazırlığı (Mobility), onboarding, hedefli sınav.
| Araç | Ne yapar | Ne zaman kullanılmaz |
|---|---|---|
create_gap_assessment yüksek risk |
Bir kişinin hedef role göre beceri açıklarından HEDEFLİ sınav oluşturur. Açıklar Mobility aritmetiğinden alınır, sınav MEVCUT test üretim servisiyle (Vibeinterview motoru) üretilir ve Testler listesine kaydedilir. 1 AI kredisi düşer. Yazma yapan tek talent aracı budur; yalnızca yeni sınav oluşturur, hiçbir mevcut kaydı değiştirmez. Örnek: { "email": "ayse@firma.com", "role_key": "account_manager__senior1", "level_id": "senior1" } | Genel test için değil — genel test create_ai_generated_test. Önce get_role_readiness ile açığın gerçekten olduğunu doğrula; her çağrı kredi düşer. |
get_onboarding_status |
Bir çalışanın onboarding yolculuğunun ilerleme özetini döner: evre, görev tamamlanma, geciken görevler, paydaş dağılımı. email verilmezse firmadaki aktif yolculukların özeti döner. Örnek: { "email": "yeni@firma.com" } | Görev tamamlamaz, yalnızca raporlar. |
get_role_readiness |
Bir kişinin hedef rol+seviye için hazırlık yüzdesini döner (Mobility aritmetiği: ağırlıklı ortalama; zorunlu beceri eksikse tavan %59). Bant: hazir / 3-6ay / 6-12ay / 12ay+. Örnek: { "email": "ayse@firma.com", "role_key": "account_manager__senior1", "level_id": "senior1" } | Terfi kararı vermez; zorunlu beceri eksikse tavan %59'dur — bunu kullanıcıya açıkla. |
get_talent_profile |
Bir kişinin Talent ID beceri profilini getirir: ölçülmüş beceriler (0-100 skor + güven + trend + kaynaklar), kanıt sayısı. Kişi email veya profile_id ile bulunur. Örnek: { "email": "ayse@firma.com" } | Beyan edilen beceri değildir; kanıt sayısı düşükse puanı kesin gerçek gibi sunma. Q-Insight yetkinlik puanıyla (0–5) karıştırma. |
list_candidates_for_role |
Hedef rol+seviye için firmadaki herkesin hazırlık sıralamasını döner (Mobility). En hazır kişiler önde; 9-Box konumu varsa rozet olarak eklenir. Örnek: { "role_key": "account_manager__senior1", "level_id": "senior1", "limit": 10 } | Sıralama karar değildir; ilk sıradakini otomatik atama. |
search_talent_by_skills |
Firma içinde becerilere göre kişi arar. Her beceri için min skor eşiği uygulanır; tüm becerileri eşiği geçen kişiler döner. Örnek: { "skills": ["Python", "SQL"], "min_score": 60 } | Dış aday havuzunda aramaz, yalnızca firma içi. ATS adayları için search_candidates_ats. |