Siirry sisältöön
Kysymyksiä?PaperOffice AI Phone Agent 24/7+49 69 3487102-0
Yleiskuva Yleiskuva Uutiset Uutiset
Jaa

MCP-palvelin

Tili. 300+ MCP-työkalua. Suoraan chat-työkalussa.

PaperOffice MCP-palvelin tuo asiakirjat, haun, työvuoit ja analytiikan Clauden, ChatGPT:n ja Cursorin käyttöön.

Valitkaa chattyökalu. Ohje näyttää jokaisen klikkauksen — OAuth 2.1, ilman asennusta.

OAuth 2.1 ensimmäisessä yhteydenotossa Etäpalvelin ilman asennusta Käsittely EU:ssa
Tili. 300+ MCP-työkalua. Suoraan chat-työkalussa.

Pikakäynnistys

Valitkaa chattyökalu

Oppaassa näytetään jokainen napsautus Claudessa, ChatGPT:ssä tai Cursorissa. Alapuolella on vain kopioitava koodinpätkä.

Kopioitava koodinpätkä

Claude Työpöytä / Claude Koodi

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

Claude-hakemiston URL — OAuth 2.1. Dokumentin toiminnot ilman TTS. Liitä /claude; ei Beareria snippetissä.

Päätepisteet

Kopioi URL AI-asiakasohjelmaan

Jokainen profiili osoittaa samaan palvelimeen — ero ainoastaan työkalujen määrässä. Mikä URL mihinkin sopii, näkyy alla olevassa taulukossa.

  • Kevyt /mcp

    Kevyt IDE-setti — ei Document-Operations-katalogia osoitteessa /cursor.

    https://mcp.paperoffice.ai/mcp
  • Täysi /mcp-full

    Kaikki MCP-työkalut (300+) teho-workflowihin.

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

/openai pysyy saavutettavana nimimerkkinä /chatgpt:lle. Poistettujen moduulien polut vastaavat HTTP 410.

Ominaisuusmatriisi

Mikä URL sopii?

Yksi rivi tehtävää kohti: suositeltu URL ja syy siihen. Tämä taulukko on ainoa täydellinen polkulista tällä sivulla.

Tehtävä Suositeltu URL Miksi
Document Operations (kanoninen) /dms Document Operations (yli 300 MCP-työkalua) — identtinen luettelo kohdissa /dms ja /cursor.
Claude Desktop / Claude Code (Hakemiston URL) /claude Hakemisto: Document Operations ilman TTS:ää. Otsikot ja huomiot jokaisessa työkalussa.
Cursor IDE koodatessa /cursor Sama Document Operations -luettelo kuin /dms (sisältäen TTS:n).
ChatGPT-yhteys /chatgpt ChatGPT-yhteysmoduuli — kuratoidut työkalut liiketoiminta-asiakirjoille ja tietokannan artikkeleille, jokainen erikseen luetteloidaan (katso työkaluviite). Alias: /openai.
Meta-Muse-konnektori /muse /chatgpt-asetus ilman ChatGPT:n ainoastaan liitetiedoston latausta; jokainen työkalu lueteltu työkaluviitteessä.
Kevyt IDE-asetelma /mcp Kompakti setti hakua, lukemista ja analysointia varten, mukaan lukien lataus ja tietokanta-artikkelit — ei Document-Operations-katalogia.
Monivaiheiset monimutkaiset tehtävät po_agents_ask osoitteessa /mcp-full Isäntä-LLM-agentti pysyy täydellisessä käyttöliittymässä, ei /dms:ssä.
Siirto / kaikki MCP-työkalut /mcp-full Täysi MCP-käyttöliittymä (yli 300 työkalua) vianmääritykseen ja perintäagentteihin.

Siirrä vanhemmat MCP-asetelmat

Poistetut moduulipolut palauttavat HTTP-vastauksen 410. Käytä Document Operationsia /dms.

  • Käytä /dms:ta kanonisena Document Operations -URL-osoitteena. /cursor jakaa tämän luettelon (mukaan lukien TTS).
  • Poistetut moduulipolut palauttavat nyt HTTP-vastauksen 410 — siirry käyttämään /dms tai /mcp.
  • Käytä /mcp:ää kevyeseen IDE-osaan — /cursor on koko asiakirjojen operaatioiden luettelo, sama kuin /dms.
  • Käytä /chatgpt kohdetta ChatGPT varten (alias /openai). Se luetellaan yksittäisesti kuratoitu työkalusetti — ei discovery- tai yleisiä suoritus työkaluja, ei TTS:ää, ei OTP- tai lukitusta poistavia työkaluja.
  • Pidä /mcp-full vain tehokäyttäjille ja media/CRM-käyttöön.
  • Käytä /muse Meta Museen (ChatGPT:n ainoastaan liitetiedoston latausta sisältämättömät /chatgpt:n kuratoidut työkalut).

