Bağlayıcının işlevi
MCP (Model Context Protocol), bir yapay zeka asistanının başka bir sistemin araçlarını kullandığı açık bir standarttır. PaperOffice bunun için uzaktan bir MCP sunucusu sağlar. Bağlantı kurulduktan sonra, Claude gibi bir asistan PaperOffice çalışma alanlarınızdaki belgelerle çalışabilir: arama yapma, okuma, özetleme, veri çıkarma, yükleme, yeniden adlandırma, taşıma, imza isteme ve iş akışlarını başlatma; her zaman PaperOffice izinlerinizle.
Yükleyecek bir şey yoktur. Asistan bir URL'ye bağlanır, PaperOffice hesabınızla oturum açarsınız ve PaperOffice araçları sohbetin içinde görünür.
Desteklenen asistanlar ve bağlayıcı URL'leri
- Claude (claude.ai, Claude Masaüstü, Claude Code):
https://mcp.paperoffice.ai/claude, OAuth 2.1 ile oturum açın. - ChatGPT:
https://mcp.paperoffice.ai/chatgpt, OAuth 2.1 ile oturum açın. - Grok:
https://mcp.paperoffice.ai/grok, OAuth 2.1 ile oturum açın. - Cursor:
https://mcp.paperoffice.ai/cursor, kişisel bir kullanıcı belirteci veya grup belirteci ile.
Profiller aynı sunucuya işaret eder ve yalnızca araç kapsamlında farklılık gösterir.
İhtiyacınız olanlar
- En az bir çalışma alanına sahip bir PaperOffice hesabı.
- Credits hesabında. Araç çağrıları API çağrıları gibi faturalandırılır.
- Bağlayıcılara izin veren bir asistan paketi, örneğin Claude Pro, Max, Team veya Enterprise. Team ve Enterprise paketlerinde yöneticinin önce bağlayıcıyı etkinleştirmiş olması gerekebilir.
Claude'i bağlayın
- claude.ai'de Ayarlar → Connectors bölümünü açın.
- Özel bağlayıcı ekle'yi seçin, PaperOffice adını ve
https://mcp.paperoffice.ai/claudeURL'sini girin. İstemci kimliği ve gizli anahtar boş bırakılsın; OAuth oturum açması otomatik olarak başlar. - Bağlan'ı seçin ve PaperOffice hesabınızla oturum açın. İstenen erişimi gözden geçirin ve onaylayın.
- Sohbet içinde, konuşma için PaperOffice araçlarını etkinleştirin.
Claude Masaüstü, claude.ai ile aynı bağlayıcı listesini kullanır. Claude Code'da sunucuyu claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude komutuyla ekleyin ve /mcp ile oturum açmayı tamamlayın.
İlk test: “Erişebileceğim hangi PaperOffice çalışma alanları var?” diye sorun. Claude çalışma alanlarınızı listelemelidir.
ChatGPT ve Grok'ü bağlayın
ChatGPT: Ayarlar → Connectors bölümünü açın, PaperOffice adında, https://mcp.paperoffice.ai/chatgpt URL'sine sahip ve OAuth'ı kimlik doğrulama yöntemi olarak kullanan özel bir bağlayıcı ekleyin; ardından bağlanıp oturum açın. Planınıza bağlı olarak, özel bağlayıcılar için geliştirici modunun etkinleştirilmesi gerekebilir. ChatGPT profili, özenle hazırlanmış bir araç seçimidir; örneğin imza ve iş akışı araçları içermez.
Grok: grok.com/connectors adresini açın, https://mcp.paperoffice.ai/grok URL'sine sahip özel bir bağlayıcı oluşturun ve ilk bağlantıda PaperOffice hesabınızla oturum açın. Grok profili de özenle hazırlanmış bir araç seçimidir.
Cursor'yi bir belirteçle bağlayın
- PaperOffice uygulamasına giriş yapın ve Hesap → API bölümünü açın.
- Bir kullanıcı belirteci oluşturun veya yöneticinizden bir grup belirteği kullanın. Belirteci API sayfasından istediğiniz zaman görüntüleyebilir ve kopyalayabilirsiniz; lütfen güvenli bir şekilde saklayın.
- Cursor'ün mcp.json dosyasına sunucuyu
https://mcp.paperoffice.ai/cursorURL'si ve Authorization başlığında bearer token olarak belirtekle ekleyin. - Cursor'yi yeniden başlatın veya MCP sunucularını yeniden yükleyin.
Gerçek bir token içeren mcp.json dosyasını asla bir depoya göndermeyin. REST API'nin gizli anahtarları ve yayımlanabilir anahtarları MCP için engellenmiştir.
İzinler: Asistan, size sahip olduğunuzden daha fazla yetki almaz
Asistan, giriş yapmış olan PaperOffice kullanıcısının izinleriyle çalışır. Çalışma alanı üyeliği, rolleri, paylaşılan klasörler, saklama kuralları (WORM) ve yasal bekletmeler (Legal Hold) değişmeden geçerlidir. PaperOffice içinde salt okunur bir kullanıcı, asistanda da salt okunur olarak kalır.
Her aracın bir başlığı vardır ve yalnızca okuma mı yoksa değişiklik mi yaptığını gösteren ipuçları bulunur. Asistan, eylemde bulunmadan önce bu ipuçlarını kullanarak size sorar. Silme, çöp kutusunu boşaltma ve imza isteklerini gönderme işlemleri yıkıcı olarak işaretlenmiştir; bu nedenle bir onay sorusu bekleyin. Silinen belgeler önce PaperOffice çöp kutusuna gider ve uygulamadan geri yüklenebilir.
Hesap ayarları, faturalandırma, kullanıcı yönetimi ve API anahtarlarının oluşturulması bağlayıcı aracılığıyla mevcut değildir. Bunlar PaperOffice uygulamasında kalır.
Veri akışı: Asistanın gördüğü şey ve PaperOffice'ün aldığı şey
- Asistana bir istek yazarsınız.
- Asistan hangi PaperOffice aracını çağıracağını karar verir ve arama terimi veya belge kimliği gibi parametreleri PaperOffice MCP sunucusuna gönderir.
- PaperOffice, izninizle çağrıyı yürütür ve sonucu, örneğin bir belgenin metnini veya dosya adlarının listesini döndürür.
- Sonuç, asistanla olan sohbetinizin bir parçası olur ve asistan sağlayıcısının koşulları altında işlenir.
PaperOffice, sohbet geçmişinizi, istemlerinizi veya asistanın yanıtlarını almaz. Sunucuya yalnızca araç çağrısı ulaşır: araç adı, parametreler, zaman ve kullanıcı. PaperOffice belgeleri kendi başına asistan sağlayıcısına yüklemez; sağlayıcı yalnızca asistanın istediğini alır.
Her araç çağrısı zaman, kullanıcı ve Credits ile kaydedilir. Yöneticiler çağrıları API ve Geliştirici → API Kullanımı altında görür.
Faturalandırma
Bağlayıcı üzerinden yapılan her araç çağrısı, Credits içinde ilgili API çağrısı gibi faturalandırılır. Ayrı bir bağlayıcı aboneliği yoktur. Bazı durum ve sağlık sorgulamaları ücretlendirilmez; detaylar API belgelerinde yer alır. Credits bittiğinde, çağrılar açık bir mesajla reddedilir; hiçbir şey silinmez. Faturalandırma ve Credits hakkında daha fazla bilgi için: PaperOffice AI'da Faturalandırma ve Credits.
Erişimi iptal etme
- Asistanda, PaperOffice bağlayıcısını kaldırın veya bağlantısını kesin. Asistan hemen kullanmayı bırakır; PaperOffice sonuçlarını içeren mevcut konuşmalar metni korur.
- PaperOffice içinde Hesap → API bölümünü açın. Asistan bağlantıları, bir MCP rozetiyle birlikte belirteç listesinde görünür. O bağlantının belirtecini oradan silin.
- Cursor için belirteci aynı sayfada döndürün veya silin.
Erişimi iptal etmek herhangi bir veriyi silmez.
Sorun giderme
- Giriş penceresi açılmıyor: Asistan için açılır pencerelere izin verin ve gizli bir tarayıcı penceresi deneyin. Takım veya Enterprise planlarında, bağlayıcının etkin olup olmadığını yöneticiye sorun.
- Bağlı ancak hiçbir PaperOffice aracı görünmüyor: Araçları konuşma için etkinleştirin veya yeni bir konuşma başlatın.
- Bir araç çağrısı sırasında "Yetkisiz": Bağlantı iptal edilmiş veya süresi dolmuş. Yeniden bağlanın. Bir token varsa, bunun kullanıcı veya grup tokenı olduğundan emin olun.
- Asistan belge bulamıyor: Önce çalışma alanı listesini isteyin. Bağlı olan kullanıcı, beklediğiniz çalışma alanına erişim sahibi olmayabilir. Yakında yüklenen belgelerin işleme alınması için biraz süre gerekir.
- Yetersiz Credits: PaperOffice uygulamasında Credits yükleyin veya otomatik yenilemeyi etkinleştirin.
Hâlâ takıldıysanız? Asistan ve plan, tam mesaj, saat ve saat dilimi ile mümkünse kişisel veri içermeyen bir ekran görüntüsü ile bir destek talebi açın.
IT ekipleri için öneri
- İzin verilecek alanlar: mcp.paperoffice.ai, api.paperoffice.ai ve app.paperoffice.ai. Tüm trafik HTTPS kullanır; ağınıza gelen bağlantı gerekmez.
- Bir pilot projeyle başlayın: Bir çalışma alanı ve salt okunur roller. Pilot sonrası yazma rollerini çalışma alanı başına etkinleştirin.
- İlk haftalarda API kullanımını düzenli olarak gözden geçirin.
Sıkça sorulan sorular
- Herhangi bir şey kurmam gerekiyor mu? Hayır. Asistan bir URL'ye bağlanır.
- Asistan tüm belgelerimi görebilir mi? Sadece PaperOffice kullanıcısının görebileceği belgeler.
- PaperOffice sohbetlerimi okur mu? Hayır. Sadece araç çağrıları PaperOffice'e ulaşır.
- Bağlayıcı için ayrı bir abonelik var mı? Hayır. Çağrılar, API çağrıları gibi Credits üzerinden faturalandırılır.
- Erişimi nasıl sonlandırırım? Asistandaki bağlayıcıyı kaldırın ve Hesap → API altında bağlantının belirtecini silin.