Přeskočit na obsah
Otázky?PaperOffice AI Phone Agent 24/7+49 69 3487102-0
Přehled Přehled Novinky Novinky
Sdílet

MCP Server

Jeden účet. 300+ MCP nástrojů. Přímo v chatovém nástroji.

Server PaperOffice MCP přináší dokumenty, vyhledávání, pracovní postupy a analýzy do Claude, ChatGPT a Cursor.

Vyberte chatovací nástroj. Návod ukazuje každý krok — OAuth 2.1, bez instalace.

OAuth 2.1 při prvním připojení Vzdálený server bez instalace Zpracování v EU
Jeden účet. 300+ MCP nástrojů. Přímo v chatovém nástroji.

Rychlý start

Vyberte chatovací nástroj

Průvodce ukazuje každý klik v Claude, ChatGPT nebo Cursor. Níže naleznete pouze úryvek ke zkopírování.

Snippet ke zkopírování

Claude Desktop / Claude Kód

{
  "mcpServers": {
    "paperoffice": {
      "url": "https://mcp.paperoffice.ai/claude"
    }
  }
}

Claude-Directory-URL — OAuth 2.1. Document Operations bez TTS. /claude vložit; žádný Bearer v snippetu.

Koncové body

Kopírovat URL pro AI klienta

Každý profil směřuje na stejný server — liší se pouze rozsahem nástrojů. Která URL ke čemu patří, je uvedena v tabulce níže.

  • Lehký /mcp

    Lehká sada IDE — nikoliv katalog dokumentových operací na /cursor.

    https://mcp.paperoffice.ai/mcp
  • Kompletní /mcp-full

    Všechna MCP nástroje (300+) pro výkonné pracovní postupy.

    https://mcp.paperoffice.ai/mcp-full

/openai zůstává dostupný jako alias pro /chatgpt. Ukončené modulkové cesty odpovídají s HTTP 410.

Schopnostní-matice

Která URL se hodí?

Jeden řádek úkol: doporučená URL a důvod pro to. Tato tabulka je jediným úplným seznamem cest na této stránce.

Úkol Doporučená URL Proč
Operace s dokumenty (kanonisch) /dms Document Operations (300+ MCP nástrojů) — identický katalog na /dms a /cursor.
Claude Desktop / Claude Code (Adresa adresáře) /claude Adresář: Document Operations bez TTS. Titulky a poznámky u každého nástroje.
Cursor IDE při kódování /cursor Stejný katalog Document Operations jako /dms (včetně TTS).
ChatGPT-Konektor /chatgpt ChatGPT konektor — kurátorské nástroje pro obchodní dokumenty a články znalostní báze, každý uveden zvlášť (viz reference nástrojů). Alias: /openai.
Meta-konektor Muse /muse Sada /chatgpt bez nahrávání příloh pouze pro ChatGPT; každý nástroj uveden v referenci nástrojů.
Lehká sada IDE /mcp Kompaktní sada pro vyhledávání, čtení a analýzu, včetně uploadu a článků znalostní báze — nikoliv katalog operací s dokumenty.
Komplexní vícekrokové úlohy po_agents_ask v /mcp-full Hostující LLM-agent zůstává na plném rozhraní, nikoliv na /dms.
Migrace / všechna MCP nástroje /mcp-full Kompletní MCP rozhraní (300+ nástrojů) pro ladění a legacy agenty.

Migrace starších nastavení MCP

Zastaralé modulkové cesty odpovídají HTTP 410. Pro operace s dokumenty používejte /dms.

  • Použijte /dms jako kanónickou URL pro Document Operations. /cursor sdílí tento katalog (včetně TTS).
  • Zastaralé modulkové cesty nyní odpovídají HTTP 410 — přejděte na /dms nebo /mcp.
  • Používejte /mcp pro tenkou sadu IDE — /cursor je plná operace s dokumenty, stejně jako /dms.
  • Použijte /chatgpt pro ChatGPT (alias /openai). Uvádí kurátovanou sadu nástrojů jednotlivě — žádné nástroje pro objevování ani obecné spouštění, žádný TTS, žádné nástroje OTP nebo odemykání.
  • Udržujte /mcp-full pouze pro pokročilé uživatele a média/CRM.
  • Použijte /muse pro Meta Muse (vybírané nástroje z /chatgpt bez nahrávání příloh pouze pro ChatGPT).

