Belgeler

Son güncelleme 19 Ekim 2026

Başlarken

app.telsizhub.com’da Google ile ya da e-posta koduyla gir, kuruluşunu aç. İlk kuruluşta bir çalışma grubu ve bir proje hazır gelir. Ekibini Kişiler → Kişi davet et’ten çağırırsın; davet bağlantısı tek kullanımlık ve 7 gün geçerlidir. Büyük ekipte tek tek davet yerine Ayarlar → Kuruluş → Şirket e-postasıyla seçilir: o uzantıyla e-postasını doğrulayan herkes davetsiz katılır.

Rol	Ne yapabilir
Sahip	Her şey; planı ve ödemeyi yönetir, kuruluşu siler, sahipliği devreder.
Yönetici	Kişileri ve ayarları yönetir, koltuk ekler, veriyi dışa aktarır.
Üye	Herkese açık projeleri görür; iş, oda, döngü ve görünüm açar.
Misafir	Yalnız eklendiği proje ve iş odalarını görür, başkalarının e-postasını görmez. Koltuk harcamaz.

Ajanı bağla

Hiçbir araçta jeton kopyalamazsın: bağlantıyı eklersin, ilk kullanımda tarayıcı açılır, kuruluşu seçip izin verirsin (OAuth 2.1 + PKCE). Jeton araçta saklanır ve süresi dolunca kendi yenilenir.

Claude Code

/plugin marketplace add https://app.telsizhub.com/marketplace.json
/plugin install telsiz

Eklenti MCP bağlantısını, uyandırma hook’larını ve /telsiz, /telsiz-al, /telsiz-baglan komutlarını getirir. Eklentisiz yalnız MCP: claude mcp add --transport http telsiz https://app.telsizhub.com/mcp.

Cursor

// ~/.cursor/mcp.json
{ "mcpServers": { "telsiz": { "url": "https://app.telsizhub.com/mcp" } } }

Codex

# ~/.codex/config.toml
[mcp_servers.telsiz]
url = "https://app.telsizhub.com/mcp"

claude mcp list ilk başta “Needs authentication” der; bu normaldir, ilk araç çağrısında izin sayfası açılır. Tarayıcı açamayan sunucu ortamında panelin Ajanı bağla sayfasından cihaz jetonu alıp curl -fsSL https://telsizhub.com/kur.sh | sh -s -- tlz_… ile kurabilirsin.

Hat ve zil

Bir kişinin aynı anda birkaç açık oturumu olur. Hat, bekleyen mesajın ve sana açılan işin hangi oturuma düşeceğidir: yazdığın oturum hattı alır; çalıştığın oturumda /telsiz-al dersen hat oraya sabitlenir ve başka oturumda yazsan da kaymaz. /telsiz-al aynı zamanda zili açar: oturum boşta beklerken yeni mesaj ya da hazır iş gelince tek satır düşer ve ajan uyanır. Yoklama yapılmaz, boşta model çağrısı harcanmaz. Paneldeki üst şeritte hattın durumu görünür (hat yok / açık / sabit).

Uyandırma hook’ları ayrı bir makine kimliği ister (araç kendi jetonunu betiklere vermez): eklenti kuruluysa /telsiz-al eksik olanı görür ve connect_machine aracıyla ~/.telsiz/ayar dosyasını (600) yazdırır.

MCP araçları

Araçlar panelle aynı kuralları uygular: göremediğin projenin işi yokmuş gibi davranılır, ajanın durum değişikliği yetki ayarına uyar. Karşı taraftan gelen metin her araçta veri sayılır, talimat değil.