Työviittaus

Jokainen ChatGPT- ja Meta Muse -liitännäisten työkalu

/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.

Jokainen työkalu vaatii OAuth 2.1:n PKCE:n kanssa (scope mcp:tools) tai PaperOffice-käyttäjä- tai ryhmätunnuksen (po_ut_ / po_gt_); po_sk_ ja po_pk_ hylätään. Kutsu suoritetaan yhdistetyn PaperOffice-käyttäjän oikeuksilla, ja sen argumentit tarkistetaan julkaistua syöttökaavaa vastaan ennen suorittamista.

Merkinnät

MCP. Jokaisella työkalulla on annotaatiot readOnlyHint, destructiveHint, idempotentHint ja openWorldHint. Merkinnät tiivistävät, mitä kutsu aiheuttaa:

  • LukuLukaa dataa ilman muutoksia (readOnlyHint tosi).
  • KirjoitusLuo tai muuttaa dataa käyttäjän PaperOffice-tilillä, esimerkiksi tallennettaessa, luotaessa, purkauttaessa, konvertatessa, siirrettäessä, kopioitaessa, tagattuna tai palautettuna dokumentteja.
  • Arkaluonteinen kirjoitusPoistaa tietoja (dokumentit siirtyvät roskakoriin) tai ylikirjoittaa ne, tekee lopullisen päätöksen jakotehtävässä, voi ilmoittaa toiselle henkilölle tai julkaista sisältöjä julkisessa tietokannassa. Asiakkaiden tulee hankkia käyttäjän vahvistus ennen näiden työkalujen kutsumista.

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