Reference nástrojů

Každý nástroj konektorů ChatGPT a Meta Muse

/chatgpt (alias /openai) lists 56 tools; /muse lists 55 — the same set without the ChatGPT-only attachment upload. Each operation is a separate tool with its own description, input schema and MCP annotations; there are no discovery tools and no generic executor.

Každý nástroj vyžaduje OAuth 2.1 s PKCE (rozsah mcp:tools) nebo token uživatele nebo skupiny PaperOffice (po_ut_ / po_gt_); po_sk_ a po_pk_ jsou zamítnuty. Volání probíhá s právy připojeného uživatele PaperOffice a jeho argumenty jsou před provedením ověřena proti zveřejněnému vstupnímu schématu.

Popisky

MCP. Každý nástroj nese anotace readOnlyHint, destructiveHint, idempotentHint a openWorldHint. Popisy shrnují, co volání způsobí:

  • ČteníČte data a nemění nic (readOnlyHint true).
  • ZápisVytváří nebo mění data v účtu PaperOffice uživatele, například při ukládání, vytváření, extrahování, konverzi, přesunu, kopírování, tagování nebo obnově dokumentů.
  • Citlivý zápisMaže data (dokumenty končí v koši) nebo je přepisuje, přijímá konečné rozhodnutí o úkolu sdílení, může upozornit jinou osobu nebo zveřejnit obsah ve veřejné znalostní databázi. Klienti by měli před voláním těchto nástrojů získat potvrzení uživatele.

/chatgpt: 56 tools (25 Read, 18 Write, 13 Sensitive write). /muse: 55 tools (25 Read, 17 Write, 13 Sensitive write).