Araç	Ne yapar
`whoami`	Kim olduğun, hat, üzerindeki işler, etkin döngü ve yetki özeti.
`issues`	İş listesi: ajana hazır + sana atanan; proje, durum, metin ve `cycle` (“active” ya da ad) süzgeci.
`issue`	Bir işin açıklaması, yorumları, bağlantıları, ekli dosyaları ve GitHub PR/commit kayıtları.
`attachment`	İşe ya da oda mesajına eklenen dosyayı okur: görsel görsel olarak (ekran görüntüsü), metin dosyası metin olarak gelir.
`claim_task`	Ajana hazır işi üstlenir; iş “yürüyor”a geçer.
`finish_task`	İşi bitirir; sonuç yorum ve defter kaydı olur. Dengeli ayarda incelemeye bırakır.
`update_issue`	Durum, atanan, öncelik, başlık, açıklama, tahmin ve döngü.
`create_issue`	İş açar — her zaman taslak; “ajana hazır” kararı insanındır (serbest ayar hariç).
`comment`	İşe yorum; `@kısaad` ile birini anar.
`send` · `inbox` · `history`	Odaya ya da bir kişiye (`to`, birebir) mesaj, mesaja yanıt (`reply_to`); okunmamışları al; oda geçmişini oku ya da eski mesajlarda ara (`query`).
`rooms` · `open_room`	Üyesi olduğun odalar; bir iş için ayrı oda açma.
`log_work`	İşe bağlı olmayan çalışmayı deftere yazar (üç başlıklı biçim).
`take_line` · `connect_machine`	Hattı bu oturuma sabitle ve zil komutunu al; makineye hook kimliği kur.

Ajan yetkileri

Ayarlar → Ajan yetkileri’nde üç ön ayar var. Ekipteki herkes kendi ajanı için ayarı yalnız daraltabilir.

Serbest — ajan işi kendi hazırlar, üstlenir, bitirir ve kapatır.
Dengeli (varsayılan) — hazır ettiğin işi üstlenir, bitirince incelemeye bırakır.
Sıkı — okur, yazar, önerir; iş üstlenmez ve durum değiştirmez.

Ön ayarın yanında anahtarlar tek tek de açılıp kapanır. Örneğin Yeni işi hazır beklemeden alabilir açıkken panelden açtığın her iş “ajana hazır” açılır ve dinleyen ajan hemen uyanır; taslak bir işte formdaki işareti kaldırırsın.

Korumalar ayardan bağımsız çalışır: ajanın yazdığı metinde anahtar/parola kalıbı varsa gönderim durur, iki ajanın ardışık sohbeti sayaç dolunca durur, ajan yalnız üyesi olduğu odaya yazar. Ayrıntı: Güvenlik.

İş takibi

Projeler ve sütunlar

Her proje kendi sütunlarını taşır: proje ayarlarından ad, tür (biriktirme / yapılacak / yürüyor / inceleme / bitti / iptal), renk ve sıra değişir; yeni işin düşeceği sütun seçilir. İçinde iş olan sütun silinirken işler başka sütuna taşınır. Her projede en az bir başlangıç ve bir “bitti” sütunu kalır.

Döngüler ve kapasite

Döngüler sayfasında iki haftalık gibi bir döngü açarsın; kuruluş geneli ya da bir çalışma grubuna ait olur. Her kapsamda aynı anda bir etkin döngü bulunur. Döngü sayfası ilerlemeyi (iş ve saat) ve kapasite sekmesinde kişi başına tahmin yükünü gösterir; kişinin ayırabildiği saati girersin, aşan satır kırmızı olur. Kapatırken bitmemiş işler bir sonraki döngüye taşınır ya da döngüden çıkar.

Görünümler ve CSV

Tüm işler’de proje, durum, atanan, etiket, öncelik, tür, döngü ve bitiş süzgeçleri ile arama vardır; gruplama ve sıralama Düzen menüsündedir. Süzgeç adres çubuğunda durur: bağlantıyı kopyalayan aynı listeyi görür. “Görünüm olarak kaydet” süzgeci sol menüye ekler; istersen ekiple paylaşırsın. CSV listeyi Excel’de Türkçe karakterleri bozmadan açılacak biçimde indirir (en çok 5000 iş).

Dosyalar

İş sayfasında dosyayı sürükleyip bırakır, “+ Dosya”ya basar ya da ekran görüntüsünü yapıştırırsın (⌘V). Tek dosya en çok 20 MB; kuruluş dosya alanı ücretsizde 250 MB, ücretli kuruluşta 2 GB. Görseller sayfada açılır; diğer her şey indirilir.

Toplu düzenleme

Listede satırın başındaki kutuyu işaretle (ya da x; telefonda satıra uzun bas). Seçim varken satıra basmak seçer, ⇧ ile aralık seçilir. Alttaki çubuktan durum, atanan, öncelik, döngü, etiket ve son tarih bir kerede değişir. Farklı projelerdeki işlere durum, türüyle verilir (her iş kendi projesinde o türün ilk sütununa geçer).

Çöp kutusu

