Asana için MCP Server

Bu Model Context Protocol server uygulaması Asana'nın, Anthropic'in Claude Desktop Application'ı gibi MCP Client'larından Asana API'si ile iletişim kurmanıza olanak sağlar ve daha pek çok araçla çalışır.

MCP hakkında daha fazla bilgi:

• https://www.anthropic.com/news/model-context-protocol
• https://modelcontextprotocol.io/introduction
• https://github.com/modelcontextprotocol

Ortam Değişkenleri

• ASANA_ACCESS_TOKEN: (Gerekli) Asana erişim tokenınız
• READ_ONLY_MODE: (İsteğe bağlı) Tüm yazma işlemlerini devre dışı bırakmak için 'true' olarak ayarlayın. Bu modda:
  • Asana verilerini değiştiren araçlar (oluştur, güncelle, sil) devre dışı bırakılır
  • create-task prompt devre dışı bırakılır
  • Yalnızca okuma işlemleri kullanılabilir Bu, test etme veya Asana çalışma alanınızda hiçbir değişiklik yapılmadığından emin olmak istediğinizde faydalıdır.

Kullanım

Seçtiğiniz yapay zeka aracında (ör: Claude Desktop) Asana görevleri, projeleri, çalışma alanları ve/veya yorumlar hakkında bir şey sorun. "Asana" sözcüğünü kullanmak, LLM'nin doğru aracı seçme olasılığını artıracaktır.

Örnek:

Sprint 30 projemizde kaç tane tamamlanmamış asana görevimiz var?

Başka bir örnek:

Araçlar

1. asana_list_workspaces
   • Asana'daki tüm mevcut çalışma alanlarını listeleyin
   • İsteğe bağlı giriş:
     • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
   • Döner: Çalışma alanlarının listesi
2. asana_search_projects
   • Asana'da ad deseni eşleştirmesi kullanarak projeleri arayın
   • Gerekli giriş:
     • workspace (string): Aranacak çalışma alanı
     • name_pattern (string): Proje adlarını eşleştirmek için düzenli ifade deseni
   • İsteğe bağlı giriş:
     • archived (boolean): Yalnızca arşivlenmiş projeleri döndür (varsayılan: false)
     • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
   • Döner: Eşleşen projelerin listesi
3. asana_search_tasks
   • Gelişmiş filtreleme seçenekleri ile çalışma alanında görevleri arayın
   • Gerekli giriş:
     • workspace (string): Aranacak çalışma alanı
   • İsteğe bağlı giriş:
     • text (string): Görev adlarında ve açıklamalarında aranacak metin
     • resource_subtype (string): Görev alt türüne göre filtreleyin (ör: milestone)
     • completed (boolean): Tamamlanan görevler için filtreleyin
     • is_subtask (boolean): Alt görevler için filtreleyin
     • has_attachment (boolean): Ekleri olan görevler için filtreleyin
     • is_blocked (boolean): Tamamlanmamış bağımlılıkları olan görevler için filtreleyin
     • is_blocking (boolean): Bağımlı görevleri olan tamamlanmamış görevler için filtreleyin
     • assignee, projects, sections, tags, teams ve diğer pek çok gelişmiş filtre
     • sort_by (string): due_date, created_at, completed_at, likes, modified_at'e göre sıralayın (varsayılan: modified_at)
     • sort_ascending (boolean): Artan sırada sıralayın (varsayılan: false)
     • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
     • custom_fields (object): Özel alan filtrelerini içeren obje
   • Döner: Eşleşen görevlerin listesi
4. asana_get_task
   • Belirli bir görev hakkında ayrıntılı bilgi alın
   • Gerekli giriş:
     • task_id (string): Alınacak görev kimliği
   • İsteğe bağlı giriş:
     • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
   • Döner: Ayrıntılı görev bilgisi