Kurátorské MCP nástroje s označením, vstupy, výstupem a vedlejšími účinky a paralelními voláními na relaci
NástrojOznačeníPoužití, pokudVstupyVýstup a vedlejší účinkyParalelní volání na relaci
po_workspaces_listList workspacesČteníThe user names a workspace or asks which workspaces exist, or a workspace_id is needed.volitelnélimitoffsetsearchworkspace_idLists ID, name and document count. Locked workspaces are unlocked only in the PaperOffice app.4
po_documents_getGet document detailsČteníThe user wants details of one document: type, sender, amounts, dates, summary, processing status. Stored data only; to extract invoice data use po_extraction_invoice.jedno z nichpofiddocuments_idvolitelnéresolvecompactŽádné vedlejší účinky.4
po_extraction_invoiceExtract invoice dataZápisThe user asks to extract invoice data (supplier, number, dates, line items, VAT, total). Not for personal ID numbers.jedno z nichpofidfile_urlupload_idvolitelnémodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_job_getGet job statusČteníAn extraction or PDF tool returned a job_id.vyžadovánojob_idReturns status and, once completed, the result. Poll until completed; stop if it failed.4
po_analytics_financial_summary_getSummarize document amountsČteníThe user asks for totals or a summary of invoice amounts across documents, e.g. by currency.volitelnéperiodworkspace_idSums extracted amounts of all documents (not only invoices) per currency, never mixing currencies.4
po_documents_create_from_contentCreate PDF from textZápisThe user asks to create or write a PDF or document (notes, letter, report).vyžadovánocontenttitleworkspace_idvolitelnécontent_typemetadatalanguageauto_classifycustom_cssheader_htmlfooter_htmlidempotency_keyPass Markdown text: PaperOffice renders and stores the PDF, returns name and pofid. Costs credits.1
po_documents_renameRename documentCitlivý zápisThe user wants to rename a document or change its file name.vyžadovánonew_file_namejedno z nichpofiddocuments_idOverwrites the file name; the original extension (e.g. .pdf) is kept.1
po_documents_text_getRead document textČteníThe user needs the full text or exact wording of a document.jedno z nichpofiddocuments_idReturns its OCR text (only after processing); emails, phone and ID numbers are masked where detected.4
po_documents_creator_agents_listList Creator AgentsČteníThe user wants a quote, letter or certificate on their own template, or asks which Creator Agents exist.žádnéLists active agents (agent_id, name, template); then use po_documents_creator_agent_preview.4
po_documents_creator_agent_previewPreview agent documentZápisThe user asks a Creator Agent to draft a document, e.g. a quote.vyžadovánoagent_idpromptvolitelnévariablessource_pofidworkspace_idFills the agent's template from the request, its knowledge bases and contacts; stores nothing, costs credits. Returns values, questions, preview_token.4
po_documents_creator_agent_runCreate agent documentZápisThe user approved a Creator Agent preview and wants the document.vyžadovánoagent_idpreview_tokenconfirmvolitelnévariablesaccept_open_questionsPass preview_token, confirm=true and answers in variables. Stores the PDF in the workspace (costs credits); a repeat returns the same document.1
po_documents_upload_filesStore chat attachmentspouze /chatgptZápisThe user wants to store files they attached in this chat. To create a PDF from text use po_documents_create_from_content.vyžadovánofilesvolitelnéworkspace_idai_dms_tieron_duplicateOne result per file; retries never store twice; workspace auto-processing may apply. If ChatGPT cannot pass an attachment to this tool (for example BLOCKED_FILE_REFERENCE), call it with files: [] to receive upload_url.1
po_knowledge_graph_askAsk across documentsČteníA question spans many documents, e.g. which contracts have a termination clause. Best effort; not for knowledge base articles (po_knowledge_search) or totals (po_analytics_financial_summary_get).vyžadovánoquestionvolitelnépofidsearch_scopeworkspace_idworkspace_idsperiodŽádné vedlejší účinky.1
po_knowledge_get_articleRead knowledge articleČteníThe user wants to read one knowledge base article in full, e.g. after a search hit.vyžadovánoidvolitelnélanguageReturns its title, text and summary in each language.4
po_analytics_financial_overdue_getList overdue invoicesČteníThe user asks which invoices are overdue.volitelnéperiodworkspace_idlimitdays_overdueLists documents whose extracted due date has passed, most overdue first, with amount and currency; totals per currency, never mixed. Payment status is not checked.4
po_documents_processStart AI processingCitlivý zápisA stored document needs OCR and AI analysis, e.g. it has no text yet.vyžadovánoai_dms_tierjedno z nichpofiddocuments_idvolitelnéconfirm_reprocessconfirm_tier_downgradeRuns in the background, costs credits; track via po_documents_get. Re-processing replaces the old analysis.1
po_documents_downloadGet download linkČteníThe user wants to download or save a document's file, e.g. the PDF.jedno z nichpofiddocuments_idReturns a temporary link to the stored file, valid for about 10 minutes.4
po_documents_update_indexUpdate index fieldsCitlivý zápisThe user wants to set or correct document metadata (index fields), e.g. document_type, sender_name, invoice_number, due_date, total_amount or currency.vyžadovánofieldsjedno z nichpofiddocuments_idvolitelnéidempotency_keyOnly the given fields are overwritten.1
po_documents_uploadUpload document from URLZápisThe user gives a public file URL to store, or wants a browser upload page (omit file_url).volitelnéupload_idfile_urlfile_nameworkspace_idai_dms_tierStores a new document; workspace auto-processing may apply.1
po_extraction_receiptExtract receipt dataZápisThe user asks to extract receipt data (merchant, date, items, tax, total), e.g. for expenses.jedno z nichpofidfile_urlupload_idvolitelnémodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_extraction_delivery_noteExtract delivery note dataZápisThe user asks to extract delivery note data (shipper, recipient, items, quantities, delivery date).jedno z nichpofidfile_urlupload_idvolitelnémodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_extraction_purchase_orderExtract purchase order dataZápisThe user asks to extract purchase order data (order number, vendor, buyer, items, delivery date, total).jedno z nichpofidfile_urlupload_idvolitelnémodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_tasks_list_my_tasksList my tasksČteníThe user asks about their tasks or pending approvals.volitelnéstatusprioritystep_typelimitoffsetLists tasks assigned to them, their role or group (default: open) with ID, status, priority and due date.4
po_tasks_get_task_detailsGet task detailsČteníThe user asks what a specific task or approval is about.vyžadovánotask_idvolitelnéinclude_interactionReturns description, status, due date, history and whether completing needs an approve decision.4
po_tasks_claim_taskClaim taskCitlivý zápisThe user explicitly wants to claim an open task. Optional; if claimed, pass claim_session_id to po_tasks_complete_task or po_tasks_reject_task.vyžadovánotask_idLocks it to them for 15 minutes and may notify the assignee.1
po_tasks_complete_taskComplete taskCitlivý zápisThe user approves a task or marks it done.vyžadovánotask_idvolitelnéresultcommentclaim_session_idFor approvals pass result {"decision":"approve"}. Final, cannot be undone; reject with po_tasks_reject_task. hitl_review tasks are done in the app.1
po_tasks_reject_taskReject taskCitlivý zápisThe user rejects or declines a task or approval.vyžadovánotask_idreasonvolitelnéclaim_session_idRecords the reason; a waiting workflow continues without the requested action. Final, cannot be undone. hitl_review tasks are done in the app.1
po_documents_moveMove documentZápisThe user wants to move a document to another workspace.vyžadovánotarget_workspace_idjedno z nichpofiddocuments_idvolitelnéconfirmAll its versions move along and keep their pofids. Documents under retention or legal hold cannot be moved.1
po_documents_copyCopy documentZápisThe user wants to copy or duplicate a document into a workspace.vyžadovánotarget_workspace_idjedno z nichpofiddocuments_idvolitelnénew_file_nameEach call creates a new copy with its own pofid; a target workspace with automatic AI processing processes it, which costs credits.1
po_documents_tags_listList document tagsČteníThe user asks which tags or labels a document has.jedno z nichpofiddocuments_idReturns tag names and colors.4
po_documents_tags_createAdd document tagZápisThe user wants to tag or label a document.vyžadovánotag_namejedno z nichpofiddocuments_idvolitelnétag_colorAdds one tag per call; a tag the document already has is rejected.1
po_documents_folders_listList document foldersČteníThe user asks for document folders, i.e. bundles of related documents, in a workspace.vyžadovánoworkspace_idLists folders only; po_documents_search lists documents.4
po_documents_folders_createCreate document folderZápisThe user wants to bundle or staple related documents, e.g. an invoice and its delivery note, into one new document folder; the files stay separate.vyžadovánopofidsvolitelnéfolder_namefolder_descriptionA document can be in only one folder.1
po_vat_validateValidate EU VAT IDČteníThe user wants to check if a company's EU VAT ID is valid.vyžadovánovat_idChecks EU VIES or a recent cached result (check date returned); returns validity and, if disclosed, company name and address.4
po_currency_convertConvert currencyČteníThe user asks to convert an amount to another currency.vyžadovánofromtovolitelnéamountUses the latest available rate (rate date returned); no historical rates.4
po_pdfstudio_mergeMerge PDFsZápisThe user wants to merge or combine two or more PDF documents into one file.jedno z nichpofidsfile_urlsvolitelnéorderoutput_filenameStarts a job; po_job_get returns the download link.1
po_pdfstudio_splitSplit PDFZápisThe user wants to split a PDF into single pages or page ranges.jedno z nichpofidfile_urlupload_idvolitelnémodesplitsoutput_prefixStarts a job; po_job_get returns the download link(s).1
po_pdfstudio_compressCompress PDFZápisThe user wants to compress a PDF or reduce its file size.jedno z nichpofidfile_urlupload_idvolitelnéqualityremove_metadataStarts a job; po_job_get returns the download link.1
po_dataripper_office2pdfConvert Office to PDFZápisThe user wants to convert a Word, Excel or PowerPoint file to PDF.jedno z nichfile_urlupload_idPass a public file_url, or omit it to get an upload page, then pass the upload_id shown there. po_job_get returns the PDF link.4
po_documents_versions_listList document versionsČteníThe user asks for earlier versions or the version history of a document.vyžadovánopofidvolitelnéinclude_trashedReturns its versions with number, pofid, date, comment and which is current.4
po_documents_audit_trail_getGet change historyČteníThe user asks what changed in a document or workspace, or for an audit trail or change log.volitelnépofiddocuments_idactionworkspace_idlimitoffsetOnly revision-secure documents log changes; returns the latest entries with action, field, old and new value.4
po_documents_trash_listList recycle binČteníThe user asks what is in the recycle bin or trash, or looks for a deleted document.volitelnéworkspace_idpageper_pageReturns deleted documents (newest first, 50 per page) with pofid and days left before permanent deletion.4
po_documents_restoreRestore documentZápisThe user wants to restore or undelete a document from the recycle bin.jedno z nichpofiddocuments_idvolitelnétarget_workspace_idPuts it back with its versions into its original workspace (a fallback one if that was deleted) or target_workspace_id.1
po_documents_deleteDelete documentCitlivý zápisThe user wants to delete a document and all its versions (not a tag or folder entry).jedno z nichpofiddocuments_idvolitelnéconfirmPermanent in standard workspaces, recycle bin in business and compliance ones. Retention or legal hold blocks it.1
po_knowledge_list_basesList knowledge basesČteníThe user asks which knowledge bases they have or a knowledge base ID is needed.volitelnéinclude_archivedReturns ID, name, visibility and languages of each active knowledge base.4
po_knowledge_list_articlesList knowledge articlesČteníThe user wants to browse or list the articles of a knowledge base instead of searching.volitelnékb_idpagelimitcategory_idlanguagesearchReturns articles (50 per page) with IDs, titles, status and content.4
po_knowledge_categoriesList knowledge categoriesČteníThe user asks which categories their knowledge base articles are sorted into.volitelnékb_idlanguageReturns each category's ID, name and article count.4
po_knowledge_get_baseGet knowledge baseČteníThe user asks about one knowledge base's settings, visibility or languages.vyžadovánoidReturns its details with article and category counts.4
po_knowledge_add_articleCreate knowledge articleCitlivý zápisThe user asks to add or write a new knowledge base article.vyžadovánokb_idtitlecontentlanguagevolitelnécategory_idtypeSaves it and indexes it for search; in a public knowledge base it is published at once.1
po_knowledge_update_articleUpdate knowledge articleCitlivý zápisThe user asks to edit or rewrite a knowledge base article.vyžadovánoidlanguagejedno z nichtitlecontentcategory_idtypeis_activeReplaces the title and/or text of one language version and clears its summary and tags; public articles change at once.1
po_knowledge_translateTranslate knowledge articleCitlivý zápisThe user asks to translate a knowledge base article.vyžadovánoidtarget_languagevolitelnésource_languageAI translates it and saves that language version, replacing an existing one; in a public knowledge base it goes live. Costs credits.1
po_knowledge_create_baseCreate knowledge baseCitlivý zápisThe user asks to create a new knowledge base for help articles.vyžadovánonamevolitelnédescriptionprimary_languageenabled_languagesvisibilityBy default it is internal (team only) with primary language en; visibility public puts its articles on the help center.1
po_knowledge_update_baseUpdate knowledge baseCitlivý zápisThe user asks to rename a knowledge base, change its description or make it public or internal.vyžadovánoidjedno z nichnamedescriptionvisibilityprimary_languageenabled_languagesOverwrites the given fields; public puts its published articles online, internal takes them offline.1
po_knowledge_delete_articleDelete knowledge articleCitlivý zápisThe user asks to delete a knowledge base article.vyžadovánoidPermanently removes it in all languages, also from search and the help center; cannot be undone.1