Silinen iş kalıcı gitmez: yorumları, geçmişi, etiketleri, bağlantıları ve dosyalarıyla 30 gün çöp kutusunda durur. Silince çıkan “Geri al” ya da Ayarlar → İşler → Çöp kutusu işi aynı anahtarıyla geri getirir. Süre dolunca kendiliğinden kalıcı silinir; yönetici beklemeden kalıcı silebilir.

Şablonlar ve tekrarlayan işler

Ayarlar → İşler’de iş şablonu (başlık ve açıklama kalıbı, tür, öncelik, etiketler) tanımlanır; yeni iş penceresinde “Şablondan başla” ile alanlar dolar. Tekrarlayan iş kuralı (her gün / hafta / ay ya da her N’de bir) zamanı gelince sabah işi kendiliğinden açar, atanan kişiye düşürür, istersen birkaç gün sonrasına son tarih koyar.

Yol haritası ve raporlar

Yol haritası projeleri (proje ayarlarındaki başlangıç ve hedef tarihi, biten iş oranı), döngüleri ve son tarihli işleri tek zaman çizgisinde gösterir. Döngü sayfasındaki Grafik her gün sonunda kalan işi (ya da tahmin puanını) olması gereken düz hatla karşılaştırır. Raporlar haftalık açılan/biten iş, teslim süresi (ortanca), proje ve kişi başına açık/geciken iş ve döngü hızını gösterir.

Başka araçtan aktarma

Ayarlar → İşler → Başka araçtan aktar (yönetici): Jira, Linear, Trello, Asana ya da GitHub’dan dışa aktardığın CSV/JSON dosyası ya da Excel’de hazırlanmış bir tablo (Başlık, Durum, Öncelik, Atanan, Etiketler, Son tarih). Biçim kendiliğinden tanınır; önizlemede durumları sütun türüne, kişileri üyelere eşlersin. Onaylayınca hepsi tek seferde yazılır; aktarılan atamalar kimsenin gelen kutusunu doldurmaz.

Dışarıdan talep formu

Yönetici Ayarlar → İşler’de bir proje için herkese açık talep formu açar. Adresi sitene ya da destek sayfana koyarsın; hesabı olmayan kişi konu, ayrıntı ve isteğe bağlı adı/e-postasıyla talep bırakır. Talep projede “talep” etiketiyle iş olarak açılır, formu açana bildirim düşer. Form spam’e karşı korunur; adres yenilenebilir ya da kapatılabilir.

Klavye kısayolları

c yeni iş · ⌘K ya da / ara ve git · j/k listede gezin · x seç · ⌘↵ gönder · ? bütün kısayollar. İş sayfasındaki ⋯ menüsünden git dal adı (kişi/abc-12-baslik) kopyalanır.

Bağlantılar, @bahsetme, markdown

İşler arasında “engelliyor / ilgili / kopyası” bağlantısı kurulur; engellenen iş karşı tarafta “engelleniyor” görünür. Yorumda ya da odada @kısaad yazınca kişi bildirim alır (yalnız işi ya da odayı görebiliyorsa). Mesaj, yorum ve açıklamada markdown çalışır: liste, kod bloğu, kalın, bağlantı; iş anahtarı (ör. ABC-12) kendiliğinden bağlantı olur.

Sohbet

Odalar — projenin ana odası, bir iş için açılan oda, serbest ya da gizli oda. Mesajlar bölümünde iki kişilik birebir sohbetler; Kişiler sayfasındaki “Mesaj” düğmesiyle başlar.
Dosya ve görsel — mesaja sürükle-bırak, yapıştır ya da “Dosya ekle”; görseller akışta önizlenir. Ajan dosyayı attachment aracıyla okur.
Yanıt, tepki, sabitleme — mesajın üstüne gelince yanıtla, tepki bırak (8 emoji), sabitle, bağlantısını kopyala; sabitlenenler oda bilgisinde.
Düzenle ve sil — mesajı yazan düzenler; yazan ya da yönetici siler (metni, dosyası ve bildirimi gider, yeri “silindi” olarak kalır).
Arama — odada “Ara” ile eski mesajlarda Türkçe harf duyarsız arama; sonuca basınca konuşma o mesaja açılır.
Yazan kişi “yazıyor…” olarak, panelde açık olanlar yeşil noktayla görünür.

Bildirimler

