MCP — Picasi'yi yapay zekâ asistanında kullanmak
MCP nedir?
Model Context Protocol (MCP), yapay zekâ asistanlarının dış araçlara ve veriye nasıl eriştiğini tanımlayan açık bir protokoldür. Her sağlayıcının kendi tümleştirmesini kurması yerine herkes aynı standardı izler.
Claude Code, Claude.ai, ChatGPT ve MCP’yi destekleyen öteki asistanlar MCP uyumlu her hizmete bağlanabilir — Picasi de onlardan biridir.
MCP sana ne kazandırır
Rekabet takibi, bilgi tam da çalıştığın yerde elinin altındaysa gerçekten işe yarar — yalnızca onun için açman gereken ayrı bir uygulamada değil.
Claude’da bir rekabet çözümlemesi yazıyorsan ve işin ortasında Muster AG’nin geçen hafta ne ilettiğini bilmek istiyorsan, Claude’a sorarsın. Claude arka planda MCP üzerinden Picasi’yi sorgular — ve sen veriyi bağlam değiştirmeden, hemen sohbette görürsün.
Bağlantı nasıl işler
Picasi’yi bir yapay zekâ asistanına bağlamanın iki yolu vardır:
API token — Claude Code, Cursor ve kendi aracıların için. Picasi’de bir token oluşturur, onu asistanın yapılandırmasına girersin ve asistanın erişimi hemen olur. Token’ın, erişimin kapsamını belirleyen bir rolü vardır.
OAuth — Claude.ai ve ChatGPT için. Asistanı doğrudan Picasi hesabın üzerinden yetkilendirirsin, token yönetimi olmadan. Bağlantı kişisel hesabına bağlıdır.
Asistan neler yapabilir
Okuma erişimiyle asistan şunları yapabilir:
- Updates aramak ve okumak
- Kaynakları ve kanalları listelemek
- Report’ları çekmek
- Ekip bağlamını (yapay zekâ bağlamı) sorgulamak
Yazma erişimiyle (admin token ya da „write“ kapsamlı OAuth) asistan ayrıca şunları yapabilir:
- Kaynak oluşturmak, düzenlemek ve silmek
- Kanal oluşturmak, düzenlemek ve kapatmak
- Tag oluşturmak ve düzenlemek
OAuth kapsam düzeyi
Bir OAuth bağlantısı kurduğunda — örneğin Claude.ai ya da ChatGPT ile — yetkilendirme adımında bir yetki düzeyi (Authorization Level) seçersin. Bu düzey bir üst sınır gibi işler: Workspace’teki rolünden bağımsız olarak, asistanın bu bağlantı üzerinden neye izinli olduğunu sınırlar.
| Düzey | İzinli | İzinsiz |
|---|---|---|
| Read-only | Updates okumak, kaynakları ve Report’ları çekmek, ekip bağlamını sorgulamak | Kaynak ya da kanal oluşturmak, düzenlemek, silmek |
| Read & Write (varsayılan) | Read-only’deki her şey, ayrıca kaynakları, kanalları ve Inbox’ı yönetmek | Ekip ayarlarını ve yapay zekâ ayarlarını yönetmek |
| Admin | Ekip ayarları dahil tüm MCP işlemleri | Faturalandırmayı yönetmek |
Seçebileceğin düzeyler kendi Workspace rolünle sınırlıdır. Admin yetkisi olmayan bir üye Admin seçeneğini görmez.
Seçilen kapsam bağlantıya kalıcı olarak bağlı kalır. Yetkilendirmeden sonra bağlantı listesinde rozet olarak görünür. Kapsamı değiştirmek için bağlantının geri alınıp yeniden kurulması gerekir.
Öneri: Somut kullanımına yeten kapsamı seç — yani gerekenden fazla erişim verme. Basit sorgular ve çözümlemeler için Read-only yeter.
Bir bağlantı ne kadar geçerlidir?
API token’larının son kullanma tarihi yoktur. Sen Picasi’de Settings → API Tokens altında geri alana ya da ilgili üye Workspace’ten ayrılana dek geçerli kalırlar. Geri alınan bir token anında geçersizleşir; yenisinin üretilip istemciye kaydedilmesi gerekir.
OAuth bağlantıları iki token kullanır:
- Kısa süre geçerli olan ve tekil araç çağrılarını yetkilendiren bir erişim token’ı.
- Bağlantı var olduğu sürece geçerli kalan bir yenileme token’ı — istemci onu arka planda taze erişim token’larıyla takas eder.
Asistan düzenli olarak eriştiği sürece bağlantı kendini yeniler. Bağlantı yaklaşık iki haftadan uzun süre kullanılmadan kalırsa yenileme token’ı sona erebilir — bu durumda asistan bir yetki hatası gösterir ve bağlantıyı Settings → Connect AI Assistant üzerinden yeniden kurman gerekir.
Tüm Workspace’ler için tek adres
MCP sunucusunun sabit bir adresi vardır: https://picasi.app/mcp. İçinde artık Workspace yoktur. Bir çağrının hangi Workspace’i kastettiği, nasıl oturum açtığına bağlıdır.
API token ile token tam olarak bir Workspace’e aittir, yani Workspace daha ilk çağrıdan önce bellidir. Asistan başka bir şey göremez.
OAuth ile bağlantı hesabına aittir, bir Workspace’e değil. Üyesi olduğun her Workspace’i kapsar; bağlantı listesi onun için All Workspaces gösterir. Asistan önce list_workspaces ile hangilerinin var olduğunu sorar ve sonraki her çağrıda kastettiğini adlandırır. Bu olmadan Picasi çağrıyı geri çevirir.
Her iki durumda da üyelik karar verir. Üyesi olmadığın bir Workspace, sohbette biri adını söylese bile görünmez.
Birden fazla Workspace’i aynı anda bağlamak
Birden fazla Picasi Workspace’in varsa (örneğin birkaç müşteri hesabı olan bir ajans) iki yolun vardır:
- OAuth: tek bağlantı yeter. Tüm Workspace’lerine uzanır ve kastettiğini sohbette adlandırırsın.
- API token: Her Workspace için ayrı bir token üretin. İstemci yapılandırmasında her token’ı kendi MCP sunucu adı altında listeleyin (
picasi-musteri-a,picasi-musteri-b). Asistan araçları o zaman ayrı kümeler olarak tanır. Bir asistanın bilerek yalnızca tek bir Workspace’i görmesi gerektiğinde yol budur.
get_team_context çağrısı team.name alanında asistanın o an hangi Workspace üzerinde çalıştığını her zaman gösterir — bu, karışıklığı önler.
Sonunda Workspace kodu olan eski adres (https://picasi.app/mcp/t-...) geçerli kalır. Var olan bağlantılar çalışmayı sürdürür, hiçbir şeyi değiştirmen gerekmez.
Güvenlik ve denetim
Denetim sende kalır. Her bağlantı Picasi’de görünür ve istediğin an tek tek geri alınabilir — anında ve artık etkisi kalmadan. Nerede durduğu, kime ait olduğundan çıkar:
- Kişisel bağlantılar Personal settings → Connections altındadır. Genel adres üzerinden kurulan her şey oraya düşer. Herkes kendininkini görür ve geri alır.
- Workspace’e bağlı bağlantılar ve API token’ları Settings → AI Connections and Tokens altındadır. Bu sayfayı adminler ve owner’lar görür.
Kişisel bir bağlantı Workspace listesinde görünmez, çünkü hiçbir Workspace’e ait değildir. Bir üyenin Workspace’ine erişimini sona erdirmek için onu Workspace’ten çıkar — bu, kişisel bağlantısında da etkili olur, çünkü karar veren üyeliktir.
Token’lar rolle sınırlıdır: bir reader token’ı, asistan onu nasıl kullanırsa kullansın kaynak oluşturamaz. OAuth bağlantılarında seçilen kapsam da sınır olarak işler.