MCP + HTTP API · ÜCRETSİZ · KAYIT GEREKMEZ
nonform araçlarını AI asistanınızdan çağırın — MCP ve HTTP API
nonform'un yapı hesap araçları ve üretilebilirlik kontrolü, AI asistanlarından doğrudan çağrılabilir. İki kanal var: Model Context Protocol (MCP) sunucusu ve HTTP API. İkisi de ücretsizdir; hesap açmanız, anahtar almanız ya da kart bağlamanız gerekmez. Sonuçlar deterministiktir — aynı girdi aynı çıktıyı verir, çünkü hesap dil modelinin aritmetiğinde değil sunucudaki motorda yapılır.
MCP sunucusuna nasıl bağlanılır?
Sunucu adresi (streamable HTTP)
https://www.nonform.ai/api/agent/mcp- 1
Bağlayıcı ekleyin
AI asistanınızın bağlayıcı (connector) ayarlarına gidin ve yeni bir uzak MCP sunucusu ekleyin.
- 2
Sunucu adresini girin
Adres olarak https://www.nonform.ai/api/agent/mcp yazın. Aktarım türü streamable HTTP'dir; kimlik doğrulama, anahtar ya da hesap gerekmez.
- 3
Araç listesinin geldiğini görün
Bağlantı kurulduğunda asistan tool listesini okur: üretilebilirlik kontrolü, gösterge fiyat aralığı, teklif yönlendirmesi ve Hesap Merkezi'ndeki malzeme-miktarı hesaplayıcıları.
- 4
Bir istem yazın
Aşağıdaki örnek istemlerden birini kopyalayıp asistana yapıştırın; asistan ilgili aracı çağırır ve yanıtı yapılandırılmış olarak alır.
Tüm tool'lar salt-okunurdur: yan etki üretmez, kayıt oluşturmaz, dışarıya istek atmaz. Kötüye kullanımı önlemek için IP başına dakikalık istek sınırı vardır; sınır aşılırsa uç 429 döner.
Çalışan istem örnekleri
Bağlantıyı kurduktan sonra aşağıdaki cümlelerden birini asistanınıza yapıştırın. Her biri parantezde yazan gerçek tool'u çağırır.
Çağrılan tool: check_feasibility
nonform araçlarıyla kontrol et: 4000 mm genişlik, 3000 mm derinlik, 2600 mm yükseklikte lamelli bir pergola İstanbul'da üretilebilir mi?Yanıtta ne var: yapılabilirlik (evet / koşullu / hayır), gösterge fiyat aralığı, fiyatı değiştiren sürücüler ve uyarılar. Net fiyat dönmez.
Çağrılan tool: hesapla_ic_cephe_boya
nonform hesap aracıyla hesapla: 3,2 m × 2,8 m ölçüsünde, 2,7 m tavan yüksekliğinde bir odanın iç cephe boyası için kaç litre boya gerekir?Yanıtta ne var: net alan, kat sayısına göre litre ihtiyacı, ambalaj önerisi ve kullanılan varsayılanların listesi. Fiyat alanı yanıtta yoktur.
Çağrılan tool: hesapla_doner_90_merdiven
nonform merdiven aracını çalıştır: 280 cm kat yüksekliği, 340×340 cm kova, sola dönüşlü sahanlıklı bir merdivenin rıht/basamak dağılımı ne olur?Yanıtta ne var: rıht adedi, rıht yüksekliği, basamak genişliği, eğim açısı, baş kurtarma yüksekliği, kesim listesi ve yönetmelik maddesine atıflı norm kontrolleri (uygun / sınırda / ihlal).
HTTP API
MCP kullanmıyorsanız aynı araçlar düz HTTP ile de çağrılır. Uç kalıbı: https://www.nonform.ai/api/agent/arac/{slug} — gövde ölçüler ve ayarlanabilir varsayılanlardır, yanıt fire dahil miktar listesidir.
curl -X POST https://www.nonform.ai/api/agent/arac/doner-90-merdiven \
-H "content-type: application/json" \
-d '{
"katYuksekligiCm": 280,
"kovaUzunlukCm": 340,
"kovaGenislikCm": 340,
"kolGenisligiCm": 100,
"donusYonu": "sol",
"donusCozumu": "sahanlik"
}'Yanıttan seçilmiş alanlar
| Alan | Değer |
|---|---|
| ok | true |
| data.ozet.toplamRihtAdedi | 18 |
| data.ozet.rihtYuksekligiCm | 15,6 |
| data.ozet.basamakGenisligiCm | 30 |
| data.ozet.egimAciDerece | 27,4 |
| data.ozet.basKurtarmaCm | 260 |
| data.normSeviyesi | uygun |
Yanıt zarfı { ok, data, request_id } biçimindedir. Yukarıdakiler seçilmiş alanlardır; yanıtta ayrıca kalem listesi, kesim listesi, kullanılan varsayılanlar ve norm kontrolleri (her biri yönetmelik maddesi atfıyla) bulunur. Hesap araçlarının yanıt şemasında fiyat alanı bulunmaz; dönen şey miktar, ambalaj önerisi ve kullanılan varsayılanlardır.
Sınırlar ve sorumluluk
Bu araç bilgilendirme ve ön-hesap amaçlıdır; bir mühendislik/mimarlık hizmeti, projesi veya statik/ruhsat hesabı değildir. Sonuçlar genel kabul görmüş hesap yöntemlerine ve girdilerinize dayalı yaklaşık değerlerdir; hiçbir doğruluk veya uygunluk garantisi verilmez. Kesin proje, uygulama ve son doğrulama sorumluluğu kullanıcıya ya da ilgili meslek mensubuna aittir.
- Fiyat: araçlar net fiyat döndürmez. Fiyat sorulduğunda gösterge aralığı ve o aralığı değiştiren sürücüler döner; kesin teklif uygulamacı firmadan alınır.
- Kişisel veri: girdiler ölçü ve malzeme seçimleridir; isim, telefon, e-posta ya da adres alanı yoktur. Ayrıntı: gizlilik politikası.
- Kapsam: araçlar malzeme miktarı ve geometri hesaplar; taşıma/statik hesabı yapmaz, ruhsat değerlendirmesi yerine geçmez.
Sık sorulanlar
- Bu araçları kullanmak ücretli mi?
- Hayır. MCP sunucusu ve HTTP araç ucu ücretsizdir; hesap açmanız, anahtar almanız ya da kart bağlamanız gerekmez. Tek sınır, kötüye kullanımı önleyen IP başına dakikalık istek sayısıdır; sınır aşılırsa uç 429 döner ve bir süre sonra kendiliğinden açılır.
- Hangi araçlar çağrılabiliyor?
- Üretilebilirlik kontrolü, gösterge fiyat aralığı, teklif alma yönlendirmesi ve Hesap Merkezi'ndeki malzeme-miktarı hesaplayıcıları. Hesap araçları tek kaynaktan türetilir: merkeze yeni bir araç eklendiğinde MCP tool'u da kendiliğinden oluşur. Güncel liste her zaman sunucunun kendi tool listesindedir; asistanınız bağlandığında onu okur.
- Gönderdiğim veriler ne oluyor?
- Araçlar kişisel veri istemez; girdiler ölçü ve malzeme seçimleridir. İsim, telefon, e-posta ya da adres alanı yoktur. Uçlarda anonim kullanım ölçümü tutulur (hangi araç çağrıldı, hangi büyüklükte) — ayrıntı için gizlilik politikasına bakın.
- Yanıtta neden net fiyat yok?
- Fiyat; firmaya, kesime, malzemeye ve bölgeye göre değişir; tek bir rakam yanıltıcı olur. Bu yüzden yanıt şemalarında net fiyat alanı bulunmaz: fiyat sorulduğunda aralık ve o aralığı değiştiren sürücüler döner. Kesin teklif uygulamacı firmadan alınır.
- Sonuçlar tekrarlanabilir mi?
- Hesap araçları deterministiktir: aynı girdi aynı çıktıyı verir. Sonuç bir dil modelinin aritmetiğinden değil, sunucudaki hesap motorundan gelir; böylece aynı soruyu iki kez sorduğunuzda iki farklı sayı almazsınız.