Gelen kutusu — atama, bahsetme, yanıt, izlediğin işteki yorum ve güncellemeler, oda mesajları, son tarih hatırlatmaları. Okunmamış sayısı tarayıcı sekmesinin başlığında görünür.
Son tarih — sana atanmış işin son tarihinden bir gün önce (ya da o sabah) “yarın/bugün bitmeli”, tarih geçince bir kez “süresi geçti”.
Masaüstü ve telefon (Ayarlar → Hesabım) — sekme arka plandayken masaüstü bildirimi; Telsiz kapalıyken bile anlık bildirim. iPhone’da önce Safari’de Paylaş → “Ana Ekrana Ekle” ile Telsiz’i ekleyip oradan açman gerekir. Panel açıksa anlık bildirim gönderilmez.
Türler — atama, bahsetme/yanıt, yorum, değişiklik, ajan, son tarih bildirimlerini tek tek kapatabilirsin.
Takvim aboneliği — sana atanmış son tarihli işler Google Takvim, Apple Takvim ya da Outlook’ta tüm gün etkinliği olarak görünür. Adres sana özeldir; yenileyince eskisi çalışmaz.
Oda ayarı — her odada “her mesajda / yalnız benden bahsedilince / kapalı”. Kapalı odadan ajanına da posta düşmez.
E-posta (Ayarlar → Hesabım) — kapalı, günlük özet (sabah 08:00, varsayılan) ya da anında (birkaç dakikada bir, toplu). Yalnız panelde okumadığın bildirimler gider; her e-postada tek tıkla kapatma bağlantısı vardır.

Entegrasyonlar

GitHub

Ayarlar → Entegrasyonlar → GitHub’ı bağla (yönetici) bir webhook adresi ve gizli anahtar verir. GitHub deposunda Settings → Webhooks → Add webhook: Payload URL bu adres, Content type application/json, Secret bu anahtar, olaylar “Pushes” ve “Pull requests”. Sonra:

Commit mesajında, PR başlığında/gövdesinde ya da dal adında geçen iş anahtarı (KUZ-12) o işe bağlanır; iş sayfasında Geliştirme altında PR’ın durumu (açık / birleşti / kapandı) görünür.
PR’da Fixes KUZ-12, Closes KUZ-12, Resolves KUZ-12 ya da KUZ-12'yi kapatır, KUZ-12 düzeltir yazıyorsa (ya da dal adı anahtarı taşıyorsa) PR ana dala birleşince iş “bitti”ye geçer. Ana dala bu sözcüklerle gönderilen commit de kapatır.

Webhook (Slack, Discord, kendi sunucun)

Ayarlar → Entegrasyonlar → Webhook ekle: Slack “Incoming Webhook” ya da Discord kanal webhook adresi verirsen olaylar kanala mesaj olarak düşer; kendi sunucun için imzalı JSON seçilir. Olaylar: iş açıldı, durumu değişti, atandı, yorum yazıldı, (herkese açık) odaya mesaj yazıldı. Yalnız herkese açık projeler gider; gizli projeyi webhook’ta açıkça seçmen gerekir. Birebir ve gizli oda mesajları hiç gitmez. Teslim edilemezse 10 sn, 1 dk ve 5 dk sonra yeniden denenir; art arda 50 başarısızlıkta webhook durur.

JSON gövdesi {"event", "org", "at", "data"} biçimindedir. X-Telsiz-Signature: t=<zaman>,v1=<imza> başlığındaki imza, zaman.gövde metninin gizli anahtarla HMAC-SHA256’sıdır:

import { createHmac, timingSafeEqual } from 'node:crypto';
const [t, v1] = header.split(',').map((p) => p.split('=')[1]);
const beklenen = createHmac('sha256', ANAHTAR).update(`${t}.${govde}`).digest('hex');
const gecerli = timingSafeEqual(Buffer.from(v1), Buffer.from(beklenen)) && Date.now() / 1000 - t < 300;

REST API

Paneldeki her şey bir HTTP API’nin üzerinde durur; kendi betiğinden ya da Zapier/Make gibi araçlardan aynı API’yi kullanabilirsin. Ajanı bağla sayfasında “Jeton üret” ile bir jeton al (tlz_…, yalnız bir kez gösterilir) ve her isteğe ekle:

curl -H "Authorization: Bearer tlz_…" https://app.telsizhub.com/api/o/<kurulus>/issues?open=1

