Yapay zekâ erişimi · ArayüzlerREV. 2026-A
Yapay zekâ asistanları bu siteye nasıl erişir
Bu sitede insanlar için olan sayfaların yanında programlar için de girişler var. Bir yapay zekâ asistanı bu girişlerden /tools'taki araçlarla hesap yaptırabilir ya da fiyatlarımızı sorgulayabilir; sayfalarda rakam aramasına gerek kalmaz. Burada nasıl bağlanacağınızı ve sınırların nerede olduğunu bulabilirsiniz.
- kayıt olmadan
- salt okunur
- hiçbir şeyi kalıcı olarak kaydetmez
Güncelleme:
01 / GENEL BAKIŞ
Üç giriş, sayfalardakiyle aynı veriler
MCP sunucusu
/mcp
Model Context Protocol kullanan asistanlar için. Şirket profilinden ve fiyatlardan /tools'taki hesaplayıcılara kadar 54 araç.
A2A uç noktası
/a2a
A2A protokolü 1.0'a göre çalışan ajanlar için. /tools'taki 50 aracı, /mcp ile aynı hesaplamayla çalıştırır.
Markdown
Accept: text/markdown
Bir program isterse, sayfa metnini Markdown olarak verir. Tarayıcılar yine HTML alır.
Üçü de web sitesiyle aynı kaynaklardan okur. Şirket bilgileri, fiyat listesi ve araçların hesaplaması hiçbir yerde iki kez tutulmaz: Bir saat ücreti değişirse, bir sonraki yayından sonra hem /preise sayfasında hem de MCP sunucusunun cevabında aynı anda görünür.
02 / MCP SUNUCUSU
MCP sunucusunu bağlamak
- Adres
- https://aureum-tech.com/mcp
- Aktarım
- Streamable HTTP, POST ile JSON-RPC 2.0
- Kimlik doğrulama
- yok
- Erişim
- salt okunur
Sunucuları adresle Streamable HTTP üzerinden ekleyen bir MCP istemcisi için bu adres yeterlidir. Kaydın tam olarak nasıl yazılacağı, istemcinizin kılavuzunda yer alır. Çoğu istemci şuna benzer bir yapılandırma bekler:
{
"mcpServers": {
"aureum-website": {
"url": "https://aureum-tech.com/mcp"
}
}
}
Bazı istemciler ayrıca aktarım türünün belirtilmesini ister, genellikle “http” ya da “streamable-http” olarak. Anahtar ya da token gerekmez.
Bağlantı sırasında ne olur
- initialize: İstemci, oturum kimliği olmadan bağlanır. Cevabın başlığında
Mcp-Session-Idbulunur; istemci bu kimliği sonraki her istekte gönderir. - notifications/initialized: İstemci, bağlantı kurulumunun tamamlandığını onaylar.
- tools/list: Sunucu, tüm araçları açıklama ve girdi şemasıyla listeler.
- tools/call: İstemci bir aracı girdileriyle çağırır. Sonuç, cevabın metin alanında JSON olarak gelir.
Elle bağlanmak, örneğin terminalde denemek isterseniz, şöyle görünür:
curl -i https://aureum-tech.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
"protocolVersion":"2025-06-18","capabilities":{},
"clientInfo":{"name":"test","version":"1.0"}}}'
Cevap bir olay akışı (text/event-stream) olarak gelir, kimlik mcp-session-id başlık satırındadır. Bu kimlikle bir araç çağrısı; 2. adımdaki onay (notifications/initialized) kısa olsun diye burada atlanmıştır, bir istemci onu önceden gönderir:
curl https://aureum-tech.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Mcp-Session-Id: <Kennung aus der ersten Antwort>" \
-H "MCP-Protocol-Version: 2025-06-18" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
"name":"preise_abfragen","arguments":{"zielgruppe":"firma"}}}'
/mcp adresini tarayıcıda açan biri GET isteği gönderir ve “Nur POST (JSON-RPC)” mesajını alır. Bu doğru cevaptır, bir arıza değildir. Sunucunun çalışıp çalışmadığını /mcp/health gösterir.
Hangi araçlar var
Dört araç bizimle ilgili soruları cevaplar:
firma_und_kontakt: adres, telefon, ulaşılabilirlik ve sicil bilgileriyle şirket profilileistungen_auflisten: tüm hizmet alanları, her biri ilgili sayfasıylapreise_abfragen: fiyat listesiyle aynı kaynaktan saat ücretleri, yol ücreti ve ek ücretlerwebsite_suchen: aureum-tech.com'un tüm sayfalarında arama
Bunlara /tools'taki 51 aracın 50'si eklenir (E-fatura kontrolü hariç hepsi), her biri werkzeug_email_check gibi bir adla. Tarayıcıdaki sayfayla aynı mantıkla hesaplarlar; her cevap aracın sayfasını, verilerin güncelleme tarihini ve sonucun sınırlarını belirtir. Bir aracın hangi girdileri beklediği, kendi sayfasındaki “Yapay zekâ asistanları için” bölümünde yazar.
03 / SINIRLAR
Hizmet herkes için çalışsın diye sınırlar
Sunucu herkese açıktır ve kullanıcı hesabı yoktur. Bu yüzden istek başına maliyet sınırlıdır; başka sunucuları sorgulayan araçların hız sınırları da tüm çağrılar için toplam olarak geçerlidir.
| Sınır | Değer | Sonra ne olur |
|---|---|---|
| Bir isteğin boyutu | 900 KB | HTTP 413 |
| Açık MCP oturumları, tüm istemciler toplam | 500 | Retry-After: 30 ile HTTP 503 |
| Etkinliği olmayan MCP oturumu | 30 dakika | Oturum geçersiz olur, istemci 404 alır ve yeniden bağlanır. |
| Ağ sorgusu yapmayan bir /tools aracının çağrı başına cevap süresi, bekleme süresi dahil | 10 saniye | Araç işlemi bir hata mesajıyla durdurur |
| E-posta kontrolü | Dakikada 30 kontrol, saatte 300 yeni DNS kontrolü | Araç, daha sonra tekrar denemenizi ister. |
| Üçüncü taraf, yapay zekâ crawler ve link önizleme kontrolü | her biri dakikada 20 kontrol, her biri saatte 150 yeni kontrol | E-posta kontrolündeki gibi |
| Canlı değerlerle Gas hesaplayıcı | Ücretler en fazla dakikada bir kez yeniden sorgulanır | Son dakikanın değerleriyle cevap; canlı değer yoksa sayfanın sabit verileriyle ve bir notla |
Önbellekte duran bir sonuç (alan adı ya da adres başına beş dakika), saatlik sınıra dahil edilmez. Bir araç kendisi bir hata bildirirse (hız sınırı, zaman sınırı, kullanılamaz girdi), bu hata cevabın fehler alanında Almanca olarak yer alır. Şemaya uymayan girdileri /a2a JSON-RPC hatası -32602 ile, /mcp ise MCP SDK'nın bir hata cevabıyla reddeder.
04 / A2A
Araçları A2A protokolüyle çağırmak
- Uç nokta
- https://aureum-tech.com/a2a
- Protokol
- JSON-RPC 2.0 üzerinden A2A 1.0
- Başlık satırı
- A2A-Version: 1.0
- Metot
- SendMessage
A2A protokolünü kullanan ajanlar aynı 50 aracı /a2a üzerinden çağırır. {"werkzeug": "…", "eingabe": {…}} veri bölümü içeren bir mesaj bir aracı çalıştırır ve cevap, /mcp ile aynı sonucu içerir:
curl https://aureum-tech.com/a2a \
-H "Content-Type: application/json" \
-H "A2A-Version: 1.0" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "SendMessage",
"params": {
"message": {
"messageId": "9b2f6c1e-4d1a-4c3b-8e55-0a7d2f3b1c90",
"role": "ROLE_USER",
"parts": [{
"data": {
"werkzeug": "werkzeug_email_check",
"eingabe": { "domain": "ihre-firma.de" }
},
"mediaType": "application/json"
}]
}
}
}'
- Yalnızca metin içeren bir mesaj, araç listesini girdi alanlarıyla birlikte döndürür. Metin bir aracın adını içeriyorsa, o aracın tüm bilgileri örnek sorularla birlikte gelir.
- Ajan sabit kurallara göre çalışır, serbest dili anlamaz.
- Görev (task) oluşturmaz ve hiçbir şey kaydetmez. Her cevap doğrudan bir mesajdır; bu yüzden
ListTasksboş bir liste döndürür. - Streaming ve push bildirimleri sunmaz, dosya kabul etmez.
A2A-Version: 1.0başlık satırı eksikse, -32009 hatasıyla cevap verir: Spesifikasyon eksik bilgiyi 0.3 sürümü olarak yorumlar.
Şirket profili, hizmetler, fiyatlar ve aramayla ilgili dört araç yalnızca /mcp üzerinden kullanılabilir. /a2a için aynı gövde sınırı, aynı zaman sınırı ve aynı hız sınırları geçerlidir. Programlar için açıklama Agent Card'da yer alır.
05 / MARKDOWN
Markdown olarak sayfalar
Bir sayfayı Accept: text/markdown başlık satırıyla isteyen biri, HTML yerine sayfanın metnini Markdown olarak alır; menü ve komut dosyaları olmadan. Tarayıcılar bu bilgiyi hiç göndermez ve sayfayı her zamanki gibi görür. Bu sürümler web sitesi derlenirken hazır sayfalardan oluşturulur, bu yüzden sayfalar kadar günceldir.
curl -H "Accept: text/markdown" https://aureum-tech.com/preise
Cevapta Content-Type: text/markdown; charset=utf-8 ve Vary: Accept bulunur. Rehber ana sayfası ve içerik yönetim sistemindeki uzman yazıları bunun dışındadır: İkisi de ancak istek anında doldurulur, orada yine HTML gelir. Bu sayfaların metnini tek bir dosyada /llms-full.txt verir.
06 / AÇIKLAMA DOSYALARI
Programlar neler olduğunu nereden öğrenir
Bu dosyalar girişleri, ajanların ve kontrol programlarının kendiliğinden aradığı formatlarda açıklar. Ana sayfa, cevabının Link başlığında API kataloğuna, OpenAPI açıklamasına ve bu sayfaya yönlendirir.
- /.well-known/api-catalogRFC 9727'ye göre API kataloğu. /mcp ve /a2a için açıklamayı, dokümantasyon olarak bu sayfayı ve /mcp için durum sorgusunu belirtir.
- /openapi.jsonOpenAPI 3.1: MCP uç noktasının HTTP arayüzü.
- /.well-known/mcp/server-card.jsonMCP sunucusunun adresi, aktarım türü ve araç listesiyle MCP Server Card.
- /.well-known/agent-card.jsonA2A Agent Card: A2A ajanının uç noktası, protokol sürümü ve yetenekleri.
- /.well-known/agent-skills/index.jsonAgent Skills dizini. İçinde ajanlar için iki kılavuz var: araçları MCP üzerinden kullanmak ve bir insan için hizmet talebi hazırlamak.
- /llms.txtDil modelleri için web sitesinin kısa özeti, önemli sayfalarla birlikte.
- /llms-full.txtSayfaların metni tek bir dosyada.
- /auth.mdAjanlar için kimlik doğrulama kılavuzu. Asıl söylediği, burada kimlik doğrulama olmadığıdır.
- /robots.txtCrawler'lar için kurallar. Hepsine izin verilir, bilinen yapay zekâ crawler'ları tek tek listelenmiştir.
07 / VERİ KORUMA
Girdilere ne olur
/mcp ya da /a2a üzerinden yapılan bir çağrı, girdileri sunucumuza gönderir; sunucu bunlarla hesap yapar ve sonucu döndürür, girdileri ya da sonucu kalıcı olarak kaydetmez. Yalnızca ağ kontrollerinin sonuçları, kontrol edilen alan adı ya da adresle birlikte, çağıranla bağlantısı olmadan en fazla altı dakika bellekte kalır. Her sayfa ziyaretinde olduğu gibi yalnızca istek kaydedilir, içeriği kaydedilmez. Asistanın sizin bilgilerinizle ne yaptığını ise kendi sağlayıcısı belirler (ayrıntılar Gizlilik politikası'nda).
08 / İŞLETMENİZ İÇİN
Kendi sistemleriniz için böyle bir erişim
Bu web sitesinin kendi verileri için sunduğunu işletmeler için de kuruyoruz: Bir yapay zekâ asistanının stok ve satış sistemine ya da bir veritabanına eriştiği, yetkilerini önceden sizin belirlediğiniz bir MCP sunucusu. Nasıl çalıştığımızı MCP entegrasyonları sayfasında bulabilirsiniz.
MCP entegrasyonlarına göz atın