Erişim anahtarları & MyWay CLI

Tarayıcı dışından MyWay’e bağlanmanın yolu kişisel erişim anahtarıdır: komut satırı aracı (MyWay CLI), betikler, CI işleri ve yapay zekâ asistanları API’yi bu anahtarla çağırır. Anahtar sahibinin yetkisiyle çalışır; panolardaki rolün neye izin veriyorsa onu yapar, fazlasını yapamaz. İş akışı kuralları, statü kilitleri, doldurma kuralları, oran sınırı ve denetim kaydı tarayıcıdan gelen istekle aynı şekilde uygulanır (v1.82.0). Yazma istekleri kullanıcı başına dakikada sınırlıdır (varsayılan olarak genel yazma 60, yorum 60, GitLab çağrısı 10, içe aktarma 10; süper yönetici Ayarlar > Sistem sınırları’ndan değiştirir). Sınıra takılan istekte CLI, sunucunun bildirdiği süre kadar bekleyip isteği en çok üç kez yeniden dener (her bekleme en çok 60 saniye) ve bunu hata çıktısına yazar; üç denemeden sonra hata verir (v1.108.0). Claude Desktop araçları da CLI’ı çalıştırdığı için aynı şekilde bekler. Süper yönetici Ayarlar > Sağlık’taki "Komut satırı ve MCP" kartında CLI ya da MCP kullanan kişileri ve sürümlerini görür; eski sürümdekiler işaretlenir (v1.108.0). Anahtarla yapılan istekler (CLI, betik, yapay zekâ asistanı) seni çevrimiçi göstermez: çevrimiçi durumu yalnız tarayıcıdaki gerçek etkileşimden hesaplanır, anahtarın kullanımı listedeki "son kullanım" bilgisinde görünür (v1.101.0).

Anahtar oluşturmak

Anahtarlar Ayarlar > Erişim anahtarları’nda (Hesabım grubu), Kişisel erişim anahtarları kartında yönetilir. Sekme her kullanıcıda vardır, yönetici yetkisi gerekmez. Kartın üstündeki satırda anahtar adı (örneğin dizüstü, Claude Code) yazılır, kapsam (varsayılan Okuma ve yazma) ve geçerlilik (varsayılan 90 gün) seçilir ve "Anahtar oluştur"a basılır.

• Anahtar yalnız oluşturulduğu anda, "Anahtarın hazır" kutusunda bir kez gösterilir. "Kopyala" ile al ve sakla; kaybedersen iptal edip yenisini oluştur. Sunucu anahtarın kendisini değil yalnız özetini saklar
• Listede her anahtarın adı, kapsamı, oluşturulma ve son geçerlilik tarihi ile son kullanım zamanı ("hiç kullanılmadı" ya da "son kullanım …") görünür. Son kullanım, anahtar kullanıldıkça en çok beş dakikada bir güncellenir
• "İptal et" anahtarı hemen geçersiz kılar: onu kullanan her araç erişimini o anda kaybeder. Sızdığını fark ettiğin okuma ve yazma anahtarını elindeki o anahtarla da iptal edebilirsin; salt okuma anahtarı yalnız tarayıcıdan iptal edilir
• Yeni anahtar yalnız tarayıcıdan oturum açmışken oluşturulur; bir anahtarla başka bir anahtar üretilemez. Böylece sızan bir anahtar kendine yeni ve süresiz bir anahtar açıp iptalden kaçamaz
• Bir kullanıcı en çok 20 anahtar tutabilir. Kullandığın her araç için ayrı anahtar aç: biri sızarsa yalnız onu iptal edersin
• Parolanı değiştirmek anahtarları düşürmez, çünkü anahtar parolanın türevi değil ayrı bir kimlik bilgisidir. Hesabın devre dışı bırakılırsa ise anahtarların hepsi o anda çalışmaz olur
• Oluşturma ve iptal, çalışma alanı yöneticilerinin gördüğü çalışma alanı denetim kaydına "Erişim anahtarı oluşturuldu" ve "Erişim anahtarı iptal edildi" olarak düşer. Anahtarla yapılan işler de denetim kaydında ve görev geçmişinde anahtarın sahibinin adıyla görünür

app.themyway.app/settings/access-tokens

CLI’ı kurmak

CLI tek bir dosyadır (myway.js) ve her kurulum kendi sürümünün CLI’ını kendi adresinden dağıtır; npm gibi dış bir kayda bağlı değildir, internete kapalı ağda da kurulur. Node.js 18 ya da üstü gerekir. Kurulum komutları aynı sekmenin MyWay CLI kartında, macOS / Linux ya da Windows seçilerek kendi sunucunun adresiyle hazır yazılı gelir; aşağıdakiler aynı komutlardır.

