@akredit/acik-mcp 0.1.0 → 0.4.0

package/dist/apps/acik-mcp/src/sunucu.js

@@ -2,44 +2,109 @@
 // deterministiktir; araç açıklamaları ve yanıtlar Türkçedir. Gelen veride kişisel veri deseni görülürse
 // çağrı hesap yapılmadan reddedilir. Her yanıt kaynak listesi ve "YÖKAK ile bağı yoktur" notu taşır.
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { ACIK_ARACLAR, AKREDIT_NOTU, AracHatasi, DEPO } from "./araclar.js";
-import { kisiselVeriIletisi, kisiselVeriTurleri } from "./kisisel-veri.js";
+import { ACIK_ARACLAR, AKREDIT_NOTU, AracHatasi, DEPO, } from "./araclar.js";
+import { GIRIS_BILGISI_ILETISI, girisBilgisiVar, kisiselVeriIletisi, kisiselVeriTurleri } from "./kisisel-veri.js";
+import { ACIK_ISTEMLER, istemSemasi } from "./promptlar.js";
 export const SUNUCU_ADI = "akredit-acik";
-export const SUNUCU_SURUMU = "0.1.0";
-export const SUNUCU_TALIMATI = "Akredit açık araçları: YÖKAK ve program akreditasyonu (MÜDEK, FEDEK, SABAK, EPDAD) ölçüt metni, EPDAD göstergeleri, YÖKAK olgunluk düzeyleri, Bologna ders bilgisi denetimi, ÇK/PÇ sağlanma hesabı, öz değerlendirme iskeleti, rapor dil denetimi. Araçlar salt okumadır, kurum verisine erişmez, model çağırmaz. Kişisel veri (ad, numara, e-posta, telefon) göndermeyin; görülürse çağrı reddedilir. Ölçüt metnini yalnız olcut_getir sonucundan alıntılayın; DOĞRULANMADI ya da 'Belgeden okunamadı' işaretli metni tahminle doldurmayın. Programın disiplinini ya da programa özgü bölümünü siz tahmin etmeyin, kurum seçer. Sayıları yalnız araç sonucundan alın. Öz değerlendirme iskeleti metin içermez: kanıtı olmayan cümleyi EKSİK bırakın. Akredit'in YÖKAK ile bağı yoktur.";
+export const SUNUCU_SURUMU = "0.4.0";
+export const SUNUCU_TALIMATI = [
+    "Akredit açık araçları öğretim elemanlarına kalite ve akreditasyon işlerinde yardım eder: Bologna ders paketi denetimi ve doldurma, öğrenme çıktısı yazma, ÇK/PÇ hesabı, YÖKAK ve program akreditasyonu (MÜDEK, FEDEK, SABAK, EPDAD) ölçüt ve kanıt rehberi, rapor dil denetimi, kaynak doğrulama.",
+    "Hoca ne yapacağını söylemediyse ya da 'akredit' yazarsa 'akredit' istemindeki araç menüsünü göster ve önce hangi aracı kullanmak istediğini sor.",
+    "Amaç: hocanın en az müdahalesiyle işi hızlı ama denetimli ve teyitli bitirmek. Her seçim menüsünde son seçenek '4) Hepsini akıllıca doldur (önerilen)' olur: her alan için en iyi seçeneği sen seçersin, araçla denetlersin, geçmeyeni düzeltip yeniden denetlersin, sonunda tek özet gösterip değiştirmek istediği numarayı sorarsın.",
+    "Giriş bilgisi: hocadan kullanıcı adı, parola, doğrulama kodu ya da çerez asla isteme; hoca yazarsa kullanma, araçlara gönderme, silmesini ve parolasını değiştirmesini öner. Hoca giriş bilgisini yalnız OBS'nin kendi ekranına kendisi yazar. CAPTCHA'yı hoca çözer. OBS'de Kaydet'e yalnız hocanın açık izniyle basarsın; onaya Gönder düğmesine hoca basar.",
+    "Tarayıcı aracın varsa OBS sayfasını okuyup formu doldurabilirsin; yoksa ya da engel çıkarsa engel_coz ve kurulum_yardimi araçlarının adımlarını hocaya sırayla, tek tek göster. Tarayıcı yoksa OBS'ye yazma alan alan kopyalamaya düşer.",
+    "Sunucu model çağırmaz ve metin üretmez: seçenekleri sen yazarsın, sunucu kural ve kalıp verir, denetler ve sayıları hesaplar. Sayıları yalnız araç sonucundan al.",
+    "Bologna sayfasındaki Dersi Verenler, Yardımcılar ve Koordinatör satırları yayımlanmış görev bilgisidir: olduğu gibi okunur, korunur, değiştirilmez. Öğrenci adı ve numarası içeren not tabloları takma adla işlenir. Sunucu istek içeriğini günlüğe yazmaz.",
+    "Kaynak önerirken hocaya kitap adını sorma: kendi web arama aracınla ders içeriğine uygun eserleri bul, kaynak_dogrula ile doğrula, yalnız doğrulananları künyesi ve bağlantısıyla göster. Doğrulanamayan kaynağı asla önerme. Ölçüt metnini yalnız olcut_getir sonucundan alıntılayın; DOĞRULANMADI ya da 'Belgeden okunamadı' işaretli metni tahminle doldurmayın. Programın disiplinini kurum seçer. Kanıtı olmayan cümle EKSİK kalır. Kitap, kişi, tarih uydurmayın.",
+    "Sunucu kullanıcıdan adres çekmez: Bologna sayfasını hoca yapıştırır ya da siz kendi web aracınızla okursunuz. Tek dış istek kaynak_dogrula'nın sabit katalog adresleridir (Crossref, Open Library, Google Books). Onay ve dış kuruma gönderim hocadadır. Akredit'in YÖKAK ile bağı yoktur.",
+].join(" ");
 const metinSonuc = (veri, isError = false) => ({
     content: [{ type: "text", text: JSON.stringify(veri, null, 2) }],
     structuredContent: veri,
     ...(isError ? { isError: true } : {}),
 });
