Doküman · MCP sunucusu
Nodus Works MCP sunucusu: Claude, ChatGPT ve Cursor'a bağlanın
- Sunucu 2.0.0
- Protokol 2026-07-28 ve eski sürümler
- MCP Streamable HTTP
Claude, ChatGPT ve Cursor bu sunucuya bağlanınca sitedeki sayfaları okur: hizmetler, entegrasyonlar, uygulamalar, vakalar ve yazılar. Her cevap yayındaki sayfanın adresiyle birlikte döner.
Sunucu adresi
Streamable HTTP · salt okunur · kimlik gerekmez
https://nodusworks.com/mcp - 1.119
- indekslenmiş sayfa ve yazı
- 3
- dil: Türkçe, İngilizce, Almanca
- 7
- salt okunur araç
- 6 + 3
- kaynak ve hazır istem
MCP nedir?
Model Context Protocol (MCP), yapay zeka uygulamalarının dış araçlara ve veri kaynaklarına bağlanması için kullanılan açık bir standarttır. Asistan, bağlandığı sunucunun araçlarını görür ve bir soruyu cevaplarken gerekli aracı kendisi çağırır. Nodus Works MCP sunucusu bu araçları sitenin kendi içeriğiyle besler; asistanınız Nodus Works hakkında tahmin yürütmek yerine ilgili sayfayı okur.
Size sayfanın başlığını, özetini ve adresini getirir
Buradan yapılamaz
- Form göndermek
- Toplantı ayarlamak
- Sipariş ve müşteri kaydı
- Hesap ve anahtarlar
Ne işe yarar?
Kaynağıyla cevap
Asistan Nodus Works'ün hizmetini, entegrasyonunu ya da bir vakayı anlatırken sayfanın kendisini okur ve adresini verir. Uydurulmuş fiyat ya da söz yerine sitede yazanı aktarır.
Üç dil, tek adres
Türkçe, İngilizce ve Almanca sayfalar aynı indekstedir. Sorunun dili algılanır, o dildeki sayfalar öne çıkar; her sonuç diğer dillerdeki eşini de taşır.
Mağazanıza dokunmaz
Bu bağlantı yalnızca sitede yayımlanmış sayfaları okur. Siparişinize, formunuza, e-postanıza ya da takviminize erişmez. İletişim istediğinizde telefonu, e-postayı ve toplantı linkini size bırakır; mesajı siz gönderirsiniz.
Bağlandıktan sonra asistanınıza şunları sorabilirsiniz:
- Nodus Works hangi Shopify hizmetlerini veriyor?
- Ticimax'ten Shopify'a geçen markalar hangileri, geçişte neler yapıldı?
- Yurtiçi Kargo ve Logo entegrasyonu için hangi sayfalara bakmalıyım?
- Shopify'da toptan satış için Nodus Works'ün bir uygulaması var mı?
Üç adımda bağlanın
Adresi kopyalayın
Sunucu adresi https://nodusworks.com/mcp. Hesap, API anahtarı ya da OAuth girişi gerekmez.
İstemcinize ekleyin
Claude ve ChatGPT'de özel bağlayıcı olarak, Cursor ve VS Code'da yapılandırma dosyasına bir satır olarak eklenir. Her istemcinin adımları aşağıdaki sekmelerde.
Sorun
Sohbette Nodus Works bağlayıcısını açın ve sorunuzu yazın. Asistan önce nodus_ara ile ilgili sayfaları bulur, gerekirse nodus_sayfa ile sayfanın tamamını okur.
İstemci kurulumu
Aşağıdaki adımlar her istemcinin kendi resmi belgesinden alındı. Menü adları istemcinin arayüz dilinde görünür; burada İngilizce adlarıyla yazıldı.
Claude
Claude'da uzak MCP sunucuları özel bağlayıcı (custom connector) olarak eklenir. Aynı bağlayıcı claude.ai, Claude Desktop ve Cowork'te çalışır; bağlantı Anthropic'in sunucularından kurulur.
Customize › Connectors sayfasını açın, + Add ve ardından Add custom connector seçin.
Ad olarak Nodus Works yazın, sunucu adresine https://nodusworks.com/mcp girin ve Continue'ya basın.
Authentication bölümünde No sign in seçin ve Add ile bitirin.
Sohbette sol alttaki + düğmesinden Connectors menüsüne girin ve Nodus Works'ü açın.
ChatGPT
ChatGPT özel MCP sunucusunu web sürümünde eklenti olarak bağlar. Çalışma alanı izinleri bu özelliği kapatabilir.
ChatGPT'yi tarayıcıda açın, Plugins sayfasında artı düğmesine basıp Add custom MCP server seçin.
Ad olarak Nodus Works yazın; Connection altında Server URL alanına https://nodusworks.com/mcp girin.
Kimlik doğrulamada No authentication seçin, risk uyarısını onaylayın ve Create as a plugin deyin.
Eklentiyi kurun. Sohbette @ yazıp Nodus Works'ü seçerek kullanın.
Cursor
Tüm projelerde kullanmak için ~/.cursor/mcp.json, yalnız bir projede kullanmak için proje kökündeki .cursor/mcp.json dosyasına ekleyin:
{
"mcpServers": {
"nodus-works": {
"url": "https://nodusworks.com/mcp"
}
}
} Sunucu kenar çubuğundaki Customize sayfasında görünür; oradan açıp kapatabilirsiniz. Cursor bir MCP aracını çalıştırmadan önce varsayılan olarak onay ister.
VS Code
GitHub Copilot ile kullanılır. Ekiple paylaşmak için çalışma alanı kökündeki .mcp.json, kişisel kullanım için ~/.copilot/mcp-config.json dosyasına ekleyin:
{
"mcpServers": {
"nodus-works": {
"type": "http",
"url": "https://nodusworks.com/mcp",
"tools": ["*"]
}
}
} Dosya yerine komut paletinden MCP: Add Server komutunu çalıştırıp HTTP seçerek adresi de girebilirsiniz. Eski .vscode/mcp.json dosyası servers biçimini kullanır ve VS Code belgelerine göre yeni kurulumlarda önerilmez.
Claude Code
Terminalde tek komutla eklenir:
claude mcp add --transport http nodus-works https://nodusworks.com/mcp Eklenen sunucuyu claude mcp list ile görebilirsiniz.
curl
Sunucu düz JSON-RPC konuşur; istemci olmadan da denenebilir. En kısa istek:
curl -s https://nodusworks.com/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"nodus_ara","arguments":{"query":"Trendyol entegrasyonu","limit":3}}}' Protokolün 2026-07-28 sürümüyle aynı istek, başlıklar ve _meta alanıyla:
curl -s https://nodusworks.com/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2026-07-28' \
-H 'Mcp-Method: tools/call' \
-H 'Mcp-Name: nodus_ara' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"nodus_ara","arguments":{"query":"Trendyol entegrasyonu","limit":3},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}' Tarayıcıda deneyin
Bu kutu, bir yapay zeka istemcisinin yaptığını yapar: /mcp ucuna tools/call isteği gönderip nodus_ara aracını çalıştırır. Sonuçlar sunucudan geldiği gibi listelenir; tam istek ve yanıtı altta açabilirsiniz.
Canlı deneme JavaScript gerektirir. Aynı isteği aşağıdaki curl komutuyla gönderebilirsiniz.
JSON-RPC alışverişini göster
Yedi salt okunur araç
Her aracın girdi şeması kapalıdır: tanımlı olmayan alan, yanlış tür ya da sınır aşımı açıklayıcı bir araç hatası döndürür.
nodus_ara
- Salt okunur
- Dış ağa çıkmaz
- Tekrarlanabilir
Üç dilde puanlı site araması. Başlık, etiket ve bölüm başlıkları metinden ağır sayılır; Türkçe ekler ve eşanlamlar (geçiş, taşıma, migration) eşlenir. Her sonuç başlık, adres, özet, en iyi eşleşen bölüm ve diğer dillerdeki eşi ile döner.
| Parametre | Tür ve sınır |
|---|---|
query zorunlu | string≤ 300 karakter |
language isteğe bağlı | tr | en | de |
types isteğe bağlı | [service, integration, app, saas, tool, case_study, reference, blog, guide, page] |
limit isteğe bağlı | integer1–10varsayılan 5 |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "nodus_ara",
"arguments": {
"query": "Trendyol entegrasyonu",
"limit": 2
}
}
} Örnek yanıtı göster
{
"results": [
{
"title": "Shopify Trendyol Entegrasyonu",
"url": "https://nodusworks.com/entegrasyonlar/shopify-trendyol-entegrasyonu",
"type": "integration",
"summary": "Shopify Trendyol entegrasyonu: ürün, stok ve fiyat eşitleme, sipariş aktarımı. İletişime geçin, Trendyol bağlantınızı sorunsuz kuralım.",
"language": "tr",
"section": "Shopify Trendyol entegrasyonu nedir?",
"excerpt": "Shopify mağazanızdaki ürünleri Trendyol'da satabilmek için iki sistemin birbiriyle sürekli konuşması gerekir. Trendyol'un yayınladığı resmi bir Shopify uygulaması olmadığı için bu …",
"equivalents": {
"en": "https://nodusworks.com/en/integrations/shopify-trendyol-integration",
"de": "https://nodusworks.com/de/integrationen/shopify-trendyol-integration"
}
},
{
"title": "Shopify Noon Entegrasyonu: Ürünlerinizi Noon Pazaryerine Nasıl Bağlarsınız?",
"url": "https://nodusworks.com/blog/shopify-noon-entegrasyonu",
"type": "blog",
"summary": "Shopify Noon entegrasyonu nasıl kurulur? Satıcı başvurusu, entegrasyon yöntemleri ve dil/kur/lojistik zorluklarıyla adım adım rehber.",
"language": "tr",
"section": "Diğer Pazaryeri Entegrasyonlarıyla İlişkisi (Trendyol, Amazon)",
"excerpt": "Yönettiğimiz Shopify Plus projelerinde, özellikle Nebim tabanlı kurumsal markalarda, Noon'u genellikle yurt içi büyüme tavanına ulaşmış markaların Körfez ülkelerine açılma …",
"equivalents": {
"en": "https://nodusworks.com/en/blog/shopify-noon-integration",
"de": "https://nodusworks.com/de/blog/shopify-noon-integration-marktplatz"
}
}
]
} Kısaltıldı: uzun metinlerin başı gösteriliyor.
nodus_sayfa
- Salt okunur
- Dış ağa çıkmaz
- Tekrarlanabilir
Tek bir sayfayı temiz Markdown olarak okur. Yol ya da tam adres alır; yalnız nodusworks.com adresleri kabul edilir. Uzun sayfalar kısaltılır, kalan bölüm başlıkları ve sayfanın tam adresi sona yazılır.
| Parametre | Tür ve sınır |
|---|---|
path zorunlu | string≤ 300 karakter |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "nodus_sayfa",
"arguments": {
"path": "/entegrasyonlar/shopify-trendyol-entegrasyonu"
}
}
} Örnek yanıtı göster
{
"title": "Shopify Trendyol Entegrasyonu",
"url": "https://nodusworks.com/entegrasyonlar/shopify-trendyol-entegrasyonu",
"type": "integration",
"language": "tr",
"description": "Shopify Trendyol entegrasyonu: ürün, stok ve fiyat eşitleme, sipariş aktarımı. İletişime geçin, Trendyol bağlantınızı sorunsuz kuralım.",
"equivalents": {
"en": "https://nodusworks.com/en/integrations/shopify-trendyol-integration",
"de": "https://nodusworks.com/de/integrationen/shopify-trendyol-integration"
},
"markdown": "# Shopify Trendyol Entegrasyonu\n\nShopify mağazanızdaki ürünleri Trendyol'da satabilmek için iki sistemin birbiriyle sürekli konuşması gerekir. Trendyol'un yayınladığı resmi bir Shopify uygulaması olmadığı için bu bağlantıyı bir entegrasyon aracı kurar. Kurulum satıcı başvurusunun onaylanmasıyla başlar ve tek ürünle verdiğiniz deneme siparişiyle kapanır. …",
"truncated": true
} Kısaltıldı: uzun metinlerin başı gösteriliyor.
nodus_hizmetler
- Salt okunur
- Dış ağa çıkmaz
- Tekrarlanabilir
Hizmetleri gruplarıyla (shopify, software, marketing, seo) ve sayfalarıyla listeler.
| Parametre | Tür ve sınır |
|---|---|
language isteğe bağlı | tr | en | de |
category isteğe bağlı | shopify | software | marketing | seo |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "nodus_hizmetler",
"arguments": {
"language": "tr",
"category": "shopify"
}
}
} Örnek yanıtı göster
{
"language": "tr",
"services": [
{
"title": "Shopify Danışmanlık Hizmeti",
"url": "https://nodusworks.com/hizmetlerimiz/shopify-danismanlik",
"category": "shopify",
"summary": "Shopify danışmanlık hizmeti: mağaza denetimi, 3-6-12 aylık yol haritası, doğru araç ve uzman eşleştirmesi. Komisyonsuz yönlendirme, altı yıllık saha deneyimi"
},
{
"title": "Shopify Dönüşüm Optimizasyonu (CRO)",
"url": "https://nodusworks.com/hizmetlerimiz/shopify-donusum-optimizasyonu-satis-arttirma-cro",
"category": "shopify",
"summary": "Shopify dönüşüm optimizasyonu: A/B testleri, ısı haritası analizi, sepet ve checkout iyileştirmeleri. Dönüşüm oranı ve AOV raporlarıyla ölçülebilir CRO."
}
],
"overview": "https://nodusworks.com/hizmetlerimiz"
} Kısaltıldı: 9 öğeden 2 tanesi ve metinlerin başı gösteriliyor.
nodus_entegrasyonlar
- Salt okunur
- Dış ağa çıkmaz
- Tekrarlanabilir
Pazaryeri, kargo, ERP ve muhasebe entegrasyonlarını platform adı ve sayfasıyla listeler. Kategoriye ya da platform adının başına göre süzülür.
| Parametre | Tür ve sınır |
|---|---|
language isteğe bağlı | tr | en | de |
category isteğe bağlı | marketplace | shipping | erp | accounting |
platform isteğe bağlı | string≤ 60 karakter |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "nodus_entegrasyonlar",
"arguments": {
"language": "tr",
"category": "shipping"
}
}
} Örnek yanıtı göster
{
"language": "tr",
"integrations": [
{
"platform": "Aras Kargo",
"category": "shipping",
"title": "Shopify Aras Kargo Entegrasyonu",
"url": "https://nodusworks.com/entegrasyonlar/shopify-aras-kargo-entegrasyonu",
"summary": "Shopify Aras Kargo entegrasyonu: kargo etiketi, takip senkronizasyonu ve teslimat güncelleme. İletişime geçin, Aras Kargo bağlantınızı sorunsuz kuralım."
},
{
"platform": "HepsiJET",
"category": "shipping",
"title": "Shopify HepsiJET Entegrasyonu",
"url": "https://nodusworks.com/entegrasyonlar/shopify-hepsijet-entegrasyonu",
"summary": "Shopify HepsiJET entegrasyonu: kargo etiketi, takip senkronizasyonu ve teslimat güncelleme. İletişime geçin, HepsiJET bağlantınızı sorunsuz kuralım."
}
],
"overview": "https://nodusworks.com/entegrasyonlar"
} Kısaltıldı: 10 öğeden 2 tanesi ve metinlerin başı gösteriliyor.
nodus_uygulamalar
- Salt okunur
- Dış ağa çıkmaz
- Tekrarlanabilir
Nodus Works'ün Shopify uygulamalarını, SaaS ürünlerini ve ücretsiz araçlarını kısa açıklama ve sayfasıyla listeler.
| Parametre | Tür ve sınır |
|---|---|
language isteğe bağlı | tr | en | de |
kind isteğe bağlı | shopify_app | saas | free_tool |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "nodus_uygulamalar",
"arguments": {
"language": "tr",
"kind": "saas"
}
}
} Örnek yanıtı göster
{
"language": "tr",
"products": [
{
"name": "Agencio: Ajans Operasyon Yönetim Paneli",
"kind": "saas",
"url": "https://nodusworks.com/saas-cozumleri/agencio",
"summary": "Müşteri portalı, ticket yönetimi, CRM ve proje takibini tek platformda birleştirin. Ajans operasyonunuzu Slack ve Trello'suz yönetin."
},
{
"name": "Station: Shopify Çok Kanallı Entegrasyon",
"kind": "saas",
"url": "https://nodusworks.com/saas-cozumleri/station",
"summary": "Shopify'ı pazaryerleri, ERP ve kargo firmalarıyla tek panelden yönetin. Gerçek zamanlı stok senkronizasyonu ile aşırı satışı önleyin."
}
],
"overview": "https://nodusworks.com/shopify-uygulamalari-saas-ve-araclar"
} Kısaltıldı: 3 öğeden 2 tanesi ve metinlerin başı gösteriliyor.
nodus_vakalar
- Salt okunur
- Dış ağa çıkmaz
- Tekrarlanabilir
Vaka çalışmalarını marka, sektör, altyapı, nereden nereye geçildiği, pazar ve kapsamla listeler. Serbest metinle ya da geçilen eski platforma göre süzülür; istenirse vaka sayfası olmayan referans markaları da ekler.
| Parametre | Tür ve sınır |
|---|---|
language isteğe bağlı | tr | en | de |
query isteğe bağlı | string≤ 80 karakter |
migrated_from isteğe bağlı | string≤ 40 karakter |
include_references isteğe bağlı | booleanvarsayılan false |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "nodus_vakalar",
"arguments": {
"language": "tr",
"migrated_from": "Ticimax"
}
}
} Örnek yanıtı göster
{
"language": "tr",
"cases": [
{
"brand": "Antioch",
"title": "Antioch: Shopify Plus, Nebim ve Mobil Uygulamayla Erkek Giyim",
"url": "https://nodusworks.com/case-study/antioch-shopify-plus-nebim-ve-mobil-uygulamayla-erkek-giyim",
"sector": "Erkek giyim",
"platform": "Shopify Plus",
"from": "Ticimax",
"to": "Shopify",
"scope": "10 iş kalemi",
"summary": "Antioch, şık ve kaliteli parçalarıyla öne çıkan bir erkek giyim markası. Stok ve siparişlerini Nebim ERP ile tek düzende yöneten, web ve mobil uygulamada aynı deneyimi sunan ve …"
},
{
"brand": "Fellas Foods",
"title": "Fellas Foods: Shopify Migration ile Performans ve SEO",
"url": "https://nodusworks.com/case-study/fellas-foods-shopify-migration-performans-seo-guclendirmesi",
"sector": "Sağlıklı atıştırmalık",
"platform": "Shopify",
"from": "Ticimax",
"to": "Shopify",
"scope": "4 iş kalemi",
"summary": "Fellas, hızlı büyüyen ve yüksek sipariş hacmine sahip bir sağlıklı atıştırmalık markası. Marka, satış operasyonunu daha güçlü bir altyapıya taşımak; bunu yaparken mevcut …"
}
],
"overview": "https://nodusworks.com/case-study"
} Kısaltıldı: 4 öğeden 2 tanesi ve metinlerin başı gösteriliyor.
nodus_iletisim
- Salt okunur
- Dış ağa çıkmaz
- Tekrarlanabilir
Telefon, WhatsApp, e-posta, adres, toplantı bağlantısı ve iletişim sayfasını verir. Sunucu mesaj gönderemez; bağlantılar kullanıcının kendisi içindir.
| Parametre | Tür ve sınır |
|---|---|
language isteğe bağlı | tr | en | de |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "nodus_iletisim",
"arguments": {
"language": "tr"
}
}
} Örnek yanıtı göster
{
"language": "tr",
"contact_page": "https://nodusworks.com/iletisim",
"phone": "+90 850 888 2815",
"phone_uri": "tel:+908508882815",
"whatsapp": "https://wa.me/908508882815",
"email": "hub@nodusworks.com",
"meeting": "https://nodusworks.com/iletisim#toplanti",
"address": "Batı, Dr. Orhan Maltepe Cd. 52/5, 34890 Pendik/İstanbul",
"linkedin": "https://linkedin.com/company/nodusworks",
"instagram": "https://instagram.com/nodusworks",
"note": "Bunlar sitedeki iletişim adresleri. Mesajı, formu ve toplantıyı ziyaretçi kendisi gönderir."
} Kaynaklar
Araçları çağırmadan bağlama eklenebilen hazır belgeler. Hepsi Markdown'dır ve araçlarla aynı indeksten üretilir.
| Adres | İçerik |
|---|---|
nodus://overview | Nodus Works'ün kısa tanıtımı, üç dildeki ana bölümler ve belgelenmiş içerik sayıları |
nodus://services | Gruplarıyla bütün hizmetler ve sayfaları |
nodus://integrations | Pazaryeri, kargo, ERP ve muhasebe entegrasyonları |
nodus://apps | Shopify uygulamaları, SaaS ürünleri ve ücretsiz araçlar |
nodus://case-studies | Marka, sektör ve geçiş yoluyla vaka çalışmaları |
nodus://contact | İletişim kanalları ve iletişim sayfaları |
nodus://page/{+path} | Herhangi bir sayfa, örneğin nodus://page/hizmetlerimiz/shopify-magaza-kurulumu |
İstemler
Claude gibi istemcilerde menüden seçilebilen hazır görevler. Her istem asistana araçları hangi sırayla kullanacağını ve kaynak göstermesini söyler.
| İstem | Ne yapar | Argüman |
|---|---|---|
nodus_gecis_plani | Mevcut platformdan Shopify'a adım adım geçiş taslağı çıkarır | platform, isteğe bağlı language |
nodus_entegrasyon_secimi | Pazaryeri, kargo, ERP ve muhasebe ihtiyaçlarına uyan entegrasyonları bulur | needs, isteğe bağlı language |
nodus_tanitim | Nodus Works'ü kaynaklarıyla kısaca tanıtır | isteğe bağlı language |
Taşıma ve sürümler
Sunucu MCP'nin Streamable HTTP taşımasını kullanır: her istek POST /mcp ile gelir, yanıt tek bir JSON gövdesidir. Akış (SSE) açılmaz, oturum tutulmaz; her istek kendi başına işlenir. GET ve DELETE 405 döner.
| Sürüm | Başlangıç | Not |
|---|---|---|
2026-07-28 | server/discover, el sıkışma yok | Her istek _meta alanında sürüm ve istemci yeteneklerini taşır |
2025-11-25 | initialize | Oturum kimliği üretilmez |
2025-06-18, 2025-03-26, 2024-11-05 | initialize | Eski istemciler için |
Desteklenen yöntemler: server/discover, initialize, ping, tools/list, tools/call, resources/list, resources/templates/list, resources/read, prompts/list, prompts/get. Bildirimler gövdesiz 202 alır; toplu (batch) istek kabul edilmez.
Başlıklar
| Başlık | Kural |
|---|---|
Content-Type | application/json olmalı, değilse 415 |
MCP-Protocol-Version | 2026-07-28 isteklerinde gövdedeki sürümle aynı olmalı |
Mcp-Method | Gövdedeki method ile aynı olmalı |
Mcp-Name | tools/call, resources/read ve prompts/get için araç, kaynak ya da istem adı; ASCII dışı ad base64 biçiminde gönderilir |
Hata kodları
| Kod | HTTP | Anlamı |
|---|---|---|
-32700 | 400 | Gövde JSON olarak çözülemedi |
-32600 | 400 | Geçersiz istek: toplu istek, yanlış id, fazladan alan |
-32601 | 404 | Bilinmeyen yöntem |
-32602 | 400 | Bilinmeyen araç, istem ya da kaynak; eksik _meta |
-32020 | 400 | Başlık ile gövde uyuşmuyor |
-32022 | 400 | Desteklenmeyen protokol sürümü; yanıt desteklenenleri listeler |
-31429 | 429 | Hız sınırı; Retry-After başlığı bekleme süresini verir |
-31403 | 403 | İzin verilmeyen köken |
Araç girdisindeki hatalar protokol hatası değil, isError: true taşıyan araç sonucudur. Böylece asistan hatayı okuyup isteğini düzeltebilir.
Güvenlik modeli
Sunucu bir dil modeli çağırmaz ve hiçbir hesaba bağlı değildir. Bir yapay zeka asistanının bu adresle yapabileceği tek şey, sitede zaten herkese açık olan sayfaları okumaktır.
Salt okunur
Araçların hepsi readOnlyHint: true ve destructiveHint: false taşır. Ağa çıkan, dosya açan ya da kayıt yazan bir araç yoktur.
Sır yok
Sunucu hiçbir ortam değişkeni okumaz, anahtar ya da parola taşımaz. İndekste sır kalıbı, yerel yol ve iç adres olmadığı testle denetlenir.
İçerik veridir
Sunucu talimatı, dönen metnin site içeriği olduğunu ve talimat sayılmaması gerektiğini istemciye söyler. Derlemede etiket, betik ve stil atılır.
Sorgu yansıtılmaz
Arama sonucu sorguyu geri yazmaz, hata metinleri sabittir. Yığın izi, dosya yolu ya da iç yapı yanıta girmez.
Kapalı şemalar
Tanımlı olmayan alan reddedilir. Sayfa yolunda .., %, ters bölü ve kontrol karakteri kabul edilmez; yabancı konağa hiçbir zaman istek atılmaz.
Sınırlar
Gövde, derinlik, hız ve eşzamanlılık sınırlıdır. Yanıtlar no-store ile önbelleğe alınmaz, arama motorlarına kapalıdır.
| Sınır | Değer |
|---|---|
| İstek gövdesi | 16 KB |
| JSON derinliği ve alan sayısı | 12 düzey, 200 alan |
| Arama sorgusu | 300 karakter |
| Sonuç sayısı | 1–10, varsayılan 5 |
| Hız | IP başına dakikada 120 istek |
| Eşzamanlı istek | IP başına 4, toplam 32 |
Tarayıcıdan gelen isteklerde yalnız https://nodusworks.com ve https://www.nodusworks.com kökenlerine izin verilir. Masaüstü ve bulut istemcileri köken başlığı göndermediği için bu kural onları etkilemez.
Sıkça sorulan sorular
- Kullanmak için hesap ya da anahtar gerekiyor mu?
Hayır. Adres herkese açıktır; hesap, API anahtarı ya da OAuth girişi istemez. Kötüye kullanıma karşı yalnız hız sınırı vardır.
- Yapay zeka bu bağlantıyla benim adıma bir şey yapabilir mi?
Hayır. Bağlantı sitede yayımlanmış sayfaları okur; siparişinize, formunuza, e-postanıza ya da takviminize erişmez. İletişim istediğinizde telefonu, e-postayı ve toplantı linkini size bırakır. Mesajı siz gönderirsiniz.
- Cevaplar nereden geliyor, güncel mi?
Cevaplar sitede yayımlanan Türkçe, İngilizce ve Almanca sayfalardan gelir. Yayındaki sayfa güncellenince yanıt da o sayfayı izler.
- Sorularım kaydediliyor mu?
Sunucu kodu sorguyu hiçbir yere yazmaz, oturum açmaz ve çerez kullanmaz. Hız sınırı için IP adresi yalnız bellekte, bir dakikalık bir sayaçta tutulur.
- Hangi dilde soru sorabilirim?
Türkçe, İngilizce ya da Almanca. Sorunun dili algılanır ve o dildeki sayfalar öne çıkar;
languageparametresiyle tek bir dile de sabitlenebilir.- Prompt injection riskine karşı ne yapılıyor?
İçerik yalnız Nodus Works'ün kendi sayfalarından gelir ve derlemede temizlenir. Sunucu talimatı, dönen metni veri olarak işaretler; sorgu yanıta yansıtılmaz. En önemlisi, araçlar eylem yapamadığı için yönlendirilmiş bir asistan bile bu sunucu üzerinden bir şey değiştiremez.
- Tarayıcıda adresi açınca hata görüyorum. Sunucu çalışmıyor mu?
Çalışıyor. MCP istekleri
POSTile gelir; tarayıcının attığıGETisteğine sunucu bilerek 405 döner. Denemek için yukarıdaki canlı kutuyu ya da curl komutunu kullanın.- Claude ya da ChatGPT bağlanamıyor. Neye bakmalıyım?
Adresin sonunda
/mcpolduğundan ve kimlik doğrulamanın kapalı (No sign in, No authentication) seçildiğinden emin olun. Claude bağlayıcıları sunucuya bilgisayarınızdan değil Anthropic'in sunucularından bağlanır; bu yüzden şirket ağınızdaki bir kısıtlama Claude'un bağlantısını etkilemez.
Mağazanıza kurulacak iş
Bu sunucu yalnızca siteyi okur.