Najeďte myší na název vstupu a zobrazíte si typ a popis. Poslední sloupec ukazuje, kolik volání nástroje může probíhat současně v rámci relace MCP.

Chyba

Chyba nástroje se vrací jako výsledek nástroje MCP s isError: true. Stejný JSON objekt je dostupný v structuredContent a v prvním textovém bloku obsahu:

{
  "error_code": "WORKSPACE_ACCESS_DENIED",
  "code": "WORKSPACE_ACCESS_DENIED",
  "message": "This connection has no access to this workspace.",
  "details": {
    "error_code": "WORKSPACE_ACCESS_DENIED",
    "workspace_id": 12345
  },
  "hint": "Use po_workspaces_list to see the workspaces this connection can access. Retrying will not change the result."
}
error_code
Stabilní, strojově čitelný kód. Je zrcadlen v code a details.error_code, protože někteří klienti mohou error_code přepisovat.
message
Vysvětlení pro lidi.
details
Kontext jako http_status, retryable / retry_safe, suggested_backoff_ms, validation_errors nebo odeslané ID.
hint
Další krok formulovaný pro model.
retryablehttp_status
Volitelná pole na nejvyšší úrovni, která jsou deklarována ve výstupních schématech.
KódVýznamOpakovat?
INVALID_PARAMSArgumenty neprošly validací schématu; details.validation_errors uvádí pole.Ne — opravit argumenty
TOOL_UNKNOWNPod tímto názvem neexistuje na tomto připojení žádný nástroj — použijte název ze seznamu nástrojů konektoru.Ne
TOOL_NOT_ON_THIS_CONNECTORNástroj existuje v PaperOffice, ale ne na tomto konektoru. Upozornění uvádí cestu: na /dms a /cursor přes po_mcp_tools_call_read nebo po_mcp_tools_call_write, jinak v aplikaci PaperOffice.Ne — postupujte podle upozornění
WORKSPACE_ACCESS_DENIEDPřipojení nemá přístup k Workspace nebo dokumentu.Ne
DOCUMENT_NOT_FOUNDNeznámé pofid nebo documents_id.Ne
CONFIRMATION_REQUIREDAkce vyžaduje potvrzení — například hromadné akce od 6 položek, zrušení sdílení nebo zrušení právního zachování. Je zahrnuta náhled dotčených položek; po potvrzení opakujte volání pomocí confirm=true.Po potvrzení uživatelem
APP_ONLY_ACTIONINSTANT_DELETE_APP_ONLYFOLDER_DELETE_NOT_ALLOWEDKonečné kroky lze provést pouze v aplikaci PaperOffice: trvale smazat, vyprázdnit koš, smazat Workspace, změnit zachování v koši nebo smazat celou složku. Dokumenty smazané přes MCP končí v koši.Ne — proveďte v aplikaci
LEGAL_HOLD_ACTIVEUNDER_RETENTIONWORM_PROTECTEDDokument je chráněn; změna byla zamítnuta.Ne
GROUP_RESTRICTIONSkupině tokenu chybí toto oprávnění, například k mazání.Ne
PLAN_UPGRADE_REQUIREDFunkce je dostupná pouze v vyšším plánu; pole details.required_plan uvádí požadovaný plán, details.plans_url odkazuje na stránku s tarify aplikace.Ne — až po upgradu plánu
INSUFFICIENT_CREDITSNedostatek Credits (HTTP 402); nic nebylo účtováno.Po dobíjení
TASK_REQUIRES_APP_REVIEWCLAIM_SESSION_MISMATCHTASK_CLAIM_EXPIREDRozhodnutí o úkolu schválení nelze uložit; upozornění uvádí další krok.Jak je uvedeno v upozornění
TRANSLATION_IN_PROGRESSPřeklad ve znalostní databázi stále probíhá.Ano, přibližně po 60 s se stejnými argumenty
WRITE_OUTCOME_UNKNOWNZápis do znalostní databáze nepřinesl v rámci časového limitu odpověď; pravděpodobně byl uložen.Nejprve ověřit, poté opakovat
TRANSIENT_TRANSPORT_ERRORPřekročení času na straně backendu (408) nebo HTTP 429, 502, 503 nebo 504; details.retryable je true, suggested_backoff_ms je 2000 a details.http_status uvádí příčinu.Ano, s čekací dobou
SESSION_BUSYACCOUNT_BUSYByl dosažen limit pro souběžné volání (viz Limity rychlosti); retry_safe je true a retry_after_ms je obsažen.Ano, po uplynutí retry_after_ms
MCP_MAINTENANCEÚdržba nebo restart serveru; retry_after_ms je 2000.Ano
SECRET_ARGUMENT_REJECTEDArgument vypadal jako přístupové datum; argumenty nástroje nesmí obsahovat tokeny nebo hesla.Ne
TOOL_ERRORObecná náhradní hodnota, pokud se nehodí žádný konkrétní kód.Záleží na zprávě