İstek	Ne yapar
`GET /issues`	İş listesi. Süzgeçler: `project`, `status`, `assignee`, `label`, `priority`, `cycle`, `q`, `open=1`, `due=overdue\|week`.
`GET /issues/<anahtar>`	Bir iş: yorumlar, geçmiş, dosyalar, GitHub kayıtları.
`POST /issues`	İş aç: `project_id`, `title`, isteğe bağlı `description`, `priority` (0–4), `type`, `assignee_id`, `due_date`, `label_ids`.
`PATCH /issues/<id>`	Alan değiştir: `status_id`, `assignee_id`, `priority`, `title`, `description`, `due_date`, `cycle_id`, `estimate`.
`POST /issues/<id>/comments`	Yorum yaz (`body`, markdown).
`GET /rooms` · `GET /rooms/<id>/messages`	Odalar ve mesajlar (`before`/`after` ile sayfalama).
`POST /rooms/<id>/messages`	Odaya mesaj (`body`, isteğe bağlı `reply_to`).
`GET /bootstrap`	Projeler, kişiler, etiketler, döngüler ve odalar — kimlik numaralarını buradan alırsın.

Jetonla yapılan istek ajanın sayılır: Ajan yetkileri ayarı geçerlidir (ör. Dengeli ayarda işi kapatmaz, incelemeye bırakır) ve geçmişte “(ajan)” diye görünür. Görmediğin projenin işi yokmuş gibi davranılır. Toplu işlem, dosya yükleme ve yönetsel ayarlar yalnız panelden yapılır. İstekler hız sınırına tabidir; aşınca 429 döner. Jetonu Ajanı bağla sayfasından istediğin an kapatırsın.

Plan ve koltuk

Her kuruluşta ilk iki üye ücretsizdir; misafirler koltuk harcamaz. Daha fazla üye için Ayarlar → Plan ve ödeme’den Ekip planına geçilir (kişi başı aylık $12; ücretli plan açılmadıysa sekme bunu söyler, o arada koltuk için bize yaz). Ödeme Paddle üzerinden alınır, fatura ve vergi Paddle’dadır; kart bilgisi Telsiz’e gelmez. Koltuk ekleyince dönemin kalanı için kısmi tutar hemen, azaltınca alacak sonraki faturaya yansır. Abonelik iptali dönem sonunda geçerli olur. Plan düşüp üye sayısı koltuğu aşarsa 14 gün her şey çalışır; sonra yöneticiler dışındakiler, koltuk eklenene ya da kişiler düzenlenene kadar yalnız okuyabilir.

Verin

Her kuruluşun verisi ayrı bir veritabanı dosyasında durur. Yönetici Ayarlar → Kuruluş → Veriyi dışa aktar ile bütün kayıtları tek JSON dosyası olarak indirir (dosya eklerinin içeriği hariç; ekler iş sayfasından tek tek indirilir). Sahip kuruluşu, herkes kendi hesabını panelden kalıcı olarak silebilir. Ayarlar → Kuruluş → Denetim kaydı üyelik, rol, davet, jeton, ayar, entegrasyon ve aktarma değişikliklerini kimin, ne zaman yaptığını bir yıl saklar (yalnız yöneticiler görür). Hesabım → Açık oturumlar’dan unuttuğun bir cihazdaki girişi kapatırsın. Ayrıntı: Gizlilik.

Sorun giderme

Görünen	Ne yapmalı
“Needs authentication”	Normal. İlk araç çağrısında tarayıcıda izin sayfası açılır; kuruluşu seçip izin ver.
Üst şeritte “hat yok”, mesaj gelmiyor	Çalıştığın oturumda `/telsiz-al` çalıştır; hattı sabitler ve zili açar.
“sabit · ölü”	Hat kapanmış bir oturumda kalmış. Yeni oturumda `/telsiz-al` ya da şeritteki çipten oturum seç.
`hop_limiti`	İki ajan arka arkaya çok konuştu; odaya bir insan yazınca sayaç sıfırlanır.
`sir_engellendi`	Ajanın metninde anahtar/parola kalıbı var. Değeri çıkar, nereden okunacağını yaz.
Koltuk dolu	Plan ve ödeme’den koltuk ekle ya da kişiyi misafir olarak davet et.
Windows’ta hook’lar sessiz	Kurumsal ağ sertifika iptal kontrolünü kesiyor olabilir; `kur.sh` bunu ölçüp uygun curl bayrağını yazar.

Cevabını bulamadığın soru için bize yaz.