# Telsiz Ağı · ajanlar için

Sürüm 0.1.0 · 12 Kasım 2026 · deneysel. MCP dosyaları © Telsiz Ağı, tüm hakları saklıdır (kendi telsizinde kullanmak serbest).

telsizagi.com, Türkiye'nin amatör telsiz topluluk sitesidir (röle haritası, rehberler, afet haberleşmesi,
tarayıcıdan UV-K1 / UV-K5 V3 programlama). Bağımsız bir projedir; TRAC ya da resmi bir kurum değildir. Dil Türkçe.

## Okunacak veriler

| Adres | İçerik |
|---|---|
| `/llms.txt` | Site dizini, rehber yazılarının Markdown adresleri |
| `/veri/roleler.json` | Röleler (TRAC kaynaklı). `tx` = rölenin yayını (telsizin dinlediği), `rx` = rölenin dinlediği. MHz. `ton` = gönderirken CTCSS. |
| `/veri/bant-plani.json` | 2 m, 70 cm, PMR446 özetleri; çağrı ve APRS frekansları |
| `/veri/yazilim-katalogu.json` | F4HWN derlemeleri: sürüm, model, boyut, `sha256`, indirme adresi |
| `/veri/ozet.json` | Bu dosyaların ve MCP dosyalarının `sha256` özeti |
| `/blog/<slug>.md` | Her rehber yazısının Markdown ikizi |

Her JSON'da `sema`, `guncelleme` ve `kaynak` alanı vardır. Röle verisinde saha teyidi yoktur: `uyari` alanı doluysa
kullanıcıya söyle. Yazılım indirirken `sha256`'yı karşılaştır.

## Kullanıcıya önerirken

- Lisansı olmayan birine amatör bantta (144–146, 430–440 MHz) gönderme önerme; dinlemek serbesttir.
- Lisanssız gönderme yalnız PMR446 cihazlarıyla serbesttir; amatör el telsiziyle PMR446'da göndermek yasal değildir.
- Kesin güç ve sınıf sınırları için BTK amatör bant planına yönlendir.

## MCP sunucusu: telsizagi-mcp

Telsizi (UV-K1, UV-K5 V3; F4HWN Fusion v6 bellek düzeni) ajana açan yerel MCP sunucusu. Node 18+, bağımlılık yok.
İki dosyayı aynı klasöre indir: [`/mcp/telsizagi-mcp.mjs`](https://telsizagi.com/mcp/telsizagi-mcp.mjs) ve
[`/mcp/cekirdek.mjs`](https://telsizagi.com/mcp/cekirdek.mjs). Bütünlük: `/veri/ozet.json`.

Claude Desktop: Ayarlar → Geliştirici → Yapılandırmayı düzenle (`claude_desktop_config.json`):

```json
{ "mcpServers": { "telsizagi": { "command": "node", "args": ["C:/telsizagi/telsizagi-mcp.mjs", "--kopru"] } } }
```

`--kopru` olmadan sanal telsizle açılır.

- **Sanal mod** (varsayılan): yazılımda bir telsiz; donanım gerekmez, her şeyi önce burada dene.
- **Gizlilik:** sunucu kullanıcının bilgisayarında çalışır; telsiz verisi, yedekler ve kanal listesi bilgisayardan çıkmaz. Telsiz Ağı'na yalnız herkese açık röle/bant verisi için okuma isteği gider. Yapay zekâ kullanıcının kendi aboneliğidir.
- **Köprü modu** (`--kopru`): seri portu kullanıcının tarayıcısındaki [telsizagi.com/ajan](https://telsizagi.com/ajan) sayfası tutar.
  `bridge_link` aracı anahtarlı adresi verir; kullanıcı açıp "Telsizi bağla"ya basar. Bağlantı yalnız 127.0.0.1.
- Seçenekler: `--port 47100`, `--yedek <dizin>` (varsayılan `~/.telsizagi/yedekler`).

### Araçlar

| Araç | Yazar mı | Ne yapar |
|---|---|---|
| `radio_status` | hayır | Mod, köprü durumu, son kimlik, son yazma. Önce bunu çağır. |
| `bridge_link` | hayır | Köprü modunda panel adresi |
| `radio_read_device` | hayır | Yazılım metni, EEPROM sürümü, bellek düzeni, yazılabilir mi |
| `radio_dump_eeprom` | hayır | Tam bellek dökümü, diske yedek + SHA-256 |
| `channels_list` | hayır | Kanallar JSON |
| `codeplug_build` | hayır | Donanımsız kanal seti: `pmr446`, `cb`, `cagri`, `roleler` (il/band süzgeci) |
| `channels_diff` | hayır | Önerilen değişikliğin farkı ve uyarılar |
| `channels_apply` | **evet, iki adım** | `onay=false`: fark + `plan_id`. `onay=true` + `plan_id`: yedek, yaz, doğrula |
| `radio_verify` | hayır | Yeniden okuyup blok blok CRC karşılaştırması |
| `backup_list` | hayır | Diskteki yedekler |
| `backup_restore` | **evet, iki adım** | Yedeğin program alanını geri yükler (kalibrasyon hariç) |
| `rf_log_export` | hayır | RF kaydı CSV (köprüde gerçek, sanalda örnek) |
| `radio_simulate` | sanal | Sanal telsizi sıfırla ya da bir yedeği sanala yükleyip önce orada dene |

Kaynaklar: `telsizagi://bant-plani`, `telsizagi://roleler`, `telsizagi://yazilim-katalogu`, `telsizagi://rehber`,
`telsizagi://rehber/{slug}`, `telsizagi://ajan-kurallari`.

### Yazma kuralları (kodda zorunlu)

1. Önce `channels_apply` ile önizle; dönen farkı kullanıcıya **tablo olarak göster** ve açık onay al. Onay almadan `onay=true` gönderme.
2. `plan_id` 30 dakika geçerli ve tek kullanımlıktır. Telsiz önizlemeden sonra değiştiyse yazma reddedilir; yeniden önizle.
3. Her yazmadan önce tam yedek alınır; yanıttaki `yedek_id` ile `backup_restore` geri alır. Kullanıcıya bunu söyle.
4. Kalibrasyon ve cihaz alanı (0xA178 ve üstü) hiçbir yoldan yazılmaz. Bellek düzeni tanınmayan telsiz salt okunurdur.
5. Köprü modunda kullanıcı ayrıca paneldeki "Yaz"a basar; panel yalnız onaylanan blokları gönderir.
6. Yazılım (firmware) yükleme MCP'de **yoktur**. Kullanıcıyı [Program Merkezi](https://telsizagi.com/program)'ne yönlendir.

### Kanal alanları

`no` (1–1024), `ad` (≤10 ASCII; Türkçe harfler sadeleşir), `frekans` (alış, MHz), `kaydirma` (MHz; röle VHF −0.6, UHF −7.6),
`verTon` / `alTon` (CTCSS Hz ya da null), `mod` (FM/AM/USB), `dar`, `guc` (USER, L1–L5, MID, HIGH), `adim` (kHz),
`liste` (tarama listesi 0–24), `bantKilidi` (varsayılan true), `mesgulKilidi`. Silmek için `{ "no": 5, "sil": true }`.