İçeriğe geç
projektraum
Demoyu açProje başlat

Dokümantasyon

Projektraum’u adım adım kullan

İlk davetten incelenmiş sonuca kadar: müşteriler, proje ekipleri ve bağlı yapay zekâ ajanları için uygulamalı rehberler.

İlk adımlar

Proje alanı bir müşteriyle ortak çalışmayı toplar. Panolar bu alanın içindeki işleri düzenler.

  1. Proje alanı oluştur

    Panelde müşteri veya proje için bir alan oluştur. “Web sitesi yenileme” gibi net bir ad ver.

  2. Pano seç

    Durum sütunları için Kanban, tablo ve bölümler için proje panosu, tarihler için takvim, zaman aralıkları için zaman çizelgesi kullan. Bir proje alanında birden çok pano bulunabilir.

  3. Müşteriyi davet et

    Müşteriler kişisel davet bağlantısıyla, hesap açmadan erişir. Yetkilerini proje ayarlarında belirle. Bağlantıyı yalnızca amaçlanan kişiyle paylaş.

  4. İlk görevi netleştir

    Hedefi, sorumlusu ve tarihi olan bir görev ekle. Müşteri erişebildiği proje alanında soruları yanıtlayabilir ve sonuçları inceleyebilir.

Görevler ve birlikte çalışma

Görev somut bir sonucu tanımlar. Yorumlar görüşmeyi, durum ise ilerlemeyi gösterir.

  1. İşi tanımla

    İstenen sonucu ve tamamlanma ölçütünü yaz. Sorumlu, öncelik ve tarihleri ekle. Küçük adımlar için kontrol listesi kullan.

  2. Soruları görevde tut

    Yorumlarda soruları ve sonuçları paylaş. @ ile doğru kişiyi seç. Etiketlemeler bildirimlerde görünür; e-posta kişinin tercihlerine bağlıdır.

  3. İlerlemeyi göster

    Görevi uygun sütuna taşı. Her panonun sütunları özelleştirilebilir. Yalnızca incelemeden veya açık tamamlanma bildiriminden sonra bitmiş olarak işaretle.

Dosyalar ve proje bilgisi

Ortak belgeleri proje alanında, göreve özel materyali ilgili görevde tut.

  1. Bağlamıyla kaydet

    Ortak belgeler için Dosyalar bölümünü kullan. Göreve özel dosyaları görevde veya yorum eki olarak yükle.

  2. Sürümü belirt

    “Anasayfa-v2.pdf” gibi açık adlar kullan ve değişikliği yorumla açıkla. Müşteri onayı isteğin oluşturulduğu içeriğe aittir.

  3. Yapay zekâyla oku

    Yetkili MCP istemcisi dosyaları listeleyip indirebilir. PDF ve Office içeriğinin okunması istemcinin yeteneklerine bağlıdır. Projektraum içeriği otomatik çıkarmaz.

Hangi iş akışı ne zaman yararlı?

Her alan farklı bir proje ihtiyacını çözer. Her görev için hepsini kullanman gerekmez.

  1. İstek → görev

    Metin yapıştır veya TXT/Markdown dosyasını yerel olarak istek alanına oku. Hedef, kontrol listesi ve tarih ekle. Hazırlık ilk satırı başlık yapar ve sorular ekler. Panoya almadan önce taslağı incele; bu otomatik belge analizi değildir.

  2. Ajan işi → incelenmiş sonuç

    Tanımlı işi belirli MCP bağlantısı için açıkça yetkilendir. Çalışan ajanın devralır; ilerleme, engel veya sonuç bildirir. İşi bitirmeden önce sonucu incele.

  3. Müşteri onayı → karar

    Müşteriden belirli sürümü incelemesini iste. Onay ve değişiklik isteği görevde görünür. Onay, görevi otomatik tamamlamaz.

  4. Kurallar ve raporlar

    Pano kuralları öncelik ve atama gibi desteklenen işlemleri yapar. Raporlar ilerlemeyi ve bekleyen kararları gösterir. Müşteri ancak kendisiyle paylaşılan raporu görür.

