Naar inhoud springen
Werkt in Claude · Geverifieerd door Anthropic
Overzicht Overzicht Nieuws Nieuws
Delen

MCP-server

Een rekening. 300+ MCP-tools. Direct in uw chattool.

De PaperOffice MCP-server brengt documenten, zoeken, workflows en analyses naar Claude, ChatGPT, Grok en Cursor.

Kies uw chattool. De handleiding toont elke klik — OAuth 2.1, zonder installatie.

OAuth 2.1 bij de eerste connectie Externe server zonder installatie Verwerking in de EU
Een rekening. 300+ MCP-tools. Direct in uw chattool.

Snelle start

Kies uw chattool

De handleiding toont elke stap in Claude, ChatGPT, Grok of Cursor. Daaronder vindt u het snippet om te kopiëren.

Snippet om te kopiëren

Claude Desktop / Claude Code

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

Claude-directory-URL — OAuth 2.1. Document Operations zonder TTS. /claude invoegen; geen Bearer in snippet.

Eindpunten

URL voor de AI-client kopiëren

Elk profiel verwijst naar dezelfde server — het verschilt alleen in de toolomvang. Welke URL bij welke functie past, staat in de tabel hieronder.

  • Slank /mcp

    Slank IDE-set — niet de Document-Operations-catalogus op /cursor.

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

    Alle MCP-tools (300+) voor power-workflows.

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

/openai blijft bereikbaar als alias van /chatgpt. Uitgeschakelde modulepaden reageren met HTTP 410.

Mogelijkhedenmatrix

Welke URL past?

Een rij per taak: aanbevolen URL en de reden daarvoor. Deze tabel is de enige volledige padlijst op deze pagina.

Taak Aanbevolen URL Waarom
Documentbewerkingen (kanoniek) /dms Documents Operations (300+ MCP tools) — identieke catalogus op /dms en /cursor.
Claude Desktop / Claude Code (Directory-URL) /claude Directory: Documentbewerkingen zonder TTS. Titel en opmerkingen bij elke tool.
Cursor IDE tijdens het coderen /cursor Zelfde Documentbewerkingen-catalogus als /dms (inclusief TTS).
ChatGPT-connector /chatgpt ChatGPT connector — samengestelde tools voor zakelijke documenten en kennisbankartikelen, elk individueel vermeld (zie de toolreferentie). Alias: /openai.
Grok Bot /grok Dezelfde gecureerde tools als /chatgpt, zonder de alleen voor ChatGPT beschikbare bijlage-upload. Verbinding via een Grok Bot met de verbindingsprompt.
Meta Muse-connector /muse Dezelfde gekurde tools als /grok: de set van /chatgpt zonder de bijlage-upload die alleen voor ChatGPT geldt, waarbij elke tool in de toolreferentie wordt vermeld.
Schlank IDE-set /mcp Compacte set om te zoeken, lezen en analyseren, plus upload en kennisbank-artikelen — niet de documentoperations-catalogus.
Complexe meerstaps-taken po_agents_ask in /mcp-full Host-LLM-agent blijft op het volledige oppervlak, niet op /dms.
Migratie / alle MCP-tools /mcp-full Volledige MCP-interface (300+ tools) voor debugging en legacy-agents.

Migreren van oudere MCP-instellingen

Afgeschakelde modulepaden antwoorden met HTTP 410. Gebruik voor Document Operations /dms.

  • Gebruik /dms als de canonieke Documents Operations-URL. /cursor deelt die catalogus (inclusief TTS).
  • Afgeschakelde modulepaden antwoorden nu met HTTP 410 — schakel over naar /dms of /mcp.
  • Gebruik /mcp voor de slimme IDE-subset — /cursor is volledige Documentbewerkingen, hetzelfde als /dms.
  • Gebruik /chatgpt voor ChatGPT (alias /openai). Het geeft een individueel samengestelde set gekurde tools weer — geen discovery- of generieke executor-tools, geen TTS, OTP of ontgrendeltools.
  • Gebruik /grok voor Grok. Het geeft nu de gekurde tools van /chatgpt (zonder de bijlage-upload die alleen voor ChatGPT geldt) weer in plaats van de Documents Operations-catalogus.
  • Behoud /mcp-full alleen voor powerusers en media/CRM.
  • Gebruik /muse voor Meta Muse (dezelfde gecureerde tools als /grok).

