Co robi łącznik
MCP (Model Context Protocol) to otwarty standard, dzięki któremu asystent AI korzysta z narzędzi innego systemu. PaperOffice udostępnia do tego zdalny serwer MCP. Po połączeniu asystent, taki jak Claude, może pracować z dokumentami w przestrzeniach roboczych PaperOffice: wyszukiwać, czytać, streszczać, wyodrębniać dane, przesyłać, zmieniać nazwy, przenosić, żądać podpisów i uruchamiać przepływy pracy, zawsze z uprawnieniami PaperOffice.
Nic nie trzeba instalować. Asystent łączy się z adresem URL, użytkownik loguje się kontem PaperOffice, a narzędzia PaperOffice pojawiają się w czacie.
Obsługiwani asystenci i adresy URL łącznika
- Claude (claude.ai, Claude Desktop, Claude Code):
https://mcp.paperoffice.ai/claude, logowanie przez OAuth 2.1. - ChatGPT:
https://mcp.paperoffice.ai/chatgpt, logowanie przez OAuth 2.1. - Grok:
https://mcp.paperoffice.ai/grok, logowanie przez OAuth 2.1. - Cursor:
https://mcp.paperoffice.ai/cursor, z osobistym tokenem użytkownika lub tokenem grupy.
Profile wskazują ten sam serwer i różnią się wyłącznie zakresem narzędzi.
Czego potrzeba
- Konto PaperOffice z co najmniej jedną przestrzenią roboczą.
- Credits na koncie. Wywołania narzędzi są rozliczane jak wywołania API.
- Plan asystenta, który pozwala na łączniki, na przykład Claude Pro, Max, Team lub Enterprise. W planach Team i Enterprise administrator może najpierw musieć włączyć łącznik.
Podłączenie Claude
- W claude.ai otworzyć Ustawienia → Connectors.
- Wybrać Dodaj niestandardowy łącznik, wpisać nazwę PaperOffice i adres URL
https://mcp.paperoffice.ai/claude. Pola identyfikatora klienta i sekretu pozostawić puste; logowanie OAuth uruchomi się automatycznie. - Wybrać Połączyć i zalogować się kontem PaperOffice. Sprawdzić żądany dostęp i potwierdzić.
- W czacie włączyć narzędzia PaperOffice dla danej rozmowy.
Claude Desktop korzysta z tej samej listy łączników co claude.ai. W Claude Code dodać serwer poleceniem claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude i dokończyć logowanie poleceniem /mcp.
Pierwszy test: zapytać „Do których przestrzeni roboczych PaperOffice mogę uzyskać dostęp?”. Claude powinien wymienić przestrzenie robocze.
Podłączenie ChatGPT i Grok
ChatGPT: otworzyć Ustawienia → Connectors, dodać niestandardowy connector o nazwie PaperOffice, adresie URL https://mcp.paperoffice.ai/chatgpt i uwierzytelnianiu OAuth, następnie połączyć się i zalogować. W zależności od planu, tryb deweloperski może wymagać włączenia dla niestandardowych connectorów. Profil ChatGPT to starannie wyselekcjonowany zestaw narzędzi; nie zawiera on na przykład narzędzi do podpisywania ani workflow.
Grok: otworzyć grok.com/connectors, utworzyć niestandardowy connector z adresem URL https://mcp.paperoffice.ai/grok i zalogować się przy pierwszym połączeniu kontem PaperOffice. Profil Grok to również starannie wyselekcjonowany zestaw narzędzi.
Podłączenie Cursor za pomocą tokenu
- Zalogować się do aplikacji PaperOffice i otworzyć Konto → API.
- Utworzyć token użytkownika lub użyć tokena grupowego od administratora. Token można wyświetlić i skopiować na stronie API w dowolnym momencie; należy go przechowywać w bezpiecznym miejscu.
- Dodać serwer do pliku mcp.json w Cursor z adresem URL
https://mcp.paperoffice.ai/cursororaz tokenem jako bearer token w nagłówku Authorization. - Ponownie uruchomić Cursor lub przeładować serwery MCP.
Nigdy nie wysyłać pliku mcp.json z prawdziwym tokenem do repozytorium. Klucze tajne i klucze publikowalne API REST są dla MCP zablokowane.
Uprawnienia: asystent nigdy nie ma więcej niż użytkownik
Asystent działa z uprawnieniami zalogowanego użytkownika PaperOffice. Członkostwo w przestrzeniach roboczych, role, udostępnione foldery, reguły retencji (WORM) i legal holdy obowiązują bez zmian. Użytkownik z prawem tylko do odczytu w PaperOffice pozostaje z prawem tylko do odczytu także w asystencie.
Każde narzędzie posiada tytuł i wskazuje, czy tylko odczytuje, czy zmienia dane. Asystent używa tych wskazówek, aby zapytać przed wykonaniem działania. Usuwanie, opróżnianie kosza i wysyłanie żądań podpisu są oznaczone jako destrukcyjne, więc należy oczekiwać pytania potwierdzającego. Usunięte dokumenty trafiają najpierw do kosza PaperOffice i mogą zostać przywrócone w aplikacji.
Ustawienia konta, rozliczenia, zarządzanie użytkownikami i tworzenie kluczy API nie są dostępne przez łącznik. Pozostają w aplikacji PaperOffice.
Przepływ danych: co widzi asystent i co otrzymuje PaperOffice
- Żądanie wpisuje się w asystencie.
- Asystent decyduje, którego narzędzia PaperOffice użyć, i wysyła parametry, na przykład wyrażenie wyszukiwania lub identyfikator dokumentu, do serwera MCP PaperOffice.
- PaperOffice wykonuje wywołanie z uprawnieniami użytkownika i zwraca wynik, na przykład tekst jednego dokumentu lub listę nazw plików.
- Wynik staje się częścią rozmowy z asystentem i podlega warunkom dostawcy asystenta.
PaperOffice nie otrzymuje historii czatu, promptów ani odpowiedzi asystenta. Do serwera trafia tylko samo wywołanie narzędzia: nazwa narzędzia, parametry, czas i użytkownik. PaperOffice nie przesyła dokumentów dostawcy asystenta z własnej inicjatywy; dostawca otrzymuje tylko to, o co poprosił asystent.
Każde wywołanie narzędzia jest zapisywane z czasem, użytkownikiem i Credits. Administratorzy widzą wywołania w sekcji API i deweloperzy → Użycie API.
Rozliczenia
Każde wywołanie narzędzia przez łącznik jest rozliczane w Credits, dokładnie tak jak odpowiadające mu wywołanie API. Nie ma osobnej subskrypcji łącznika. Niektóre zapytania o status i kondycję nie są naliczane; szczegóły znajdują się w dokumentacji API. Gdy Credits się wyczerpią, wywołania są odrzucane z jasnym komunikatem; nic nie zostaje usunięte. Więcej w przewodniku o rozliczeniach i Credits: Rozliczenia i Credits w PaperOffice AI.
Unieważnienie dostępu
- W asystencie usunąć lub odłączyć łącznik PaperOffice. Asystent natychmiast przestaje z niego korzystać; rozmowy, które już zawierają wyniki z PaperOffice, zachowują ten tekst.
- W PaperOffice otworzyć Konto → API. Połączenia asystenta pojawiają się na liście tokenów z odznaką MCP. Należy usunąć token tego połączenia tam.
- Dla Cursor należy obrócić lub usunąć token na tej samej stronie.
Unieważnienie dostępu nie usuwa żadnych danych.
Rozwiązywanie problemów
- Okno logowania się nie otwiera: zezwolić na wyskakujące okna dla asystenta i spróbować prywatnego okna przeglądarki. W planach Team lub Enterprise zapytać administratora, czy łącznik jest włączony.
- Połączenie zostało nawiązane, ale nie widać narzędzi PaperOffice: włączyć narzędzia dla rozmowy albo rozpocząć nową rozmowę.
- „Unauthorized” podczas wywołania narzędzia: połączenie zostało odwołane lub wygasło. Połączyć się ponownie. W przypadku tokenu sprawdzić, czy jest to token użytkownika lub grupy.
- Asystent nie znajduje dokumentów: najpierw zapytać o listę przestrzeni roboczych. Połączony użytkownik może nie mieć dostępu do oczekiwanej przestrzeni roboczej. Niedawno przesłane dokumenty potrzebują chwili, aż przetwarzanie się zakończy.
- Za mało Credits: doładować w aplikacji PaperOffice lub włączyć automatyczne doładowanie.
Problem nadal występuje? Należy otworzyć zgłoszenie do pomocy technicznej, podając asystenta i plan, dokładny komunikat, czas z podaniem strefy czasowej oraz, jeśli to możliwe, zrzut ekranu bez danych osobowych.
Zalecenia dla zespołów IT
- Domeny do dopuszczenia: mcp.paperoffice.ai, api.paperoffice.ai i app.paperoffice.ai. Cały ruch korzysta z HTTPS; nie jest wymagane żadne połączenie przychodzące do sieci.
- Zacząć od pilotażu: jedna przestrzeń robocza i role tylko do odczytu. Role z prawem zapisu włącza się dla poszczególnych przestrzeni roboczych dopiero po pilotażu.
- Regularnie przeglądać użycie API w pierwszych tygodniach.
Najczęściej zadawane pytania
- Czy trzeba coś instalować? Nie. Asystent łączy się z adresem URL.
- Czy asystent widzi wszystkie moje dokumenty? Tylko te, które może zobaczyć użytkownik PaperOffice.
- Czy PaperOffice czyta moje czaty? Nie. Do PaperOffice docierają wyłącznie wywołania narzędzi.
- Czy łącznik ma osobną subskrypcję? Nie. Wywołania są rozliczane w Credits jak wywołania API.
- Jak zakończyć dostęp? Usunąć connector w asystencie i usunąć token połączenia pod Konto → API.