Kurulum
| Biçim | Yapılandırma |
|---|---|
| Yerel (stdio) | npx -y @trkit-app-pack/mcp |
| Uzak (Streamable HTTP) | https://<sunucunuz>/mcp (aşağıya bakın) |
Tüm araçlar salt okunurdur: dosya yazmaz, ağa istek atmaz, kimlik bilgisi istemez. Dosyaları yazmak asistanınızın işidir.
Araçlar
trkit_list
Eklenebilecek bileşen/sayfa/uç noktaları, yasal metin şablonlarını ve rehber başlıklarını listeler. Asistanınız bir trkit işine başlamadan önce bunu çağırır.
trkit_get_files
Registry öğelerinin bağımlılıklarıyla birlikte kaynak kodunu ve projedeki hedef yollarını döndürür.
| Girdi | Tür | Açıklama |
|---|---|---|
items | string[] | Örn. ["kvkk", "cerez-banner"] |
srcDir | boolean? | Proje src/ dizini kullanıyorsa true |
importAlias | string? | Varsayılan "@/" |
Çıktıda files (yol + içerik), dependencies, env, notes ve eşdeğer CLI komutu (cli) bulunur. Terminal erişimi olan asistanlar genelde doğrudan npx trkit add çalıştırır.
trkit_generate_legal
Şirket bilgilerinden yasal metin üretir.
| Girdi | Tür |
|---|---|
template | kvkk-aydinlatma, acik-riza, cerez-politikasi, mesafeli-satis, on-bilgilendirme, teslimat-iade, ticari-ileti, kvkk-basvuru |
company | { unvan, adres, eposta, website, mersis?, telefon?, kvkkEposta?, ... } |
options | trkit.config.ts'deki diğer alanlar (kvkk, satis, cerezler...) |
format | markdown (varsayılan) veya html |
Çıktıda content, eksik bilgileri gösteren warnings ve hukuki uyarı (disclaimer) bulunur.
trkit_validate
kind: tckn, vkn, vergi-no, iban, telefon, plaka, posta-kodu. Geçerliliği ve normalize edilmiş değeri döndürür (IBAN için banka kodu ve adı, telefon için tür ve E.164).
trkit_address_search
Türkçe karakter duyarsız il/ilçe araması. query ve isteğe bağlı province.
trkit_guide
Konular: baslangic, kvkk, cerez, odeme, sms, dogrulama. Ödeme, KVKK veya çerez kodu yazmadan önce asistanın okuması gereken kısa ve kesin kurallar. Aynı rehberler trkit://guide/<konu> kaynakları (resources) olarak da sunulur.
Uzak sunucuyu yayınlamak
Yerel (stdio) sunucu, Claude Code, Cursor, VS Code ve Codex için yeterlidir. ChatGPT ve claude.ai gibi web istemcileri ise internetten erişilebilen bir adres ister. Bu dokümantasyon sitesi GitHub Pages'te statik olarak yayınlandığı için /mcp uç noktası burada çalışmaz; uzak sunucuyu Node.js çalıştırabilen bir yerde yayınlamanız gerekir.
Seçenek 1: trkit dokümantasyon sitesini sunucu modunda yayınlayın. Depodaki apps/docs uygulaması varsayılan modda /mcp uç noktasını içerir. Vercel'de kök dizin olarak apps/docs seçip yayınlamanız yeterli; adres https://<projeniz>.vercel.app/mcp olur.
Seçenek 2: Kendi Next.js projenize ekleyin. @trkit-app-pack/mcp paketindeki createServer() fonksiyonuyla herhangi bir taşıyıcıya bağlanabilirsiniz. Next.js route handler örneği:
import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
import { createServer } from "@trkit-app-pack/mcp";
export async function POST(req: Request) {
const server = createServer();
const transport = new WebStandardStreamableHTTPServerTransport({
sessionIdGenerator: undefined, // durumsuz
enableJsonResponse: true,
});
await server.connect(transport);
return transport.handleRequest(req);
}