5. asana_create_task
   • Bir projede yeni bir görev oluşturun
   • Gerekli giriş:
     • project_id (string): Görevin oluşturulacağı proje
     • name (string): Görevin adı
   • İsteğe bağlı giriş:
     • notes (string): Görevin açıklaması
     • html_notes (string): Görevin HTML biçimli açıklaması
     • due_on (string): Bitiş tarihi YYYY-MM-DD biçiminde
     • assignee (string): Atanan kişi ('me' veya bir kullanıcı kimliği olabilir)
     • followers (array of strings): Takipçi olarak eklenecek kullanıcı kimliklerinin dizisi
     • parent (string): Bu görevin altına ayarlanacak ana görevin kimliği
     • projects (array of strings): Bu görevin eklenecği proje kimliklerinin dizisi
     • resource_subtype (string): Görevin türü (default_task veya milestone)
     • custom_fields (object): Özel alan GID dizelerini değerlerine eşleyen obje
   • Döner: Oluşturulan görev bilgisi
6. asana_get_task_stories
   • Belirli bir görev için yorumlar ve hikayeleri alın
   • Gerekli giriş:
     • task_id (string): Hikayeleri alınacak görev kimliği
   • İsteğe bağlı giriş:
     • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
   • Döner: Görev hikayeleri/yorumlarının listesi
7. asana_update_task
   • Mevcut bir görevin ayrıntılarını güncelleyin
   • Gerekli giriş:
     • task_id (string): Güncellenecek görev kimliği
   • İsteğe bağlı giriş:
     • name (string): Görev için yeni ad
     • notes (string): Görev için yeni açıklama
     • html_notes (string): Görevin HTML biçimli açıklaması (desteklenen HTML etiketleri alt kümesi)
     • due_on (string): Yeni bitiş tarihi YYYY-MM-DD biçiminde
     • assignee (string): Yeni atanan kişi ('me' veya bir kullanıcı kimliği olabilir)
     • followers (array): Takipçi olarak eklenecek kullanıcı kimliklerinin dizisi
     • parent (string): Bu görevin altına taşınacağı ana görevin kimliği
     • completed (boolean): Görevi tamamlandı olarak işaretleyin veya işaretlemeyin
     • resource_subtype (string): Görevin türü (default_task veya milestone)
     • custom_fields (object): Özel alan GID dizelerini değerlerine eşleyen obje
   • Döner: Güncellenmiş görev bilgisi
8. asana_get_project
   • Belirli bir proje hakkında ayrıntılı bilgi alın
   • Gerekli giriş:
     • project_id (string): Alınacak proje kimliği
   • İsteğe bağlı giriş:
     • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
   • Döner: Ayrıntılı proje bilgisi
9. asana_get_project_task_counts
   • Bir projede görev sayısını alın
   • Gerekli giriş:
     • project_id (string): Görev sayıları alınacak proje kimliği
   • İsteğe bağlı giriş:
     • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
   • Döner: Görev sayısı bilgisi
10. asana_get_project_sections
    • Bir projede bölümleri alın
    • Gerekli giriş:
      • project_id (string): Bölümleri alınacak proje kimliği
    • İsteğe bağlı giriş:
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Proje bölümlerinin listesi
11. asana_create_task_story
    • Bir görev üzerinde yorum veya hikaye oluşturun
    • Gerekli giriş:
      • task_id (string): Hikayenin ekleneceği görev kimliği
      • text (string): Hikaye/yorumun metin içeriği
    • İsteğe bağlı giriş:
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Oluşturulan hikaye bilgisi
12. asana_add_task_dependencies
    • Bir görev için bağımlılıklar ayarlayın
    • Gerekli giriş:
      • task_id (string): Bağımlılıklar eklenecek görev kimliği
      • dependencies (array of strings): Bu görevin bağlı olduğu görev kimliklerinin dizisi
    • Döner: Güncellenmiş görev bağımlılıkları
13. asana_add_task_dependents
    • Bir görev için bağımlı görevleri ayarlayın (bu göreve bağlı görevler)
    • Gerekli giriş:
      • task_id (string): Bağımlı görevler eklenecek görev kimliği
      • dependents (array of strings): Bu göreve bağlı görev kimliklerinin dizisi
    • Döner: Güncellenmiş görev bağımlı görevleri
