Какво прави конекторът
MCP (Model Context Protocol) е отворен стандарт, чрез който един AI асистент използва инструментите на друга система. PaperOffice предоставя отдалечен сървър MCP за тази цел. След свързване, асистент като Claude може да работи с документите във Вашите работни пространства на PaperOffice: да търси, чете, обобщава, извлича данни, качва, преименува, премества, иска подписи и стартира работни процеси, винаги с Вашите разрешения за PaperOffice.
Няма нищо за инсталиране. Асистентът се свързва към URL адрес, Вие влизате с Вашия акаунт на PaperOffice, и инструментите на PaperOffice се появяват вътре в чата.
Поддържани асистенти и URL адреси на конектори
- Claude (claude.ai, Claude Desktop, Claude Code):
https://mcp.paperoffice.ai/claude, влизане чрез OAuth 2.1. - ChatGPT:
https://mcp.paperoffice.ai/chatgpt, влизане чрез OAuth 2.1. - Grok:
https://mcp.paperoffice.ai/grok, влизане чрез OAuth 2.1. - Cursor:
https://mcp.paperoffice.ai/cursor, с личен потребителски токен или токен на група.
Профилите сочат към един и същ сървър и се различават само в обхвата на инструментите.
Какво Ви е необходимо
- Акаунт на PaperOffice с поне едно работно пространство.
- Credits в акаунта. Повикванията към инструментите се таксуват като API повиквания.
- План за асистент, който позволява конектори, например Claude Pro, Max, Team или Enterprise. В плановете Team и Enterprise администраторът може да трябва първо да активира конектора.
Свързване на Claude
- В claude.ai отворете Настройки → Connectors.
- Изберете Add custom connector, въведете името PaperOffice и URL адреса
https://mcp.paperoffice.ai/claude. Оставете client ID и secret празни; влизането чрез OAuth започва автоматично. - Изберете Свържете и влезте с Вашия акаунт на PaperOffice. Прегледайте исканите права за достъп и потвърдете.
- В чата активирайте инструментите PaperOffice за разговора.
Claude Desktop използва същия списък с конектори като claude.ai. В Claude Code добавете сървъра с claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude и завършете влизането с /mcp.
Първи тест: попитайте „До кои работни пространства на PaperOffice имам достъп?“ Claude трябва да изброи Вашите работни пространства.
Свързване на ChatGPT и Grok
ChatGPT: отворете Настройки → Connectors, добавете персонализиран конектор с името PaperOffice, URL адреса https://mcp.paperoffice.ai/chatgpt и OAuth като удостоверяване, след което се свържете и влезте. В зависимост от Вашия план може да се наложи да активирате режима за разработчици за персонализирани конектори. Профилът ChatGPT е подбрана селекция от инструменти; той например не съдържа инструменти за подпис и работни потоци.
Grok: отворете grok.com/connectors, създайте персонализиран конектор с URL адреса https://mcp.paperoffice.ai/grok и влезте с Вашия PaperOffice акаунт при първото свързване. Профилът Grok също е подбрана селекция от инструменти.
Свързване на Cursor с токен
- Влезте в приложението PaperOffice и отворете Акаунт → API.
- Създайте потребителски токен или използвайте групов токен от Вашия администратор. Можете да преглеждате и копирате токена на страницата с API по всяко време; пазете го на сигурно място.
- Добавете сървъра във файла mcp.json на Cursor с URL адреса
https://mcp.paperoffice.ai/cursorи токена като bearer token в заглавката Authorization. - Рестартирайте Cursor или презаредете сървърите MCP.
Никога не публикувайте файл mcp.json с реален токен в хранилище. Секретните ключове и публичните ключове на REST API са блокирани за MCP.
Разрешения: асистентът никога няма да получи повече права, отколкото Вие
Асистентът работи с разрешенията на влезлия в системата потребител PaperOffice. Членството, ролята, споделените папки, правилата за задържане (WORM) и правните задържания (Legal Hold) се прилагат непроменени. Потребител с права само за четене в PaperOffice остава с права само за четене и в асистента.
Всеки инструмент има заглавие и подсказва дали само чете, или променя нещо. Асистентът използва тези подсказки, за да Ви попита, преди да действа. Изтриването, изпразването на кошчето и изпращането на заявки за подпис са маркирани като разрушителни, така че очаквайте въпрос за потвърждение. Изтритите документи първо отиват в кошчето на PaperOffice и могат да бъдат възстановени в приложението.
Настройките на акаунта, фактурирането, управлението на потребителите и създаването на API ключове не са налични чрез конектора. Те остават в приложението PaperOffice.
Поток на данните: какво вижда асистентът и какво получава PaperOffice
- Вие пишете заявка в асистента.
- Асистентът решава кой инструмент PaperOffice да извика и изпраща параметрите, например термин за търсене или ID на документ, към сървъра PaperOffice MCP.
- PaperOffice изпълнява обаждането с Вашите разрешения и връща резултата, например текста на един документ или списък с имена на файлове.
- Резултатът става част от разговора Ви с асистента и се обработва според условията на доставчика на асистента.
PaperOffice не получава историята на чата Ви, Вашите промпти или отговорите на асистента. Само самото обаждане към инструмента достига до сървъра: име на инструмента, параметри, време и потребител. PaperOffice не качва документи в доставчика на асистента самостоятелно; доставчикът получава само това, за което е попитал асистентът.
Всяко извикване на инструмент се записва с време, потребител и Credits. Администраторите виждат извикванията под API и разработка → API използване.
Фактуриране
Всяко извикване на инструмент чрез конектора се таксува в Credits, точно както съответното извикване на API. Няма отделна абонаментна такса за конектора. Някои заявки за статус и здраве не се таксуват; подробности са в документацията на API. Когато Credits свършат, извикванията се отхвърлят с ясно съобщение; нищо не се изтрива. Повече в ръководството за фактуриране и Credits: Фактуриране и Credits в PaperOffice AI.
Отмяна на достъпа
- В асистента премахнете или прекъснете връзката с конектора PaperOffice. Асистентът спира да го използва незабавно; разговори, които вече съдържат резултати от PaperOffice, запазват този текст.
- В PaperOffice отворете Акаунт → API. Връзките на асистента се появяват в списъка с токени със значка MCP. Изтрийте токена на тази връзка там.
- За Cursor завъртете или изтрийте токена на същата страница.
Оттеглянето на достъпа не изтрива никакви данни.
Отстраняване на неизправности
- Прозорецът за влизане не се отваря: разрешете изскачащите прозорци (pop-ups) за асистента и опитайте в режим на частно сърфиране. В планове Team или Enterprise попитайте администратора дали конекторът е активиран.
- Свързано, но не се появяват инструменти PaperOffice: активирайте инструментите за разговора или започнете нов разговор.
- "Неоторизиран" по време на извикване на инструмент: връзката е отменена или е изтекла. Свържете се отново. С токен проверете, че той е потребителски или групов токен.
- Асистентът не намира документи: попитайте за списъка с работни пространства първо. Влезлият потребител може да няма достъп до работното пространство, което очаквате. Наскоро качените документи се нуждаят от малко време, докато обработката приключи.
- Недостатъчно Credits: заредете в приложението PaperOffice или активирайте автоматичното зареждане.
Все още заседнали? Отворете билет за поддръжка с асистента и плана, точното съобщение, времето с часова зона и, ако е възможно, екранна снимка без лични данни.
Препоръка за ИТ екипите
- Домейни за разрешаване: mcp.paperoffice.ai, api.paperoffice.ai и app.paperoffice.ai. Целият трафик използва HTTPS; не се изисква входяща връзка към Вашата мрежа.
- Започнете с пилотен проект: едно работно пространство и роли само за четене. Активирайте роли за писане на работно пространство след пилотния проект.
- Преглеждайте използването на API редовно през първите седмици.
Често задавани въпроси
- Трябва ли да инсталирам нещо? Не. Асистентът се свързва към URL адрес.
- Може ли асистентът да вижда всички мои документи? Само онези, които вашият PaperOffice потребител може да вижда.
- Чете ли PaperOffice разговорите ми? Не. Само извикванията на инструменти достигат до PaperOffice.
- Има ли отделна абонаментна такса за конектора? Не. Извикванията се таксуват в Credits по същия начин като API извикванията.
- Как да прекратя достъпа? Премахнете конектора в асистента и изтрийте токена на връзката под Акаунт → API.