Velocity

npx add-mcp 'https://velocity.quest/api/mcp'

MCP Sunucusu

AI ajanlarını Model Context Protocol üzerinden Velocity'ye bağlayın.

MCP Nedir?

Model Context Protocol (MCP), AI ajanlarının harici araçlarla birleşik bir arayüz üzerinden etkileşime girmesini sağlayan açık bir standarttır. Velocity, sorun takibi, PRD'ler ve kullanıcı hikayeleri, proje bağlamı, çalışma alanı etkinlikleri, çalışma alanı ve kullanıcı yönetimi, yol haritası planlaması, özel alan adları, Claude ajan koordinasyonu ve daha fazlası için 84 araç içeren yerleşik bir MCP sunucusu içerir.

Claude Code, Claude Desktop, Codex, Cursor ve diğer MCP uyumlu istemciler gibi AI ajanları Velocity'ye bağlanabilir; sorun oluşturabilir, görev arayabilir, durumları güncelleyebilir, projeleri yönetebilir, yol haritaları planlayabilir ve alan adlarını yapılandırabilir — tüm bunları kendi iş akışlarından çıkmadan yapabilirler.

Kullanılabilirlik ve erişim

MCP, Pro, Business veya Enterprise planındaki çalışma alanlarının mevcut üyeleri için kullanılabilir. Ücretsiz çalışma alanları MCP kullanamaz. Tarayıcı OAuth veya Ayarlar → MCP bölümünden bir çalışma alanı bağlantı belirteci ile bağlanın. Kişisel API anahtarları MCP kimlik doğrulaması yapamaz. Kurulum ve sorun giderme bölümüne bakın.

Bağlı sunucunun tools/list yanıtı, mevcut araç ve girdi şeması kataloğudur. Listelenen bir araç yine de yazma kapsamı, sahip/yönetici rolü, özellik hakkı, entegrasyon yapılandırması veya yönetilen çalışan kiralama gerektirebilir. Yalnızca araç erişimi bir çalışanı başlatmaz veya otonom kodlama, inceleme, birleştirme veya dağıtımı garanti etmez.

Kullanım Durumları

• AI kodlama asistanları — kod incelemelerinden doğrudan hata raporları oluşturun
• Otomatik önceliklendirme — ajanlar gelen sorunları kategorize eder ve önceliklendirir
• Durum güncellemeleri — ajanlar işlerini tamamladıkça sorun ilerlemesini günceller
• Arama ve bağlam — ajanlar işlerini bilgilendirmek için ilgili sorunları bulur
• Proje yönetimi — ajanlar projeleri, döngüleri ve kilometre taşlarını okur
• Yol haritası planlaması — ajanlar yol haritası öğelerini, sürümleri ve oylamayı yönetir
• Alan adı yönetimi — ajanlar özel alan adları ekler ve doğrular
• AI ajan koordinasyonu — yapılandırılmış çalışanlar sorunları işler, commit'leri bağlar ve sprint ilerlemesini takip eder

Kullanılabilir Araçlar

Bu tablolar seçilmiş araçlardır. Araç referansı ayrıca PRD ve hikaye planlamasını, özel ekleri, çalışma alanı etkinliklerini, sorun/check izlemeyi ve teslimat profillerini kapsar. MCP şu anda proje/döngü bağlamını okur; projeler, döngüler veya proje kilometre taşları oluşturmak için GraphQL API kullanın.

PRD'ler ve kullanıcı hikayeleri

PRD'leri, gereksinimleri ve hikayeleri okuyun ve düzenleyin; hikayeleri bölün, sorunları bağlayın ve incelenen hikaye önerilerinden sorunlar oluşturun. AI öneri araçları mcp:write, ilgili AI plan hakkı ve kullanılabilir kredi gerektirir. Öneriler ayrı inceleme ve kaydetme eylemleri gerektirir; insan PRD onayı Velocity'de kalır. Fikirden sorunlara bölümüne bakın.

Sorun Takibi

Araç	Kapsam	Açıklama
list_issues	okuma	Proje, durum, öncelik, atanan kişi, etiket filtreleriyle sorunları listeler
get_issue	okuma	Bir sorunun kimliğine veya tanımlayıcısına göre tüm ayrıntılarını alır (örn. ENG-123)
create_issue	yazma	Başlık, açıklama, öncelik, durum ile yeni bir sorun oluşturur
update_issue	yazma	Mevcut bir sorunun alanlarını günceller
search_issues	okuma	Sorun başlıkları ve açıklamalarında tam metin araması yapar
add_comment	yazma	Bir soruna yorum ekler
list_comments	okuma	Bir sorundaki tüm yorumları listeler

Projeler ve Döngüler

Araç	Kapsam	Açıklama
list_projects	okuma	İsteğe bağlı durum filtresiyle tüm projeleri listeler
get_project	okuma	Kilometre taşları ve sorun sayısı dahil proje ayrıntılarını alır
list_cycles	okuma	İsteğe bağlı durum filtresiyle sprint döngülerini listeler
get_cycle	okuma	Sorun sayıları ve ilerleme ile döngü ayrıntılarını alır

Çalışma Alanı Meta Verileri