14. asana_create_subtask
    • Mevcut bir görev için yeni bir alt görev oluşturun
    • Gerekli giriş:
      • parent_task_id (string): Alt görevin oluşturulacağı ana görev kimliği
      • name (string): Alt görevin adı
    • İsteğe bağlı giriş:
      • notes (string): Alt görevin açıklaması
      • due_on (string): Bitiş tarihi YYYY-MM-DD biçiminde
      • assignee (string): Atanan kişi ('me' veya bir kullanıcı kimliği olabilir)
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Oluşturulan alt görev bilgisi
15. asana_get_multiple_tasks_by_gid
    • GID'lerine göre birden çok görev hakkında ayrıntılı bilgi alın (maksimum 25 görev)
    • Gerekli giriş:
      • task_ids (array of strings or comma-separated string): Alınacak görev GID'leri (maks 25)
    • İsteğe bağlı giriş:
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Ayrıntılı görev bilgisinin listesi
16. asana_get_project_status
    • Bir proje durum güncellemesi alın
    • Gerekli giriş:
      • project_status_gid (string): Alınacak proje durumu GID'i
    • İsteğe bağlı giriş:
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Proje durumu bilgisi
17. asana_get_project_statuses
    • Bir proje için tüm durum güncellemelerini alın
    • Gerekli giriş:
      • project_gid (string): Durumlara alınacak proje GID'i
    • İsteğe bağlı giriş:
      • limit (number): Sayfa başına sonuçlar (1-100)
      • offset (string): Sayfalandırma offset jetonu
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Proje durum güncellemelerinin listesi
18. asana_create_project_status
    • Bir proje için yeni bir durum güncellemesi oluşturun
    • Gerekli giriş:
      • project_gid (string): Durum oluşturulacak proje GID'i
      • text (string): Durum güncellemesinin metin içeriği
    • İsteğe bağlı giriş:
      • color (string): Durumun rengi (green, yellow, red)
      • title (string): Durum güncellemesinin başlığı
      • html_text (string): Durum güncellemesi için HTML biçimli metin
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Oluşturulan proje durumu bilgisi
19. asana_delete_project_status
    • Bir proje durum güncellemesini silin
    • Gerekli giriş:
      • project_status_gid (string): Silinecek proje durumu GID'i
    • Döner: Silme onayı
20. asana_set_parent_for_task
    • Bir görevin ana görevini ayarlayın ve alt görevi bu ana görevin diğer alt görevleri içinde konumlandırın
    • Gerekli giriş:
      • task_id (string): İşlem yapılacak görev kimliği
      • data (object):
        • parent (string): Görevin yeni ana görevi veya ana görev olmadığı için null
    • İsteğe bağlı giriş:
      • insert_after (string): Alt görevin eklenecği ana görevin alt görevi veya listenin başına eklemek için null
      • insert_before (string): Alt görevin eklenecği ana görevin alt görevi veya listenin sonuna eklemek için null
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Güncellenmiş görev bilgisi
21. asana_get_tag
    • Belirli bir etiket hakkında ayrıntılı bilgi alın
    • Gerekli giriş:
      • tag_gid (string): Etiket için genel olarak benzersiz tanımlayıcı
    • İsteğe bağlı giriş:
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Ayrıntılı etiket bilgisi
22. asana_get_tags_for_task
    • Bir görevin etiketlerini alın
    • Gerekli giriş:
      • task_gid (string): İşlem yapılacak görev
    • İsteğe bağlı giriş:
      • limit (number): Sayfa başına sonuçlar. Döndürülecek sayfa başına nesne sayısı. Değer 1 ile 100 arasında olmalıdır.
      • offset (string): Offset jetonu. API tarafından döndürülen sonraki sayfaya bir offset.
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Görevle ilişkili etiketlerin listesi
23. asana_get_tasks_for_tag
    • Belirli bir etiket için görevleri alın
    • Gerekli giriş:
      • tag_gid (string): Görevleri alınacak etiket GID'i
    • İsteğe bağlı giriş:
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
      • opt_pretty (boolean): Yanıtı 'güzel' biçimde sağlar
      • limit (integer): Sayfa başına döndürülecek nesne sayısı. Değer 1 ile 100 arasında olmalıdır.
      • offset (string): API tarafından döndürülen sonraki sayfaya bir offset.
    • Döner: Belirtilen etiketin görevlerinin listesi