Chyba není: Pokud chybí vstup souboru, vrátí nástroje založené na souborech (extrakce, PDF) normální textový výsledek začínající na FILE_UPLOAD_REQUIRED a uvádějící přijatelné vstupy nebo stránku pro nahrání přes prohlížeč.

Na transportní úrovni obdrží chybějící, neplatný, vypršený nebo odvolaný token HTTP 401 s hlavičkou WWW-Authenticate (provést OAuth znovu). Dokud není přihlášení nebo katalog nástrojů dočasně nedostupné, odpovídá server HTTP 503 a Retry-After (2–5 s).

Limitování rychlosti a kvóty

  • Na relaci MCP (Mcp-Session-Id): nejvýše 8 volání nástrojů současně. Nástroje s hodnotou 1 ve sloupci vpravo běží postupně: druhé současné volání okamžitě vrátí SESSION_BUSY (opakovat po přibližně 300 ms, u po_knowledge_graph_ask po 500 ms). Ostatní nástroje běží s až 4 paralelními voláními a čekají až 15 s na volné místo.
  • Přístupový token je platný napříč všemi relacemi: maximálně 24 volání nástrojů současně (ACCOUNT_BUSY).
  • Pro každé volání nástroje platí limity požadavků pro PaperOffice API: Bezplatné tokeny a návštěvnické tokeny získávají minimálně 5 požadavků za sekundu, 30 za minutu, 100 za hodinu a 500 za den; hodnoty plánů mohou být vyšší. Placené plány s zbývajícím Credits omezují zůstatek, nikoliv rychlost požadavků. Omezená volání se neúčtují; vracejí TRANSIENT_TRANSPORT_ERROR s details.http_status 429 a dobou čekání ve zprávě.
  • Časové limity: Volání backendu je přerušeno po 90 sekundách (zápis do znalostní databáze pak vrací WRITE_OUTCOME_UNKNOWN nebo TRANSLATION_IN_PROGRESS, místo slepého opakování); po_knowledge_graph_ask se zastaví po 120 sekundách.
  • Limity uvedené v popisech nástrojů: až 10 souborů na volání po_documents_upload_files (pouze /chatgpt), 2 nebo více PDF souborů na sloučení, až 500 výsledků vyhledávání na stránku, až 200 Workspaces na stránku a 10–200 položek koše na stránku. Odkazy ke stažení vyprší přibližně po 10 minutách a převzatá úloha zůstává uzamčena po dobu 15 minut.
  • Účtování: Volání MCP se účtují jako volání REST API v Credits. Nástroje, jejichž popis říká „costs credits“ nebo „uses credits“, spouštějí zpracování AI a spotřebovávají více Credits.

