AgileHero

npx add-mcp 'https://mcp.agilehero.io/mcp'

AgileHero, yerleşik bir MCP sunucusuyla birlikte gelir: MCP destekleyen herhangi bir AI asistanına tek bir URL ekleyin, AgileHero hesabınızla oturum açın; projelerinizde tam olarak sizin izinlerinizle çalışır — panolar, backlog, epikler, wiki, beyaz tahtalar, retrospektifler ve yol haritası genelinde 49 araç. Bu referans, sunucunun kendisinden üretilir, bu yüzden her zaman günceldir.

Yeni misiniz? AI ajanlarına genel bakış ile başlayın veya aşağıda istemcinizi bağlama bölümüne geçin. Bu sunucudaki her yerdeki zengin metin, AgileHero Markup (AHM) biçimindedir — ajanların insan içeriğini asla bozmaması için tasarlanmış, katı, doğrulanmış bir XML lehçesidir. Bir asistan bağlamak yerine bir betik mi yazıyorsunuz? REST API referansı aynı OAuth oturum açma yöntemini kullanır.

AI istemcinizi bağlayın

Bağlanmak iki şey demektir: uç nokta URL'sini istemcinize ekleyin, ardından istemci istediğinde AgileHero hesabınızla oturum açın. Oluşturulacak veya yapıştırılacak bir anahtar yoktur. Bağlandıktan sonra istemci sizin gibi, tam olarak sizin izinlerinizle hareket eder; bağlı her istemci uygulamada Ayarlar → AI istemcileri altında listelenir ve istediğiniz zaman erişimini iptal edebilirsiniz. Gözlemciler MCP sunucusunu kullanamaz: gözlemci olduğunuz bir çalışma alanı listelenmez ve içindeki her şey bulunamadı olarak okunur.

Uç nokta

https://mcp.agilehero.io/mcp

Taşıma

Streamable HTTP (POST)

Oturum açma

AI istemciniz bir tarayıcı penceresi açar; bir kez onaylayın, istediğiniz zaman Ayarlar → AI istemcileri bölümünden iptal edin.

Claude Code

Terminalde bir kez çalıştırın; Claude Code sunucuyu kullanıcı düzeyindeki yapılandırmanızda saklar ve tarayıcınız üzerinden oturum açar.

claude mcp add --transport http --scope user agilehero https://mcp.agilehero.io/mcp

• Tüm bayraklar sunucu adından önce gelmelidir.
• Ardından bir Claude Code oturumu içinde /mcp komutunu çalıştırın ve Kimlik Doğrula seçeneğini seçin (veya claude mcp login agilehero komutunu çalıştırın) ve tarayıcınızda oturum açmayı onaylayın.

Doğrulama: claude mcp list komutunu çalıştırın — agilehero bağlı olarak görünmelidir. "kimlik doğrulama gerekiyor" gösteriyorsa, claude mcp login agilehero komutunu çalıştırın.

Claude Code belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

VS Code (GitHub Copilot)

Bir çalışma alanındaki .vscode/mcp.json dosyasına ekleyin veya tüm çalışma alanları için "MCP: Kullanıcı Yapılandırmasını Aç" komutunu çalıştırın. Sunucu ilk başladığında oturum açma için bir tarayıcı penceresi açılır.

.vscode/mcp.json