İki somut müşteri projesi

Sonraki adımı kimin attığını ve hangi bilgiye ihtiyaç duyduğunu takip et.

  1. Web sitesi: ek telefon alanı

    Marc isteğe bağlı telefon alanı ister. Lara mobil davranışı ve kabul ölçütlerini netleştirir. Görev oluşturur, gerekirse çalışan ajanına açık iş verir, sonucu inceler ve Marc’tan onay ister. Sonra kapanışa karar verir.

  2. Tasarım: ürün görsellerini açma

    Sina iki görseli ve istediği değişikliği belirtir. Lara sürümü netleştirir, dosyaları kendisi düzenler ve yeniden onay ister. Talep ve karar görevde kalır; ajan gerekmez.

  3. Demonun gösterdiği

    Rehberli örnekler devir adımlarını açıklar. Veriler ve işlemler demo içinde kalır; gerçek iş başlatılmaz, mesaj gönderilmez.

Web sitesi: ek telefon alanıÖrneği deneTasarım: ürün görsellerini açmaÖrneği dene

MCP kurulumu

MCP, yapay zekâ istemcisini belirli proje alanına bağlar. İstemci yalnızca verilen yetkiler içindeki araç ve verilere erişir.

  1. Bağlantı anahtarı oluştur

    Proje sahibi yapay zekâ/MCP ayarlarını açıp proje alanını seçer. Davet edilen müşteriler bağlantıyı kendi proje alanının ayarlarında bulur. Her istemci için ayrı ve açık adlandırılmış anahtar oluştur.

  2. Yetkiyi seç

    Salt okuma veya okuma ve yazma seç. Yazma, hesabının yetkileri içinde yorum ve görev değişikliklerine izin verir. Tam anahtar yalnızca bir kez gösterilir; güvenli sakla.

  3. Bağlantıyı dene

    Aşağıdan istemcini yapılandır. Ardından “Projektraum’daki açık görevleri ve okunmamış etiketlemelerimi göster” diye sor. Önce doğru proje olduğunu kontrol et.

  4. Erişimi yönet

    Kullanılmayan anahtarları ayarlarda iptal et; süresi dolanları yenile. Yorum stilini bağlantı başına kısa veya ayrıntılı seçebilirsin.

MCP sunucu adresi

https://projektraum.io/api/mcp

Yalnızca tek kimlik doğrulama yöntemi kullan. Anahtarı sohbete, URL’ye veya Git deposuna koyma. prk_… yalnızca yer tutucudur: onu oluşturulurken bir kez gösterilen tam anahtarla değiştir; yalnızca ön ek veya üç nokta yeterli değildir.

Claude

Özel bağlantıda sunucu adresini ve “No sign-in” seç. Request headers altında yerleşik x-api-key seçip yalnızca tam prk_ anahtarını gir. OAuth istemci kimliği oluşturma.

URL: https://projektraum.io/api/mcp
x-api-key: prk_…

Hesabında uygun istek başlıkları yoksa Claude Code kullan. Kaydedilmiş başlıklar düzenlenemiyorsa bağlantıyı doğru ayarlarla yeniden oluştur.

Resmî rehber
Codex

Yapılandırmayı ~/.codex/config.toml dosyasına ekle. PROJEKTRAUM_API_KEY yalnızca anahtarı içerir ve çalışan Codex sürecine aktarılmış olmalıdır.

[mcp_servers.projektraum]
url = "https://projektraum.io/api/mcp"
bearer_token_env_var = "PROJEKTRAUM_API_KEY"

Codex Bearer ön ekini ekler. Terminaldeki değişken ayrı başlatılan masaüstü uygulamasına otomatik geçmez. /mcp veya bağlantı görünümünde kontrol et.

Resmî rehber
Claude Code