Nástroje

Šest rodin, jeden katalog

Nástroje MCP jsou seskupeny podle úkolů. Klient je vidí s názvem a krátkým popisem a sám si vybere ten správný nástroj.

  • Document AI

    Dokumenty, OCR, IDP, vyhledávání, operace s PDF, podpisy a AI DMS.

    document-ai
  • Workflow AI

    Pracovní postupy, úlohy, úkoly, HITL, schvalování a automatizace procesů.

    workflow-ai
  • Relations AI

    CRM, partneři, leady, helpdesk a termíny.

    relations-ai
  • Analytics AI

    Analytika, BI, znalostní graf, entity a RAG.

    analytics-ai
  • Media AI

    Image Studio, TTS, STT a překlad.

    media-ai
  • Data AI

    Validace, DPH, měna, geodata a bezpečnostní lookupy.

    data-ai

Pokryté oblasti

  • Správa dokumentů Vyhledávání, čtení, nahrávání, úpravy, přesun, kopírování, mazání
  • Inteligentní vyhledávání Plnotextové vyhledávání, sémantická podobnost, pokročilé vyhledávání, statistiky
  • Elektronický podpis Žádosti o podpis, šablony, ověřování, mobilní odkazy
  • Zpracování pomocí AI AI-OCR, analýza dokumentů, detekce PII, anonymizace
  • Inteligence dokumentů Entity, relace, shrnutí, meta-pole, vektorové reprezentace (embeddings)
  • Analýzy Trendy, finance, tepelné mapy, auditní centrum
  • Knowledge Graph Obchodní případy, časové osy, reference, relace
  • CRM-inteligence Účty, leady, příležitosti, sentiment
  • Inteligence Business Dashboardy, analýza polí, metriky Workspace
  • Webhooky a události Odebírat, testovat, spravovat, předplatné úloh
  • Poznámky, štítky a komentáře Textové komentáře a poznámky — vytvářet, vypisovat, řešit, mazat
  • Verzování a audit Revize, právní zadržení, auditní stopa

