MCP Kullanım Rehberi

Bu sayfa, MCP Server bağlantısı kurulduktan sonra günlük kullanımda işe yarayan istem kalıplarını ve araçların davranışını anlatır.

Altın kural: space ve projeyi yazın

Her istekte space ve proje adını verin. Vermezseniz model bunları bulmak için önce listeleme çağrıları yapar; sonuç aynı olsa da gereksiz tur atar.

✗  What is the value of temp_value?
✓  In space guide, project Docs Demo — what is the value of temp_value?

Kılavuz araçları

Sunucu, her konu için ayrı bir kılavuz aracı sunar. Bunlar yazma işlemlerinden önce çağrılır: metot imzaları, enum yazımları ve script motoru kuralları sürümler arasında değiştiği için modelin hafızası değil kılavuz esas alınır.

Araç	Konu
inscada_guide_script	Script yazma, ins.* API’si
inscada_guide_animation	Animasyon, eleman tipleri, expression’lar
inscada_guide_faceplate	Faceplate ve placeholder’lar
inscada_guide_custom_html	Custom HTML sayfaları
inscada_guide_custom_menu	Özel menüler
inscada_guide_chart	Grafikler
inscada_guide_alarm	Alarm tanımları ve grupları
inscada_guide_variable	Değişkenler, ölçekleme, loglama
inscada_guide_connection · inscada_guide_protocol	Bağlantılar ve protokol ayarları
inscada_guide_trend	Trend tanımları
inscada_guide_report · inscada_guide_html_report	Raporlar
inscada_guide_component	Bileşen kütüphanesi
inscada_guide_role_menu · inscada_guide_access_group	Rol, menü ve erişim yetkileri
inscada_guide_admin_monitor	Yönetim ve izleme araçları

Nereden başlayacağınızı bilmiyorsanız inscada_welcome yetenek listesini ve örnek istemleri döndürür.

Kılavuzu siz istemek zorunda değilsiniz

Model, yazma işlemi yapacağı konunun kılavuzunu kendisi çağırır. Yine de bir animasyon veya script işine girerken “read the guide first” demek, modelin hafızasından gitmesini engellemenin en kısa yoludur.

Senaryolar

Aşağıdaki örnekler guide space’indeki Docs Demo projesine göredir.

Canlı değer okuma

Kılavuz gerekmez.

In space guide, project Docs Demo — value of temp_value?

In space guide, project Docs Demo — show the current values of all variables

In space guide — check the connection statuses

Geçmiş veri ve grafik

Kılavuz gerekmez; zaman aralığını yazın.

In space guide, project Docs Demo — chart temp_value for the last 24 hours

In space guide, project Docs Demo — compare temp_value and press_value, last 6 hours

In space guide, project Docs Demo — 7-day statistics for temp_value

Değişken keşfi

In space guide, project Docs Demo — list the variables

In space guide, project Docs Demo — list variables whose name contains "press"

Alarm ve durum

In space guide — show the active alarms

In space guide, project Docs Demo — project status

Script yazma

Kılavuz gerekir. Script motoru ES5’tir ve ins.* imzaları sürümle değişir.

Read the script guide first. In space guide, project Docs Demo —
write a script that runs every 10 seconds and raises a notification
when temp_value goes above 60

Var olan bir script’i değiştirmek için de aynı sıra geçerlidir:

Read the script guide first. In space guide, project Docs Demo —
read the "Pump Supervisor" script and change its threshold to 65

Script içinde arama kılavuz gerektirmez:

In space guide — search the scripts for "getVariableValue"

Animasyon oluşturma

Kılavuz gerekir. Eleman tipleri ve expression tipleri kritiktir.

Read the animation guide first. In space guide, project Docs Demo —
create an SVG animation showing temp_value, press_value and tank_bar

Bar ve Pipe elemanlarında görsel ayarlar çalışma zamanında da belirlenebilir: EXPRESSION tipi bir obje döndürürse, kayıtlı props yerine o objedeki alanlar kullanılır — akış durumunu ve rengini aynı ifadeden sürmek bu yüzden mümkündür.