{
  "servers": {
    "agilehero": {
      "type": "http",
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• "type": "http" gereklidir — onsuz VS Code URL'yi çalıştırılacak bir komut olarak ele alır.

Doğrulama: "MCP: Sunucuları Listele" komutunu çalıştırın, agilehero'yu başlatın, tarayıcıda oturum açmayı tamamlayın ve araçlarının Sohbet görünümünde göründüğünü kontrol edin.

VS Code (GitHub Copilot) belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

Codex

Terminalden ekleyin, ardından oturum açın — yapılandırma Codex CLI, IDE uzantısı ve ChatGPT masaüstü uygulaması tarafından paylaşılır.

codex mcp add agilehero --url https://mcp.agilehero.io/mcp
codex mcp login agilehero

• Codex oturum açmayı kendi başına başlatmaz — sunucuyu ekledikten sonra codex mcp login agilehero komutunu çalıştırın.

Doğrulama: codex mcp list komutunu çalıştırın — agilehero kimliği doğrulanmış olarak görünmelidir; ardından Codex'ten AgileHero projelerinizi listelemesini isteyin.

Codex belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

Zed

settings.json dosyasına ekleyin veya Ayarlar → AI → MCP Sunucuları → Uzak Sunucu Ekle seçeneğini kullanın; Zed sizden oturum açmanızı ister.

~/.config/zed/settings.json

{
  "context_servers": {
    "agilehero": {
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• Başlıkları boş bırakın — Zed oturum açmayı yalnızca Authorization başlığı yapılandırılmadığında başlatır.

Doğrulama: Zed'i yeniden başlatın, istendiğinde tarayıcınızda oturum açmayı onaylayın ve AgileHero projelerinizi listelemesini isteyin — ilk başarılı çağrı bağlantıyı doğrular.

Zed belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

GitHub Copilot CLI

~/.copilot/mcp-config.json dosyasına veya bir depo içindeki .mcp.json dosyasına ekleyin.

~/.copilot/mcp-config.json

{
  "mcpServers": {
    "agilehero": {
      "type": "http",
      "url": "https://mcp.agilehero.io/mcp"
    }
  }
}

• GitHub Copilot CLI 1.0.83 veya daha yenisini gerektirir (İstemci Kimliği Meta Veri Belgesi desteği).
• Copilot CLI, sunucu ilk istediğinde oturum açmayı açar; ayrıca bir oturum içinde /mcp auth agilehero komutunu da çalıştırabilirsiniz.

Doğrulama: Copilot CLI içinde /mcp komutunu çalıştırın — agilehero, araçlarıyla birlikte bağlı olarak listelenmelidir.

GitHub Copilot CLI belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

Claude (web, masaüstü, Cowork)

AgileHero'yu özel bir bağlayıcı olarak ekleyin ve oturum açın; bağlayıcı web'deki Claude, Claude Desktop, Cowork ve mobil uygulamalarda kullanılabilir.

Settings → Connectors → Add custom connector
Name: AgileHero
URL: https://mcp.agilehero.io/mcp
Sign in now

• Bağlayıcı, aynı Claude hesabıyla oturum açıldığında Claude Code'da da görünür.
• Ücretsiz plan: bir özel bağlayıcı. Team ve Enterprise: bir Sahip bağlayıcıyı ekler ve her üye kendi AgileHero hesabıyla oturum açar.

Doğrulama: Yeni bir sohbet başlatın — AgileHero bağlayıcılar altında listelenir ve Claude'dan AgileHero projelerinizi listelemesini istemek çalışır.

Claude (web, masaüstü, Cowork) belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

ChatGPT

Geliştirici modunda bir bağlayıcı oluşturun ve OAuth ile oturum açın.

Settings → Connectors → Create (Developer mode)
Name: AgileHero
MCP server URL: https://mcp.agilehero.io/mcp
Authentication: OAuth

• Geliştirici modu etkin olan Plus, Pro, Business, Enterprise ve Edu'da kullanılabilir; bir çalışma alanında bir yönetici veya sahip, bağlayıcıyı üyeler için yayınlar.

Doğrulama: AgileHero bağlayıcısı etkinken yeni bir sohbet açın ve ChatGPT'den AgileHero projelerinizi listelemesini isteyin.

ChatGPT belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

Diğer istemci

İstemci Kimliği Meta Veri Belgeleri ile OAuth'u destekleyen herhangi bir MCP istemcisi: uç noktayı uzak (Streamable HTTP) bir sunucu olarak ekleyin ve tarayıcınızda oturum açmayı onaylayın.

Transport: Streamable HTTP
URL: https://mcp.agilehero.io/mcp
Authentication: OAuth (sign in when the client asks)

• Yalnızca statik belirteçleri veya başlıkları destekleyen istemciler bağlanamaz — AgileHero yalnızca OAuth oturum açma kullanır.

Doğrulama: İstemciyi yeniden başlatın, istendiğinde tarayıcınızda oturum açmayı onaylayın ve AgileHero projelerinizi listelemesini isteyin — ilk başarılı çağrı bağlantıyı doğrular.

Diğer istemci belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

Henüz desteklenmiyor

Bu istemciler henüz AgileHero'ya oturum açamaz. Çoğu, AgileHero'nun kullandığı OAuth istemci kayıt yöntemi olan İstemci Kimliği Meta Veri Belgelerini (mevcut MCP önerisi) desteklemez; satıcı belgelerini düzenli olarak yeniden kontrol ediyoruz ve bir istemci uygun hale gelir gelmez yukarı taşıyoruz.

CursorHenüz değil

Cursor henüz İstemci Kimliği Meta Veri Belgelerini desteklemiyor (OAuth oturum açması Dinamik İstemci Kaydı veya önceden kayıtlı bir istemci gerektirir), bu nedenle şimdilik AgileHero'ya bağlanamaz.

Cursor belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

OpenCodeHenüz değil

OpenCode henüz İstemci Kimliği Meta Veri Belgelerini desteklemiyor (OAuth oturum açması Dinamik İstemci Kaydı veya önceden kayıtlı bir istemci gerektirir), bu nedenle şimdilik AgileHero'ya bağlanamaz.

OpenCode belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

Gemini CLIHenüz değil

Gemini CLI henüz İstemci Kimliği Meta Veri Belgelerini desteklemiyor (OAuth oturum açması Dinamik İstemci Kaydı veya önceden kayıtlı bir istemci gerektirir), bu nedenle şimdilik AgileHero'ya bağlanamaz.

Gemini CLI belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

ClineHenüz değil

Cline henüz İstemci Kimliği Meta Veri Belgelerini desteklemiyor (OAuth oturum açması Dinamik İstemci Kaydı veya önceden kayıtlı bir istemci gerektirir), bu nedenle şimdilik AgileHero'ya bağlanamaz.

Cline belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

Google AntigravityHenüz değil

Google Antigravity henüz İstemci Kimliği Meta Veri Belgelerini desteklemiyor (OAuth oturum açması Dinamik İstemci Kaydı veya önceden kayıtlı bir istemci gerektirir), bu nedenle şimdilik AgileHero'ya bağlanamaz.

Google Antigravity belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

AmpHenüz değil

Amp henüz İstemci Kimliği Meta Veri Belgelerini desteklemiyor (OAuth oturum açması Dinamik İstemci Kaydı veya önceden kayıtlı bir istemci gerektirir), bu nedenle şimdilik AgileHero'ya bağlanamaz.

Amp belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

Raycast AIHenüz değil

Raycast AI henüz İstemci Kimliği Meta Veri Belgelerini desteklemiyor (OAuth oturum açması Dinamik İstemci Kaydı veya önceden kayıtlı bir istemci gerektirir), bu nedenle şimdilik AgileHero'ya bağlanamaz.

Raycast AI belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

KiroHenüz değil

Kiro, sizin sağladığınız bir İstemci Kimliği Meta Veri Belgesi URL'si ile oturum açar ve AgileHero henüz bunun için bir İstemci Kimliği Meta Veri Belgesi barındırmaz.

Kiro belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

WarpHenüz değil

Warp'ın henüz kullanıcı tarafından eklenen sunucular için OAuth oturum açması yoktur, bu nedenle şimdilik AgileHero'ya bağlanamaz.

Warp belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

JetBrains AI AssistantHenüz değil

JetBrains AI Assistant'ın uzak sunucular için OAuth oturum açması yoktur ve mcp-remote köprüsü barındırılan bir istemci belgesi gerektirir — AgileHero henüz bunun için bir İstemci Kimliği Meta Veri Belgesi barındırmaz.

JetBrains AI Assistant belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

ContinueHenüz değil

Continue'un Streamable HTTP sunucuları için OAuth oturum açması yoktur ve mcp-remote köprüsü barındırılan bir istemci belgesi gerektirir — AgileHero henüz bunun için bir İstemci Kimliği Meta Veri Belgesi barındırmaz.

Continue belgeleri · satıcı belgelerine karşı 2026-09-15 tarihinde doğrulandı

Sunucu talimatları

Her MCP istemcisi bu kuralları başlatma sırasında alır:

AgileHero MCP sunucusu.

Her id parametresi ve yanıttaki her id kısa bir uid'dir — her zaman list/get/search araçlarının döndürdüğü uid'leri kullanın, asla bir tane icat etmeyin. Çoğu araç bir proje uid'si gerektirir — çalışma alanlarını ve projeleri keşfetmek için önce list_projects çağrısını yapın. search (tam metin, tüm içerik türleri) aracını search_cards (başlık-alt dizesi, tek proje) aracına tercih edin.

Güncelleme araçlarında, koleksiyonlar için add_*/remove_* delta alanlarını tercih edin (kademeli, güvenli); düz koleksiyon alanları (assigned_to, labels, checklists, cards_relations, links, attachments) önceki durumu DEĞİŞTİRİR ve delta alanlarıyla birleştirilemez. Kontrol listesi öğeleri { description, checked } biçimindedir. list_cards / list_epics üzerinde updated_since ile değişiklikleri yakalayın.

Bir kartın listesini veya konumunu değiştirmek için move_card (update_card değil) kullanın; boş bir list_id, backlog anlamına gelir.

Wiki, beyaz tahta, retrospektif ve yol haritası araçları, projenin çalışma alanının Pro veya deneme planında olmasını gerektirir. Beyaz tahta öğe yazmaları toplu araçlardır ve ya hep ya hiçtir; öğe uid'leri get_whiteboard'dan gelir. Retrospektif öğeleri add_retro_items ve move_retro_item ile yönetilir (move_card retrospektif kartlarını reddeder).

Günlük limitler: araç çağrıları kullanıcı başına çalışma alanı başına ölçülür — Ücretsiz planda günde 500, Pro veya deneme planında günde 5.000, 00:00 UTC'de sıfırlanır. get_ahm_spec ve list_projects asla sayılmaz (kapsamı belirsiz bir arama gibi tek bir çalışma alanına atfedilemeyen hiçbir çağrı da sayılmaz). Limitin üzerinde, araçlar sıfırlama veya yükseltme yapılana kadar günlük limit hatası döndürür.

TÜM zengin metin (wiki sayfaları, kart/epik açıklamaları, yorumlar) AgileHero Markup (AHM) biçimindedir — katı XML, ASLA markdown veya HTML değil; herhangi birini yazmadan önce get_ahm_spec'i bir kez çağırın. Zengin metin düzenlemeleri tasarım gereği iki adımlıdır: preview_wiki_page_update / preview_description_update (sonuçlar + preview_token), ardından bu belirteçle eşleşen güncelleme aracı.

Tam araç belgeleri: https://agilehero.io/docs/mcp

AHM belirtimi: https://agilehero.io/docs/mcp/agilehero-markup

Araçlar (49)

list_projectsalt okuma

Belirtecin kullanıcısının erişebildiği her çalışma alanını ve projeyi listeler; böylece ajan, diğer çoğu aracın gerektirdiği proje uid'sini çözebilir. Hiçbir proje uid'si bilinmediğinde bunu ilk çağırın — kullanıcıdan asla bir tane yapıştırmasını istemeyin. Çalışma alanlarını (uid, ad, plan, rolünüz) projeleriyle (uid, ad, url) birlikte döndürür. Pro-pillar araçları (wiki, metrikler) çalışma alanının planının pro veya deneme olmasını gerektirir.

searchalt okuma

Ürünün global tam metin araması (OpenSearch): kartlar, epikler, wiki sayfaları ve projeler; başlık, açıklama, yorum, kontrol listesi öğeleri ve ek dosya adlarında eşleşme yapar; alaka düzeyine göre sıralanır ve yakınlık artışı uygulanır. Bunu içeriğe göre herhangi bir şeyi bulmak için kullanın ("göçü tartıştığımız kart"); search_cards'ı yalnızca tek bir proje içinde başlık-alt dizesi aramaları için kullanın. Her sonuç bir tür, eyleme hazır bir uid (kartlar get_card/update_card, epikler get_epic, wiki_pages show_wiki_page, projeler project_id parametrelerini besler), bir derin bağlantı URL'si ve neden eşleştiğini gösteren <mark> vurgulu parçacıklar taşır. İsteğe bağlı olarak project_id veya assigned_to_me ile kapsam belirleyin. page/per_page ile sayfalayın; total_count tam eşleşme sayısıdır.

Parametre	Tür	Zorunlu	Açıklama
query	string	evet	Serbest metin arama sorgusu
project_id	string		Aramayı kapsamak için isteğe bağlı proje uid'si
assigned_to_me	boolean		Yalnızca token kullanıcısına atanmış sonuçlar
page	integer		Sayfa numarası (varsayılan 1)
per_page	integer		Sayfa başına sonuç, 1-50 (varsayılan 20)

get_cardread-only

Bir kartı tam olarak okuyun: blok kimlikleri ve description_version içeren AgileHero Markup açıklaması (preview_description_update / update_description girdilerinin aldığı iki girdi), liste yerleşimi, epik, etiketler, atananlar, raporlayan, tür, tahmin, bitiş tarihi, kontrol listeleri, bağlantılar, ekler, ilgili kartlar ve iş parçacıklı yorumlar. Yalnızca kart uid'sini alır — project_id parametresi yoktur. Kart uid'leri list_cards, search veya search_cards'tan gelir.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Kartın benzersiz tanımlayıcısı

get_epicread-only

Bir epiği tam olarak okuyun: blok kimlikleri ve description_version içeren AgileHero Markup açıklaması (preview_description_update / update_description girdilerinin aldığı iki girdi), ad, numara, renk, başlangıç/bitiş tarihleri, atananlar, kontrol listeleri, bağlantılar, ekler, üzerindeki her kart (uid, numara, başlık ve kategorisiyle listesi — null liste = backlog — pano sırasına göre, bu nedenle bir epiğin tüm kartlarını listelemenin ve hangilerinin yapılacak, devam eden veya tamamlanmış olduğunu görmenin yolu budur) ve iş parçacıklı yorumlar. Yalnızca epik uid'sini alır — project_id parametresi yoktur. Epik uid'leri list_epics veya search'tan gelir.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Epiğin benzersiz tanımlayıcısı

list_wiki_pathsPro · wikiread-only

Bir projenin tüm wiki ağacını görüntüleme sırasına göre listeleyin — her klasör ve sayfa, uid'si, adı, türü (sayfa veya klasör) ve parent_id'si ile — böylece aracı, show_wiki_page'in aldığı sayfa uid'sini çözebilir ve create_wiki_page için bir parent_id seçebilir. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Projenin benzersiz tanımlayıcısı

show_wiki_pagePro · wikiread-only

Bir wiki sayfasını document_version ile AgileHero Markup (AHM) olarak alın. İçerik AHM'dir, markdown değil — blok kimlikleri, <discussion> çapaları ve <image/>/<attachment/> referansları belgenin parçasıdır; düzenlemeden önce get_ahm_spec'i okuyun. preview_wiki_page_update ardından update_wiki_page ile düzenleyin, burada döndürülen blok kimliklerini ve document_version'ı kullanın. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Sayfa yolunun benzersiz tanımlayıcısı

get_ahm_specread-only

AgileHero Markup (AHM) v1.0 spesifikasyonu — AgileHero'nun kabul ettiği TEK zengin metin biçimi (markdown ve HTML reddedilir). Herhangi bir zengin metin (wiki sayfaları, kart/epik açıklamaları, yorumlar) yazmadan veya düzenlemeden önce bunu BİR KEZ okuyun: kelime dağarcığı, nitelikler, kaçış kuralları ve çalışılmış bir örnek. Web'de aynı metin: https://agilehero.io/docs/mcp/agilehero-markup

create_wiki_pagePro · wiki

AgileHero Markup (AHM) içeriğiyle (isteğe bağlı olarak bir klasör içinde) bir wiki sayfası oluşturun. İçerik <agile-hero-markup version="1.0"> ile sarılmalıdır — markdown ve HTML reddedilir; önce get_ahm_spec'i okuyun. Yeni sayfanın uid'sini, URL'sini, document_version'ını ve içeriğini döndürür. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Projenin benzersiz tanımlayıcısı (uid)
name	string	evet	Sayfa başlığı
parent_id	string		İsteğe bağlı klasör uid'si (list_wiki_paths'tan)
content	string		Sayfa gövdesi AHM olarak; boş sayfa için atlayın

preview_wiki_page_updatePro · wikiread-only

Her wiki sayfası güncellemesinin ZORUNLU ilk adımı: işlemleri doğrular ve sunucu tarafından hesaplanan sonuçları (eklenen/kaldırılan/değiştirilen bloklar, kalıcı olarak silinecek dosyalar, çapalarını kaybedecek ekip tartışmaları, olası-markdown uyarıları) ve update_wiki_page'in gerektirdiği preview_token'ı döndürür. Hiçbir şey değiştirilmez. İşlemler blok adreslidir (replace_block / insert_after / delete_block / move_block) ve AHM içeriğiyle — önce get_ahm_spec'i okuyun ve blok kimliklerini + document_version'ı show_wiki_page'ten alın. Kaydetmeden önce sonuçları inceleyin: listelenen bir dosya silme veya tartışma çapa kaldırma yalnızca kullanıcı istediğinde kabul edilebilir. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Sayfa yolu uid'si
document_version	string	evet	show_wiki_page'ten — tazeliği kanıtlar
operations	array of object	evet	Gelişen belgeye karşı sırayla uygulanır

update_wiki_pagePro · wikidestructive

Daha önce önizlenen bir güncellemeyi bir wiki sayfasına uygulayın. preview_wiki_page_update'ten preview_token'ı TAM OLARAK bu işlemler ve bu document_version için gerektirir — önizleme olmadan kaydetmek tasarım gereği imkansızdır. Her kayıt, insanların uygulamada geri alabileceği bir sayfa sürümü oluşturur. Güncellenmiş sayfayı (AHM + yeni document_version) ve uygulanan sonuçları döndürür. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Sayfa yolu uid'si
document_version	string	evet	Önizlemenin alındığı sürüm
operations	array of object	evet	Önizlenen tam işlemler
preview_token	string	evet	preview_wiki_page_update'ten

preview_description_updateread-only

Her kart veya epik açıklama düzenlemesinin ZORUNLU ilk adımı: blok işlemlerini doğrular ve sunucu tarafından hesaplanan sonuçları ve update_description'ın gerektirdiği preview_token'ı döndürür. Hiçbir şey değiştirilmez. İçerik AgileHero Markup'tır (AHM, açıklama yüzeyi: tablo, renk, hizalama, tartışma veya dosya ekleri yok) — önce get_ahm_spec'i okuyun; blok kimlikleri ve document_version get_card / get_epic'ten gelir.

Parametre	Tür	Zorunlu	Açıklama
resource_type	enum: card | epic	evet
id	string	evet	Kart veya epik uid'si
document_version	string	evet	get_card / get_epic'ten
operations	array of object	evet	Gelişen açıklamaya karşı sırayla uygulanır

update_descriptiondestructive

Daha önce önizlenen bir açıklama güncellemesini bir karta veya epiğe uygulayın. preview_description_update'ten preview_token'ı TAM OLARAK bu işlemler ve bu document_version için gerektirir — önizleme olmadan kaydetmek tasarım gereği imkansızdır. Güncellenmiş açıklamayı (AHM + yeni document_version) döndürür.

Parametre	Tür	Zorunlu	Açıklama
resource_type	enum: card | epic	evet
id	string	evet	Kart veya epik uid'si
document_version	string	evet	Önizlemenin alındığı sürüm
operations	array of object	evet	Önizlenen tam işlemler
preview_token	string	evet	preview_description_update'ten

list_whiteboardsPro · whiteboardread-only

Bir projenin beyaz tahtalarını listeleyin (uid, ad, öğe sayısı, url). Bir tahtanın öğelerini okumak için get_whiteboard kullanın. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Projenin benzersiz tanımlayıcısı

create_whiteboardPro · whiteboard

Bir projede boş bir beyaz tahta oluşturun. create_whiteboard_elements ile içerik ekleyin. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Projenin benzersiz tanımlayıcısı
name	string	evet	Beyaz tahta adı

get_whiteboardPro · whiteboardread-only

Bir beyaz tahtayı kompakt bir metin temsili olarak okuyun: tahta sınırları artı öğe başına bir satır — "<type> <uid> at <x>,<y> size <w>x<h> [color] [parent <frame-uid>] [linked <card|epic> <uid>] \"text\"", bağlayıcılar "connector <uid> <from> -> <to>" olarak. Buradaki öğe uid'leri, her beyaz tahta yazma aracının aldığı tutamaçlardır. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Beyaz tahtanın benzersiz tanımlayıcısı

create_whiteboard_elementsPro · whiteboard

Tek bir işlemsel çağrıda (tümü-veya-hiçbiri, tek bir gerçek zamanlı olay) en fazla 100 beyaz tahta öğesi oluşturun. Yerel boyutlar, renkler ve metin yerleşimi sunucu tarafında uygulanır — genellikle yalnızca tür + metin (+ renk) verin. x/y'yi atlayın ve öğeler otomatik düzenlenir (varsayılan olarak ızgara; arrange: row|column|grid, origin_x/origin_y/gap ile ayarlayın); tam kontrol için x/y verin. Çerçeveler öğeleri parent_id (mevcut bir çerçeve uid'si) veya parent_ref (BU çağrıda daha önceki bir çerçevenin ref'i) ile içerir. Bağlayıcılar öğeleri uid (source_id/target_id) veya toplu ref (source_ref/target_ref) ile bağlar — asla koordinatlarla değil; çapalar UI tarafından hesaplanır. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
whiteboard_id	string	evet	Beyaz tahtanın benzersiz tanımlayıcısı
elements	array of object	evet	Dizi sırasına göre oluşturulur — ref'ler yalnızca geriye doğru çözülür
arrange	enum: grid | row | column		Açık x/y olmayan öğeler için düzen (varsayılan grid)
origin_x	number		Otomatik düzen başlangıç x'i (varsayılan 100)
origin_y	number		Otomatik düzen başlangıç y'si (varsayılan 100)
gap	number		Otomatik düzen aralığı px cinsinden (varsayılan 20)

create_whiteboard_diagramPro · whiteboard

Bir beyaz tahtaya anlamsal bir grafikten (düğümler, kenarlar, isteğe bağlı gruplar, KOORDİNAT YOK) bir diyagram (akış şeması, süreç, bağımlılık grafiği) çizin: sunucu, yerel boyutlarla katmanlı yukarıdan aşağıya yerleşim yapar ve oluşturulan öğe uid'lerini sizin düğüm kimliklerinize göre döndürür. Mevcut tahta içeriğinin altına yerleştirilir. İşlemsel (tümü-veya-hiçbiri, tek bir gerçek zamanlı olay). En fazla 20 düğüm — daha büyük akışları iki diyagrama bölün. Anlambilim gerektirmedikçe şekilleri düz (dikdörtgen) tutun (elmas = karar, stadyum = başlangıç/bitiş, silindir = veri deposu). Sonucu update_whiteboard_elements ile düzenleyin — yerleşim asla tekrar çalışmaz. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
whiteboard_id	string	evet	Beyaz tahtanın benzersiz tanımlayıcısı
title	string		Diyagram başlığı (çerçeve başlığı veya gruplar kullanıldığında bir başlık)
nodes	array of object	evet
edges	array of object
groups	array of object
origin_x	number		İsteğe bağlı sol üst x; varsayılan olarak mevcut içeriğin altında
origin_y	number		İsteğe bağlı sol üst y; varsayılan olarak mevcut içeriğin altında

update_whiteboard_elementsPro · whiteboard

Tek bir çağrıda 100 beyaz tahta öğesini ya hep ya hiç ilkesiyle güncelleyin: taşı (x/y), yeniden boyutlandır, yeniden istifle (z_index), metni değiştir, rengi değiştir, yeniden ebeveynle (parent_id — bir çerçeve kimliği veya ayırmak için ""), ve bağlayıcı ok/yol/etiket. Öğe kimlikleri get_whiteboard'dan gelir; öğe türleri değiştirilemez. Yalnızca sağlanan alanlar değişir — ilgisiz özellikler korunur. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
whiteboard_id	string	evet	Beyaz tahtanın benzersiz tanımlayıcısı
updates	object dizisi	evet

delete_whiteboard_elementsPro · whiteboardyıkıcı

Tek bir işlemsel çağrıda 100 beyaz tahta öğesini silin. Bir çerçeveyi veya zihin haritası düğümünü silmek, alt öğelerini tahtaya bırakır (bunlar SİLİNMEZ — onları da silmek için kimliklerini açıkça ekleyin). Silinen öğelere bağlı bağlayıcılar kaldırılmaz ve sarkık kalır. Öğe kimlikleri get_whiteboard'dan gelir. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
whiteboard_id	string	evet	Beyaz tahtanın benzersiz tanımlayıcısı
ids	string dizisi	evet	Silinecek öğe kimlikleri

review_whiteboardPro · whiteboardsalt okunur

Bir beyaz tahtada deterministik kalite kontrolleri çalıştırın: öğesinden taşma olasılığı olan metin, görünür şekilde çakışan öğeler, bağlanmamış veya sarkık uç noktalara sahip bağlayıcılar, UI paletinin dışındaki renkler, ızgara dışı konumlar ve ebeveyni silinmiş öğeler. Danışma niteliğindedir — bulgular hata değil öneridir ve bulguları olan bir tahta kullanıcının tam olarak istediği şey olabilir. Çizimden sonra sağlamasını yapmak için kullanın, en fazla bir kez düzeltin ve boş bir rapor kovalamak için döngüye girmeyin. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Beyaz tahtanın benzersiz tanımlayıcısı

convert_whiteboard_elementPro · whiteboard

Bir beyaz tahta öğesini bir iş kalemine dönüştürün: bir yapışkan notu kart veya destana, veya bir çerçeveyi destana (çerçevenin yapışkan not alt öğeleri o destandaki kartlar olur; zaten dönüştürülmüş alt öğeler yeniden atanır, çoğaltılmaz). Öğe tahtada kalır ve dönüştüğü şeye bağlanır — get_whiteboard bağlantıyı gösterir. Bir öğe yalnızca bir kez dönüştürülebilir. Not/çerçeve metni, siz bir tane geçmediğiniz sürece başlık olur. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Öğe kimliği (get_whiteboard'dan bir sticky_note veya frame)
to	enum: card | epic	evet	Ne oluşturulacağı
title	string		Kart başlığı / destan adı; öğenin metnine varsayılan olarak ayarlanır
list_id	string		Yalnızca kart: hedef liste kimliği; backlog için atlayın
color	string		Yalnızca destan: onaltılık renk; öğenin rengine varsayılan olarak ayarlanır

convert_mind_mapPro · whiteboard

Bir zihin haritasını düğüm başına eşleme ile iş kalemlerine dönüştürün: kök, yeni bir destan olabilir (rol "epic") veya mevcut bir destana eklenebilir (rol "existing_epic" + target_epic_id); diğer düğümler o destandaki kartlar (rol "card") veya proje etiketleri (rol "label" — ağaçta bir kart düğümünün üzerindeki etiket düğümleri o karta uygulanır) olur; rol "skip" bir düğümü yok sayar. id olarak KÖK öğe kimliğini ve dönüştürmek istediğiniz her düğümü nodes içinde geçirin (listelenmeyen düğümler yok sayılır). Düğüm başına bir dönüştürme: zaten dönüştürülmüş düğümler baştan reddedilir — onlar olmadan yeniden gönderin. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	KÖK zihin haritası düğüm kimliği (get_whiteboard'dan)
nodes	object dizisi	evet
target_epic_id	string		Destan kimliği, kökte rol "existing_epic" ile zorunlu

list_retrospectivesPro · retrospectivessalt okunur

Bir projenin retrospektiflerini listeleyin: çalışma alanında varsa yeni model retrospektifler ve sağlık kontrolleri, aksi takdirde klasik retrospektif panoları. Yeni model bir girdi uid, name, kind (retro | health_check), status (open | live | closed), date (starts_on; sağlık kontrolü için closes_on), geçerli aşama, şablon, kolaylaştırıcı kimliği, oluşturduğu eylemlerin sayıları ve url içerir; yanıt projenin open_actions_count değerini ekler. Tam resim için get_retrospective kullanın. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Projenin benzersiz tanımlayıcısı

create_retrospectivePro · retrospectives

Bir retrospektif oluşturun: çalışma alanında varsa yeni model bir retrospektif, aksi takdirde klasik bir retrospektif panosu; yanıt, get_retrospective'in döndürdüğü gibi retrospektiftir (kimlikleriyle sütunlar), böylece add_retro_items hemen takip edebilir. Yeni model bir retrospektif bir şablondan gelir (varsayılan went_well), hemen notlara açıktır ve sizi kolaylaştırıcı olarak atar; isteğe bağlı: focus, anonymity (varsayılan: şablonun), participant_ids (Seçilmiş üyeler retrosu; yazma erişimi olan her proje üyesi için atlayın), check_in ve feedback soru türleri ve votes. Kolaylaştırıcı onu başlatır ve aşamalarını uygulamada yürütür. Klasik panolar yalnızca name, date ve previous_retrospective_id alır ve yeni model argümanlarını reddeder. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Projenin benzersiz tanımlayıcısı
name	string	evet	Retrospektif adı
template	enum: went_well | start_stop_continue | four_ls | mad_sad_glad | kalm | daki | starfish | plus_delta | sailboat | rose_thorn_bud | wrap | hot_air_balloon | three_pigs | project_retro | postmortem | kudos_lessons		Şablon anahtarı; varsayılan went_well
starts_on	string		Tarih, ISO-8601 (YYYY-MM-DD); varsayılan bugün
starts_at	string		starts_on için kullanımdan kaldırılmış takma ad
focus	string		Bu retronun ne hakkında olduğu, adının altında gösterilir
anonymity	enum: anonymous | optional | named		Notlarda kim gösterilir: anonymous, optional (yazarlar adlarını ekleyebilir) veya named
participant_ids	string dizisi		Katılımcıların kullanıcı kimlikleri (list_project_users); siz her zaman birisiniz
check_in	enum: safety | mood | esvp | one_word		Check-in sorusu (varsayılan safety)
feedback	enum: roti | pulse | one_word		Kapanış geri bildirim sorusu (varsayılan roti)
votes	object		Oylama ayarları: budget (auto | fixed | unlimited), per_person (1-20), max_per_topic (1-10)
previous_retrospective_id	string		Yalnızca klasik panolar: Eylemler sütunu "Geçmiş eylemler" olarak gösterilen daha önceki bir retrospektifin kimliği

get_retrospectivePro · retrospectivessalt okunur

Bir retrospektifi görebileceğiniz gibi okuyun: çalışma alanında varsa yeni model bir retrospektif veya sağlık kontrolü, aksi takdirde klasik bir retrospektif panosu. Yeni model bir retrospektif kurulum, aşamalar (geçerli olan, zamanlayıcı, ilerleme), not gruplarını (kimlikleriyle) tutan sütunlar (kimlikleriyle), check-in ve geri bildirim sayıları, kalan oylarınız, Tartışma kuyruğu ve bekletilen konular, öneriler, eylemler (oluşturdukları artı projenin açık olanları) ve kapandığında özetini döndürür. Gizlilik odayı takip eder: açıklamadan önce yalnızca kendi notlarınızı alırsınız (her sütun herkesin notlarını sayar), yazarlar yalnızca adlandırılmış notlarda, oy toplamları yalnızca oylar açıklandığında. Bir sağlık kontrolü boyutlarını ve katılımını, açıkken kendi derecelendirmelerinizi ve kapandığında boyut başına toplamları döndürür. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Retrospektif kimliği (list_retrospectives'dan)

add_retro_itemsPro · retrospectives

Bir retrospektife kendiniz olarak aynı anda birkaç öğe ekleyin: çalışma alanında varsa yeni model bir retrospektifte notlar, aksi takdirde klasik bir retrospektif panosunda kartlar. Her öğe { column, text, recipient_id? } şeklindedir: column, get_retrospective'ten bir sütun başlığıdır (büyük/küçük harf duyarsız) veya kimliğidir; text en fazla 1000 karakterdir (klasik panolarda 255); recipient_id, teşekkür edilen takım arkadaşının kullanıcı kimliği, yeni model bir kudos sütununda zorunludur ve klasik panolarda reddedilir. Yeni model bir not kendi konusunu başlatır ve diğerleri notlar açıklandığında görür; notlar yalnızca retrospektif notlara açıkken veya Yazma aşamasındayken alınır, aksi takdirde çağrı wrong_stage kodu ve geçerli aşamayla reddedilir. KISMİ başarısızlık: geçerli öğeler eklenir, geçersiz olanlar dizin başına raporlanır — "failed" dizisini kontrol edin. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
retrospective_id	string	evet	Retrospektif kimliği
items	object dizisi	evet

move_retro_itemPro · retrospectives

Bir retrospektif öğesini taşıyın: çalışma alanında varsa yeni model bir retrospektifte bir notu yeniden gruplayın, aksi takdirde klasik bir retrospektif panosunda bir kartı başka bir sütuna taşıyın. Yeni model, yalnızca Grup aşaması: topic_id notu o konuya (not grubu) yerleştirir; column (başlık veya kimlik) onu orada kendi konusu yapar, sütunun konuları arasında position konumunda (son için atlayın). Birisi bu arada yeniden grupladığında stale koduyla reddedilmek için get_retrospective'ten notun konu updated_at değeri olan expected_updated_at değerini geçirin. Grup dışında çağrı wrong_stage kodu ve geçerli aşamayla reddedilir; kudos ve diğer notlar asla karışmaz. Klasik panolar yalnızca column ve position alır (position atlanırsa = en üst). Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Not kimliği (klasik panolar: öğe kimliği) get_retrospective'ten
topic_id	string		Hedef konu kimliği; column'u boş bırakın
column	string		Hedef sütun başlığı veya kimliği
position	integer		Hedef sütundaki dizin (0 = ilk)
expected_updated_at	string		Notun konu updated_at değeri son okunduğu gibi (çakışma kontrolü)

list_project_userssalt okunur

Bir projenin üyelerini listeleyin — standart bir proje için her çalışma alanı üyesi; özel bir proje için oluşturucu, çalışma alanı sahipleri ve yöneticileri ve açıkça eklenen herkes — böylece aracı adları tahmin etmek yerine atanan kimliklerini çözebilir. Her üyenin uid, tam ad, e-posta ve çalışma alanı rolünü (owner, admin, member veya observer) döndürür. Bu kimlikler create_card, update_card, create_epic, update_epic ve create_roadmap_slot üzerinde assigned_to'nun aldığı şeydir.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Projenin benzersiz tanımlayıcısı

list_board_listssalt okunur

Bir projenin kanban panosunun listelerini listeleyin, böylece aracı geçerli bir move_card hedefi çözebilir. Her aktif listeyi görüntüleme sırasına göre kimliğiyle (move_card hedefi olarak kullanılabilir) ve görüntüleme adıyla döndürür. Backlog, boş dize kimliğiyle seçilebilir bir girdi olarak dahil edilir.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Projenin benzersiz tanımlayıcısı (uid)

list_epicssalt okunur

Bir projenin destanlarını listeleyin, böylece aracı get_epic ve kart ataması için destan kimliklerini çözebilir. Her destanı görüntüleme sırasına göre (konum artan) kimliği, numarası, adı, açıklaması (Markdown), rengi, başlangıç/bitiş tarihleri ve kart sayılarıyla döndürür.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Projenin benzersiz tanımlayıcısı (uid)
updated_since	string		Yalnızca kaydı bu ISO-8601 tarih veya tarih-saat değerinde veya sonrasında değişen destanlar. Uyarı: koleksiyon düzenlemeleri (kontrol listeleri, bağlantılar) bir destanın değişiklik zamanını artırmayabilir; ad/tarih/açıklama düzenlemeleri her zaman artırır.

list_labelssalt okunur

Bir projenin etiketlerini listeleyin, böylece aracı kart yazımlarında neredeyse aynı olanları oluşturmak yerine mevcut taksonomiyi yeniden kullanabilir. Her etiketi görüntüleme sırasına göre (konum artan) kimliği, adı ve konumuyla döndürür.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Projenin benzersiz tanımlayıcısı (uid)

list_cardsalt okunur

Bir kanban listesinin kartlarını veya list_id boş bırakıldığında ya da boş bir string olarak verildiğinde projenin backlog'unun kartlarını, pano görüntüleme sırasına göre (sütunun üstü ilk, yani yerleşim konumu azalan — ürün arayüzünün gösterdiği sırayla) listeler. Filtreler AND ile birleşir: epic_id, label_id, assigned_user_id ve reporter_id uid alır (bilinmeyen bir uid hiçbir şeyle eşleşmez); due_date, verilen tarihe kadar veya o tarihte vadesi dolan kartları tutar. get_card / move_card / update_card için hazır, eyleme yetecek kart özetlerini (uid, başlık, liste + konum, epic, etiketler, atananlar, raporlayan, vade tarihi) döndürür; limit (varsayılan 50, maks 100) ve offset ile sayfalanır; total_count tam filtrelenmiş sayıdır.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Projenin benzersiz tanımlayıcısı (uid)
list_id	string		Okunacak liste uid'si; backlog için boş bırakın veya boş bir string verin
epic_id	string		Yalnızca seçilen listede veya backlog'da bu epic'teki (epic uid) kartlar; bir epic'in tüm listelerdeki tüm kartlarını listelemek için get_epic kullanın
label_id	string		Yalnızca bu etiketi (etiket uid) taşıyan kartlar
assigned_user_id	string		Yalnızca bu kullanıcıya (kullanıcı uid) atanan kartlar
reporter_id	string		Yalnızca bu kullanıcı (kullanıcı uid) tarafından raporlanan (oluşturulan) kartlar
due_date	string		Yalnızca bu tarihe kadar veya bu tarihte vadesi dolan kartlar (ISO-8601, örn. 2026-06-10)
updated_since	string		Yalnızca kaydı bu ISO-8601 tarihinde veya saatinde ya da sonrasında değişen kartlar — "son çalıştırmamdan bu yana ne değişti" filtresi. Uyarı: ekli koleksiyonlardaki (etiketler, kontrol listeleri, bağlantılar) düzenlemeler bir kartın değişiklik zamanını artırmayabilir; başlık/açıklama/skaler düzenlemeler her zaman artırır.
limit	integer		Sayfa boyutu, 1-100 (varsayılan 50)
offset	integer		Atlanacak kart sayısı (varsayılan 0)

search_cardsalt okunur

Bir proje içinde (kanban panosu ve backlog) başlık alt dizesi kart araması, ürünün proje içi canlı kart aramasıyla birebir eşleşir (veritabanı yalnızca kart başlığında büyük/küçük harf duyarsız alt dize — açıklamalar ve yorumlar aranmaz; tüm içerik türlerinde tam metin araması için search aracını kullanın), en yeni oluşturulan ilk olacak şekilde sıralanır. Eyleme yetecek kart özetlerini (uid, başlık, liste yerleşimi + konum, epic, etiketler, atananlar, raporlayan, vade tarihi) döndürür; eşleşme olmayan bir sorgu, hata değil boş bir kart dizisi döndürür. limit (varsayılan 50, maks 100) ve offset ile sayfalanır; total_count tam eşleşme sayısıdır.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Projenin benzersiz tanımlayıcısı (uid)
query	string	evet	Kart başlıklarıyla eşleştirilecek metin (büyük/küçük harf duyarsız alt dize)
limit	integer		Sayfa boyutu, 1-100 (varsayılan 50)
offset	integer		Atlanacak eşleşen kart sayısı (varsayılan 0)

list_attention_cardsPro · metricsalt okunur

Bir projenin kanban panosunda ilgi gerektiren kartları listeler — ürünün Metrikler sayfalarındakiyle aynı listeler. Türler: stuck (bir sütunda, backlog/Done değil, 7 günden fazla hareketsiz; en uzun süre takılı kalan ilk), blocking (diğer kartların engellendiği tamamlanmamış kartlar), overdue (sonraki 7 gün içinde vadesi dolacak veya vadesi geçmiş; en yakın vade ilk). kind bir listeyi veya 'all' (varsayılan) seçer. İsteğe bağlı olarak bir atanan uid'sine veya 'unassigned' değişmezine göre filtreleyin. İstenen her bölüm, get_card / move_card / update_card için hazır kart özetlerini döndürür, limit ile sınırlandırılır ve tam total_count ile birlikte gelir. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Projenin benzersiz tanımlayıcısı (uid)
kind	enum: stuck | blocking | overdue | all		Hangi ilgi listesinin döndürüleceği (varsayılan 'all' = her liste kendi bölümü olarak)
assignee_id	string		Yalnızca bu kullanıcı uid'sine atanan kartlar veya atananı olmayan kartlar için 'unassigned'
limit	integer		Bölüm başına maks kart, 1-100 (varsayılan 50)

get_metrics_summaryPro · metricsalt okunur

Bir projenin kanban panosunda ilgi gerektiren kartların tek çağrılık sayıları: overdue_cards_count, blocking_cards_count ve stuck_cards_count — list_attention_cards ile aynı tanımlar; bu araç her sayının arkasındaki kartları döndürür. Ucuzdur; daha derin bir bakışın değip değmeyeceğine karar vermek için önce bunu çağırın. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Projenin benzersiz tanımlayıcısı (uid)

list_roadmap_slotsPro · roadmapalt okunur

Bir projenin, bir tarih penceresiyle örtüşen yol haritası slotlarını listeler (varsayılan: bu ay ile beş ay sonrası arası). Bir slot, bir epic'i iki tarih arasında programlar ve atananlar taşıyabilir; bir epic birden fazla slot tutabilir, çakışmalar dahil — bu tasarım gereğidir. En fazla 200 slot döndürür — sınıra takılırsanız pencereyi daraltın. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Projenin benzersiz tanımlayıcısı
start_date	string		Pencere başlangıcı, ISO-8601 (YYYY-MM-DD); varsayılan: bu ayın başı
end_date	string		Pencere sonu, ISO-8601; varsayılan: start_date + 6 ay

create_roadmap_slotPro · roadmap

Proje yol haritasında bir epic programlayın: start_date'ten end_date'e bir slot, isteğe bağlı olarak atananlarla. Bir epic birden fazla slot tutabilir ve çakışmalara tasarım gereği izin verilir — mevcut bir slotu genişletmek yerine yeni bir tane eklemek istiyorsanız önce list_roadmap_slots'u kontrol edin. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Projenin benzersiz tanımlayıcısı
epic_id	string	evet	Epic uid'si (list_epics'ten); bu projeye ait olmalıdır
start_date	string	evet	ISO-8601 (YYYY-MM-DD)
end_date	string	evet	ISO-8601; start_date ile aynı gün olabilir
assigned_to	string dizisi		Atanacak kullanıcı uid'leri (proje üyeleri — bkz. list_project_users)

update_roadmap_slotPro · roadmap

Bir yol haritası slotunu güncelleyin: yeniden programlayın veya yeniden boyutlandırın (start_date/end_date), aynı projenin başka bir epic'ine taşıyın (epic_id) veya atananlarını ayarlayın. Yalnızca sağlanan alanlar değişir, assigned_to HARİÇ — bu, atanan kümesinin TAMAMINI DEĞİŞTİRİR — önce slotu okuyun ve kalması gereken herkesi gönderin. Slot uid'leri list_roadmap_slots'tan gelir. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Yol haritası slot uid'si
epic_id	string		Yeni epic uid'si (aynı proje)
start_date	string		ISO-8601 (YYYY-MM-DD)
end_date	string		ISO-8601
assigned_to	string dizisi		Tüm atananları DEĞİŞTİRİR (kullanıcı uid'leri, proje üyeleri); [] temizler

delete_roadmap_slotPro · roadmapyıkıcı

Bir yol haritası slotunu (ve atanan bağlantılarını) KALICI olarak siler. Bu geri alınamaz — yol haritası slotları için çöp kutusu yoktur. Epic'in kendisine dokunulmaz; yeniden programlamak için update_roadmap_slot'u tercih edin. Pro veya deneme çalışma alanı gerektirir.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Yol haritası slot uid'si (list_roadmap_slots'tan)

create_label

Bir projede ada göre yeni bir etiket oluşturun. Aynı ada sahip bir etiket zaten varsa (büyük/küçük harf duyarsız), neredeyse aynı bir tane oluşturmak yerine mevcut etiket değiştirilmeden döndürülür. Yeni etiket, görüntüleme sırasının sonuna eklenir.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Etiketin ait olduğu proje uid'si
name	string	evet

create_card

Bir projenin kanban panosunda bir kart oluşturun. Yalnızca project_id ve title zorunludur. Kartı backlog'a koymak için list_id'yi atlayın; kuyruğun sonuna katılmak için position'ı atlayın (move_card konum sözleşmesini belgeler). description, AgileHero Markup'tır — asla markdown veya HTML değil; önce get_ahm_spec'i okuyun. epic_id ve atanan uid'leri zaten mevcut olmalıdır (list_epics, list_project_users), henüz mevcut olmayan etiket adları ise projede oluşturulur. estimation, Fibonacci karmaşıklığıdır (0/1/2/3/5/8/13), bir zaman tahmini değildir. Kontrol listeleri, bağlantılar, ekler ve kart ilişkileri aynı çağrıda sağlanabilir.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Kartın ait olduğu proje uid'si (kart, projenin kanban panosunda oluşturulur)
list_id	string		Liste uid'si; backlog'a yerleştirmek için atlayın
position	integer
type	enum: story | bug | chore | research
title	string	evet
description	string		AgileHero Markup (AHM) — asla markdown veya HTML değil; önce get_ahm_spec'i okuyun. Açıklama yüzeyi: tablo, renk, hizalama veya tartışma yok.
epic_id	string		Epic uid'si; projede zaten mevcut olmalıdır
estimation	enum: 0 | 1 | 2 | 3 | 5 | 8 | 13		Hikaye puanı cinsinden karmaşıklık tahmini (Fibonacci ölçeği), bir zaman tahmini değil
due_date	string		ISO-8601 tarihi
assigned_to	string dizisi		Atanan kullanıcı uid'leri, list_project_users ile keşfedilebilir
labels	string dizisi		Etiket adları; bilinmeyen adlar projede oluşturulur
checklists	object dizisi		Her biri { name, items: [{ description, checked }] }; öğeler sağlanan sırayı korur
cards_relations	object dizisi		Her biri { type, target_card_id (aynı panoda bir kart uid'si) }
links	object dizisi		Her biri { url, description }
attachments	object dizisi		Her biri { url, name }; dosya url'den getirilir

update_cardyıkıcı

Mevcut bir kartı uid'sine göre güncelleyin. Koleksiyonlar için add_*/remove_* delta alanlarını tercih edin (güvenli artımlı düzenlemeler: add_labels, remove_assignees, add_checklist_items, check_items, …); düz koleksiyon alanları (labels, assigned_to, checklists, cards_relations, links, attachments) önceki durumu yıkıcı bir şekilde DEĞİŞTİRİR ve delta alanlarıyla birleştirilemez. Liste veya konumu değiştirmek için move_card'ı ve açıklamayı düzenlemek için preview_description_update / update_description'ı kullanın.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Kart kimliği
type	enum: story | bug | chore | research
title	string
epic_id	string
estimation	enum: 0 | 1 | 2 | 3 | 5 | 8 | 13		Hikaye puanı cinsinden karmaşıklık tahmini (Fibonacci ölçeği), zaman tahmini değildir
due_date	string		ISO-8601 tarihi
assigned_to	string dizisi		Atanan kullanıcı kimlikleri, list_project_users ile keşfedilebilir; kartın atananlarını değiştirir
labels	string dizisi		Etiket adları; bilinmeyen adlar projede oluşturulur; kartın etiketlerini değiştirir
checklists	nesne dizisi		Her biri { name, items: [{ description, checked }] }; öğeler verilen sırayı korur; kartın kontrol listelerini değiştirir
cards_relations	nesne dizisi		Her biri { type, target_card_id (aynı panodaki bir kart kimliği) }; kartın ilişkilerini değiştirir
links	nesne dizisi		Her biri { url, description }; kartın bağlantılarını değiştirir
attachments	nesne dizisi		Her biri { url, name }; dosya url adresinden alınır; kartın eklerini değiştirir
add_labels	string dizisi		Ada göre etiket ekler (bilinmeyen adlar oluşturulur); mevcut etiketleri korur
remove_labels	string dizisi		Ada göre etiketleri kaldırır (büyük/küçük harf duyarsız); olmayan adlar işlem yapmaz
add_assignees	string dizisi		Kullanıcı kimliğine göre atanan ekler; mevcut atananları korur
remove_assignees	string dizisi		Kullanıcı kimliğine göre atananları kaldırır; olmayan kimlikler işlem yapmaz
add_checklist_items	nesne dizisi		Öğe ekler: her biri { checklist, description, checked? } — adlandırılmış kontrol listesi yoksa oluşturulur
check_items	nesne dizisi		Öğeleri tamamlandı olarak işaretler, adlandırılmış kontrol listesi içinde tam açıklamayla eşleştirilir
uncheck_items	nesne dizisi		Öğeleri tamamlanmadı olarak işaretler (check_items ile aynı eşleştirme)
remove_checklist_items	nesne dizisi		Öğeleri siler; olmayan öğeler işlem yapmaz
add_relations	nesne dizisi		İlişki ekler; mevcut ilişkileri korur
remove_relations	nesne dizisi		Eşleşen ilişkileri kaldırır; olmayanlar işlem yapmaz
add_links	nesne dizisi		Bağlantı ekler: her biri { url, description? }; mevcut bağlantıları korur
remove_links	string dizisi		Tam url ile bağlantıları kaldırır; olmayan url'ler işlem yapmaz

delete_cardyıkıcı

Bir kartı kimliğine göre yumuşak siler: kart panodan ve tüm listelerden çıkar, diğer kartlarla ilişkileri kaldırılır, üzerindeki tahmin oturumu devre dışı bırakılır ve bağlı beyaz tahta öğeleri bağlantısız hale getirilir. Ait olduğu epik silinmez. MCP üzerinden geri alma yoktur.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Kart kimliği

move_card

Bir kartı farklı bir listeye taşır (veya aynı liste içinde konumunu değiştirir). Yalnızca kanban panosundaki kartlar taşınabilir; retrospektif panolardaki kartlar reddedilir. Kartı kanban birikim listesine taşımak için list_id için boş bir dize geçirin. Bir liste en yüksek konumundan yukarıdan aşağıya görüntülenir, bu nedenle konum 0 listenin ALTIDIR. Konum atlanırsa, birikim listesinde ve to_do ve in_progress listelerinde kuyruğun sonuna (alt, konum 0) veya done listesinin üstüne katılır.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Kart kimliği
list_id	string	evet	Hedef liste kimliği; boş dize birikim listesine taşır (yalnızca kanban)
position	integer		Hedef içindeki yerleşim: 0 alt, en yüksek konum üsttür. 0 ile hedefte zaten bulunan diğer kart sayısı arasında olmalıdır. Atlanırsa, birikim listesinde ve to_do ve in_progress listelerinde kuyruğun sonuna (konum 0) veya done listesinin üstüne katılır.

create_epic

Bir projede epik oluşturur. Yalnızca project_id ve name zorunludur. description AgileHero Markup'tır — asla markdown veya HTML değil; önce get_ahm_spec okuyun. Atanan kullanıcı kimlikleri list_project_users'tan gelir. Kontrol listeleri, bağlantılar ve ekler aynı çağrıda sağlanabilir. Yeni epik kimliğini döndürür — create_card / update_card'ın epic_id olarak aldığı ve create_roadmap_slot'un programladığı kimlik.

Parametre	Tür	Zorunlu	Açıklama
project_id	string	evet	Epikin ait olduğu proje kimliği
name	string	evet
description	string		AgileHero Markup (AHM) — asla markdown veya HTML değil; önce get_ahm_spec okuyun. Açıklama yüzeyi: tablo, renk, hizalama veya tartışma yok.
color	string		#0060F0 gibi hex renk
start_date	string		ISO-8601 tarihi
end_date	string		ISO-8601 tarihi
assigned_to	string dizisi		Atanan kullanıcı kimlikleri, list_project_users ile keşfedilebilir
checklists	nesne dizisi		Her biri { name, items: [{ description, checked }] }; öğeler verilen sırayı korur
links	nesne dizisi		Her biri { url, description }
attachments	nesne dizisi		Her biri { url, name }; dosya url adresinden alınır

update_epicyıkıcı

Mevcut bir epiki kimliğine göre günceller; yalnızca sağlanan alanlar değiştirilir. Koleksiyonlar için add_*/remove_* delta alanlarını tercih edin (güvenli artımlı düzenlemeler); düz koleksiyon alanları (assigned_to, checklists, links, attachments) önceki durumu yıkıcı şekilde DEĞİŞTİRİR ve delta alanlarıyla birleştirilemez. Açıklamayı düzenlemek için preview_description_update / update_description kullanın.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Epik kimliği
name	string
color	string		#0060F0 gibi hex renk
start_date	string		ISO-8601 tarihi
end_date	string		ISO-8601 tarihi
assigned_to	string dizisi		Atanan kullanıcı kimlikleri, list_project_users ile keşfedilebilir; epikin atananlarını değiştirir
checklists	nesne dizisi		Her biri { name, items: [{ description, checked }] }; epikin kontrol listelerini değiştirir
links	nesne dizisi		Her biri { url, description }; epikin bağlantılarını değiştirir
attachments	nesne dizisi		Her biri { url, name }; dosya url adresinden alınır; epikin eklerini değiştirir
add_assignees	string dizisi		Kullanıcı kimliğine göre atanan ekler; mevcut atananları korur
remove_assignees	string dizisi		Kullanıcı kimliğine göre atananları kaldırır; olmayan kimlikler işlem yapmaz
add_checklist_items	nesne dizisi		Öğe ekler: her biri { checklist, description, checked? } — adlandırılmış kontrol listesi yoksa oluşturulur
check_items	nesne dizisi		Öğeleri tamamlandı olarak işaretler, adlandırılmış kontrol listesi içinde tam açıklamayla eşleştirilir
uncheck_items	nesne dizisi		Öğeleri tamamlanmadı olarak işaretler (check_items ile aynı eşleştirme)
remove_checklist_items	nesne dizisi		Öğeleri siler; olmayan öğeler işlem yapmaz
add_links	nesne dizisi		Bağlantı ekler: her biri { url, description? }; mevcut bağlantıları korur
remove_links	string dizisi		Tam url ile bağlantıları kaldırır; olmayan url'ler işlem yapmaz

delete_epicyıkıcı

Bir epiki kimliğine göre yumuşak siler. Kartları SİLİNMEZ — panoda kalır, epikten ayrılır. Epikin yol haritası slotları KALICI olarak silinir (bir slot bir epiki programlar, bu yüzden epik olmadan anlamsızdır) ve epike bağlı beyaz tahta öğeleri bağlantısız hale getirilir.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Epik kimliği

create_comment

Bir karta veya bir epike yorum ekler. card_id veya epic_id'den tam olarak birini sağlayın. İçerik AgileHero Markup'tır (AHM, yorum yüzeyi: tablo, medya, renk, hizalama veya tartışma yok) — asla markdown veya HTML değil; önce get_ahm_spec okuyun. Yorum, bu istemcinin hareket ettiği oturum açmış kullanıcıya atfedilir ve sonraki get_card / get_epic yanıtlarında görünür. Yorumlar MCP üzerinden düzenlenemez; delete_comment kendi yorumlarınızı kaldırır (hataları silme + yeniden gönderme ile düzeltin). Mevcut bir yoruma yanıt vermek için parent_comment_id geçirin. Konular bir seviye derinliğindedir: bir yanıta yanıt vermek, yeni yorumu o yanıtın konu köküne ekler, bu yüzden iç içe yanıtlar denemeyin. Üst öğe, aynı kart veya epik üzerinde bir yorum olmalıdır — başka bir yerden gelen bir kimlik reddedilir.

Parametre	Tür	Zorunlu	Açıklama
card_id	string		Yorum yapılacak kart kimliği (epic_id ile karşılıklı dışlayıcı)
epic_id	string		Yorum yapılacak epik kimliği (card_id ile karşılıklı dışlayıcı)
content	string	evet	AgileHero Markup (AHM) olarak yorum gövdesi
parent_comment_id	string		AYNI kart veya epik üzerindeki bir yoruma yanıt vermek için isteğe bağlı kimlik. Üst düzey bir yorum için atlayın. Bir yanıta yanıt vermek, o yanıtın konu köküne normalleştirilir (konular bir seviye derinliğindedir).

delete_commentyıkıcı

SİZİN gönderdiğiniz bir yorumu siler (yorumlar, bu istemcinin hareket ettiği oturum açmış kullanıcıya atfedilir — başkalarının yorumları silinemez). Düzeltme deseni, silme + create_comment ile düzeltilmiş bir yorum göndermedir. Yanıtları olan silinmiş bir yorum, konusunda bir mezar taşı olarak görünür kalır. Yorum kimlikleri get_card / get_epic'ten gelir.

Parametre	Tür	Zorunlu	Açıklama
id	string	evet	Yorum kimliği