Příklady

Co řeknete — jaký nástroj běží

Čtyři běžné věty a nástroj MCP, který váš klient pro ně volá. Oprávnění pocházejí z vašeho Workspace, ne z chatu.

  • Extrahujte všechna data z přiloženého faktury.

    Nástroj MCP po_aiocr_analyze

    Faktura analyzována — extrahovaná data:

  • Přejmenujte tento dokument na Faktura-2026-0042.

    Nástroj MCP po_documents_rename

    Dokument přejmenován:

  • Přidejte recenzní komentář na stranu 2.

    Nástroj MCP po_documents_comments_create

    Komentář vytvořen:

  • Jak se vyvíjel náš objem dokumentů?

    Nástroj MCP po_analytics_trends_get

    Analýza trendu za posledních 6 měsíců:

Zvýraznění

Co činí MCP-server výjimečným

MCP server není obalem kolem REST API — je to stejné jádro s oprávněním Vašeho účtu, Workspaces a kredity.

  • OAuth 2.1 a uživatelský token

    OAuth pro Claude a ChatGPT; uživatelské tokeny (po_ut_ / po_gt_) pro Cursor — po_sk_ je blokováno.

  • Hybridní vyhledávání s vektory

    Vektory PaperOffice a plnotextové vyhledávání spolupracují, aby klient našel odpovídající nástroj.

  • Příprava a upload souborů

    Předpřipravené upload URL — žádné Base64 v chatu.

  • Knowledge Graph

    Obchodní případy, časové osy a vztahy dokumentů přirozeným jazykem.

  • Analytika a BI

    Trendy, finance, tepelné mapy a metriky Workspace na požádání.

  • Zpracování v EU

    Zpracování ve vlastní infrastruktuře EU — stejná oprávnění a Workspaces jako v aplikaci.