-/** Bir aracı doğrudan çalıştırır (MCP katmanı dışında da kullanılabilir: test, belge). */
-export function aracCalistir(a, girdi, b) {
-    const turler = kisiselVeriTurleri(girdi);
+/** Denetimler (giriş bilgisi, kişisel veri, şema). Geçerse doğrulanmış girdiyi, geçmezse hata sonucunu döndürür. */
+function hazirla(a, girdi) {
+    const ayik = a.onAyikla ? a.onAyikla(girdi) : { girdi, atilan: [], ileti: undefined };
+    girdi = ayik.girdi;
+    if (girisBilgisiVar(girdi))
+        return { hata: { veri: { hata: GIRIS_BILGISI_ILETISI, kod: "giris_bilgisi", not: AKREDIT_NOTU }, hata: true } };
+    const turler = kisiselVeriTurleri(girdi, a.kunyeAlanlari, a.kisiselVeriKapsami ?? "ogrenci");
     if (turler.length)
-        return { veri: { hata: kisiselVeriIletisi(turler), kod: "kisisel_veri", not: AKREDIT_NOTU }, hata: true };
+        return {
+            hata: {
+                veri: {
+                    hata: [kisiselVeriIletisi(turler), a.kisiselVeriIpucu].filter(Boolean).join(" "),
+                    kod: "kisisel_veri",
+                    not: AKREDIT_NOTU,
+                },
+                hata: true,
+            },
+        };
     const g = a.girdi.safeParse(girdi);
     if (!g.success) {
         const alanlar = g.error.issues.slice(0, 5).map((i) => `${i.path.join(".") || "girdi"}: ${i.message}`);
         return {
-            veri: {
-                hata: "Girdi geçersiz. Alanları düzeltip yeniden deneyin.",
-                kod: "gecersiz_girdi",
-                alanlar,
-                not: AKREDIT_NOTU,
+            hata: {
+                veri: {
+                    hata: "Girdi geçersiz. Aşağıdaki alanları düzeltip yeniden deneyin.",
+                    kod: "gecersiz_girdi",
+                    alanlar,
+                    not: AKREDIT_NOTU,
+                },
+                hata: true,
             },
-            hata: true,
         };
     }
+    return { veri: g.data, atilan: ayik.atilan, ileti: ayik.ileti };
+}
+function basari(a, s, atilan, ileti) {
+    return {
+        veri: {
+            sonuc: s.sonuc,
+            sonrakiAdim: s.sonrakiAdim ?? a.sonrakiAdim,
+            ...(atilan.length
+                ? { atilan: ileti ?? `Şu kısımlar okunmadan atıldı, hiçbir yere yazılmadı: ${atilan.join(", ")}.` }
+                : {}),
+            kaynak: s.kaynak,
+            not: AKREDIT_NOTU,
+            kod_deposu: DEPO,
+        },
+        hata: false,
+    };
+}
+function hataSonucu(e) {
+    const ileti = e instanceof AracHatasi ? e.message : "Beklenmeyen bir sorun oluştu. Girdiyi denetleyip yeniden deneyin.";
+    return {
+        veri: { hata: ileti, kod: e instanceof AracHatasi ? "arac_hatasi" : "beklenmeyen", not: AKREDIT_NOTU },
+        hata: true,
+    };
+}
+/** Bir aracı doğrudan çalıştırır (MCP katmanı dışında da kullanılabilir: test, belge). Yalnız eşzamanlı araçlar. */
+export function aracCalistir(a, girdi, b) {
+    const h = hazirla(a, girdi);
+    if ("hata" in h)
+        return h.hata;
     try {
-        const s = a.calistir(g.data, b);
-        return { veri: { sonuc: s.sonuc, kaynak: s.kaynak, not: AKREDIT_NOTU, kod_deposu: DEPO }, hata: false };
+        const s = a.calistir(h.veri, b);
+        if (s instanceof Promise)
+            throw new Error("Eşzamansız araç için aracCalistirAsenkron kullanın.");
+        return basari(a, s, h.atilan, h.ileti);
     }
     catch (e) {
-        const ileti = e instanceof AracHatasi ? e.message : "Beklenmeyen bir sorun oluştu. Girdiyi denetleyip yeniden deneyin.";
-        return {
-            veri: { hata: ileti, kod: e instanceof AracHatasi ? "arac_hatasi" : "beklenmeyen", not: AKREDIT_NOTU },
-            hata: true,
-        };
+        return hataSonucu(e);
+    }
+}
+/** Her araç için (eşzamanlı ya da eşzamansız) çalıştırma; MCP katmanı bunu kullanır. */
+export async function aracCalistirAsenkron(a, girdi, b) {
+    const h = hazirla(a, girdi);
+    if ("hata" in h)
+        return h.hata;
+    try {
+        return basari(a, await a.calistir(h.veri, b), h.atilan, h.ileti);
+    }
+    catch (e) {
+        return hataSonucu(e);
     }
 }
 /** Yeni bir McpServer kurar. Durumsuz HTTP'de her istek için, stdio'da süreç başına bir kez çağrılır. */
@@ -50,7 +115,10 @@ export function acikSunucu(s = {}) {
         title: "Akredit (açık araçlar)",
         version: SUNUCU_SURUMU,
         websiteUrl: "https://akredit.org/mcp-kullan",
-    }, { instructions: SUNUCU_TALIMATI, capabilities: { tools: { listChanged: false } } });
+    }, {
+        instructions: SUNUCU_TALIMATI,
+        capabilities: { tools: { listChanged: false }, prompts: { listChanged: false } },
+    });
     for (const a of s.araclar ?? ACIK_ARACLAR) {
         sunucu.registerTool(a.ad, {
             title: a.baslik,
@@ -58,11 +126,22 @@ export function acikSunucu(s = {}) {
             // Şema SDK'ya yalnız tanıtım (JSON şeması) içindir; asıl doğrulama aracCalistir içinde, kişisel veri
             // denetiminden sonra yapılır. Bu yüzden girdi gevşek (loose) verilir.
             inputSchema: a.girdi.loose(),
-            annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+            annotations: {
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: a.disAg === true,
+            },
         }, async (girdi) => {
-            const r = aracCalistir(a, girdi, { simdi });
+            const r = await aracCalistirAsenkron(a, girdi, { simdi, ...(s.fetch ? { fetch: s.fetch } : {}) });
             return metinSonuc(r.veri, r.hata);
         });
     }
+    for (const i of s.istemler ?? ACIK_ISTEMLER) {
+        sunucu.registerPrompt(i.ad, { title: i.baslik, description: i.aciklama, argsSchema: istemSemasi(i) }, (a) => ({
+            description: i.aciklama,
+            messages: [{ role: "user", content: { type: "text", text: i.metin(a) } }],
+        }));
+    }
     return sunucu;
 }