24. asana_get_tags_for_workspace
    • Çalışma alanında etiketleri alın
    • Gerekli giriş:
      • workspace_gid (string): Çalışma alanı veya organizasyon için genel olarak benzersiz tanımlayıcı
    • İsteğe bağlı giriş:
      • limit (integer): Sayfa başına sonuçlar. Döndürülecek sayfa başına nesne sayısı. Değer 1 ile 100 arasında olmalıdır.
      • offset (string): Offset jetonu. API tarafından döndürülen sonraki sayfaya bir offset.
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Çalışma alanındaki etiketlerin listesi
25. asana_update_tag
    • Mevcut bir etiketi güncelleyin
    • Gerekli giriş:
      • tag_gid (string): Etiket için genel olarak benzersiz tanımlayıcı
    • İsteğe bağlı giriş:
      • name (string): Etiketin adı
      • color (string): Etiketin rengi. Şu değerlerden biri olabilir: dark-pink, dark-green, dark-blue, dark-red, dark-teal, dark-brown, dark-orange, dark-purple, dark-warm-gray, light-pink, light-green, light-blue, light-red, light-teal, light-brown, light-orange, light-purple, light-warm-gray
      • notes (string): Etiket hakkında notlar
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Güncellenmiş etiket bilgisi
26. asana_delete_tag
    • Bir etiketi silin
    • Gerekli giriş:
      • tag_gid (string): Etiket için genel olarak benzersiz tanımlayıcı
    • Döner: Silme onayı
27. asana_create_tag_for_workspace
    • Çalışma alanında yeni bir etiket oluşturun
    • Gerekli giriş:
      • workspace_gid (string): Çalışma alanı veya organizasyon için genel olarak benzersiz tanımlayıcı
      • name (string): Etiketin adı
    • İsteğe bağlı giriş:
      • color (string): Etiketin rengi. Şu değerlerden biri olabilir: dark-pink, dark-green, dark-blue, dark-red, dark-teal, dark-brown, dark-orange, dark-purple, dark-warm-gray, light-pink, light-green, light-blue, light-red, light-teal, light-brown, light-orange, light-purple, light-warm-gray
      • notes (string): Etiket hakkında notlar
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Oluşturulan etiket bilgisi
28. asana_add_tag_to_task
    • Bir göreve etiket ekleyin
    • Gerekli giriş:
      • task_gid (string): Etiket eklenecek görev GID'i
      • tag_gid (string): Göreve eklenecek etiket GID'i
    • Döner: Başarı yanıtı
29. asana_remove_tag_from_task
    • Bir görevden etiket kaldırın
    • Gerekli giriş:
      • task_gid (string): Etiket kaldırılacak görev GID'i
      • tag_gid (string): Görevden kaldırılacak etiket GID'i
    • Döner: Başarı yanıtı
30. asana_add_project_to_task
    • Mevcut bir görevi bir projeye ekleyin
    • Gerekli giriş:
      • task_id (string): Projeye eklenecek görev kimliği
      • project_id (string): Görevi eklenecek proje kimliği
    • İsteğe bağlı giriş:
      • section (string): Görevin proje içinde ekleneceği bölüm kimliği
      • insert_after (string): Bu görevin eklenecği bir görev kimliği. En fazla insert_before, insert_after veya section belirtilmelidir.
      • insert_before (string): Bu görevin eklenecği bir görev kimliği. En fazla insert_before, insert_after veya section belirtilmelidir.
    • Döner: Görevin projeye eklendiğini onaylayan başarı mesajı
    • Notlar: Konumlandırma argümanları verilmezse, görev projenin sonuna eklenir