# macOS / Linux
mkdir -p ~/.local/bin && curl -fsSL https://myway.company.com/cli/myway.js -o ~/.local/bin/myway && chmod +x ~/.local/bin/myway
myway login --url https://myway.company.com     # asks for the token, it is not shown on screen

# Windows (PowerShell)
New-Item -ItemType Directory -Force "$HOME\myway" | Out-Null
Invoke-WebRequest https://myway.company.com/cli/myway.js -OutFile "$HOME\myway\myway.js"
Set-Content "$HOME\myway\myway.cmd" '@node "%~dp0myway.js" %*'
# once: add it to PATH, then close and reopen PowerShell
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$HOME\myway", "User")
myway login --url https://myway.company.com

• myway login anahtarı gizli sorar ve ~/.config/myway/config.json dosyasına yazar; macOS ve Linux’ta dosyayı yalnız sen okuyabilirsin. myway logout kayıtlı anahtarı unutur; anahtarı sunucuda geçersiz kılmak için ayrıca iptal et
• Birden çok kurulumla çalışıyorsan her biri için ayrı profil açılır: --profile ile seçilir, myway use <profil> varsayılanı değiştirir, myway profiles listeler
• myway whoami bağlı kullanıcıyı, sunucuyu ve sürümleri yazar; CLI’ın sürümü sunucununkinden farklıysa bunu söyler. myway self-update CLI’ı sunucunun dağıttığı sürümle değiştirir. Kurulumu güncelledikten sonra bir kez çalıştırman yeter. v1.92.0’dan eski CLI’da myway version create sürüm açmak yerine aracın kendi sürüm numarasını yazıyordu; v1.105.0’dan eski CLI’da ise Windows’ta her komut kapanırken hata verip başarısız sayılıyordu ve başka bir komuta aktarılan --json çıktısı kesiliyordu. self-update bunları da düzeltir
• Kendi sertifikasıyla (IP adresi ya da iç CA) çalışan kurulumda Node.js o sertifikaya güvenmelidir: kök sertifikayı NODE_EXTRA_CA_CERTS ortam değişkeniyle göster

Komutlar

Komut adları ve çıktısı İngilizcedir. Adlar kimliğe kendiliğinden çevrilir: pano anahtar önekiyle (MYW), statü, iş tipi, etiket, sprint ve sürüm adıyla (Türkçe harf ve büyük küçük harf farkı yok sayılır), kişi @kullanıcıadı ya da me ile verilir. Her komut --json ile makine okunur çıktı verir; myway help <komut> ayrıntısını, myway help --json bütün komut ve bayrakları yazar.

myway mine                                  # open work assigned to me, all boards
myway tasks --board MYW --status inprogress --label bug
myway task MYW-12                           # details, subtasks, links, comments
myway create --board MYW --title "Login fails on Safari" --type Bug --assignee me --description @notes.md
myway update MYW-12 --due 2026-11-01 --priority high --add-label bug
myway move MYW-12 "In Review"
myway comment MYW-12 "Fixed on staging"
myway start MYW-12                          # assign to me, in progress, git branch MYW-12-<title>
myway pages --board WIKI && myway page pg-abc123

myway start seni görevin atananlarına ekler (var olanlar kalır), panonun ilk "devam ediyor" statüsüne taşır ve bulunduğun git deposunda MYW-12-gorevin-basligi biçiminde bir dal açar ya da varsa ona geçer; --no-branch dalı atlar, --status başka bir hedef statü verir. Dal adında görev anahtarı geçtiği için GitLab entegrasyonu bağlıysa commit ve MR’lar göreve kendiliğinden bağlanır, myway current de o dalın görevini açar.

Çıkış kodları betiklerde kullanılabilir: 0 tamam, 1 hata, 2 kullanım hatası, 3 kimlik (giriş yok ya da anahtar geçersiz), 4 bulunamadı, 5 yetki yok.

Yapay zekâ asistanları

Terminal komutu çalıştırabilen her asistan MyWay’de senin adına iş yapabilir: "bana atananları özetle", "bu hatayı MYW panosuna aç ve bana ata", "PR açıldı, görevi incelemeye al ve yorum yaz" gibi. Asistan tarayıcı açmaz, CLI’ı kullanır ve senin yetkinle çalışır. Komut çalıştıramayan Claude Desktop ise aynı CLI’ı araç olarak kullanır (aşağıda).

Claude Desktop (MCP)