Případy užití

Zobrazte PaperOffice MCP za 30 sekund

Čtyři skutečné pracovní postupy s Claude — po jednom krátkém videu pro každý. Podrobné články jsou níže odkazovány.

Často kladené otázky

Vše o serveru PaperOffice MCP

Jak se autentizuje server MCP?
Claude a ChatGPT začínají s OAuth 2.1. Alternativně uživatelský nebo skupinový token (po_ut_ / po_gt_) — po_sk_ a po_pk_ jsou pro MCP blokovány.
Kolik stojí používání přes MCP?
Volání MCP účtují Credits stejně jako REST-API. Zůstatek a využití lze dotazovat přes billing endpointy.
Který koncový bod nabízí které nástroje?
/mcp is the slim IDE subset. /dms and /cursor share Documents Operations including capture, workflow and TTS. /claude is Directory without TTS. /chatgpt (alias /openai) lists a curated tool set for ChatGPT; /muse lists the same tools except the ChatGPT-only attachment upload. The tool reference on this page marks every curated tool as Read, Write or Sensitive write.
Je podporován OAuth 2.1?
Ano. OAuth 2.1 se spustí při prvním připojení. Alternativně uživatelský nebo skupinový token (po_ut_ / po_gt_) — po_sk_ a po_pk_ jsou pro MCP blokovány.
Co je to MCP-native AI-DMS?
AI-DMS, jehož možnosti jsou nativně dostupné prostřednictvím Model Context Protocol — stejná oprávnění a Workspaces jako v aplikaci.
Jaké klienty podporujete?
Včetně Claude, ChatGPT, Cursor a bezhlavých profilů DMS — viz stránky připojení.
Jak rychlé je připojení?
Za několik minut: OAuth 2.1 při prvním připojení nebo uživatelský/skupinový token (po_ut_ / po_gt_), poté uvolnit nástroje. po_sk_ je pro MCP blokováno.
Liší se profily?
Ano — rozsah nástroje závisí na koncovém bodu. To, co může volání provést, určují práva připojeného uživatele; skupinový token (po_gt_) má přesně ta práva své uživatelské skupiny.
Kde je dokumentace?
V dokumentaci Developer-MCP, jakož i v llms.txt a Live-Postman kolekci.
Je k dispozici hosting v EU?
Ano — zpracování v infrastruktuře PaperOffice EU.

PaperOffice AI · Problem Solver

Povězte nám, co Vám denně zabírá čas.

Jednoduše popište. Odborné termíny nejsou potřeba.

Nebo začněte s příkladem

Jak chcete PaperOffice využívat?

Počítač a smartphone jsou propojeny: workspace na počítači, zachycování na telefonu.

Kde chcete začít?

Plný workspace je optimalizován pro počítač. Mobilní verze se hodí k zachycování, kontrole a schvalování dokumentů.

Registrovat se zdarma app.paperoffice.ai

Začněte na počítači

Vaši osobní přístupový odkaz zašleme na vaši e-mailovou adresu.