Read the animation guide first. In space guide, project Docs Demo —
create a water system mimic. The pipe should change colour and speed
with pump state: blue and flowing when running, grey and stopped when off

Bu istek için üretilen ifade return true/false yerine şuna benzer:

var running = ins.getVariableValue('motor_lamp') == 1;
return {
  value: running,
  fillColor: running ? '#04B3FF' : '#999999',
  speed: 2000,
  strokeArray: 10
};

Obje döndürme yalnızca Bar ve Pipe’ta props’u ezer

Diğer tiplerde ifadenin döndürdüğü obje yalnızca value alanı için açılır; renk, hız, kalınlık gibi ayarlar eleman kaydındaki props alanından okunur. Ayrıntı: Element Editor.

Dashboard

Şablonla çalışıyorsanız kılavuz gerekmez; özel HTML için gerekir.

In space guide, project Docs Demo — gauge dashboard for temp_value, 0-100

Read the custom HTML guide first. In space guide, project Docs Demo —
custom HTML dashboard: three gauges on top, a trend chart below

Harici kaynakları yerele almak. Custom HTML sayfaları içerik güvenlik politikasına tabidir; izin verilmeyen bir CDN’den JS, CSS, font veya resim çekmek yerine dosyayı platforma yükleyip yerelden kullanın. Yüklenen dosya /api/files/static/<ad> adresinden servis edilir; sayfadaki CDN adresini bu yolla değiştirmeniz yeterlidir.

In space guide — upload chart.min.js to the static files,
then build the dashboard referencing it instead of the CDN

Excel’e aktarma

In space guide, project Docs Demo — export 24 hours of temp_value to Excel

API keşfi

Find the alarm endpoints in the inSCADA API

Hızlı başvuru

Görev	İstem kalıbı	Kılavuz
Canlı değer	In space X, project Y — value of <var>?	Hayır
Grafik	... chart <var> for the last 24 hours	Hayır
Gauge	... gauge dashboard for <var>, 0-100	Hayır
İstatistik	... 7-day statistics for <var>	Hayır
Alarmlar	In space X — show the active alarms	Hayır
Proje durumu	In space X, project Y — project status	Hayır
Değişken listesi	... list the variables	Hayır
Script	Read the script guide first. ...	Evet
Animasyon	Read the animation guide first. ...	Evet
Özel dashboard	Read the custom HTML guide first. ...	Evet
Excel	... export 24 hours of <var> to Excel	Hayır
API keşfi	Find the <topic> endpoints in the inSCADA API	Hayır

Compact ve verbose yanıtlar

Araçlar varsayılan olarak yalnızca gereken alanları döndürür. Ham alanlara ihtiyaç duyduğunuzda “detaylı ver” demeniz veya verbose: true geçmeniz yeterlidir.

inscada_get_live_value — varsayılan:

{
  "value": 421.79,
  "name": "temp_value",
  "dsc": "Bearing temperature",
  "date": "2026-04-03T00:43:08"
}

Verbose yanıt bunlara ek olarak ölçeklenmiş/ham değer ayrımını (flags, extras.raw_value), değişkenin frame–device–connection zincirini ve epoch milisaniye damgasını içerir.

list_variables — varsayılan olarak id, name, type, unit, dsc döner; verbose ayrıca connection_id, project_id, ölçekleme sınırları ve loglama ayarlarını ekler.

Token tüketimini ne belirler

• Space ve projeyi yazmak en büyük tek kazançtır; model keşif çağrısı yapmaz.
• Kılavuz yalnızca gerektiğinde yüklenir. Canlı değer sorarken kılavuz istemeyin.
• Compact varsayılanı bozmayın. “Detaylı” gerçekten ham alan gerektiğinde işe yarar.
• Değişkenleri süzerek isteyin. 500 değişkenli bir projede “list the variables” yerine ada göre süzmek yanıtı belirgin şekilde küçültür.
• Basit sorgular için küçük bir model yeterlidir; kılavuz gerektiren script ve animasyon işlerinde büyük model tercih edilir.