package/dist/apps/acik-mcp/src/temel.d.ts

@@ -0,0 +1,54 @@
+import type { z } from "zod";
+import type { KisiselVeriKapsami } from "./kisisel-veri.ts";
+export declare const DEPO = "https://github.com/tialkan/akredit";
+/** Her yanıtta yer alan not. */
+export declare const AKREDIT_NOTU = "Akredit ba\u011F\u0131ms\u0131z, a\u00E7\u0131k kaynak bir ara\u00E7t\u0131r; Y\u00D6KAK ile ba\u011F\u0131 yoktur. Sonu\u00E7lar resm\u00EE de\u011Ferlendirme yerine ge\u00E7mez; beyan ve karar kurumdad\u0131r.";
+export interface Kaynak {
+    ad: string;
+    adres: string;
+    sayfa?: number | null;
+    sha256?: string | null;
+    erisimTarihi?: string;
+}
+export interface AracSonucu {
+    sonuc: unknown;
+    kaynak: Kaynak[];
+    /** Asistana bir sonraki adım önerisi; verilmezse aracın varsayılanı kullanılır. */
+    sonrakiAdim?: string;
+}
+export interface AracBaglami {
+    simdi: () => Date;
+    /** Dış istek için fetch; testlerde sahtesi verilir. Verilmezse genel fetch kullanılır. */
+    fetch?: typeof fetch;
+}
+export interface AcikArac<S extends z.ZodObject = z.ZodObject> {
+    ad: string;
+    baslik: string;
+    aciklama: string;
+    girdi: S;
+    /** Yanıtta dönen varsayılan "sonraki adım" önerisi. */
+    sonrakiAdim: string;
+    /** Kişisel veri reddinde iletiye eklenecek, bu araca özgü ipucu. */
+    kisiselVeriIpucu?: string;
+    /**
+     * Kişisel veri denetiminden önce, yalnız bellekte çalışan ayıklama. Atılan değerler hiçbir yere yazılmaz;
+     * yalnız atılan alanların adları döner. Ayıklamadan sonra kalan girdi yine denetlenir.
+     */
+    onAyikla?: (girdi: unknown) => {
+        girdi: unknown;
+        atilan: string[];
+        ileti?: string;
+    };
+    /** Kişisel veri denetiminin kapsamı; varsayılan "ogrenci" (bkz. kisisel-veri.ts). */
+    kisiselVeriKapsami?: KisiselVeriKapsami;
+    /** Araç dış ağa (yalnız izinli hostlara) istek atar mı. */
+    disAg?: boolean;
+    /** Künye kuralıyla denetlenen alan adları: altındaki yazar adları kişisel veri sayılmaz (e-posta, telefon yine sayılır). */
+    kunyeAlanlari?: readonly string[];
+    calistir: (girdi: z.infer<S>, b: AracBaglami) => AracSonucu | Promise<AracSonucu>;
+}
+export declare const arac: <S extends z.ZodObject>(a: AcikArac<S>) => AcikArac<S>;
+/** Araç girdisi hatası: kullanıcıya gösterilecek Türkçe ileti. */
+export declare class AracHatasi extends Error {
+}
+export declare const KOD_KAYNAGI: (yol: string, ad: string) => Kaynak;