Claude Desktop’ın sohbet ekranı bilgisayarında komut çalıştıramaz; MyWay’e CLI’ın içinde gelen bir MCP sunucusu (myway mcp) üzerinden ulaşır. Ayrı bir paket yoktur, sunucu myway self-update ile CLI’la birlikte güncellenir. Her araç CLI’ın kendisini çalıştırır, yani ad çözümleme, yetkiler, iş akışı kuralları ve sunucu hataları komut satırıyla birebir aynıdır (v1.95.0).

1. 1Ayarlar > Erişim anahtarları’nda bir anahtar oluştur (örneğin adı "Claude Desktop") ve "Kopyala" ile al.
2. 2Aynı sekmenin MyWay CLI kartında işletim sistemini seç, "1. İndir ve kur" komutunu çalıştır, sonra "Bu kuruluma bağlan" altındaki myway login --url komutuyla giriş yap; anahtarı sorar, ekranda görünmez.
3. 3"Yapay zekâ asistanları ve otomasyon" bölümündeki Claude Desktop (sohbet) kartından myway mcp-setup komutunu kopyalayıp terminalde çalıştır. Komut Claude Desktop’ın yapılandırma dosyasına "myway" sunucusunu ekler ve dosyanın yolunu yazar.
4. 4Claude Desktop’tan tamamen çık ve yeniden aç (pencereyi kapatmak yetmez). Sonra "MyWay’de bana atananlar ne?" diye sor.

• Yapılandırma dosyası macOS’ta ~/Library/Application Support/Claude/claude_desktop_config.json, Windows’ta %APPDATA%\Claude\claude_desktop_config.json, Linux’ta (resmi uygulama yok, topluluk sürümleri) ~/.config/Claude/claude_desktop_config.json. Başka bir dosya için --config kullanılır
• Yalnız mcpServers içindeki myway girdisi yazılır, öteki sunuculara ve ayarlara dokunulmaz. Dosya varsa yazmadan önce yanına zaman damgalı bir .bak yedeği alınır; dosya geçerli JSON değilse hiç yazılmaz
• Anahtar yapılandırma dosyasına yazılmaz: sunucu kimliği myway login profilinden okur. Varsayılan olarak o an seçili profil kullanılır; belirli bir kurulum için myway mcp-setup --profile <ad>. Henüz giriş yapmadıysan mcp-setup bunu hatırlatır, araçlar da "Not signed in to MyWay" hatasını verir
• myway mcp-setup --print dosyaya dokunmadan eklenecek girdiyi yazar; elle eklemek ya da başka bir istemcide kullanmak için
• Girdi node’un tam yolunu ve myway.js dosyasının yerini taşır, çünkü Claude Desktop kısıtlı bir PATH ile başlar ve node’u kendisi bulamayabilir. node’un yeri değişirse (örneğin nvm ile Node sürümü değiştirdiysen) ya da myway.js’i taşıdıysan myway mcp-setup’ı yeniden çalıştır. myway self-update dosyanın yerini değiştirmediği için yeniden kurulum gerektirmez
• Sorun çıkarsa: sunucunun tanı satırları macOS’ta ~/Library/Logs/Claude/mcp-server-myway.log dosyasına düşer (açılışta "[myway mcp] ready, 27 tools" yazar). Bir araç 2 dakikada yanıt vermezse yarıda kesilir
• Claude Desktop’tan yapılan işler görev geçmişinde ve denetim kaydında senin adınla görünür ve seni çevrimiçi göstermez

CI ve betikler

Pipeline’da ayar dosyası gerekmez: adres ve anahtar MYWAY_URL ve MYWAY_TOKEN ortam değişkenleriyle verilir, varsayılan pano MYWAY_BOARD ile seçilir. Anahtarı CI’ın gizli değişkenlerinde tut; yalnız okuyan bir iş için salt okuma anahtarı kullan. Betikte CLI yerine doğrudan HTTP de kullanılabilir: istek Authorization: Bearer başlığıyla anahtarı taşır.

# GitLab CI: comment on the task named in the branch once the deploy succeeds
export MYWAY_URL=https://myway.company.com
export MYWAY_TOKEN=$MYWAY_CI_TOKEN          # a masked CI variable
TASK=$(echo "$CI_COMMIT_REF_NAME" | grep -oE "[A-Z][A-Z0-9]*(-[A-Z][A-Z0-9]*)*-[0-9]+" | head -1)
if [ -n "$TASK" ]; then myway comment "$TASK" "Deployed to staging: $CI_PIPELINE_URL"; fi

# nightly report with a read-only token
myway tasks --board MYW --status inprogress --json > in-progress.json

İlgili sayfalar: Claude Code ve Claude Desktop ile çalışmak, GitLab entegrasyonu, Roller & izinler.