Yapılandırmayı çalışma projesinin .mcp.json dosyasına birleştir. PROJEKTRAUM_API_KEY değişkenini Claude Code’u başlatan ortamda ayarla.

{
  "mcpServers": {
    "projektraum": {
      "type": "http",
      "url": "https://projektraum.io/api/mcp",
      "headers": {
        "Authorization": "Bearer ${PROJEKTRAUM_API_KEY}"
      }
    }
  }
}

Mevcut mcpServers girdilerini koru. Claude Code değişkeni başlangıçta çözer. Proje yapılandırmasını onayla ve /mcp üzerinden kontrol et veya yeniden bağlan.

Resmî rehber
ChatGPT

Mevcut Projektraum bağlantısı ChatGPT Web’de doğrudan korumalı bağlantıyı desteklemiyor. ChatGPT bunun için OAuth ister; Projektraum burada API anahtarı kullanır.

prk_ anahtarı OAuth istemci kimliği veya sırrı değildir. “No authentication” sunucu korumasını aşmaz. Mevcut bağlantıyla Codex kullanabilirsin.

Resmî rehber

31 Ekim 2026 tarihinde kontrol edildi

Geliştiriciler ve ajanlar için MCP

Uç nokta Streamable HTTP kullanır. Anahtarının erişebildiği araçları ve güncel şemaları almak için önce tools/list çağır.

  1. Yazmadan önce oku

    get_project panoları, sütunları ve üyeleri döndürür. get_task ve list_comments görev bağlamını sağlar. Kimlik ve durum anahtarlarını yanıttan al, tahmin etme. Listeler limit ve offset destekler.

  2. Güvenli yeniden deneme

    Yazma işlemleri yeni UUID request_id ister. Yeniden denemede aynı kimliği ve değişmeyen argümanları kullan. Görev güncellemesinde get_task yanıtındaki task.updated_at değerini expected_updated_at olarak gönder. Çakışmada tekrar oku ve uzlaştır.

  3. Açıklama ve etiketlemeler

    append_task_description mevcut içeriği koruyarak ekler. update_task içindeki description tüm açıklamayı değiştirir. Yorumlar düz metindir; @ ve tam üye adı etiketleme oluşturur. list_notifications okur, mark_notification_read ayrı olarak okundu işaretler.

  4. Dosyalar ve ajan işleri

    list_files kimlik ve source döndürür. get_file 60 saniyelik özel indirme URL’si verir; süre dolarsa yeniden iste. list_agent_jobs, claim_agent_job ve update_agent_job işleri yönetir. Claim token ve lease sınırlarına uy; review için sonuç kanıtı gerekir.

Sorun çözme

Belirli hatadan başla. Kaydedilmiş bağlantı tek başına bilgisayarında ajan başlatmaz.

  1. Bağlantı veya kimlik doğrulama hatası

    HTTPS adresini, tam anahtarı, süresini ve iptal durumunu kontrol et. x-api-key yalnızca anahtar alır; Authorization için Bearer, tek boşluk ve anahtar kullan. Tırnak ekleme, iki başlığı birlikte gönderme.

  2. Okuma çalışıyor, yazma çalışmıyor

    Bağlantının yazma yetkisini ve güncel proje haklarını kontrol et. Arşivlenmiş veya kısıtlı projeler değişikliği engelleyebilir. Hatayı aşmak için yetkileri gereksiz genişletme.

  3. Güncellemeden sonra araçlar eksik

    İstemcinin araç listesini yenile veya yeniden bağlan. Gerekirse yeni sohbet başlat. Claude bağlantı menüsünde seçenek sunabilir; CLI bağlantıları /mcp üzerinden veya yeniden başlatmayla yenilenebilir.

  4. Ajan otomatik yanıt vermiyor

    Ajan çalışmalı ve bildirimleri ya da işlerini sorgulamalıdır. MCP erişim sağlar; otomatik başlatma servisi değildir. Etiketleme, bilgisayarda her türlü işlem için yetki vermez.