Bu site insanlar için okunur HTML’in yanında AI araçları için makine-okunur yüzeyler yayınlar. Hepsi içerikten derleme anında üretilir; elle tutulan bir kopya yoktur, bu yüzden sayfalarla her zaman aynıdır.

Yüzey	Adres	Ne zaman
`llms.txt`	/llms.txt	Bölümlere ayrılmış indeks (llmstxt.org biçimi); her bağlantı sayfanın `.md` ikizine gider
`llms-full.txt`	/llms-full.txt	Tüm sayfaların tek Markdown dosyasında birleşimi (bağlantılar mutlak)
Sayfa Markdown’ı	`/<sayfa>.md` (ör. /theme-quickstart.md)	Tek sayfayı bağlam olarak vermek
Doküman MCP	`/api/mcp`	Ajanın arayıp okuması; paket sürümleri ve `@tecof/theme-editor` tip tanımları
Arama dizini	`/search-index.json`	Sitenin ⌘K araması (istemci tarafı)

Sayfa eylemleri#

Her sayfanın başlığındaki düğme grubu:

Markdown’ı kopyala — sayfanın ham Markdown’ını (başlık, açıklama, kaynak adresi ve son güncelleme satırıyla) panoya alır.
README olarak kopyala — aynı içeriği bağlantıları mutlak adrese çevirip kaynak notuyla verir; bir depoya README.md ya da ajan talimat dosyası olarak doğrudan konabilir.
Markdown’ı görüntüle — .md ikizini açar.
ChatGPT’de aç / Claude’da aç — sayfanın .md adresini bağlam olarak veren hazır bir istemle yeni sohbet başlatır.

Paketler sayfasında ayrıca her paket için README’yi kopyala vardır: README npm’den alınır (/packages/<paket>/readme.md); npm’de README’si olmayan paket için katalog bilgisinden üretilir.

Doküman MCP sunucusu#

Salt-okunur, kimlik doğrulama istemeyen bir MCP sunucusudur. Aynı araçlar iki taşıma ile sunulur.

Araç	Ne yapar
`get_docs_outline`	Tüm bölüm ve sayfaları slug, başlık ve açıklamayla listeler
`read_doc_page`	Bir sayfanın tam Markdown’ını döndürür (`slug`; `packages` dahil)
`search_docs`	Türkçe-duyarlı arama; sayfa adresi ve alıntıyla en iyi eşleşmeler (`query`, `limit`)
`get_package_versions`	Tüm `@tecof/*` paketlerinin güncel sürümü, kurulum komutu, peer bağımlılıkları
`list_exported_types`	`@tecof/theme-editor`’ün gerçekten dışa aktardığı adlar (`filter` isteğe bağlı)
`read_type_definition`	Bir adın `dist/index.d.ts` içindeki gerçek TypeScript bildirimi (`symbol`)

Kaynaklar: tecof-docs://llms.txt, tecof-docs://pages/<slug> ve tecof-docs://types/theme-editor (paketin tam tip dosyası).

Sunucu bağlanan asistana şu talimatı verir: önce search_docs ile ara, kod önermeden önce read_doc_page ile sayfanın tamamını oku, belgede olmayan API uydurma; @tecof/theme-editor sorularında çelişki varsa read_type_definition ile gerçek bildirimi doğrula.

Uzak (Streamable HTTP)#

Durumsuz (stateless) çalışır; her istek kendi sunucu örneğini açıp kapatır.

Terminal

claude mcp add --transport http tecof-docs https://tecof-app-dev.vercel.app/api/mcp

.mcp.json

{
  "mcpServers": {
    "tecof-docs": { "type": "http", "url": "https://tecof-app-dev.vercel.app/api/mcp" }
  }
}

.cursor/mcp.json

{
  "mcpServers": {
    "tecof-docs": { "url": "https://tecof-app-dev.vercel.app/api/mcp" }
  }
}

Claude.ai ve ChatGPT’de: Ayarlar → Connectors → Özel bağlayıcı ekle ve aynı adresi girin. GET /api/mcp insan ve ajanlar için bir tanıtım belgesi döner; MCP istekleri POST ile gelir.

Yerel (stdio)#

Depoyu klonladıysanız aynı sunucuyu yerelde çalıştırabilirsiniz:

Terminal

npm install
npm run mcp

.mcp.json

{
  "mcpServers": {
    "tecof-docs": {
      "command": "npx",
      "args": ["tsx", "/MUTLAK/YOL/tecof-app-dev/scripts/mcp-server.ts"]
    }
  }
}

Sunucu içeriği ve node_modules’u depo kökünden okur; betik çalışma dizinini kendisi depo köküne sabitler.

Hangi MCP ne için#

Sunucu	Adres	İçerik
Doküman MCP (bu sayfa)	`/api/mcp`	Belgeler, paket sürümleri, editör tipleri — salt okunur, kimliksiz
Tecof MCP	`https://api.tecof.com/mcp`	Mağazanızın verisi: sayfalar, CMS, ürünler, tema, raporlar — kimlik ve kapsam ister
`@tecof/mcp`	stdio	Tema reposunun içinden bileşen kataloğuyla sayfa yazma

Kodlama ajanı kurarken ikisini birlikte vermek iyi sonuç verir: ajan belgeyi doküman MCP’sinden okur, değişikliği Tecof MCP ya da CLI ile yapar. Proje kökünde tecof setup agent uzak Tecof MCP’sini yapılandırır (Güvenlik ve CI).