Toolreferentie

Elke tool van de connectors ChatGPT, Meta Muse en Grok

/chatgpt (alias /openai) vermeldt 56 tools; /muse en /grok vermelden 55 — dezelfde set zonder de ChatGPT-exclusieve bestandupload. Elke bewerking is een aparte tool met een eigen beschrijving, invoerschema en MCP-annotaties; er zijn geen ontdekkings tools en geen generieke executor.

Elke tool vereist OAuth 2.1 met PKCE (scope mcp:tools) of een PaperOffice-gebruikers- of groepstoken (po_ut_ / po_gt_); po_sk_ en po_pk_ worden geweigerd. Een aanroep wordt uitgevoerd met de machtigingen van de verbonden PaperOffice-gebruiker, en de argumenten worden gecontroleerd tegen het gepubliceerde invoerschema voordat de tool wordt uitgevoerd.

Labels

MCP. Elke tool draagt de annotaties readOnlyHint, destructiveHint, idempotentHint en openWorldHint. Het label vat samen wat een aanroep doet:

  • LezenLeest gegevens en verandert niets (readOnlyHint true).
  • SchrijvenMaakt gegevens aan of wijzigt deze in het PaperOffice-account van de gebruiker, bijvoorbeeld door documenten op te slaan, aan te maken, te extraheren, om te zetten, te verplaatsen, te kopiëren, te taggen of te herstellen.
  • Gevoelig schrijvenVerwijdert gegevens (documenten belanden in de prullenbak) of overschrijft ze, neemt een definitief besluit over een taak voor delen, kan een andere persoon verwittigen of inhoud publiceren in een openbare kennisbank. Clients moeten voor het aanroepen van deze tools de bevestiging van de gebruiker vragen.

/chatgpt: 56 tools (25 Lezen, 18 Schrijven, 13 Gevoelig schrijven). /muse en /grok: 55 tools (25 Lezen, 17 Schrijven, 13 Gevoelig schrijven).

