# auth.md - Çanta Proje Agent Authentication and Registration

Bu doküman, otonom yapay zeka ajanlarının, tarayıcıların ve dijital asistanların `cantaproje.com` üzerindeki servisleri ve yetenekleri keşfetmesi, kaydolması ve etkileşime girmesi için hazırlanmıştır.

## Servis ve Kaynak Bilgileri
- **Alan Adı (FQDN)**: `cantaproje.com`
- **Kaynak Tanımlayıcısı (PRM)**: `https://cantaproje.com/api`
- **Yetkilendirme Sunucusu (Issuer)**: `https://cantaproje.com`
- **Desteklenen Kimlik Tipleri**: `anonymous`, `identity_assertion`
- **İletişim & Yetkili Mühendis**: Karakaş Araç Proje Mühendislik (0554 816 63 02)

## Keşif Uç Noktaları
- **Agentic Resource Discovery (ARD)**: `/.well-known/ai-catalog.json`
- **RFC 9727 API Kataloğu**: `/.well-known/api-catalog`
- **MCP Sunucu Kartı (SEP-1649)**: `/.well-known/mcp/server-card.json`
- **Ajan Becerileri İndeksi**: `/.well-known/agent-skills/index.json`
- **Kişisel Ajan Protokolü (Poppy)**: `/.well-known/poppy.json`
- **OAuth Korumalı Kaynak Bilgisi**: `/.well-known/oauth-protected-resource`
- **OAuth Yetkilendirme Sunucusu**: `/.well-known/oauth-authorization-server`

## Ajan Kayıt ve Yetkilendirme Yöntemleri
1. **Anonim Erişim**:
   Ajanlar, site üzerindeki hizmet bilgilerini, mevzuat rehberlerini ve keşif kataloglarını herhangi bir oturum açma veya API anahtarı gerekmeden doğrudan GET istekleriyle tüketebilir.
2. **WebMCP ile Tarayıcı İçi Araç Çağrısı**:
   Ajan tarayıcı ortamındaysa sayfa yüklendiğinde `document.modelContext.registerTool()` üzerinden sunulan araçları (`get_canta_service_info`, `get_contact_and_hours`) ve form özniteliklerini (`projeTeklifAl`) doğrudan çağırabilir.
3. **Bearer Token ile Yetkili İstekler**:
   Gerektiğinde yetkilendirilmiş istekler `Authorization: Bearer <token>` başlığı ile kabul edilir.