Araç	Kapsam	Açıklama
list_teams	okuma	Çalışma alanındaki tüm ekipleri listeler
list_labels	okuma	Tüm kullanılabilir etiketleri listeler
list_statuses	okuma	Ekipler arasındaki tüm sorun durumlarını listeler
list_members	okuma	Rolleriyle birlikte çalışma alanı üyelerini listeler

Yol Haritası

Araç	Kapsam	Açıklama
list_roadmap_items	okuma	Durum, kategori ve sürüm filtreleriyle yol haritası öğelerini listeler
create_roadmap_item	yazma	Yeni bir yol haritası öğesi oluşturur
update_roadmap_item	yazma	Mevcut bir yol haritası öğesini günceller
delete_roadmap_item	yazma	Bir yol haritası öğesini siler
vote_roadmap_item	yazma	Bir yol haritası öğesinde oylamayı değiştirir
list_roadmap_versions	okuma	Tüm yol haritası sürümlerini (sürümler) listeler
create_roadmap_version	yazma	Yeni bir yol haritası sürümü oluşturur
get_roadmap_settings	okuma	Yol haritası görünürlüğünü ve oylama ayarlarını alır
update_roadmap_settings	yazma	Yol haritası ayarlarını günceller

Çalışma Alanı ve Kullanıcı

Araç	Kapsam	Açıklama
list_workspaces	okuma	Kullanıcı çalışma alanlarını listeler; OAuth yalnızca bağlı çalışma alanını döndürür
create_workspace	yazma	Yeni bir çalışma alanı oluşturur (kullanıcı sahip olur)
delete_workspace	yazma	Bir çalışma alanını kalıcı olarak siler (yalnızca sahip)
get_workspace	okuma	Geçerli çalışma alanı ayrıntılarını alır (ad, plan, üye sayısı)
update_workspace	yazma	Çalışma alanı adını günceller (açıklama desteklenmez)
get_current_user	okuma	Kimliği doğrulanmış kullanıcının profilini alır
update_current_user	yazma	Kullanıcı görünen adını veya avatarını günceller
list_user_api_keys	okuma	Kişisel API anahtarlarını listeler (velu_ öneki)
create_user_api_key	yazma	Kişisel bir API anahtarı oluşturur (anahtarı yalnızca bir kez döndürür)
revoke_user_api_key	yazma	Kişisel bir API anahtarını iptal eder

Özel Alan Adları

Araç	Kapsam	Açıklama
list_domains	okuma	Doğrulama durumuyla özel alan adlarını listeler
add_domain	yazma	DNS kurulum talimatlarıyla özel bir alan adı ekler
verify_domain	yazma	Alan adı doğrulama durumunu kontrol eder
remove_domain	yazma	Özel bir alan adını kaldırır

Ajan iş akışı

Araç	Kapsam	Açıklama
transition_issue	yazma	Sorunu UUID yerine ada göre bir duruma taşır (örn. "Devam Ediyor")
get_my_issues	okuma	Kimliği doğrulanmış kullanıcıya atanan sorunları durum grubuna göre filtreleyerek alır
get_active_sprint	okuma	Sorun sayıları ve ilerleme ile aktif döngüyü alır
link_commit	yazma	Bir soruna karşı bir commit SHA'sı kaydeder
link_pr	yazma	Bir soruna karşı bir pull request URL'si kaydeder
get_issue_context	okuma	Zengin sorun bağlamı: yorumlar, etkinlikler, etiketler, bağlı olaylar
get_pending_agent_runs	okuma	Yerel bir çalışan için bekleyen API veya Claude Code çalıştırmalarını alır
update_agent_run	yazma	Bir ajan çalıştırmasının durumunu, belirteçlerini ve sonucunu günceller

Kaynaklar

MCP sunucusu ayrıca hızlı bağlam için şu salt okunur kaynakları da sunar:

URI	Açıklama
velocity://workspace	Çalışma alanı meta verileri (ad, kısa ad, plan, üye/ekip sayıları)
velocity://issues	Son sorunlar (son 20, güncelleme zamanına göre sıralanmış)
velocity://projects	Durum ve ilerleme ile tüm projeler
velocity://roadmap	Yol haritası öğeleri, sürümler ve ayarlar genel bakışı
velocity://domains	Doğrulama durumuyla özel alan adları

Kimlik bilgisi sınırlamaları

OAuth bağlantıları, bu araçlar katalogda görünse bile kişisel API anahtarlarını listeleyemez, oluşturamaz veya iptal edemez. Anahtarları Velocity ayarlarında yönetin veya bu araçlar için bir bağlantı belirteci kullanın. Bağlantı belirteçleri daha geniş hesap yeteneklerine sahiptir; bunları gizli tutun ve kullanılmayan bağlantıları iptal edin.

Kapsamlar

MCP OAuth izinleri şu kapsamları kullanır. Ayarlar → MCP bölümündeki bağlantı belirteçleri her ikisini de içerir:

• mcp:read — Kimlik bilgisi ve özellik kısıtlamalarına tabi okuma araçları ve kaynakları
• mcp:write — Rol, özellik ve çalışan politikası kontrollerine tabi yazma araçları (mcp:read ile isteyin)

Sonraki Adımlar

• Kurulum ve Kimlik Doğrulama — oturum açın veya bir bağlantı belirteci oluşturun ve istemcinizi yapılandırın
• Araç Referansı — her araç için ayrıntılı parametre belgeleri