Gecurateerde MCP-tools met label, invoer, uitvoer en neveneffecten, en parallelle aanroepen per sessie
ToolLabelGebruik het wanneerInvoerUitvoer en neveneffectenParallelle aanroepen per sessie
po_workspaces_listList workspacesLezenThe user names a workspace or asks which workspaces exist, or a workspace_id is needed.optioneellimitoffsetsearchworkspace_idLists ID, name and document count. Locked workspaces are unlocked only in the PaperOffice app.4
po_documents_getGet document detailsLezenThe user wants details of one document: type, sender, amounts, dates, summary, processing status. Stored data only; to extract invoice data use po_extraction_invoice.een vanpofiddocuments_idoptioneelresolvecompactGeen neveneffecten.4
po_extraction_invoiceExtract invoice dataSchrijvenThe user asks to extract invoice data (supplier, number, dates, line items, VAT, total). Not for personal ID numbers.een vanpofidfile_urlupload_idoptioneelmodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_job_getGet job statusLezenAn extraction or PDF tool returned a job_id.verplichtjob_idReturns status and, once completed, the result. Poll until completed; stop if it failed.4
po_analytics_financial_summary_getSummarize document amountsLezenThe user asks for totals or a summary of invoice amounts across documents, e.g. by currency.optioneelperiodworkspace_idSums extracted amounts of all documents (not only invoices) per currency, never mixing currencies.4
po_documents_create_from_contentCreate PDF from textSchrijvenThe user asks to create or write a PDF or document (notes, letter, report).verplichtcontenttitleworkspace_idoptioneelcontent_typemetadatalanguageauto_classifycustom_cssheader_htmlfooter_htmlidempotency_keyPass Markdown text: PaperOffice renders and stores the PDF, returns name and pofid. Costs credits.1
po_documents_renameRename documentGevoelig schrijvenThe user wants to rename a document or change its file name.verplichtnew_file_nameeen vanpofiddocuments_idOverwrites the file name; the original extension (e.g. .pdf) is kept.1
po_documents_text_getRead document textLezenThe user needs the full text or exact wording of a document.een vanpofiddocuments_idReturns its OCR text (only after processing); emails, phone and ID numbers are masked where detected.4
po_documents_creator_agents_listList Creator AgentsLezenThe user wants a quote, letter or certificate on their own template, or asks which Creator Agents exist.geenLists active agents (agent_id, name, template); then use po_documents_creator_agent_preview.4
po_documents_creator_agent_previewPreview agent documentSchrijvenThe user asks a Creator Agent to draft a document, e.g. a quote.verplichtagent_idpromptoptioneelvariablessource_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 documentSchrijvenThe user approved a Creator Agent preview and wants the document.verplichtagent_idpreview_tokenconfirmoptioneelvariablesaccept_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 attachmentsAlleen /chatgptSchrijvenThe user wants to store files they attached in this chat. To create a PDF from text use po_documents_create_from_content.verplichtfilesoptioneelworkspace_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 documentsLezenA 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).verplichtquestionoptioneelpofidsearch_scopeworkspace_idworkspace_idsperiodGeen neveneffecten.1
po_knowledge_get_articleRead knowledge articleLezenThe user wants to read one knowledge base article in full, e.g. after a search hit.verplichtidoptioneellanguageReturns its title, text and summary in each language.4
po_analytics_financial_overdue_getList overdue invoicesLezenThe user asks which invoices are overdue.optioneelperiodworkspace_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 processingGevoelig schrijvenA stored document needs OCR and AI analysis, e.g. it has no text yet.verplichtai_dms_tiereen vanpofiddocuments_idoptioneelconfirm_reprocessconfirm_tier_downgradeRuns in the background, costs credits; track via po_documents_get. Re-processing replaces the old analysis.1
po_documents_downloadGet download linkLezenThe user wants to download or save a document's file, e.g. the PDF.een vanpofiddocuments_idReturns a temporary link to the stored file, valid for about 10 minutes.4
po_documents_update_indexUpdate index fieldsGevoelig schrijvenThe user wants to set or correct document metadata (index fields), e.g. document_type, sender_name, invoice_number, due_date, total_amount or currency.verplichtfieldseen vanpofiddocuments_idoptioneelidempotency_keyOnly the given fields are overwritten.1
po_documents_uploadUpload document from URLSchrijvenThe user gives a public file URL to store, or wants a browser upload page (omit file_url).optioneelupload_idfile_urlfile_nameworkspace_idai_dms_tierStores a new document; workspace auto-processing may apply.1
po_extraction_receiptExtract receipt dataSchrijvenThe user asks to extract receipt data (merchant, date, items, tax, total), e.g. for expenses.een vanpofidfile_urlupload_idoptioneelmodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_extraction_delivery_noteExtract delivery note dataSchrijvenThe user asks to extract delivery note data (shipper, recipient, items, quantities, delivery date).een vanpofidfile_urlupload_idoptioneelmodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_extraction_purchase_orderExtract purchase order dataSchrijvenThe user asks to extract purchase order data (order number, vendor, buyer, items, delivery date, total).een vanpofidfile_urlupload_idoptioneelmodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_tasks_list_my_tasksList my tasksLezenThe user asks about their tasks or pending approvals.optioneelstatusprioritystep_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 detailsLezenThe user asks what a specific task or approval is about.verplichttask_idoptioneelinclude_interactionReturns description, status, due date, history and whether completing needs an approve decision.4
po_tasks_claim_taskClaim taskGevoelig schrijvenThe 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.verplichttask_idLocks it to them for 15 minutes and may notify the assignee.1
po_tasks_complete_taskComplete taskGevoelig schrijvenThe user approves a task or marks it done.verplichttask_idoptioneelresultcommentclaim_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 taskGevoelig schrijvenThe user rejects or declines a task or approval.verplichttask_idreasonoptioneelclaim_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 documentSchrijvenThe user wants to move a document to another workspace.verplichttarget_workspace_ideen vanpofiddocuments_idoptioneelconfirmAll its versions move along and keep their pofids. Documents under retention or legal hold cannot be moved.1
po_documents_copyCopy documentSchrijvenThe user wants to copy or duplicate a document into a workspace.verplichttarget_workspace_ideen vanpofiddocuments_idoptioneelnew_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 tagsLezenThe user asks which tags or labels a document has.een vanpofiddocuments_idReturns tag names and colors.4
po_documents_tags_createAdd document tagSchrijvenThe user wants to tag or label a document.verplichttag_nameeen vanpofiddocuments_idoptioneeltag_colorAdds one tag per call; a tag the document already has is rejected.1
po_documents_folders_listList document foldersLezenThe user asks for document folders, i.e. bundles of related documents, in a workspace.verplichtworkspace_idLists folders only; po_documents_search lists documents.4
po_documents_folders_createCreate document folderSchrijvenThe 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.verplichtpofidsoptioneelfolder_namefolder_descriptionA document can be in only one folder.1
po_vat_validateValidate EU VAT IDLezenThe user wants to check if a company's EU VAT ID is valid.verplichtvat_idChecks EU VIES or a recent cached result (check date returned); returns validity and, if disclosed, company name and address.4
po_currency_convertConvert currencyLezenThe user asks to convert an amount to another currency.verplichtfromtooptioneelamountUses the latest available rate (rate date returned); no historical rates.4
po_pdfstudio_mergeMerge PDFsSchrijvenThe user wants to merge or combine two or more PDF documents into one file.een vanpofidsfile_urlsoptioneelorderoutput_filenameStarts a job; po_job_get returns the download link.1
po_pdfstudio_splitSplit PDFSchrijvenThe user wants to split a PDF into single pages or page ranges.een vanpofidfile_urlupload_idoptioneelmodesplitsoutput_prefixStarts a job; po_job_get returns the download link(s).1
po_pdfstudio_compressCompress PDFSchrijvenThe user wants to compress a PDF or reduce its file size.een vanpofidfile_urlupload_idoptioneelqualityremove_metadataStarts a job; po_job_get returns the download link.1
po_dataripper_office2pdfConvert Office to PDFSchrijvenThe user wants to convert a Word, Excel or PowerPoint file to PDF.een vanfile_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 versionsLezenThe user asks for earlier versions or the version history of a document.verplichtpofidoptioneelinclude_trashedReturns its versions with number, pofid, date, comment and which is current.4
po_documents_audit_trail_getGet change historyLezenThe user asks what changed in a document or workspace, or for an audit trail or change log.optioneelpofiddocuments_idactionworkspace_idlimitoffsetOnly revision-secure documents log changes; returns the latest entries with action, field, old and new value.4
po_documents_trash_listList recycle binLezenThe user asks what is in the recycle bin or trash, or looks for a deleted document.optioneelworkspace_idpageper_pageReturns deleted documents (newest first, 50 per page) with pofid and days left before permanent deletion.4
po_documents_restoreRestore documentSchrijvenThe user wants to restore or undelete a document from the recycle bin.een vanpofiddocuments_idoptioneeltarget_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 documentGevoelig schrijvenThe user wants to delete a document and all its versions (not a tag or folder entry).een vanpofiddocuments_idoptioneelconfirmPermanent in standard workspaces, recycle bin in business and compliance ones. Retention or legal hold blocks it.1
po_knowledge_list_basesList knowledge basesLezenThe user asks which knowledge bases they have or a knowledge base ID is needed.optioneelinclude_archivedReturns ID, name, visibility and languages of each active knowledge base.4
po_knowledge_list_articlesList knowledge articlesLezenThe user wants to browse or list the articles of a knowledge base instead of searching.optioneelkb_idpagelimitcategory_idlanguagesearchReturns articles (50 per page) with IDs, titles, status and content.4
po_knowledge_categoriesList knowledge categoriesLezenThe user asks which categories their knowledge base articles are sorted into.optioneelkb_idlanguageReturns each category's ID, name and article count.4
po_knowledge_get_baseGet knowledge baseLezenThe user asks about one knowledge base's settings, visibility or languages.verplichtidReturns its details with article and category counts.4
po_knowledge_add_articleCreate knowledge articleGevoelig schrijvenThe user asks to add or write a new knowledge base article.verplichtkb_idtitlecontentlanguageoptioneelcategory_idtypeSaves it and indexes it for search; in a public knowledge base it is published at once.1
po_knowledge_update_articleUpdate knowledge articleGevoelig schrijvenThe user asks to edit or rewrite a knowledge base article.verplichtidlanguageeen vantitlecontentcategory_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 articleGevoelig schrijvenThe user asks to translate a knowledge base article.verplichtidtarget_languageoptioneelsource_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 baseGevoelig schrijvenThe user asks to create a new knowledge base for help articles.verplichtnameoptioneeldescriptionprimary_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 baseGevoelig schrijvenThe user asks to rename a knowledge base, change its description or make it public or internal.verplichtideen vannamedescriptionvisibilityprimary_languageenabled_languagesOverwrites the given fields; public puts its published articles online, internal takes them offline.1
po_knowledge_delete_articleDelete knowledge articleGevoelig schrijvenThe user asks to delete a knowledge base article.verplichtidPermanently removes it in all languages, also from search and the help center; cannot be undone.1