package/dist/apps/acik-mcp/src/temel.js

@@ -0,0 +1,10 @@
+// Araçların ortak yapı taşları: araç tanımı, hata türü, kaynak biçimi ve her yanıttaki not.
+// Ayrı dosyadadır, çünkü hem ölçüt araçları (araclar.ts) hem Bologna araçları (bologna.ts) kullanır.
+export const DEPO = "https://github.com/tialkan/akredit";
+/** Her yanıtta yer alan not. */
+export const AKREDIT_NOTU = "Akredit bağımsız, açık kaynak bir araçtır; YÖKAK ile bağı yoktur. Sonuçlar resmî değerlendirme yerine geçmez; beyan ve karar kurumdadır.";
+export const arac = (a) => a;
+/** Araç girdisi hatası: kullanıcıya gösterilecek Türkçe ileti. */
+export class AracHatasi extends Error {
+}
+export const KOD_KAYNAGI = (yol, ad) => ({ ad, adres: `${DEPO}/tree/main/${yol}` });

package/dist/apps/acik-mcp/src/yardim.d.ts

@@ -0,0 +1,56 @@
+import { z } from "zod";
+export interface Adim {
+    no: number;
+    yap: string;
+    /** Adımdan sonra ekranda ne görüleceği. */
+    goreceginiz?: string;
+    /** Menü ya da düğme adı sürüme göre değişebilir, doğrulanmadı. */
+    degisebilir?: boolean;
+}
+/** Her rehberin başında hocaya söylenecek giriş kuralı. */
+export declare const GIRIS_KURALI_HOCAYA = "Kullan\u0131c\u0131 ad\u0131n\u0131z\u0131 ve parolan\u0131z\u0131 yaln\u0131z OBS'nin kendi giri\u015F ekran\u0131na, kendiniz yaz\u0131n. Bana, sohbete ya da Akredit'e asla yazmay\u0131n. Do\u011Frulama kodu (SMS, e-posta) ve CAPTCHA da yaln\u0131z sizindir.";
+export declare const MCP_ADRESI = "https://akredit.org/mcp";
+export declare const ISTEMCILER: readonly ["claude_web", "claude_masaustu", "claude_chrome", "chatgpt", "cursor", "vscode", "claude_code"];
+export type Istemci = (typeof ISTEMCILER)[number];
+/** Bağlayıcı ekleme adımları; site (akredit.org ana sayfası) aynı adımları buradan okur. */
+export declare function baglayiciAdimlari(istemci: Istemci): Adim[];
+export declare const ENGELLER: readonly ["tarayici_araci_yok", "site_acilmiyor", "giris_duvari", "captcha", "cerceve", "oturum_dustu", "sayfa_okunamiyor", "kaydet_basilamiyor", "akredit_gorunmuyor"];
+export type Engel = (typeof ENGELLER)[number];
+export declare const kurulumYardimiAraci: import("./temel.ts").AcikArac<z.ZodObject<{
+    istemci: z.ZodEnum<{
+        claude_web: "claude_web";
+        claude_masaustu: "claude_masaustu";
+        claude_chrome: "claude_chrome";
+        chatgpt: "chatgpt";
+        cursor: "cursor";
+        vscode: "vscode";
+        claude_code: "claude_code";
+    }>;
+    konu: z.ZodDefault<z.ZodEnum<{
+        baglayici: "baglayici";
+        hepsi: "hepsi";
+        tarayici: "tarayici";
+    }>>;
+}, z.core.$strip>>;
+export declare const engelCozAraci: import("./temel.ts").AcikArac<z.ZodObject<{
+    engel: z.ZodEnum<{
+        cerceve: "cerceve";
+        tarayici_araci_yok: "tarayici_araci_yok";
+        site_acilmiyor: "site_acilmiyor";
+        giris_duvari: "giris_duvari";
+        captcha: "captcha";
+        oturum_dustu: "oturum_dustu";
+        sayfa_okunamiyor: "sayfa_okunamiyor";
+        kaydet_basilamiyor: "kaydet_basilamiyor";
+        akredit_gorunmuyor: "akredit_gorunmuyor";
+    }>;
+    istemci: z.ZodOptional<z.ZodEnum<{
+        claude_web: "claude_web";
+        claude_masaustu: "claude_masaustu";
+        claude_chrome: "claude_chrome";
+        chatgpt: "chatgpt";
+        cursor: "cursor";
+        vscode: "vscode";
+        claude_code: "claude_code";
+    }>>;
+}, z.core.$strip>>;

package/dist/apps/acik-mcp/src/yardim.js