Kuratoitujen MCP-työkalujen merkinnät, syötteet, tulokset ja sivuvaikutukset sekä istunnon aikana suoritettavat rinnakkaiset kutsut
TyökaluMerkintäKäyttöehdotSyötteetTulos ja sivuvaikutuksetRinnakkaiset kutsut istunnon aikana
po_workspaces_listList workspacesLukuThe user names a workspace or asks which workspaces exist, or a workspace_id is needed.valinnainenlimitoffsetsearchworkspace_idLists ID, name and document count. Locked workspaces are unlocked only in the PaperOffice app.4
po_documents_getGet document detailsLukuThe user wants details of one document: type, sender, amounts, dates, summary, processing status. Stored data only; to extract invoice data use po_extraction_invoice.yksi näistäpofiddocuments_idvalinnainenresolvecompactEi sivuvaikutuksia.4
po_extraction_invoiceExtract invoice dataKirjoitusThe user asks to extract invoice data (supplier, number, dates, line items, VAT, total). Not for personal ID numbers.yksi näistäpofidfile_urlupload_idvalinnainenmodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_job_getGet job statusLukuAn extraction or PDF tool returned a job_id.vaaditaanjob_idReturns status and, once completed, the result. Poll until completed; stop if it failed.4
po_analytics_financial_summary_getSummarize document amountsLukuThe user asks for totals or a summary of invoice amounts across documents, e.g. by currency.valinnainenperiodworkspace_idSums extracted amounts of all documents (not only invoices) per currency, never mixing currencies.4
po_documents_create_from_contentCreate PDF from textKirjoitusThe user asks to create or write a PDF or document (notes, letter, report).vaaditaancontenttitleworkspace_idvalinnainencontent_typemetadatalanguageauto_classifycustom_cssheader_htmlfooter_htmlidempotency_keyPass Markdown text: PaperOffice renders and stores the PDF, returns name and pofid. Costs credits.1
po_documents_renameRename documentArkaluonteinen kirjoitusThe user wants to rename a document or change its file name.vaaditaannew_file_nameyksi näistäpofiddocuments_idOverwrites the file name; the original extension (e.g. .pdf) is kept.1
po_documents_text_getRead document textLukuThe user needs the full text or exact wording of a document.yksi näistäpofiddocuments_idReturns its OCR text (only after processing); emails, phone and ID numbers are masked where detected.4
po_documents_creator_agents_listList Creator AgentsLukuThe user wants a quote, letter or certificate on their own template, or asks which Creator Agents exist.ei mitäLists active agents (agent_id, name, template); then use po_documents_creator_agent_preview.4
po_documents_creator_agent_previewPreview agent documentKirjoitusThe user asks a Creator Agent to draft a document, e.g. a quote.vaaditaanagent_idpromptvalinnainenvariablessource_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 documentKirjoitusThe user approved a Creator Agent preview and wants the document.vaaditaanagent_idpreview_tokenconfirmvalinnainenvariablesaccept_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 attachmentsvain /chatgptKirjoitusThe user wants to store files they attached in this chat. To create a PDF from text use po_documents_create_from_content.vaaditaanfilesvalinnainenworkspace_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 documentsLukuA 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).vaaditaanquestionvalinnainenpofidsearch_scopeworkspace_idworkspace_idsperiodEi sivuvaikutuksia.1
po_knowledge_get_articleRead knowledge articleLukuThe user wants to read one knowledge base article in full, e.g. after a search hit.vaaditaanidvalinnainenlanguageReturns its title, text and summary in each language.4
po_analytics_financial_overdue_getList overdue invoicesLukuThe user asks which invoices are overdue.valinnainenperiodworkspace_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 processingArkaluonteinen kirjoitusA stored document needs OCR and AI analysis, e.g. it has no text yet.vaaditaanai_dms_tieryksi näistäpofiddocuments_idvalinnainenconfirm_reprocessconfirm_tier_downgradeRuns in the background, costs credits; track via po_documents_get. Re-processing replaces the old analysis.1
po_documents_downloadGet download linkLukuThe user wants to download or save a document's file, e.g. the PDF.yksi näistäpofiddocuments_idReturns a temporary link to the stored file, valid for about 10 minutes.4
po_documents_update_indexUpdate index fieldsArkaluonteinen kirjoitusThe user wants to set or correct document metadata (index fields), e.g. document_type, sender_name, invoice_number, due_date, total_amount or currency.vaaditaanfieldsyksi näistäpofiddocuments_idvalinnainenidempotency_keyOnly the given fields are overwritten.1
po_documents_uploadUpload document from URLKirjoitusThe user gives a public file URL to store, or wants a browser upload page (omit file_url).valinnainenupload_idfile_urlfile_nameworkspace_idai_dms_tierStores a new document; workspace auto-processing may apply.1
po_extraction_receiptExtract receipt dataKirjoitusThe user asks to extract receipt data (merchant, date, items, tax, total), e.g. for expenses.yksi näistäpofidfile_urlupload_idvalinnainenmodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_extraction_delivery_noteExtract delivery note dataKirjoitusThe user asks to extract delivery note data (shipper, recipient, items, quantities, delivery date).yksi näistäpofidfile_urlupload_idvalinnainenmodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_extraction_purchase_orderExtract purchase order dataKirjoitusThe user asks to extract purchase order data (order number, vendor, buyer, items, delivery date, total).yksi näistäpofidfile_urlupload_idvalinnainenmodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_tasks_list_my_tasksList my tasksLukuThe user asks about their tasks or pending approvals.valinnainenstatusprioritystep_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 detailsLukuThe user asks what a specific task or approval is about.vaaditaantask_idvalinnaineninclude_interactionReturns description, status, due date, history and whether completing needs an approve decision.4
po_tasks_claim_taskClaim taskArkaluonteinen kirjoitusThe 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.vaaditaantask_idLocks it to them for 15 minutes and may notify the assignee.1
po_tasks_complete_taskComplete taskArkaluonteinen kirjoitusThe user approves a task or marks it done.vaaditaantask_idvalinnainenresultcommentclaim_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 taskArkaluonteinen kirjoitusThe user rejects or declines a task or approval.vaaditaantask_idreasonvalinnainenclaim_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 documentKirjoitusThe user wants to move a document to another workspace.vaaditaantarget_workspace_idyksi näistäpofiddocuments_idvalinnainenconfirmAll its versions move along and keep their pofids. Documents under retention or legal hold cannot be moved.1
po_documents_copyCopy documentKirjoitusThe user wants to copy or duplicate a document into a workspace.vaaditaantarget_workspace_idyksi näistäpofiddocuments_idvalinnainennew_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 tagsLukuThe user asks which tags or labels a document has.yksi näistäpofiddocuments_idReturns tag names and colors.4
po_documents_tags_createAdd document tagKirjoitusThe user wants to tag or label a document.vaaditaantag_nameyksi näistäpofiddocuments_idvalinnainentag_colorAdds one tag per call; a tag the document already has is rejected.1
po_documents_folders_listList document foldersLukuThe user asks for document folders, i.e. bundles of related documents, in a workspace.vaaditaanworkspace_idLists folders only; po_documents_search lists documents.4
po_documents_folders_createCreate document folderKirjoitusThe 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.vaaditaanpofidsvalinnainenfolder_namefolder_descriptionA document can be in only one folder.1
po_vat_validateValidate EU VAT IDLukuThe user wants to check if a company's EU VAT ID is valid.vaaditaanvat_idChecks EU VIES or a recent cached result (check date returned); returns validity and, if disclosed, company name and address.4
po_currency_convertConvert currencyLukuThe user asks to convert an amount to another currency.vaaditaanfromtovalinnainenamountUses the latest available rate (rate date returned); no historical rates.4
po_pdfstudio_mergeMerge PDFsKirjoitusThe user wants to merge or combine two or more PDF documents into one file.yksi näistäpofidsfile_urlsvalinnainenorderoutput_filenameStarts a job; po_job_get returns the download link.1
po_pdfstudio_splitSplit PDFKirjoitusThe user wants to split a PDF into single pages or page ranges.yksi näistäpofidfile_urlupload_idvalinnainenmodesplitsoutput_prefixStarts a job; po_job_get returns the download link(s).1
po_pdfstudio_compressCompress PDFKirjoitusThe user wants to compress a PDF or reduce its file size.yksi näistäpofidfile_urlupload_idvalinnainenqualityremove_metadataStarts a job; po_job_get returns the download link.1
po_dataripper_office2pdfConvert Office to PDFKirjoitusThe user wants to convert a Word, Excel or PowerPoint file to PDF.yksi näistäfile_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 versionsLukuThe user asks for earlier versions or the version history of a document.vaaditaanpofidvalinnaineninclude_trashedReturns its versions with number, pofid, date, comment and which is current.4
po_documents_audit_trail_getGet change historyLukuThe user asks what changed in a document or workspace, or for an audit trail or change log.valinnainenpofiddocuments_idactionworkspace_idlimitoffsetOnly revision-secure documents log changes; returns the latest entries with action, field, old and new value.4
po_documents_trash_listList recycle binLukuThe user asks what is in the recycle bin or trash, or looks for a deleted document.valinnainenworkspace_idpageper_pageReturns deleted documents (newest first, 50 per page) with pofid and days left before permanent deletion.4
po_documents_restoreRestore documentKirjoitusThe user wants to restore or undelete a document from the recycle bin.yksi näistäpofiddocuments_idvalinnainentarget_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 documentArkaluonteinen kirjoitusThe user wants to delete a document and all its versions (not a tag or folder entry).yksi näistäpofiddocuments_idvalinnainenconfirmPermanent in standard workspaces, recycle bin in business and compliance ones. Retention or legal hold blocks it.1
po_knowledge_list_basesList knowledge basesLukuThe user asks which knowledge bases they have or a knowledge base ID is needed.valinnaineninclude_archivedReturns ID, name, visibility and languages of each active knowledge base.4
po_knowledge_list_articlesList knowledge articlesLukuThe user wants to browse or list the articles of a knowledge base instead of searching.valinnainenkb_idpagelimitcategory_idlanguagesearchReturns articles (50 per page) with IDs, titles, status and content.4
po_knowledge_categoriesList knowledge categoriesLukuThe user asks which categories their knowledge base articles are sorted into.valinnainenkb_idlanguageReturns each category's ID, name and article count.4
po_knowledge_get_baseGet knowledge baseLukuThe user asks about one knowledge base's settings, visibility or languages.vaaditaanidReturns its details with article and category counts.4
po_knowledge_add_articleCreate knowledge articleArkaluonteinen kirjoitusThe user asks to add or write a new knowledge base article.vaaditaankb_idtitlecontentlanguagevalinnainencategory_idtypeSaves it and indexes it for search; in a public knowledge base it is published at once.1
po_knowledge_update_articleUpdate knowledge articleArkaluonteinen kirjoitusThe user asks to edit or rewrite a knowledge base article.vaaditaanidlanguageyksi näistätitlecontentcategory_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 articleArkaluonteinen kirjoitusThe user asks to translate a knowledge base article.vaaditaanidtarget_languagevalinnainensource_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 baseArkaluonteinen kirjoitusThe user asks to create a new knowledge base for help articles.vaaditaannamevalinnainendescriptionprimary_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 baseArkaluonteinen kirjoitusThe user asks to rename a knowledge base, change its description or make it public or internal.vaaditaanidyksi näistänamedescriptionvisibilityprimary_languageenabled_languagesOverwrites the given fields; public puts its published articles online, internal takes them offline.1
po_knowledge_delete_articleDelete knowledge articleArkaluonteinen kirjoitusThe user asks to delete a knowledge base article.vaaditaanidPermanently removes it in all languages, also from search and the help center; cannot be undone.1