Beweeg de muis over een invoernam om het type en de beschrijving te zien. De laatste kolom toont hoeveel aanroepen van een tool tegelijkertijd kunnen draaien in één MCP sessie.

Fouten

Een tool-fout wordt teruggegeven als een MCP tool-resultaat met isError: true. Hetzelfde JSON-object staat in structuredContent en in het eerste tekstinhoudsblok:

{
  "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
Stabiele, machine-leesbare code. Deze wordt gespiegeld in code en details.error_code omdat sommige clients error_code herschrijven.
message
Menselijk leesbare uitleg.
details
Context zoals http_status, retryable / retry_safe, suggested_backoff_ms, validation_errors of de verzonden IDs.
hint
Wat u hierna moet doen, geschreven voor het model.
retryablehttp_status
Optionele velden op het hoogste niveau die in de uitvoerschema's zijn gedeclareerd.
CodeBetekenisOpnieuw proberen?
INVALID_PARAMSDe argumenten hebben de schema-validatie niet doorstaan; details.validation_errors noemt de velden.Nee — los de argumenten op
TOOL_UNKNOWNEr bestaat geen tool met deze naam op deze verbinding — gebruik de naam uit de toollijst van de connector.Nee
TOOL_NOT_ON_THIS_CONNECTORDe tool bestaat in PaperOffice, maar niet op deze connector. De hint geeft de weg aan: naar /dms en /cursor via po_mcp_tools_call_read of po_mcp_tools_call_write, anders in de PaperOffice-app.Nee — de hint volgen
WORKSPACE_ACCESS_DENIEDDe verbinding heeft geen toegang tot de Workspace of het document.Nee
DOCUMENT_NOT_FOUNDOnbekende pofid of documents_id.Nee
CONFIRMATION_REQUIREDDe actie vereist een bevestiging — bijvoorbeeld bulkacties vanaf 6 elementen, het intrekken van delen of het opheffen van een Legal Hold. Een voorbeeld van de betrokken elementen is inbegrepen; na de bevestiging de aanroep met confirm=true herhalen.Na bevestiging door de gebruiker
APP_ONLY_ACTIONINSTANT_DELETE_APP_ONLYFOLDER_DELETE_NOT_ALLOWEDDefinitieve stappen gaan alleen in de PaperOffice-app: definitief verwijderen, de prullenbak legen, een Workspace verwijderen, de bewaring in de prullenbak wijzigen of een hele map verwijderen. Via MCP verwijderde documenten belanden in de prullenbak.Nee — in de app uitvoeren
LEGAL_HOLD_ACTIVEUNDER_RETENTIONWORM_PROTECTEDHet document is beveiligd; de wijziging is geweigerd.Nee
GROUP_RESTRICTIONDe groep van het token beschikt niet over deze machtiging, bijvoorbeeld voor verwijderen.Nee
PLAN_UPGRADE_REQUIREDDe functie is alleen beschikbaar in een hoger abonnement; details.required_plan vermeldt het benodigde abonnement, details.plans_url de tariefpagina van de app.Nee — eerst na het upgraden van het abonnement
INSUFFICIENT_CREDITSOnvoldoende credits (HTTP 402); er is niets in rekening gebracht.Na een opwaardering
TASK_REQUIRES_APP_REVIEWCLAIM_SESSION_MISMATCHTASK_CLAIM_EXPIREDDe beslissing op een goedkeuringsopdracht kon niet worden vastgelegd; de hint legt de volgende stap uit.Zoals de hint aangeeft
TRANSLATION_IN_PROGRESSEr is nog een vertaling van de kennisbank bezig.Ja, na ongeveer 60 seconden met dezelfde argumenten
WRITE_OUTCOME_UNKNOWNHet schrijven naar de kennisbank leverde binnen de tijdslimiet geen antwoord op; het is waarschijnlijk wel opgeslagen.Controleer eerst, en probeer het opnieuw
TRANSIENT_TRANSPORT_ERRORBackend-timeout (408) of HTTP 429, 502, 503 of 504; details.retryable is true, suggested_backoff_ms is 2000 en details.http_status geeft de oorzaak aan.Ja, met backoff
SESSION_BUSYACCOUNT_BUSYEr is een limiet voor gelijktijdige verbindingen bereikt (zie rate limits); retry_safe is true en retry_after_ms is opgenomen.Ja, na retry_after_ms
MCP_MAINTENANCEServeronderhoud of herstart; retry_after_ms is 2000.Ja
SECRET_ARGUMENT_REJECTEDEen argument leek op een referentiegegevens; toolargumenten mogen geen tokens of wachtwoorden bevatten.Nee
TOOL_ERRORAlgemene uitwijkoptie wanneer geen specifieke code van toepassing is.Hangt af van de boodschap

Geen fout: wanneer een bestandsinvoer ontbreekt, retourneren de op bestanden gebaseerde tools (extractie, PDF) een normaal tekstresultaat dat begint met FILE_UPLOAD_REQUIRED en de geaccepteerde invoeren of een browseruploadpagina vermeldt.

Op het transportniveau krijgt een ontbrekend, ongeldig, verlopen of ingetrokken token HTTP 401 met een WWW-Authenticate header (voer OAuth opnieuw uit). Terwijl authenticatie of de toolcatalogus kort niet beschikbaar is, antwoordt de server met HTTP 503 met Retry-After (2–5 s).

Snelheidsbeperkingen en quota

  • Per MCP-sessie (Mcp-Session-Id): maximaal 8 toolaanroepen tegelijk. Tools met 1 in de laatste kolom worden sequentieel uitgevoerd: een tweede gelijktijdige aanroep levert direct SESSION_BUSY op (opnieuw na ongeveer 300 ms, bij po_knowledge_graph_ask na 500 ms). De overige tools werken met tot 4 parallelle aanroepen en wachten tot 15 s op een vrije plek.
  • Per toegangstoken over alle sessies: maximaal 24 gelijktijdige toolaanroepen (ACCOUNT_BUSY).
  • De aanvraaglimieten van de PaperOffice API gelden voor elke toolaanroep: gratis tokens en bezoekerstokens krijgen minimaal 5 aanvragen per seconde, 30 per minuut, 100 per uur en 500 per dag; planwaarden kunnen hoger zijn. Betaalde abonnementen met resterende credits worden beperkt door de credits, niet door een aanvraagfrequentie. Snelheidsbeperkte aanroepen worden niet in rekening gebracht; ze retourneren TRANSIENT_TRANSPORT_ERROR met details.http_status 429 en de wachttijd in het bericht.
  • Tijdslimieten: een backendaanroep wordt na 90 s afgebroken (kennisbasisschrijvingen retourneren dan WRITE_OUTCOME_UNKNOWN of TRANSLATION_IN_PROGRESS in plaats van blindelings te herhalen); po_knowledge_graph_ask stopt na 120 s.
  • Limieten zoals vermeld in de toolbeschrijvingen: maximaal 10 bestanden per po_documents_upload_files-aanroep (alleen /chatgpt), 2 of meer PDF's per samenvoeging, maximaal 500 zoekresultaten per pagina, maximaal 200 Workspaces per pagina en 10–200 verwijderde items per pagina. Downloadlinks vervallen na ongeveer 10 minuten en een opgeëiste taak blijft 15 minuten vergrendeld.
  • Facturatie: MCP aanroepen worden in credits gefactureerd zoals REST API-aanroepen. Tools waarvan de beschrijving zegt 'kost credits' of 'gebruikt credits' starten AI-verwerking op en gebruiken meer credits.

Tools

Zes families, één catalogus

De MCP-tools zijn gegroepeerd per taak. De client ziet ze met titel en korte beschrijving en kiest zelf het passende hulpmiddel.

  • Document AI

    Documenten, OCR, IDP, zoeken, PDF-operaties, handtekeningen en AI-DMS.

    document-ai
  • Workflow AI

    Workflows, taken, jobs, HITL, goedkeuringen en procesautomatisering.

    workflow-ai
  • Relations AI

    CRM, partners, leads, helpdesk en afspraken.

    relations-ai
  • Analytics AI

    Analytics, BI, kennisgrafiek, entiteiten en RAG.

    analytics-ai
  • Media AI

    Image Studio, TTS, STT en vertaling.

    media-ai
  • Data AI

    Validatie, BTW, valuta, geo-gegevens en security-opslagservices.

    data-ai

Afgedekte gebieden

  • Documentbeheer Zoeken, lezen, uploaden, bewerken, verplaatsen, kopiëren, verwijderen
  • Intelligente zoekopdracht Volledige tekst, semantische gelijkenis, geavanceerd zoeken, statistieken
  • E-handtekening Handtekeningverzoeken, sjablonen, verificatie, mobiele links
  • AI-verwerking AI-OCR, documentanalyse, PII-detectie, anonymisering
  • Document-intelligentie Entiteiten, relaties, samenvattingen, meta-velden, embeddings
  • Analyses Trends, financiën, heatmaps, auditcenter
  • Knowledge Graph Businesscases, tijdlijnen, referenties, relaties
  • CRM-intelligentie Accounts, leads, kansen, sentiment
  • Business-intelligentie Dashboards, veldanalyse, workspace-metrieken
  • Webhooks & gebeurtenissen Abonneren, testen, beheren, job-subscriptions
  • Notities, tags & opmerkingen Tekstopmerkingen en notities — aanmaken, lijst tonen, oplossen, verwijderen
  • Versiebeheer & audit Revisies, legal hold, audit trail

Voorbeelden

Wat u zegt — welke tool draait

Vier zinnen uit de dagelijkse praktijk en het MCP-tool dat de client daarvoor aanroept. De rechten komen uit uw workspace, niet uit de chat.

  • Haal alle gegevens uit de bijgevoegde factuur.

    MCP-tool po_aiocr_analyze

    Factuur geanalyseerd — geëxtraheerde gegevens:

  • Hernoem dit document naar Factuur-2026-0042.

    MCP-tool po_documents_rename

    Document hernoemd:

  • Voeg een review-opmerking toe aan pagina 2.

    MCP-tool po_documents_comments_create

    Opmerking gemaakt:

  • Hoe heeft onze documentenvolume zich ontwikkeld?

    MCP-tool po_analytics_trends_get

    Trendanalyse van de laatste 6 maanden:

Hoogtepunten

Wat de MCP-server uitmaakt

De MCP-server is geen wrapper rond de REST-API — het is dezelfde kern met uw accounttoestemmingen, Workspaces en credits.

  • OAuth 2.1 en gebruikers-token

    OAuth voor Claude, ChatGPT en Grok; gebruikers-token (po_ut_ / po_gt_) voor Cursor — po_sk_ is geblokkeerd.

  • Hybride zoeken met embeddings

    PaperOffice-embeddings en volledige tekst werken samen, zodat de client het juiste hulpprogramma kan vinden.

  • Bestandsstaging en upload

    Presigned upload-URL's — geen Base64 in de chat.

  • Knowledge Graph

    Businesscases, tijdlijnen en documentrelaties via natuurlijke taal.

  • Analytiek en BI

    Trends, financiën, heatmaps en workspace-metriken op verzoek.

  • EU-verwerking

    Verwerking in eigen EU-infrastructuur — dezelfde rechten en workspaces als in de app.

Toepassingen

Zie PaperOffice MCP in 30 seconden op

Vier echte workflows met Claude — elk een korte video. Diepgaande artikelen zijn hieronder gelinkt.

Veelgestelde vragen

Alles over de PaperOffice MCP-server

Hoe authenticeert de MCP-server zich?
Claude, ChatGPT en Grok starten met OAuth 2.1. Alternatief een gebruikers- of groepstoken (po_ut_ / po_gt_) — po_sk_ en po_pk_ zijn voor MCP geblokkeerd.
Wat kost het gebruik via MCP?
MCP-aanroepen belasten Credits zoals de REST-API. Saldo en gebruik zijn via billing-eindpunten opvraagbaar.
Welk eindpunt biedt welke tools?
/mcp is het slanke IDE-deelset. /dms en /cursor delen Documents Operations inclusief vastlegging, workflow en TTS. /claude is Directory zonder TTS. /chatgpt (alias /openai) geeft een samengestelde set tools voor ChatGPT weer; /grok en /muse geven dezelfde tools weer, behalve de bijlage-upload die alleen voor ChatGPT geldt. De toolreferentie op deze pagina markeert elke gekurde tool als Lezen, Schrijven of Gevoelig schrijven.
Wordt OAuth 2.1 ondersteund?
Ja. OAuth 2.1 start bij de eerste connectie. Alternatief een gebruikers- of groepstoken (po_ut_ / po_gt_) — po_sk_ en po_pk_ zijn geblokkeerd voor MCP.
Wat is een MCP-native AI-DMS?
Een AI-DMS waarvan de mogelijkheden natief bereikbaar zijn via het Model Context Protocol — dezelfde toestemmingen en Workspaces als in de app.
Welke clients worden ondersteund?
Onder andere Claude, ChatGPT, Grok, Cursor en Headless-DMS-profielen — zie de connectiepagina's.
Hoe snel is de connectie?
In enkele minuten: OAuth 2.1 bij de eerste connectie of een gebruikers-/groepstoken (po_ut_ / po_gt_), daarna tools vrijgeven. po_sk_ is geblokkeerd voor MCP.
Verschillen profielen?
Ja — het bereik van de tool hangt af van het eindpunt. Wat een aanroep mag doen, wordt bepaald door de rechten van de verbonden gebruiker; een groeps-token (po_gt_) heeft precies de rechten van zijn gebruikersgroep.
Waar bevindt de documentatie zich?
In de Developer-MCP-documentatie evenals onder llms.txt en de Live-Postman-verzameling.
Is er een EU-hosting?
Ja — verwerking in de PaperOffice-EU-infrastructuur.

PaperOffice AI · Problem Solver

Vertel ons, wat u dagelijks tijd kost.

Eenvoudig beschrijven. Geen vakjargon nodig.

Of start met een voorbeeld

Hoe wilt u PaperOffice gebruiken?

Computer en smartphone zijn verbonden: workspace op de computer, vastleggen op de telefoon.

Waar wilt u beginnen?

De volledige workspace is geoptimaliseerd voor de computer. De mobiele versie is geschikt voor het vastleggen, controleren en goedkeuren van documenten.

Gratis registreren app.paperoffice.ai

Start op de computer

We sturen uw persoonlijke toegangslink naar uw e-mailadres.