Co konektor dělá
MCP (Model Context Protocol) je otevřený standard, prostřednictvím kterého asistent AI používá nástroje jiného systému. PaperOffice poskytuje pro tento účel vzdálený server MCP. Po připojení může asistent, jako je Claude, pracovat s dokumenty ve vašich pracovních prostorech PaperOffice: vyhledávat, číst, shrnovat, extrahovat data, nahrávat, přejmenovávat, přesouvat, požadovat podpisy a spouštět pracovní postupy, vždy s vašimi oprávněními PaperOffice.
Není třeba nic instalovat. Asistent se připojí k URL adrese, přihlásíte se pomocí svého účtu PaperOffice a nástroje PaperOffice se objeví uvnitř chatu.
Podporovaní asistenti a URL adresy konektorů
- Claude (claude.ai, Claude Desktop, Claude Code):
https://mcp.paperoffice.ai/claude, přihlášení pomocí OAuth 2.1. - ChatGPT:
https://mcp.paperoffice.ai/chatgpt, přihlášení pomocí OAuth 2.1. - Grok:
https://mcp.paperoffice.ai/grok, přihlášení pomocí OAuth 2.1. - Cursor:
https://mcp.paperoffice.ai/cursor, s osobním uživatelským tokenem nebo tokenem skupiny.
Profily směřují na stejný server a liší se pouze rozsahem nástrojů.
Co potřebujete
- Účet PaperOffice s alespoň jedním pracovním prostorem.
- Credits na účtu. Volání nástrojů se účtují jako volání API.
- Plán asistenta, který umožňuje konektory, například Claude Pro, Max, Team nebo Enterprise. U plánů Team a Enterprise může správce nejprve povolit konektor.
Připojte Claude
- V claude.ai otevřete Nastavení → Connectors.
- Vyberte Přidat vlastní konektor, zadejte název PaperOffice a URL adresu
https://mcp.paperoffice.ai/claude. Nechte ID klienta a tajemství prázdná; přihlášení OAuth začne automaticky. - Vyberte Připojit a přihlaste se pomocí svého účtu PaperOffice. Zkontrolujte požadovaný přístup a potvrďte jej.
- V chatu povolte nástroje PaperOffice pro konverzaci.
Claude Desktop používá stejný seznam konektorů jako claude.ai. V Claude Code přidejte server pomocí claude mcp add --transport http paperoffice https://mcp.paperoffice.ai/claude a dokončete přihlášení pomocí /mcp.
První test: zeptejte se „Které pracovní prostory PaperOffice mohu přístupovat?“ Claude by měl vypsat vaše pracovní prostory.
Připojte ChatGPT a Grok
ChatGPT: Otevřete Nastavení → Connectors, přidejte vlastní konektor s názvem PaperOffice, URL https://mcp.paperoffice.ai/chatgpt a ověřením OAuth, poté se připojte a přihlaste se. V závislosti na vašem plánu může být nutné pro vlastní konektory povolit vývojářský režim. Profil ChatGPT je pečlivě vybraná sada nástrojů; neobsahuje například nástroje pro podpis ani workflow.
Grok: Otevřete grok.com/connectors, vytvořte vlastní konektor s URL https://mcp.paperoffice.ai/grok a při prvním připojení se přihlaste pomocí svého účtu PaperOffice. Profil Grok je také pečlivě vybraná sada nástrojů.
Připojte Cursor s tokenem
- Přihlaste se do aplikace PaperOffice a otevřete Účet → API.
- Vytvořte uživatelský token nebo použijte skupinový token od vašeho správce. Token můžete kdykoli zobrazit a zkopírovat na stránce API; mějte jej v bezpečí.
- Přidejte server do souboru mcp.json Cursor s URL adresou
https://mcp.paperoffice.ai/cursora tokenem jako bearer token v hlavičce Authorization. - Restartujte Cursor nebo znovu načtěte servery MCP.
Nikdy nekomitujte soubor mcp.json s reálným tokenem do repozitáře. Tajné klíče a veřejné klíče REST API jsou pro MCP blokovány.
Oprávnění: asistent nikdy nedostane více, než máte vy
Asistent pracuje s oprávněními přihlášeného uživatele PaperOffice. Členství v pracovním prostoru, role, sdílené složky, pravidla zachování (WORM) a právní zámky se uplatňují beze změny. Uživatel pouze pro čtení v PaperOffice zůstává pouze pro čtení i v asistentovi.
Každý nástroj má název a naznačuje, zda pouze čte, nebo něco mění. Asistent používá tyto nápovědy k tomu, aby se vás před akcí zeptal. Mazání, vyprázdnění koše a odesílání požadavků na podpis jsou označeny jako destruktivní, takže očekávejte potvrzovací otázku. Smazané dokumenty nejprve putují do koše PaperOffice a lze je obnovit v aplikaci.
Nastavení účtu, fakturace, správa uživatelů a vytváření klíčů API nejsou přes konektor dostupné. Zůstávají v aplikaci PaperOffice.
Tok dat: co asistent vidí a co PaperOffice přijímá
- Vy napíšete požadavek do asistenta.
- Asistent rozhodne, který nástroj PaperOffice má zavolat, a odešle parametry, například vyhledávací výraz nebo ID dokumentu, na server PaperOffice MCP.
- PaperOffice provede volání s vašimi oprávněními a vrátí výsledek, například text jednoho dokumentu nebo seznam názvů souborů.
- Výsledek se stane součástí vaší konverzace s asistentem a je zpracováván za podmínek poskytovatele asistenta.
PaperOffice nepřijímá historii vašich chatů, vaše podněty ani odpovědi asistenta. Na server dorazí pouze samotné volání nástroje: název nástroje, parametry, čas a uživatel. PaperOffice nenahrává dokumenty do poskytovatele asistenta samostatně; poskytovatel přijímá pouze to, o co asistent požádal.
Každé volání nástroje je zaznamenáno s časem, uživatelem a Credits. Administrátoři vidí volání pod API a vývojáři → Využití API.
Fakturace
Každé volání nástroje přes konektor je fakturováno v Credits, přesně jako odpovídající volání API. Neexistuje samostatné předplatné pro konektor. Některé dotazy na stav a zdraví nejsou účtovány; podrobnosti naleznete v dokumentaci API. Když Credits dojdou, volání jsou odmítnuta s jasnou zprávou; nic se nesmaže. Více v průvodci fakturací a Credits: Fakturace a Credits v PaperOffice AI.
Zrušení přístupu
- V asistentovi odeberte nebo odpojte konektor PaperOffice. Asistent jej okamžitě přestane používat; konverzace, které již obsahují výsledky PaperOffice, si tento text ponechají.
- V PaperOffice otevřete Účet → API. Připojení asistentů se zobrazí v seznamu tokenů s odznakem MCP. Zde smažte token tohoto připojení.
- Pro Cursor otočte nebo smažte token na stejné stránce.
Zrušení přístupu nesmaže žádná data.
Řešení problémů
- Okno pro přihlášení se neotevře: povolte vyskakovací okna pro asistenta a zkuste soukromé okno prohlížeče. V plánech Team nebo Enterprise se zeptejte administrátora, zda je konektor povolen.
- Připojeno, ale nezobrazují se žádné nástroje PaperOffice: povolte nástroje pro konverzaci nebo začněte novou konverzaci.
- "Neoprávněno" během volání nástroje: připojení bylo zrušeno nebo vypršelo. Připojte se znovu. U tokenu zkontrolujte, zda se jedná o token uživatele nebo skupiny.
- Asistent nenajde žádné dokumenty: nejprve požádejte o seznam pracovních prostorů. Připojený uživatel nemusí mít přístup k pracovnímu prostoru, který očekáváte. Nedávno nahrané dokumenty potřebují chvíli, než bude zpracování dokončeno.
- Nedostatek Credits: doplňte v aplikaci PaperOffice nebo povolte automatické doplňování.
Stále to nefunguje? Otevřete podpůrný tiket s asistentem a plánem, přesnou zprávou, časem se časovým pásmem a, pokud je to možné, screenshotem bez osobních údajů.
Doporučení pro IT týmy
- Domény k povolení: mcp.paperoffice.ai, api.paperoffice.ai a app.paperoffice.ai. Veškerá komunikace používá HTTPS; není vyžadováno žádné příchozí připojení do vaší sítě.
- Začněte pilotním projektem: jeden pracovní prostor a role pouze pro čtení. Po pilotním projektu povolte role pro zápis podle pracovního prostoru.
- Pravidelně kontrolujte využití API během prvních týdnů.
Často kladené otázky
- Musíte něco instalovat? Ne. Asistent se připojuje k URL.
- Může asistent vidět všechny mé dokumenty? Pouze to, co může vidět váš uživatel PaperOffice.
- Čte PaperOffice moje chaty? Ne. Pouze volání nástrojů dosahují PaperOffice.
- Je pro konektor potřeba samostatné předplatné? Ne. Volání se účtují v Credits stejně jako API volání.
- Jak ukončit přístup? Odstraňte konektor v asistentovi a smažte token připojení pod Účet → API.