Panoları API üzerinden veya bir yapay zeka asistanından yönetin

Panolar, kontrol panelinin dışından da tamamen yönetilebilir. İki rota, tek bir yetkilendirme modeli ve ekranlarla birebir aynı davranış — çünkü aynı kodu çağırırlar.

REST API

Her işlem, TypeScript, Python, PHP ve Go dillerinde oluşturulan istemcilerle birlikte herkese açık OpenAPI belirtimimizde yer alır ve CLI da aynı belirtimden üretilir. Panolar, sütunlar, kartlar, yorumlar, sorular, etiketler, üyeler ve paylaşım bağlantılarının tümü kapsam dahilindedir.

En sık kullanacağınız uç noktalar:

• GET /v1/agency/boards — panolarınız
• GET /v1/agency/boards/{id} — sütunları ve kartlarıyla tek bir pano
• POST /v1/agency/boards/{id}/cards — iş ekleyin
• POST /v1/agency/boards/{id}/cards/{id}/move — işi taşıyın
• POST /v1/agency/boards/{id}/invites — bir paylaşım bağlantısı oluşturun

Paylaşım bağlantısının belirteci bu son çağrıda ve yalnızca bu çağrıda döndürülür. Belirtecin yalnızca dijital parmak izini saklarız, bu nedenle onu daha sonra okuyabilecek hiçbir uç nokta yoktur — betiğiniz bağlantıya ihtiyaç duyuyorsa, onu yanıttan kaydedin.

MCP sunucusu

MCP protokolünü destekleyen bir yapay zekâ asistanı kullanıyorsanız, onu bağladığınızda doğrudan pano araçlarına erişim kazanır: panoları listeleme, bir panonun tamamını okuma, pano oluşturma, kart ekleme, kart taşıma, yorum yapma, paylaşım bağlantısı oluşturma ve bağlantıyı iptal etme. Bu sayede "bu haftayı özetle ve Acme'ye bir bağlantı gönder" talimatı, iki ayrı sistem ve kopyala-yapıştır döngüsü yerine tek bir komuta dönüşür.

Araçlar hakkında bilmenizde fayda olan iki husus:

• Siz aksini belirtmedikçe yeni bir kart dahili niteliktedir. Dahili çalışmalarınızı özetleyen bir asistan, kimse aksini söylemedi diye bu özeti müşterinize yayımlamamalıdır; bu nedenle visibility varsayılan olarak dahili kalır ve kasıtlı olarak client şeklinde ayarlanmalıdır.
• Bir bağlantıyı iptal etmek onay gerektirir, çünkü bu bağlantı üzerinden katılan herkesi de kaldırır — ve araç, alelade bir başarı bildirimi yerine bunun kaç kişiyi etkilediğini size iletir.

Neler gereklidir

API ve MCP erişimi Boards Business sürümüne ve tüm Agency barındırma planlarına dahildir. Boards Free ve Boards Pro sürümlerinde pano uç noktaları bu durumu belirten bir mesajla yanıt verir.

Bir API anahtarı veya MCP bağlantısı, yalnızca onu oluşturan kişinin izin verilen kuruluşlarda yapabildiklerini gerçekleştirebilir. Bir asistan tarafından oluşturulan paylaşım bağlantısı da aynı şekilde sınırlandırılmıştır: yetkilendiren kişinin bizzat sahip olmadığı bir rolü atayamaz.