Kun hiiri viedään syötteen nimen päälle, näkyviin tulee sen tyyppi ja kuvaus. Viimeisessä sarakkeessa näytetään, kuinka monta työkalun kutsua voi suorittaa samanaikaisesti yhdessä MCP-istunnossa.

Virheet

Työkaluvirhe palautuu MCP-työkalutuloksena isError: true -arvolla. Sama JSON-objekti on sekä structuredContentissa että ensimmäisessä tekstisisältölohkossa:

{
  "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
Vakaa, koneellisesti luettava koodi. Se heijastuu code- ja details.error_code-kenttiin, koska jotkut asiakkaat voivat muuttaa error_codea.
message
Selitys ihmisille.
details
Konteksti kuten http_status, retryable / retry_safe, suggested_backoff_ms, validation_errors tai lähetetyt ID:t.
hint
Seuraava askel, muotoiltu mallille.
retryablehttp_status
Ylätason kentät, jotka on määritetty tulosskeemassa.
KoodiMerkitysToistetaanko?
INVALID_PARAMSArgumentit eivät läpäisseet skeematarkistusta; details.validation_errors listaa kentät.Ei — korjaa argumentit
TOOL_UNKNOWNTällä yhdistelmällä ei ole työkalua tällä nimellä — käytä konnektorin työkaluluettelossa annettua nimeä.Ei
TOOL_NOT_ON_THIS_CONNECTORTyökalu on olemassa kohteessa PaperOffice, mutta ei tällä konnektorilla. Vihje osoittaa polun: /dms ja /cursor kautta po_mcp_tools_call_read:n tai po_mcp_tools_call_write:n välityksellä, muuten PaperOffice-sovelluksessa.Ei — seuraa vihjettä
WORKSPACE_ACCESS_DENIEDYhteydellä ei ole pääsyä kohteeseen Workspace tai asiakirjaan.Ei
DOCUMENT_NOT_FOUNDTuntematon pofid tai documents_id.Ei
CONFIRMATION_REQUIREDToiminto vaatii vahvistuksen — esimerkiksi joukkotoiminnot alkaen 6 kohteesta, jakojen peruuttaminen tai Legal Holdin poistaminen. Vahvistuksessa näkyy vaikuttettujen kohteiden esikatselu; vahvistuksen jälkeen kutsu toistetaan koodilla confirm=true.Kun käyttäjä on vahvistanut
APP_ONLY_ACTIONINSTANT_DELETE_APP_ONLYFOLDER_DELETE_NOT_ALLOWEDLopulliset vaiheet suoritetaan vain PaperOffice-sovelluksessa: lopullinen poisto, roskakorin tyhjennys, Workspace poisto, roskakorin säilytyksen muuttaminen tai koko kansion poisto. MCP:n kautta poistetut dokumentit siirtyvät roskakoriin.Ei — suoritettava sovelluksessa
LEGAL_HOLD_ACTIVEUNDER_RETENTIONWORM_PROTECTEDAsiakirja on suojattu; muutosta ei hyväksytty.Ei
GROUP_RESTRICTIONTokenin ryhmältä puuttuu tämä oikeus, esimerkiksi poisto-oikeus.Ei
PLAN_UPGRADE_REQUIREDOminaisuus sisältyy vasta korkeammassa tilissä; details.required_plan kertoo tilin, details.plans_url sovelluksen hinnoittelusivun.Ei — vasta tilin päivityksen jälkeen
INSUFFICIENT_CREDITSRiittämättömät Credits (HTTP 402); mitään ei laskutettu.Lataamisen jälkeen
TASK_REQUIRES_APP_REVIEWCLAIM_SESSION_MISMATCHTASK_CLAIM_EXPIREDPäästötehtävän päätöstä ei voitu tallentaa; vihje kertoo seuraavan vaiheen.Vihjeen mukaisesti
TRANSLATION_IN_PROGRESSTietokannassa on vielä käynnissä käännös.Kyllä, noin 60 sekunnin kuluttua samoilla argumenteilla
WRITE_OUTCOME_UNKNOWNKirjoitusoperaatio tietokantaan ei saanut vastausta aikarajan sisällä; se todennäköisesti tallentui.Ensin tarkistus, sitten uusi yritys
TRANSIENT_TRANSPORT_ERRORAikakatkaisu backendissa (408) tai HTTP-virheet 429, 502, 503 tai 504; details.retryable on tosi, details.http_status näyttää syyn ja suggested_backoff_ms on 2000.Kyllä, viiveellä
SESSION_BUSYACCOUNT_BUSYSamanaikaisten kutsujen raja on saavitettu (katso nopeusrajoitukset); retry_safe on tosi ja retry_after_ms sisältyy.Kyllä, retry_after_ms:n jälkeen
MCP_MAINTENANCEPalvelimen ylläpito tai uudelleenkäynnistys; retry_after_ms on 2000.Kyllä
SECRET_ARGUMENT_REJECTEDArgumentti näytti olevan kirjautumisajan arvo; työkalun argumentit eivät saa sisältää tunnuksia tai salasanoja.Ei
TOOL_ERRORYleinen virhe, kun mikään tarkempi koodi ei sovi.Riippuu viestistä

Ei virhe: Jos tiedostonsyöte puuttuu, tiedostopohjaiset työkalut (purku, PDF) palauttavat normaalin tekstituloksen, joka alkaa merkillä FILE_UPLOAD_REQUIRED ja mainitsee hyväksytyt syötteet tai selaimen lataussivun.

Siirtokerroksessa puuttuva, virheellinen, vanhentunut tai peruutettu token aiheuttaa HTTP-virheen 401 WWW-Authenticate-päätteen kanssa (suorita OAuth uudelleen). Jos kirjautuminen tai työkaluluettelo on tilapäisesti saavuttamattomissa, palvelin vastaa HTTP 503:lla ja Retry-After-päätteellä (2–5 s).

Nopeusrajoitukset ja kvootit

  • Jokaisen MCP-istunnon (Mcp-Session-Id) aikana: enintään 8 työkalukutsua samanaikaisesti. Työkalut, joissa viimeisessä sarakkeessa on arvo 1, suoritetaan peräkkäin: toinen samanaikainen kutsu palauttaa välittömästi virheen SESSION_BUSY (uudelleenyritys noin 300 ms kuluttua, po_knowledge_graph_ask:n kohdalla 500 ms). Muut työkalut suoritetaan enintään 4 rinnakkaisella kutsulla ja odottavat enintään 15 sekuntia vapautuvan paikan saapumista.
  • Käyttötoken rajat kaikissa istunnoissa: enintään 24 työkalukutsua samanaikaisesti (ACCOUNT_BUSY).
  • Jokaiselle työkalukutsulle sovelletaan PaperOffice API pyyntörajoja: ilmaiset ja vierastokenit saavat vähintään 5 pyyntöä sekunnissa, 30 minuutissa, 100 tunnissa ja 500 päivässä; tilausarvot voivat olla korkeampia. Maksulliset tilaukset, joiden jäljellä oleva Credits on rajoitettu, rajoittavat saldoa eikä pyyntönopeutta. Nopeusrajoitetut kutsut eivät ole laskutettavissa; ne palauttavat TRANSIENT_TRANSPORT_ERROR:n HTTP-tilakoodilla 429 ja odotusajan viestissä.
  • Aikarajat: Backend-kutsu keskeytyy 90 sekunnin jälkeen (tietokantaan kirjoitukset tuolloin WRITE_OUTCOME_UNKNOWN tai TRANSLATION_IN_PROGRESS, eivätkä sokeasti toista); po_knowledge_graph_ask pysähtyy 120 sekunnin jälkeen.
  • Työkalukuvauksissa mainitut rajat: enintään 10 tiedostoa per kutsu kohteessa po_documents_upload_files (vain /chatgpt), vähintään 2 PDF-tiedostoa yhdistämistä varten, enintään 500 hakutulosta per sivu, enintään 200 Workspaces per sivu ja 10–200 roskakorin merkintää per sivu. Latauslinkit vanhenevat noin 10 minuutin kuluttua, ja siirretty tehtävä on lukittuna 15 minuuttia.
  • Laskutus: MCP kutsua laskutetaan kuin REST API kutsuja kohteessa Credits. Työkalut, joiden kuvauksessa lukee "costs credits" tai "uses credits", käynnistävät tekoälyn käsittelyn ja kuluttavat enemmän Credits.

Työkalut

Kuusi perhettä, yksi luettelo

MCP-työkalut on ryhmitelty tehtävien mukaan. Asiakas näkee ne otsikon ja lyhyen kuvauksen kanssa ja valitsee itse sopivan työkalun.

  • Document AI

    Dokumentit, OCR, IDP, haku, PDF-toiminnot, allekirjoitukset ja AI-DMS.

    document-ai
  • Workflow AI

    Workflows, tehtävät, työt, HITL, hyväksynnät ja prosessiautomaatio.

    workflow-ai
  • Relations AI

    CRM, kumppanit, leadit, helpdesk ja tapahtumat.

    relations-ai
  • Analytics AI

    Analytiikka, BI, tietokaavio, entiteetit ja RAG.

    analytics-ai
  • Media AI

    Kuvastudio, TTS, STT ja käännös.

    media-ai
  • Data AI

    Validointi, ALV, valuutta, maantieteelliset tiedot ja tietoturvan tarkistukset.

    data-ai

Kattavat alueet

  • Asiakirjahallinta Hae, lue, lataa, muokkaa, siirrä, kopioi, poista
  • Älykäs haku Täysi teksti, semanttinen samankaltaisuus, Advanced Search, tilastot
  • Elektroninen allekirjoitus Allekirjoituspyynnöt, mallit, vahvistus, mobiililinkit
  • Käsittelevä tekoäly AI-OCR, asiakirjan analyysi, PII-tunnistus, anonymisointi
  • Asiakirjanäkyvyys Entiteetit, suhteet, yhteenvedot, meta-kentät, upotukset
  • Analytiikka Trendit, talous, lämpökartat, auditointikeskus
  • Knowledge Graph Liike-elämän tapaukset, aikajana, viitteet, suhteet
  • CRM-älykkyyttä Tilit, johdonmukaisuusmahdollisuudet, mahdollisuudet, mielipide
  • Liiketoiminnanäkyvyys Workspacet, kenttäanalyysi, Workspacen mittarit
  • Webhookit & tapahtumat Tilaa, testaa, hallinnoi, työn tilaukset
  • Muistiinpanot, tunnisteet & kommentit Tekstikommentit ja muistiinpanot — luo, hae, ratkaise, poista
  • Versiointi & auditointi Versiot, oikeudellinen säilytys, auditointiloki

Esimerkkejä

Mitä sanotte — mikä työkalu käynnistyy

Neljä lausetta arjesta ja MCP-työkalu, jonka asiakas kutsuu käyttämään. Oikeudet tulevat Workspacestanne, ei keskustelusta.

  • Pura kaikki tiedot liitetystä laskusta.

    MCP-työkalu po_aiocr_analyze

    Lasku analysoitu — purettu data:

  • Nimeä tämä asiakirja uudelleen nimellä Lasku-2026-0042.

    MCP-työkalu po_documents_rename

    Asiakirja nimetty uudelleen:

  • Lisää arvostelukommentti sivulle 2.

    MCP-työkalu po_documents_comments_create

    Kommentti luotu:

  • Miten asiakirjamäärämme on kehittynyt?

    MCP-työkalu po_analytics_trends_get

    Viimeisen kuuden kuukauden trendianalyysi:

Korostukset

Mitä MCP-palvelimessa on erityistä

MCP-palvelin ei ole REST-API:n kääre, vaan sama ydin, jolla on tilinne oikeudet, Workspacet ja Credits.

  • OAuth 2.1 ja käyttäjätunnus

    OAuth Claudelle ja ChatGPT:lle; käyttäjätunnukset (po_ut_ / po_gt_) Cursorille — po_sk_ on estetty.

  • Hybridihaku upotusten kanssa

    PaperOffice-upotukset ja täydellinen teksti toimivat yhdessä, jotta asiakas löytää oikean työkalun.

  • Tiedon esivaiheistus ja lataus

    Allekirjoitetut lataus-URL:t — ei Base64:ta keskustelussa.

  • Knowledge Graph

    Liiketoimintatapaukset, aikataulut ja asiakirjasuhteet luonnollisella kielellä.

  • Analytiikka ja BI

    Trendit, talous, lämpökartat ja Workspace-mittarit pyynnöstä.

  • EU-käsittely

    Käsittely omassa EU-infrastruktuurissa — samat oikeudet ja Workspacet kuin sovelluksessa.

Käyttötapaukset

Katso PaperOffice MCP 30 sekunnissa

Neliö todellista työvirtaa Claudesta — yksi lyhyt video kullekin. Syvälliset artikkelit alla.

Usein kysytyt kysymykset

Kaikki PaperOffice MCP-palvelimesta

Miten MCP-palvelu todentaa itsensä?
Claude ja ChatGPT alkavat OAuth 2.1:lla. Vaihtoehtoisesti Käyttäjä- tai Ryhmätunnus (po_ut_ / po_gt_) — po_sk_ ja po_pk_ on estetty MCP:lle.
Mikä on MCP:n käytön hinta?
MCP-kutsut laskevat Credits kuten REST-API. Saldo ja käyttö ovat saatavilla laskutus päätepisteiden kautta.
Mitkä päätepisteet tarjoavat mitkä työkalut?
/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.
Tukeeko järjestelmä OAuth 2.1?:
Kyllä. OAuth 2.1 käynnistyy ensimmäisessä yhteydenotossa. Vaihtoehtoisesti käyttäjä- tai ryhmätunnus (po_ut_ / po_gt_) — po_sk_ ja po_pk_ on estetty MCP:lle.
Mikä on MCP-native AI-DMS?
AI-DMS, jonka ominaisuudet ovat saatavilla natiivisti Model Context Protocolin kautta — samat oikeudet ja Workspacet kuin sovelluksessa.
Mitä asiakkaita tuetaan?
Sisältää Claude, ChatGPT:n, Cursor ja headless DMS-profiilit — katso yhdistämis-sivut.
Kuinka nopea yhteys on?
Muutamassa minuutissa: OAuth 2.1 ensimmäisessä yhteydenotossa tai käyttäjä-/ryhmätunnus (po_ut_ / po_gt_), jonka jälkeen työkalut vapautetaan. po_sk_ on estetty MCP:lle.
Ero profiilit eroavat toisistaan?
Kyllä — työkalun laajuus riippuu päätepisteestä. Mitä kutsu saa tehdä, määräävät yhdistetyn käyttäjän oikeudet; ryhmätunnus (po_gt_) saa täsmälleen ne oikeudet, jotka kuuluvat sen käyttäjäryhmälle.
Missä dokumentaatio sijaitsee?
Developer-MCP-dokumentaatiossa sekä llms.txt-tiedostossa ja Live-Postman-kokoelmassa.
Onko olemassa EU-palvelinta?
Kyllä — käsittely tapahtuu PaperOffice:n EU-infrastruktuurissa.

PaperOffice AI · Problem Solver

Kertokaa meille, mikä vie teiltä päivittäin aikaa.

Kuvailkaa yksinkertaisesti. Ammattitermejä ei tarvita.

Tai aloittakaa esimerkillä

Miten haluaisitte käyttää PaperOfficea?

Tietokone ja älypuhelin yhdistetty: työtila tietokoneella, kerääminen puhelimella.

Mistä haluatte aloittaa?

Täysi työtila on optimoitu tietokoneelle. Mobiiliversio soveltuu dokumenttien keräämiseen, tarkistamiseen ja hyväksymiseen.

Rekisteröitykää veloituksetta app.paperoffice.ai

Aloittakaa tietokoneella

Henkilökohtainen kirjautumislinkki lähetetään ilmoitettuun sähköpostiosoitteeseen.

Avatkaa PaperOffice Mobile

Kerätkää ja käsitelkää dokumentteja suoraan älypuhelimella.

Avatkaa mobiiliversio