# Dokümanı AI ile Kullanın

> Bu dokümantasyonu AI asistanlarına bağlama — llms.txt ve llms-full.txt, her sayfanın .md ikizi, sayfa eylemleri (Markdown/README kopyala, ChatGPT/Claude’da aç) ve salt-okunur doküman MCP sunucusu (HTTP ve stdio).
>
> Kaynak: https://tecof-app-dev.vercel.app/ai-docs · Bölüm: AI ve MCP · Son güncelleme: 2018-10-20

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](/llms.txt) | Bölümlere ayrılmış indeks ([llmstxt.org](https://llmstxt.org) biçimi); her bağlantı sayfanın `.md` ikizine gider |
| `llms-full.txt` | [/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](/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](/packages) 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.

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

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

```json title=".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.

> [!NOTE] Alan adı
> Örneklerdeki adres sitenin yayın adresidir ve derleme sırasında `NEXT_PUBLIC_SITE_URL` değerinden gelir. Site başka bir alan adına taşınırsa kendi MCP yapılandırmanızdaki adresi de güncelleyin.

### Yerel (stdio)

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

```bash
npm install
npm run mcp
```

```json title=".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](/mcp) | `https://api.tecof.com/mcp` | Mağazanızın verisi: sayfalar, CMS, ürünler, tema, raporlar — kimlik ve kapsam ister |
| [`@tecof/mcp`](/mcp#tecofmcp-stdio-paketi) | 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](/dev-security#tecof-setup-agent)).