31. asana_remove_project_from_task
    • Bir görevi bir projeden kaldırın
    • Gerekli giriş:
      • task_id (string): Projeden kaldırılacak görev kimliği
      • project_id (string): Görevin kaldırılacağı proje kimliği
    • Döner: Görevin projeden kaldırıldığını onaylayan başarı mesajı
    • Notlar: Görev sistemde kalır, ancak artık projede olmayacaktır
32. asana_delete_task
    • Bir görevi kalıcı olarak silin
    • Gerekli giriş:
      • task_id (string): Silinecek görev kimliği
    • Döner: Görevin silindiğini onaylayan başarı mesajı
    • Notlar: Bu işlem geri alınamaz. Görev kalıcı olarak kaldırılacaktır.
33. asana_create_project
    • Bir çalışma alanında veya ekipta yeni bir proje oluşturun
    • Gerekli giriş:
      • workspace (string): Projenin oluşturulacağı çalışma alanı GID'i
      • name (string): Projenin adı
    • İsteğe bağlı giriş:
      • team (string): Ekip GID'i (organizasyon çalışma alanları için gerekli)
      • notes (string): Proje için açıklama veya notlar
      • color (string): Projenin rengi (ör: dark-pink, dark-green, light-blue)
      • privacy_setting (string): Gizlilik ayarı (public_to_workspace, private_to_team, private)
      • default_view (string): Varsayılan görünüm (list, board, calendar, timeline)
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Oluşturulan proje objesi
34. asana_update_project
    • Bir projenin ayrıntılarını güncelleyin (ad, açıklama, vb.)
    • Gerekli giriş:
      • project_id (string): Güncellenecek proje GID'i
    • İsteğe bağlı giriş:
      • name (string): Proje için yeni ad
      • notes (string): Proje için yeni düz metin açıklaması
      • html_notes (string): Yeni HTML biçimli açıklama (geçerli Asana XML olmalıdır)
      • color (string): Projenin rengi (ör: dark-pink, dark-green, light-blue)
      • privacy_setting (string): Gizlilik ayarı (public_to_workspace, private_to_team, private)
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Güncellenmiş proje bilgisi
35. asana_create_section
    • Bir projede yeni bir bölüm oluşturun
    • Gerekli giriş:
      • project_id (string): Bölümün oluşturulacağı proje GID'i
      • name (string): Yeni bölümün adı
    • İsteğe bağlı giriş:
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Oluşturulan bölüm bilgisi
36. asana_update_section
    • Bir bölümü güncelleyin (yeniden adlandırın)
    • Gerekli giriş:
      • section_id (string): Güncellenecek bölüm GID'i
      • name (string): Bölüm için yeni ad
    • İsteğe bağlı giriş:
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi
    • Döner: Güncellenmiş bölüm bilgisi
37. asana_delete_section
    • Bir bölümü bir projeden silin
    • Gerekli giriş:
      • section_id (string): Silinecek bölüm GID'i
    • Döner: Silme onayı
38. asana_add_task_to_section
    • Bir görevi projesi içindeki bir bölüme taşıyın
    • Gerekli giriş:
      • section_id (string): Görevin ekleneceği bölüm GID'i
      • task_id (string): Taşınacak görev GID'i
    • İsteğe bağlı giriş:
      • insert_before (string): Görevin eklenecği bir görev GID'i
      • insert_after (string): Görevin eklenecği bir görev GID'i
    • Döner: Başarı onayı
39. asana_get_subtasks
    • Belirli bir görevin tüm alt görevlerini alın. Her alt görevin kompakt bir temsilini döndürür.
    • Gerekli giriş:
      • task_gid (string): Ana görevin GID'i
    • İsteğe bağlı giriş:
      • opt_fields (string): Dahil edilecek isteğe bağlı alanların virgülle ayrılmış listesi (ör: 'name,completed,assignee,due_on')
    • Döner: Alt görev nesnelerinin dizisi
40. asana_get_tasks_for_project
    • Bir projede tüm görevleri