@@ -0,0 +1,371 @@
+// Kurulum ve engel çözme rehberi. Metinler sabittir, model üretmez. Hocanın kendi OBS'sine tarayıcıyla girmesi
+// için adımlar verir. Değişmez kural: kullanıcı adı, parola ve doğrulama kodu yalnız OBS'nin kendi ekranına,
+// hocanın kendisi tarafından yazılır; asistana ve Akredit'e hiç yazılmaz. CAPTCHA'yı hoca çözer. OBS'de Kaydet'e
+// hoca ya da hocanın açık izniyle asistan basar; onaya Gönder düğmesine hoca basar.
+//
+// Menü ve düğme adları istemcinin sürümüne göre değişir. Doğrulanmamış adlar `degisebilir: true` ile işaretlidir.
+import { z } from "zod";
+import { arac, KOD_KAYNAGI } from "./temel.js";
+const numarala = (xs) => xs.map(([yap, goreceginiz, degisebilir], i) => ({
+    no: i + 1,
+    yap,
+    ...(goreceginiz ? { goreceginiz } : {}),
+    ...(degisebilir ? { degisebilir: true } : {}),
+}));
+/** Her rehberin başında hocaya söylenecek giriş kuralı. */
+export const GIRIS_KURALI_HOCAYA = "Kullanıcı adınızı ve parolanızı yalnız OBS'nin kendi giriş ekranına, kendiniz yazın. Bana, sohbete ya da Akredit'e asla yazmayın. Doğrulama kodu (SMS, e-posta) ve CAPTCHA da yalnız sizindir.";
+export const MCP_ADRESI = "https://akredit.org/mcp";
+export const ISTEMCILER = [
+    "claude_web",
+    "claude_masaustu",
+    "claude_chrome",
+    "chatgpt",
+    "cursor",
+    "vscode",
+    "claude_code",
+];
+const ISTEMCI_ADI = {
+    claude_web: "Claude (claude.ai, web)",
+    claude_masaustu: "Claude masaüstü uygulaması",
+    claude_chrome: "Claude in Chrome (Chrome eklentisi)",
+    chatgpt: "ChatGPT",
+    cursor: "Cursor",
+    vscode: "VS Code",
+    claude_code: "Claude Code",
+};
+const BAGLAYICI = {
+    claude_web: [
+        ["claude.ai adresine girin ve oturum açın.", "Sol tarafta sohbet listesi, ortada yazı kutusu."],
+        ["Sol alttaki adınıza tıklayın, Settings (Ayarlar) seçin.", "Ayarlar sayfası açılır.", true],
+        ["Connectors (Bağlayıcılar) bölümünü açın.", "Bağlı araçların listesi.", true],
+        ["Add custom connector (Özel bağlayıcı ekle) düğmesine basın.", "Ad ve adres soran küçük bir pencere.", true],
+        [`Ad olarak Akredit, adres olarak ${MCP_ADRESI} yazın ve Add (Ekle) deyin.`, "Listede Akredit görünür."],
+        [
+            "Yeni sohbet açın. Yazı kutusunun altındaki + düğmesinden Akredit'in açık olduğunu denetleyin.",
+            "Akredit'in yanında açık anahtar.",
+            true,
+        ],
+        [
+            "Yazı kutusuna akredit yazın ya da + menüsünden Akredit altındaki akredit başlangıcını seçin.",
+            "Odak menüsü: 1-5 arası seçenek.",
+        ],
+    ],
+    claude_masaustu: [
+        ["Claude masaüstü uygulamasını açın ve oturum açın.", "claude.ai ile aynı görünüm."],
+        [
+            "Sol alttaki adınızdan Settings (Ayarlar), ardından Connectors (Bağlayıcılar) bölümüne girin.",
+            "Bağlayıcı listesi.",
+            true,
+        ],
+        [`Add custom connector ile ad Akredit, adres ${MCP_ADRESI} olarak ekleyin.`, "Listede Akredit görünür.", true],
+        ["Yeni sohbette akredit yazın.", "Odak menüsü."],
+    ],
+    claude_chrome: [
+        ["Önce Claude'a Akredit bağlayıcısını ekleyin (Claude web adımları).", "Sohbette Akredit açık."],
+        [
+            "Chrome tarayıcısını açın. Chrome Web Mağazası'nda Claude eklentisini arayın (Claude in Chrome).",
+            "Eklentinin sayfası.",
+            true,
+        ],
+        ["Chrome'a ekle düğmesine basın, izin penceresinde onaylayın.", "Sağ üstte Claude simgesi.", true],
+        ["Yapboz simgesinden Claude'u sabitleyin (iğne simgesi).", "Claude simgesi araç çubuğunda kalır.", true],
+        ["Simgeye tıklayın, Claude hesabınızla oturum açın.", "Tarayıcının kenarında Claude paneli açılır.", true],
+        [
+            "OBS sayfanızı aynı pencerede açın; panelde akredit yazın.",
+            "Asistan OBS sayfasını okumak için izin ister; siz onaylarsınız.",
+        ],
+        [
+            "Eklenti bazı planlarda ya da kurum hesaplarında kapalı olabilir; o durumda kopyala-yapıştır yedeğini kullanın.",
+            undefined,
+            true,
+        ],
+    ],
+    chatgpt: [
+        ["chatgpt.com adresinde oturum açın.", "Sohbet ekranı."],
+        [
+            "Settings (Ayarlar), Apps (Uygulamalar), Advanced settings altında Developer mode (geliştirici kipi) seçeneğini açın.",
+            "Uygulama oluşturma düğmesi görünür.",
+            true,
+        ],
+        [
+            `Create (Oluştur) ile yeni uygulama ekleyin: ad Akredit, adres ${MCP_ADRESI}, kimlik doğrulama yok.`,
+            "Akredit araçları listelenir.",
+            true,
+        ],
+        ["İş ve kurum hesaplarında bu ayarı yönetici açar; açamıyorsanız yöneticinize sorun.", undefined, true],
+        ["Yeni sohbette Akredit'i seçin ve akredit yazın.", "Odak menüsü."],
+    ],
+    cursor: [
+        ["Cursor'da Settings (Ayarlar), ardından MCP bölümünü açın.", "MCP sunucu listesi.", true],
+        [
+            `Add new MCP server ile ad akredit, adres ${MCP_ADRESI} girin. Ya da .cursor/mcp.json dosyasına ekleyin.`,
+            "Akredit yeşil noktayla görünür.",
+            true,
+        ],
+        ["Sohbet panelinde eğik çizgi (/) yazın ve akredit seçin.", "Odak menüsü."],
+    ],
+    vscode: [
+        ["Komut paletini açın (Ctrl+Shift+P, Mac'te Cmd+Shift+P).", "Üstte arama kutusu."],
+        ["MCP: Add Server yazıp seçin, HTTP türünü seçin.", "Adres soran kutu.", true],
+        [`Adres olarak ${MCP_ADRESI}, ad olarak akredit yazın.`, "Akredit sunucu listesinde."],
+        ["Copilot sohbetinde ajan (Agent) kipini seçin, eğik çizgiyle akredit komutunu çalıştırın.", "Odak menüsü.", true],
+    ],
+    claude_code: [
+        [
+            `Uçbirimde şunu çalıştırın: claude mcp add --transport http akredit ${MCP_ADRESI}`,
+            "Added HTTP MCP server iletisi.",
+        ],
+        ["claude komutuyla oturumu açın, /mcp ile Akredit'in bağlı olduğunu denetleyin.", "akredit: connected.", true],
+        ["Eğik çizgiyle akredit komutunu seçin.", "Odak menüsü."],
+    ],
+};
+/** Bağlayıcı ekleme adımları; site (akredit.org ana sayfası) aynı adımları buradan okur. */
+export function baglayiciAdimlari(istemci) {
+    return numarala(BAGLAYICI[istemci]);
+}
+const TARAYICI = {
+    claude_web: [
+        [
+            "claude.ai web sürümü kendi başına OBS'nize giremez. Tarayıcı için Claude in Chrome eklentisini ya da masaüstü uygulamasını kullanın.",
+            undefined,
+        ],
+        [
+            "Bunlar yoksa kopyala-yapıştır yedeği: OBS'de ders sayfasını açın, Ctrl+A ile hepsini seçin, Ctrl+C ile kopyalayın, sohbete Ctrl+V ile yapıştırın.",
+            "Asistan sayfayı ayrıştırır.",
+        ],
+    ],
+    claude_masaustu: [
+        [
+            "Masaüstü uygulamasında sohbetin yanında tarayıcı paneli açılabilir. Panelin düğmesi ya da menüsü sürüme göre değişir.",
+            "Sohbetin yanında küçük bir tarayıcı.",
+            true,
+        ],
+        ["Asistandan OBS adresinizi açmasını isteyin ya da adresi panele siz yazın.", "OBS giriş ekranı."],
+        [
+            "Kullanıcı adınızı ve parolanızı panelde OBS'nin kendi kutularına kendiniz yazın. Sohbete yazmayın.",
+            "OBS ana sayfası.",
+        ],
+        [
+            "Asistana 'girdim' yazın. Asistan ders listesini ve Bologna sayfasını okur.",
+            "Ders listesi sohbette numaralı görünür.",
+        ],
+    ],
+    claude_chrome: [
+        ["Chrome'da yeni sekmede OBS adresinizi açın.", "OBS giriş ekranı."],
+        [
+            "Kullanıcı adınızı ve parolanızı OBS'nin kendi kutularına kendiniz yazın; varsa doğrulama kodunu ve CAPTCHA'yı siz girin.",
+            "OBS ana sayfası.",
+        ],
+        [
+            "Claude simgesine tıklayıp paneli açın, 'OBS'ye girdim' yazın.",
+            "Asistan sayfayı okumak için izin isteyebilir; onaylayın.",
+            true,
+        ],
+        ["Asistan ders listesini okur, dersinizi numarasıyla seçersiniz.", "Ders bilgi paketi alanları."],
+        [
+            "Asistan formu doldurursa her alanı gözle denetleyin. Kaydet'e siz basarsınız; isterseniz açık izninizle asistan basar. Onaya Gönder düğmesine siz basarsınız.",
+            "OBS'nin kayıt iletisi.",
+        ],
+    ],
+    chatgpt: [
+        [
+            "Yazı kutusundaki Araçlar (Tools) menüsünden Ajan modunu (Agent mode) seçin.",
+            "ChatGPT kendi tarayıcısını açar.",
+            true,
+        ],
+        ["OBS adresinizi açmasını isteyin.", "OBS giriş ekranı ajanın tarayıcısında."],
+        [
+            "Giriş ekranında Devral (Take over) düğmesine basın; kullanıcı adı ve parolayı kendiniz yazın. Sohbete yazmayın.",
+            "OBS ana sayfası.",
+            true,
+        ],
+        ["Denetimi asistana geri verin.", "Asistan sayfayı okur."],
+        ["Kaydet'e siz basarsınız ya da açık izninizle asistan basar. Onaya Gönder düğmesine siz basarsınız.", undefined],
+    ],
+    cursor: [
+        ["Cursor'un tarayıcı aracı sürüme göre değişir. Varsa asistandan OBS adresini açmasını isteyin.", undefined, true],
+        ["Yoksa kopyala-yapıştır yedeği: sayfada Ctrl+A, Ctrl+C, sohbete Ctrl+V.", "Asistan sayfayı ayrıştırır."],
+    ],
+    vscode: [
+        ["VS Code'da OBS'ye tarayıcıyla girmek için ek araç gerekir; bu en zor yoldur.", undefined, true],
+        [
+            "En kolayı kopyala-yapıştır: tarayıcınızda OBS sayfasında Ctrl+A, Ctrl+C, sohbete Ctrl+V.",
+            "Asistan sayfayı ayrıştırır.",
+        ],
+    ],
+    claude_code: [
+        [
+            "Claude Code'da tarayıcı için Claude in Chrome eklentisi bağlanabilir; adımlar sürüme göre değişir.",
+            undefined,
+            true,
+        ],
+        ["Yoksa kopyala-yapıştır yedeği: sayfada Ctrl+A, Ctrl+C, uçbirime yapıştırın.", "Asistan sayfayı ayrıştırır."],
+    ],
+};
+export const ENGELLER = [
+    "tarayici_araci_yok",
+    "site_acilmiyor",
+    "giris_duvari",
+    "captcha",
+    "cerceve",
+    "oturum_dustu",
+    "sayfa_okunamiyor",
+    "kaydet_basilamiyor",
+    "akredit_gorunmuyor",
+];
+const KOPYALA_YAPISTIR = [
+    ["Yedek yol: OBS'de ders bilgi paketi sayfasını kendiniz açın.", "Ders sayfası."],
+    ["Sayfanın boş bir yerine tıklayın, Ctrl+A ile hepsini seçin (Mac'te Cmd+A).", "Sayfa mavi seçilir."],
+    ["Ctrl+C ile kopyalayın (Mac'te Cmd+C).", undefined],
+    [
+        "Sohbete dönüp Ctrl+V ile yapıştırın ve gönderin.",
+        "Asistan alanları ayrıştırıp bulunan ve bulunamayan alanları söyler.",
+    ],
+];
+const ENGEL_ADIMLARI = {
+    tarayici_araci_yok: {
+        ad: "Asistanın tarayıcı aracı yok",
+        adimlar: [
+            [
+                "Claude kullanıyorsanız Claude in Chrome eklentisini kurun (kurulum_yardimi, istemci: claude_chrome).",
+                undefined,
+            ],
+            ["Claude masaüstü uygulamasında sohbetin yanındaki tarayıcı panelini açmayı deneyin.", undefined, true],
+            ["ChatGPT'de Araçlar menüsünden Ajan modunu seçin.", undefined, true],
+        ],
+        yedek: true,
+    },
+    site_acilmiyor: {
+        ad: "OBS sitesi açılmıyor",
+        adimlar: [
+            ["Adresi kendi tarayıcınızda açıp deneyin. Açılıyorsa adresi asistana olduğu gibi verin.", undefined],
+            [
+                "Kurum dışından erişim kapalı olabilir (VPN ya da kampüs ağı). Kurumunuzun bilgi işlem sayfasına bakın.",
+                undefined,
+            ],
+            ["Site bakımda olabilir; birkaç dakika sonra yeniden deneyin.", undefined],
+        ],
+        yedek: true,
+    },
+    giris_duvari: {
+        ad: "Giriş ekranı",
+        adimlar: [
+            ["Bu normaldir. Kullanıcı adınızı ve parolanızı OBS'nin kendi kutularına kendiniz yazın.", "OBS ana sayfası."],
+            [
+                "Asistana yalnız 'girdim' yazın. Parolayı sohbete yazmayın; yazdıysanız silin ve parolanızı değiştirin.",
+                undefined,
+            ],
+            ["e-Devlet ya da kurum tek oturum açma ekranı gelirse onu da kendiniz tamamlayın.", undefined],
+        ],
+        yedek: false,
+    },
+    captcha: {
+        ad: "Ben robot değilim (CAPTCHA) kutusu",
+        adimlar: [
+            ["CAPTCHA'yı siz çözün; asistan çözmez.", undefined],
+            ["Çözdükten sonra asistana 'devam' yazın.", "Asistan kaldığı yerden sürer."],
+        ],
+        yedek: false,
+    },
+    cerceve: {
+        ad: "Sayfa çerçeve (iframe) içinde, asistan içeriği göremiyor",
+        adimlar: [
+            [
+                "Ders sayfasındaki bağlantıya sağ tıklayın, Bağlantıyı yeni sekmede aç seçin.",
+                "Sayfa tek başına açılır.",
+                true,
+            ],
+            ["Asistandan bu yeni sekmeyi okumasını isteyin.", undefined],
+        ],
+        yedek: true,
+    },
+    oturum_dustu: {
+        ad: "Oturum düştü ya da süre doldu",
+        adimlar: [
+            ["OBS'ye yeniden kendiniz girin (kullanıcı adı ve parolayı yalnız OBS ekranına).", "OBS ana sayfası."],
+            [
+                "Kaydedilmemiş alanlar silinmiş olabilir. Asistandan son seçilen metni yeniden istemek için 'kopya metnini ver' yazın.",
+                undefined,
+            ],
+            ["Uzun formlarda her sekmeyi doldurduktan sonra Kaydet'e basın.", undefined],
+        ],
+        yedek: false,
+    },
+    sayfa_okunamiyor: {
+        ad: "Asistan sayfayı okuyamıyor ya da alanları bulamıyor",
+        adimlar: [
+            ["Sayfanın tamamen yüklendiğini bekleyin ve asistandan yeniden okumasını isteyin.", undefined],
+            ["Bologna sayfasında dersin Ders Bilgileri sekmesinde olduğunuzu denetleyin.", undefined, true],
+        ],
+        yedek: true,
+    },
+    kaydet_basilamiyor: {
+        ad: "Kaydet ya da Gönder",
+        adimlar: [
+            [
+                "Kaydet'e siz basarsınız; isterseniz asistan sizin açık izninizle (evet ya da bir kez hepsini kaydet) basar. Onaya Gönder düğmesine yalnız siz basarsınız.",
+                undefined,
+            ],
+            ["Basmadan önce alanları gözle denetleyin.", undefined],
+            ["Düğme pasifse zorunlu bir alan boş olabilir; OBS'nin kırmızı uyarısına bakın ve asistana söyleyin.", undefined],
+        ],
+        yedek: false,
+    },
+    akredit_gorunmuyor: {
+        ad: "Akredit araçları ya da akredit komutu görünmüyor",
+        adimlar: [
+            ["Yeni bir sohbet açın; bağlayıcı eski sohbette görünmeyebilir.", undefined],
+            ["Yazı kutusunun altındaki + ya da araç menüsünden Akredit'in açık olduğunu denetleyin.", undefined, true],
+            ["Komut görünmüyorsa 'Akredit ile başlayalım' yazmanız yeter.", "Asistan odak menüsünü gösterir."],
+            [`Bağlayıcı adresinin tam olarak ${MCP_ADRESI} olduğunu denetleyin.`, undefined],
+        ],
+        yedek: false,
+    },
+};
+export const kurulumYardimiAraci = arac({
+    ad: "kurulum_yardimi",
+    baslik: "Kurulum yardımı",
+    aciklama: "Akredit bağlayıcısını eklemek ve OBS'ye tarayıcıyla girmek için istemciye göre adım adım rehber verir: Claude web ve masaüstü, Claude in Chrome, ChatGPT, Cursor, VS Code, Claude Code. Her adımda ekranda ne görüleceğini söyler.",
+    sonrakiAdim: "Adımları hocaya tek tek gösterin: bir adım verin, 'oldu' demesini bekleyin, sonra sıradakine geçin. 'değişebilir' işaretli menü adını 'sizde biraz farklı olabilir' diye söyleyin. Giriş kuralını hocaya bir kez açıkça söyleyin.",
+    girdi: z.object({
+        istemci: z.enum(ISTEMCILER).describe("Hocanın kullandığı asistan"),
+        konu: z
+            .enum(["baglayici", "tarayici", "hepsi"])
+            .default("hepsi")
+            .describe("Bağlayıcı ekleme, OBS'ye tarayıcıyla giriş ya da ikisi"),
+    }),
+    calistir: ({ istemci, konu }) => ({
+        sonuc: {
+            istemci: ISTEMCI_ADI[istemci],
+            girisKurali: GIRIS_KURALI_HOCAYA,
+            ...(konu !== "tarayici" ? { baglayiciAdimlari: numarala(BAGLAYICI[istemci]) } : {}),
+            ...(konu !== "baglayici" ? { tarayiciAdimlari: numarala(TARAYICI[istemci]) } : {}),
+            not: "Menü adları istemcinin sürümüne ve diline göre değişebilir. 'degisebilir' işaretli adlar doğrulanmadı.",
+        },
+        kaynak: [KOD_KAYNAGI("apps/acik-mcp/src/yardim.ts", "Akredit kurulum rehberi")],
+    }),
+});
+export const engelCozAraci = arac({
+    ad: "engel_coz",
+    baslik: "Engel çöz",
+    aciklama: "OBS'ye girerken ya da sayfayı okurken çıkan engel için numaralı çözüm adımları verir: tarayıcı aracı yok, site açılmıyor, giriş ekranı, CAPTCHA, çerçeve, oturum düşmesi, sayfa okunamıyor, Kaydet düğmesi, Akredit görünmüyor. Gerekirse kopyala-yapıştır yedeğini de verir.",
+    sonrakiAdim: "Adımları hocaya tek tek gösterin. Hiçbiri olmazsa kopyala-yapıştır yedeğine geçin. Parola, doğrulama kodu ya da çerez istemeyin.",
+    girdi: z.object({
+        engel: z.enum(ENGELLER),
+        istemci: z.enum(ISTEMCILER).optional(),
+    }),
+    calistir: ({ engel, istemci }) => {
+        const e = ENGEL_ADIMLARI[engel];
+        const ozel = engel === "tarayici_araci_yok" && istemci ? TARAYICI[istemci] : [];
+        return {
+            sonuc: {
+                engel: e.ad,
+                girisKurali: GIRIS_KURALI_HOCAYA,
+                adimlar: numarala([...ozel, ...e.adimlar]),
+                ...(e.yedek ? { yedekYol: numarala(KOPYALA_YAPISTIR) } : {}),
+                obsyeYazmaYedegi: "Tarayıcı aracı yoksa asistan bologna_kopya_metni ile alan alan kopyalanacak metni verir; siz OBS'de ilgili kutuya yapıştırıp Kaydet'e basarsınız.",
+            },
+            kaynak: [KOD_KAYNAGI("apps/acik-mcp/src/yardim.ts", "Akredit engel çözme rehberi")],
+        };
+    },
+});