İçeriğe atlayın
Claude'da çalışır · Anthropic tarafından doğrulandı
Genel bakış Genel bakış Haberler Haberler
Paylaş

MCP Sunucusu

Bir hesap. 300+ MCP aracı. Doğrudan Sohbet Aracında.

PaperOffice MCP Sunucusu, belgeleri, aramayı, iş akışlarını ve analizleri Claude, ChatGPT, Grok ve Cursor'e getirir.

Sohbet aracını seçin. Kılavuz, her tıklamayı adım adım gösterir — OAuth 2.1, kurulum gerektirmez.

İlk bağlantıda OAuth 2.1 Kurulum gerektirmeyen uzak sunucu AB içinde işleme
Bir hesap. 300+ MCP aracı. Doğrudan Sohbet Aracında.

Hızlı Başlangıç

Sohbet Aracını Seçin

Kılavuz, Claude, ChatGPT, Grok veya Cursor'teki her tıklamayı gösterir. Altında kopyalamanız gereken kod parçacığı yer alır.

Kopyalanacak Kod Parçacığı

Claude Masaüstü / Claude Kodu

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

Claude-Dizin-URL'si — OAuth 2.1. TTS olmadan Belge İşlemleri. /claude içine yerleştirin; snippet'te Bearer kullanmayın.

Uç noktalar

AI istemcisi için URL'yi kopyalayın

Her profil aynı sunucuyu gösterir — yalnızca araç kapsamı farklıdır. Hangi URL'nin neye uygun olduğu aşağıdaki tabloda yer almaktadır.

  • İnce /mcp

    İnce IDE seti — /cursor'daki Belge İşlemleri kataloğu değil.

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

    Güçlü iş akışları için tüm MCP araçları (300+).

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

/openai, /chatgpt takma adı olarak erişilebilir kalır. Kapatılmış modül yolları HTTP 410 yanıtı verir.

Yetenek Matrisi

Hangi URL uygun?

Her görev için bir satır: önerilen URL ve bunun nedeni. Bu tablo, bu sayfadaki tek eksiksiz yol listesidir.

Görev Önerilen URL Neden
Doküman İşlemleri (kanonik) /dms Document Operations (300+ MCP aracı) — /dms ve /cursor'te aynı katalog.
Claude Masaüstü / Claude Kodu (Dizin URL'si) /claude Dizin: TTS olmadan Doküman İşlemleri. Her aracın başlığı ve ipuçları.
Cursor Kodlama sırasında IDE /cursor /dms ile aynı Doküman İşlemleri kataloğu (TTS dahil).
ChatGPT Bağlayıcı /chatgpt ChatGPT bağdaştırıcısı — iş belgeleri ve bilgi bankası makaleleri için özenle hazırlanmış araçlar; her biri tek tek listelenir (bkz. Araç Referansı). Takma ad: /openai.
Grok Bot /grok /chatgpt ile aynı özenle hazırlanmış araçlar, yalnızca ChatGPT için geçerli olan ek yükleme özelliği hariç. Bağlantı, bağlantı istemi kullanılarak bir Grok Bot üzerinden sağlanır.
Meta-Muse bağdaştırıcısı /muse /grok ile aynı kurgulanmış araçlar: yalnızca ChatGPT için mevcut olan ek yükleme hariç tutulan /chatgpt'un seti; her araç araç referansında listelenir.
Hafif IDE Seti /mcp Arama, okuma ve analiz etme, ayrıca yükleme ve bilgi bankası makaleleri için kompakt bir set — Document-Operations kataloğu değildir.
Karmaşık Çok Adımlı Görevler /mcp-full içinde po_agents_ask Ana LLM ajanı tam arayüzde kalır, /dms üzerinde değil.
Geçiş / tüm MCP araçları /mcp-full Hata ayıklama ve eski ajanlar için tam MCP arayüzü (300+ araç).

Eski MCP kurulumlarını taşıma

Kullanımdan kaldırılan modül yolları HTTP 410 yanıtı verir. Document Operations /dms için kullanın.

  • /dms'ü kanonik Document-Operations URL'si olarak kullanın. /cursor bu kataloğu (TTS dahil) paylaşır.
  • Kullanımdan kaldırılan modül yolları artık HTTP 410 yanıtı verir — /dms veya /mcp'e geçiş yapın.
  • Slim IDE alt kümesi için /mcp kullanın — /cursor, /dms ile aynı olan tam Dokümanlar İşlemleridir.
  • /chatgpt'u ChatGPT için kullanın (takma ad: /openai). Tek tek listelenen kurgulanmış bir araç seti içerir; keşif veya genel yürütme araçları, TTS, OTP veya kilidini açma araçları yoktur.
  • /grok'yi Grok için kullanın. Artık Document Operations kataloğu yerine, yalnızca ChatGPT için mevcut olan ek yükleme hariç tutulan /chatgpt'un kurgulanmış araçlarını listeler.
  • Güçlü kullanıcılar ve medya/CRM için /mcp-full'i yalnızca koruyun.
  • /muse'ü Meta Muse için kullanın (/grok ile aynı kurgulanmış araçlar).

Araç Referansı

ChatGPT, Meta Muse ve Grok için bağdaştırıcıların tüm araçları

/chatgpt (takma ad: /openai) 56 aracı listeler; /muse ve /grok 55 araç listeler — yalnızca ChatGPT için mevcut olan ek yükleme hariç tutulan aynı set. Her işlem, kendi açıklaması, kendi giriş şeması ve kendi MCP açıklamaları ile ayrı bir aracıdır; keşif araçları veya genel yürütücü yoktur.

Her araca OAuth 2.1 (PKCE ile, kapsam: mcp:tools) veya bir PaperOffice kullanıcı veya grup belirteci (po_ut_ / po_gt_) gereklidir; po_sk_ ve po_pk_ reddedilir. Bir çağrı, bağlı olan PaperOffice kullanıcının yetkileriyle yürütülür ve argümanları yürütmeden önce yayımlanan giriş şemasına karşı doğrulanır.

Etiketleme

MCP. Her araç, readOnlyHint, destructiveHint, idempotentHint ve openWorldHint etiketlerini taşır. Etiketler, bir çağrının ne yaptığını özetler:

  • OkumaVerileri okur ve hiçbir değişiklik yapmaz (readOnlyHint true).
  • YazmaBelge kaydetme, oluşturma, çıkarma, dönüştürme, taşıma, kopyalama, etiketleme veya geri yükleme gibi işlemlerle kullanıcının PaperOffice hesabında veri oluşturur veya değiştirir.
  • Hassas YazmaVerileri siler (belgeler çöp kutusuna gider) veya üzerine yazar, bir paylaşım görevi hakkında kesin karar verir, başka bir kişiyi bildirebilir veya içeriği herkese açık bir bilgi tablosunda yayınlayabilir. İstemciler, bu araçları çağırmadan önce kullanıcının onayını almalıdır.

/chatgpt: 56 araç (25 Okuma, 18 Yazma, 13 Hassas Yazma). /muse ve /grok: 55 araç (25 Okuma, 17 Yazma, 13 Hassas Yazma).

Oturum başına paralel çağrılar dahil, etiketler, girdiler, çıktılar ve yan etkilerle işaretlenmiş MCP araçları
AraçEtiketKullanım durumuGirdilerÇıktılar ve yan etkilerOturum başına paralel çağrılar
po_workspaces_listList workspacesOkumaThe user names a workspace or asks which workspaces exist, or a workspace_id is needed.isteğe bağlılimitoffsetsearchworkspace_idLists ID, name and document count. Locked workspaces are unlocked only in the PaperOffice app.4
po_documents_getGet document detailsOkumaThe user wants details of one document: type, sender, amounts, dates, summary, processing status. Stored data only; to extract invoice data use po_extraction_invoice.bunlardan biripofiddocuments_idisteğe bağlıresolvecompactYan etkisi yoktur.4
po_extraction_invoiceExtract invoice dataYazmaThe user asks to extract invoice data (supplier, number, dates, line items, VAT, total). Not for personal ID numbers.bunlardan biripofidfile_urlupload_idisteğe bağlımodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_job_getGet job statusOkumaAn extraction or PDF tool returned a job_id.gereklijob_idReturns status and, once completed, the result. Poll until completed; stop if it failed.4
po_analytics_financial_summary_getSummarize document amountsOkumaThe user asks for totals or a summary of invoice amounts across documents, e.g. by currency.isteğe bağlıperiodworkspace_idSums extracted amounts of all documents (not only invoices) per currency, never mixing currencies.4
po_documents_create_from_contentCreate PDF from textYazmaThe user asks to create or write a PDF or document (notes, letter, report).gereklicontenttitleworkspace_idisteğe bağlı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 documentHassas YazmaThe user wants to rename a document or change its file name.gereklinew_file_namebunlardan biripofiddocuments_idOverwrites the file name; the original extension (e.g. .pdf) is kept.1
po_documents_text_getRead document textOkumaThe user needs the full text or exact wording of a document.bunlardan biripofiddocuments_idReturns its OCR text (only after processing); emails, phone and ID numbers are masked where detected.4
po_documents_creator_agents_listList Creator AgentsOkumaThe user wants a quote, letter or certificate on their own template, or asks which Creator Agents exist.yokLists active agents (agent_id, name, template); then use po_documents_creator_agent_preview.4
po_documents_creator_agent_previewPreview agent documentYazmaThe user asks a Creator Agent to draft a document, e.g. a quote.gerekliagent_idpromptisteğe bağlı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 documentYazmaThe user approved a Creator Agent preview and wants the document.gerekliagent_idpreview_tokenconfirmisteğe bağlı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 attachmentssadece /chatgptYazmaThe user wants to store files they attached in this chat. To create a PDF from text use po_documents_create_from_content.gereklifilesisteğe bağlı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 documentsOkumaA 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).gerekliquestionisteğe bağlıpofidsearch_scopeworkspace_idworkspace_idsperiodYan etkisi yoktur.1
po_knowledge_get_articleRead knowledge articleOkumaThe user wants to read one knowledge base article in full, e.g. after a search hit.gerekliidisteğe bağlılanguageReturns its title, text and summary in each language.4
po_analytics_financial_overdue_getList overdue invoicesOkumaThe user asks which invoices are overdue.isteğe bağlı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 processingHassas YazmaA stored document needs OCR and AI analysis, e.g. it has no text yet.gerekliai_dms_tierbunlardan biripofiddocuments_idisteğe bağlı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 linkOkumaThe user wants to download or save a document's file, e.g. the PDF.bunlardan biripofiddocuments_idReturns a temporary link to the stored file, valid for about 10 minutes.4
po_documents_update_indexUpdate index fieldsHassas YazmaThe user wants to set or correct document metadata (index fields), e.g. document_type, sender_name, invoice_number, due_date, total_amount or currency.gereklifieldsbunlardan biripofiddocuments_idisteğe bağlıidempotency_keyOnly the given fields are overwritten.1
po_documents_uploadUpload document from URLYazmaThe user gives a public file URL to store, or wants a browser upload page (omit file_url).isteğe bağlıupload_idfile_urlfile_nameworkspace_idai_dms_tierStores a new document; workspace auto-processing may apply.1
po_extraction_receiptExtract receipt dataYazmaThe user asks to extract receipt data (merchant, date, items, tax, total), e.g. for expenses.bunlardan biripofidfile_urlupload_idisteğe bağlımodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_extraction_delivery_noteExtract delivery note dataYazmaThe user asks to extract delivery note data (shipper, recipient, items, quantities, delivery date).bunlardan biripofidfile_urlupload_idisteğe bağlımodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_extraction_purchase_orderExtract purchase order dataYazmaThe user asks to extract purchase order data (order number, vendor, buyer, items, delivery date, total).bunlardan biripofidfile_urlupload_idisteğe bağlımodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_tasks_list_my_tasksList my tasksOkumaThe user asks about their tasks or pending approvals.isteğe bağlı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 detailsOkumaThe user asks what a specific task or approval is about.gereklitask_idisteğe bağlıinclude_interactionReturns description, status, due date, history and whether completing needs an approve decision.4
po_tasks_claim_taskClaim taskHassas YazmaThe 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.gereklitask_idLocks it to them for 15 minutes and may notify the assignee.1
po_tasks_complete_taskComplete taskHassas YazmaThe user approves a task or marks it done.gereklitask_idisteğe bağlı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 taskHassas YazmaThe user rejects or declines a task or approval.gereklitask_idreasonisteğe bağlı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 documentYazmaThe user wants to move a document to another workspace.gereklitarget_workspace_idbunlardan biripofiddocuments_idisteğe bağlıconfirmAll its versions move along and keep their pofids. Documents under retention or legal hold cannot be moved.1
po_documents_copyCopy documentYazmaThe user wants to copy or duplicate a document into a workspace.gereklitarget_workspace_idbunlardan biripofiddocuments_idisteğe bağlı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 tagsOkumaThe user asks which tags or labels a document has.bunlardan biripofiddocuments_idReturns tag names and colors.4
po_documents_tags_createAdd document tagYazmaThe user wants to tag or label a document.gereklitag_namebunlardan biripofiddocuments_idisteğe bağlıtag_colorAdds one tag per call; a tag the document already has is rejected.1
po_documents_folders_listList document foldersOkumaThe user asks for document folders, i.e. bundles of related documents, in a workspace.gerekliworkspace_idLists folders only; po_documents_search lists documents.4
po_documents_folders_createCreate document folderYazmaThe 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.gereklipofidsisteğe bağlıfolder_namefolder_descriptionA document can be in only one folder.1
po_vat_validateValidate EU VAT IDOkumaThe user wants to check if a company's EU VAT ID is valid.gereklivat_idChecks EU VIES or a recent cached result (check date returned); returns validity and, if disclosed, company name and address.4
po_currency_convertConvert currencyOkumaThe user asks to convert an amount to another currency.gereklifromtoisteğe bağlıamountUses the latest available rate (rate date returned); no historical rates.4
po_pdfstudio_mergeMerge PDFsYazmaThe user wants to merge or combine two or more PDF documents into one file.bunlardan biripofidsfile_urlsisteğe bağlıorderoutput_filenameStarts a job; po_job_get returns the download link.1
po_pdfstudio_splitSplit PDFYazmaThe user wants to split a PDF into single pages or page ranges.bunlardan biripofidfile_urlupload_idisteğe bağlımodesplitsoutput_prefixStarts a job; po_job_get returns the download link(s).1
po_pdfstudio_compressCompress PDFYazmaThe user wants to compress a PDF or reduce its file size.bunlardan biripofidfile_urlupload_idisteğe bağlıqualityremove_metadataStarts a job; po_job_get returns the download link.1
po_dataripper_office2pdfConvert Office to PDFYazmaThe user wants to convert a Word, Excel or PowerPoint file to PDF.bunlardan birifile_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 versionsOkumaThe user asks for earlier versions or the version history of a document.gereklipofidisteğe bağlıinclude_trashedReturns its versions with number, pofid, date, comment and which is current.4
po_documents_audit_trail_getGet change historyOkumaThe user asks what changed in a document or workspace, or for an audit trail or change log.isteğe bağlı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 binOkumaThe user asks what is in the recycle bin or trash, or looks for a deleted document.isteğe bağlıworkspace_idpageper_pageReturns deleted documents (newest first, 50 per page) with pofid and days left before permanent deletion.4
po_documents_restoreRestore documentYazmaThe user wants to restore or undelete a document from the recycle bin.bunlardan biripofiddocuments_idisteğe bağlı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 documentHassas YazmaThe user wants to delete a document and all its versions (not a tag or folder entry).bunlardan biripofiddocuments_idisteğe bağlıconfirmPermanent in standard workspaces, recycle bin in business and compliance ones. Retention or legal hold blocks it.1
po_knowledge_list_basesList knowledge basesOkumaThe user asks which knowledge bases they have or a knowledge base ID is needed.isteğe bağlıinclude_archivedReturns ID, name, visibility and languages of each active knowledge base.4
po_knowledge_list_articlesList knowledge articlesOkumaThe user wants to browse or list the articles of a knowledge base instead of searching.isteğe bağlıkb_idpagelimitcategory_idlanguagesearchReturns articles (50 per page) with IDs, titles, status and content.4
po_knowledge_categoriesList knowledge categoriesOkumaThe user asks which categories their knowledge base articles are sorted into.isteğe bağlıkb_idlanguageReturns each category's ID, name and article count.4
po_knowledge_get_baseGet knowledge baseOkumaThe user asks about one knowledge base's settings, visibility or languages.gerekliidReturns its details with article and category counts.4
po_knowledge_add_articleCreate knowledge articleHassas YazmaThe user asks to add or write a new knowledge base article.gereklikb_idtitlecontentlanguageisteğe bağlıcategory_idtypeSaves it and indexes it for search; in a public knowledge base it is published at once.1
po_knowledge_update_articleUpdate knowledge articleHassas YazmaThe user asks to edit or rewrite a knowledge base article.gerekliidlanguagebunlardan birititlecontentcategory_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 articleHassas YazmaThe user asks to translate a knowledge base article.gerekliidtarget_languageisteğe bağlı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 baseHassas YazmaThe user asks to create a new knowledge base for help articles.gereklinameisteğe bağlı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 baseHassas YazmaThe user asks to rename a knowledge base, change its description or make it public or internal.gerekliidbunlardan birinamedescriptionvisibilityprimary_languageenabled_languagesOverwrites the given fields; public puts its published articles online, internal takes them offline.1
po_knowledge_delete_articleDelete knowledge articleHassas YazmaThe user asks to delete a knowledge base article.gerekliidPermanently removes it in all languages, also from search and the help center; cannot be undone.1

Bir girdinin adının üzerine fareyi getirerek türünü ve açıklamasını görebilirsiniz. Son sütun, bir MCP oturumunda bir aracın çağrılarının aynı anda kaç tanesinin çalışabileceğini gösterir.

Hata

Bir araç hatası, isError: true ile birlikte bir MCP araç sonucu olarak döndürülür. Aynı JSON nesnesi structuredContent ve ilk metin içerik bloğunda bulunur:

{
  "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
Sabit, makine tarafından okunabilir kod. Bazı istemciler error_code'u yeniden yazdığından, code ve details.error_code'da yansıtılır.
message
İnsanlar için açıklama.
details
http_status, retryable / retry_safe, suggested_backoff_ms, validation_errors veya gönderilen kimlikler gibi bağlam bilgileri.
hint
Model için formüle edilmiş sonraki adım.
retryablehttp_status
Çıış şemalarında üst düzeyde tanımlanmış isteğe bağlı alanlar.
KodAnlamYeniden Deneyin?
INVALID_PARAMSArgümanlar şema doğrulamasını geçemedi; details.validation_errors alanları listeler.Hayır — Argümanları düzeltin
TOOL_UNKNOWNBu isimde, bu bağlantıda bir araç bulunmamaktadır — aracı, bağlayıcının araç listesinden kullanın.Hayır
TOOL_NOT_ON_THIS_CONNECTORAraç PaperOffice'de mevcuttur ancak bu bağlayıcıda değildir. İpucu yolu gösterir: po_mcp_tools_call_read veya po_mcp_tools_call_write üzerinden /dms ve /cursor'e, aksi takdirde PaperOffice uygulamasına.Hayır — ipucunu takip edin
WORKSPACE_ACCESS_DENIEDBağlantının Workspace veya belgeye erişimi yoktur.Hayır
DOCUMENT_NOT_FOUNDBilinmeyen pofid veya documents_id.Hayır
CONFIRMATION_REQUIREDİşlem onay gerektirir — örneğin, 6 öğeden fazla olan toplu işlemler, paylaşım iptalleri veya bir yasal tutma kuralının kaldırılması. Etkilenen öğelerin önizlemesi dahildir; onaydan sonra çağrıyı confirm=true ile tekrarlayın.Kullanıcı onayladıktan sonra
APP_ONLY_ACTIONINSTANT_DELETE_APP_ONLYFOLDER_DELETE_NOT_ALLOWEDKesin adımlar yalnızca PaperOffice uygulamasında gerçekleştirilir: kalıcı silme, çöp kutusunu boşaltma, bir Workspace silme, çöp kutusundaki saklama süresini değiştirme veya tüm bir klasörü silme. MCP üzerinden silinen belgeler çöp kutusuna gider.Hayır — uygulamada gerçekleştirin
LEGAL_HOLD_ACTIVEUNDER_RETENTIONWORM_PROTECTEDBelge korunmaktadır; değişiklik reddedildi.Hayır
GROUP_RESTRICTIONToken'ın grubunda bu izin bulunmamaktadır, örneğin silme izni gibi.Hayır
PLAN_UPGRADE_REQUIREDBu özellik yalnızca daha yüksek bir planda mevcuttur; details.required_plan gerekli planı, details.plans_url ise uygulamanın tarifeler sayfasını belirtir.Hayır — yalnızca plan yükseltmesinden sonra
INSUFFICIENT_CREDITSCredits yetersiz (HTTP 402); hiçbir şey hesaplanmadı.Yükleme sonrasında
TASK_REQUIRES_APP_REVIEWCLAIM_SESSION_MISMATCHTASK_CLAIM_EXPIREDBir onay görevine ilişkin karar kaydedilemedi; ipucu bir sonraki adımı belirtir.İpuçunda açıklandığı gibi
TRANSLATION_IN_PROGRESSBilgi veritabanında bir çeviri işlemi devam etmektedir.Evet, yaklaşık 60 saniye sonra aynı argümanlarla
WRITE_OUTCOME_UNKNOWNBilgi veritabanına yapılan bir yazma işleminin zaman aşımı içinde yanıt alamaması nedeniyle muhtemelen kaydedilmiştir.Önce kontrol edip ardından tekrarlayın
TRANSIENT_TRANSPORT_ERRORArka uçta zaman aşımı (408) veya HTTP 429, 502, 503 veya 504; details.retryable true'dur, details.http_status nedeni gösterir ve suggested_backoff_ms 2000'dir.Evet, bekleme süresiyle birlikte
SESSION_BUSYACCOUNT_BUSYEşzamanlı çağrı sınırı aşıldı (Hız Sınırlamaları'na bakın); retry_safe true'dur ve retry_after_ms dahil edilmiştir.Evet, retry_after_ms süresinden sonra
MCP_MAINTENANCESunucu bakımı veya yeniden başlatma; retry_after_ms 2000'dir.Evet
SECRET_ARGUMENT_REJECTEDBir argüman bir erişim tarihi gibi görünüyordu; Araç argümanları belirteç veya şifre içeremez.Hayır
TOOL_ERRORBelirli bir kodun uymadığı genel bir geri dönüş.Mesaja bağlıdır

Hata değil: Bir dosya girişi eksikse, dosya tabanlı araçlar (çıkarma, PDF), FILE_UPLOAD_REQUIRED ile başlayan ve kabul edilen girişleri veya bir tarayıcı yükleme sayısını belirten normal bir metin sonucu döndürür.

Taşıma katmanında, eksik, geçersiz, süresi dolmuş veya iptal edilmiş bir belirteç için HTTP 401 ve bir WWW-Authenticate başlığı alınır (OAuth'u yeniden gerçekleştirin). Giriş veya araç kataloğu kısa süreli olarak erişilemez olduğunda, sunucu Retry-After (2–5 s) ile HTTP 503 yanıtı verir.

Hız Sınırlamaları ve Kontingantlar

  • Her MCP oturumu (Mcp-Session-Id) başına: aynı anda en fazla 8 araç çağrısı. Son sütunda 1 olan araçlar ardışık çalışır: İkinci eşzamanlı çağrı hemen SESSION_BUSY döndürür (yaklaşık 300 ms sonra yeniden deneyin, po_knowledge_graph_ask için 500 ms). Diğer araçlar en fazla 4 paralel çağrı ile çalışır ve boş bir yer için en fazla 15 s bekler.
  • Her oturumda erişim belirteci başına aynı anda en fazla 24 araç çağrısı (ACCOUNT_BUSY).
  • Her araç çağrısı için PaperOffice API POX kuralları geçer: Ücretsiz ve ziyaretçi belirteçleri saniyede en az 5, dakikada 30, saatte 100 ve günde 500 istek alır; plan değerleri daha yüksek olabilir. Kalan Credits ile sınırlı ücretli planlar, bakiyeyi sınırlar, istek hızını değil. Hız sınırına takılan çağrılar ücretlendirilmez; TRANSIENT_TRANSPORT_ERROR döndürür, details.http_status 429 ve mesajda bekleme süresi yer alır.
  • Zaman sınırları: Bir arka uç çağrısı 90 saniye sonra sonlandırılır (bilgi veritabanına yazma işlemleri WRITE_OUTCOME_UNKNOWN veya TRANSLATION_IN_PROGRESS döndürür, kör tekrar yerine); po_knowledge_graph_ask 120 saniye sonra durur.
  • Açıklamalarda belirtilen sınırlar: po_documents_upload_files çağrısı başına en fazla 10 dosya (yalnızca /chatgpt), birleştirme başına 2 veya daha fazla PDF, sayfa başına en fazla 500 arama sonucu, sayfa başına en fazla 200 Workspaces ve sayfa başına 10–200 çöp kutusu girişi. İndirme bağlantıları yaklaşık 10 dakika sonra süresi dolar ve devralınan görev 15 dakika boyunca kilitli kalır.
  • Faturalandırma: MCP çağrıları, REST API çağrıları gibi Credits üzerinden faturalandırılır. Açıklamasında "kredi gerektirir" veya "kredi kullanır" yazan araçlar AI işleme başlatır ve daha fazla Credits tüketir.

Araçlar

Altı aile, bir katalog

MCP araçları görevlere göre gruplandırılmıştır. İstemci bunları başlık ve kısa açıklamayla görür ve uygun aracı kendisi seçer.

  • Document AI

    Belgeler, OCR, IDP, arama, PDF işlemleri, imzalar ve AI DMS.

    document-ai
  • Workflow AI

    İş akışları, işler, görevler, HITL, onaylar ve süreç otomasyonu.

    workflow-ai
  • Relations AI

    CRM, Partner, Leads, Yardım Masası ve Terminler.

    relations-ai
  • Analytics AI

    Analitik, BI, Bilgi Grafiği, Varlıklar ve RAG.

    analytics-ai
  • Media AI

    Grafik Stüdyosu, TTS, STT ve Çeviri.

    media-ai
  • Veri AI

    Doğrulama, KDV, Para Birimi, Coğrafi Veriler ve Güvenlik Aramaları.

    data-ai

Kapsanan alanlar

  • Doküman Yönetimi Arama, okuma, yükleme, düzenleme, taşıma, kopyalama, silme
  • Akıllı Arama Tam metin, anlamsal benzerlik, gelişmiş arama, istatistikler
  • E-İmza İmza talepleri, şablonlar, doğrulama, mobil bağlantılar
  • AI İşleme AI-OCR, Belge analizi, PII algılama, anonimleştirme
  • Belge Zekası Varlıklar, ilişkiler, özetler, meta alanlar, gömümler
  • Analizler Trendler, finans, ısı haritaları, denetim merkezi
  • Knowledge Graph İş vakaları, zaman çizelgeleri, referanslar, ilişkiler
  • CRM Zekası Hesaplar, adaylar, fırsatlar, duygu analizi
  • İş Zekası Gösterge panoları, alan analizi, Workspace metrikleri
  • Webhooks ve Olaylar Abone olun, test edin, yönetin, İş Abonelikleri
  • Notlar, Etiketler ve Yorumlar Metin yorumları ve notlar — oluşturun, listeleyin, çözün, silin
  • Sürümleme ve Denetim Revizyonlar, Yasal Koruma, Denetim İzleri

Örnekler

Ne söylerseniz — hangi araç çalışır

Dört günlük cümle ve bunlar için istemci tarafından çağrılan MCP aracı. İzinler sohbetinizden değil, Workspace hesabınızdan gelir.

  • Ekli faturadaki tüm verileri çıkarın.

    MCP aracı po_aiocr_analyze

    Fatura analiz edildi — çıkarılan veriler:

  • Bu belgeyi 'Fatura-2026-0042' olarak yeniden adlandırın.

    MCP aracı po_documents_rename

    Belge yeniden adlandırıldı:

  • Sayfa 2'ye bir inceleme yorumu ekleyin.

    MCP aracı po_documents_comments_create

    Yorum oluşturuldu:

  • Doküman hacmimiz nasıl gelişti?

    MCP aracı po_analytics_trends_get

    Son 6 ayın trend analizi:

Öne Çıkanlar

MCP Sunucusunun Önemli Özellikleri

MCP sunucusu REST API'nin üzerine bir sarmalayıcı değildir — hesabınızın izinleri, Workspaces ve kredileri ile aynı çekirdektir.

  • OAuth 2.1 ve Kullanıcı Tokeni

    Claude, ChatGPT ve Grok için OAuth; Cursor için kullanıcı tokeni (po_ut_ / po_gt_) — po_sk_ engellenmiştir.

  • Gömme ile Hibrit Arama

    PaperOffice gömme ve tam metin birlikte çalışarak istemcinin uygun aracı bulmasını sağlar.

  • Dosya Ön Hazırlama ve Yükleme

    Ön imzalı yükleme URL'leri — sohbette Base64 yok.

  • Knowledge Graph

    Doğal dil ile İş Senaryoları, Zaman Çizelgeleri ve Belge İlişkileri.

  • Analitik ve BI

    Trendler, finans, ısı haritaları ve talep üzerine Workspace metrikleri.

  • AB İşleme

    Kendi AB altyapımızda işleme — uygulamada olduğu gibi aynı izinler ve Workspaces.

Kullanım Senaryoları

PaperOffice MCP'u 30 saniyede görün

Claude ile dört gerçek iş akışı — her biri kısa bir videoya sahip. Aşağıda bağlantılı derinlemesine makaleler.

Sıkça Sorulan Sorular

PaperOffice MCP Sunucusu hakkında her şey

MCP Sunucusu nasıl kimlik doğrulaması yapar?
Claude, ChatGPT ve Grok OAuth 2.1 ile başlar. Alternatif olarak kullanıcı veya grup belirteci (po_ut_ / po_gt_) — po_sk_ ve po_pk_ MCP için engellenmiştir.
MCP üzerinden kullanım ne kadar maliyetlidir?
MCP çağrıları, REST-API gibi Credits düşer. Bakiye ve kullanım faturalandırma uç noktaları üzerinden sorgulanabilir.
Hangi uç nokta hangi araçları sunar?
/mcp, hafif IDE setidir. /dms ve /cursor, Capture, Workflow ve TTS dahil olmak üzere Document Operations'ı paylaşır. /claude, TTS olmadan Directory'dir. /chatgpt (takma ad: /openai), ChatGPT için kurgulanmış bir araç seti listeler; /grok ve /muse, yalnızca ChatGPT için mevcut olan ek yükleme hariç tutulan aynı araçları listeler. Bu sayfadaki araç referansı, her kurgulanmış aracı Okuma, Yazma veya Hassas Yazma olarak işaretler.
OAuth 2.1 destekleniyor mu?
Evet. OAuth 2.1 ilk bağlantı sırasında başlar. Alternatif olarak bir kullanıcı veya grup belirteci (po_ut_ / po_gt_) — po_sk_ ve po_pk_ MCP için engellenmiştir.
Bir MCP-native AI-DMS nedir?
Yetenekleri Model Context Protocol aracılığıyla yerel olarak erişilebilen bir AI-DMS — uygulamada olduğu gibi aynı izinler ve Workspaces.
Hangi istemciler destekleniyor?
Claude, ChatGPT, Grok, Cursor ve Headless-DMS profilleri dahil — bağlantı sayfalarına bakın.
Bağlantı ne kadar hızlıdır?
Birkaç dakika içinde: İlk bağlantıda OAuth 2.1 veya bir kullanıcı/grup belirteci (po_ut_ / po_gt_), ardından araçları serbest bırakın. po_sk_ MCP için engellenmiştir.
Profiller birbirinden farklı mı?
Evet — aracın kapsamı uç noktaya bağlıdır. Bir çağrının ne yapabileceği, bağlanan kullanıcının yetkileri tarafından belirlenir; bir grup belirteci (po_gt_), kullanıcı grubunun sahip olduğu yetkilere tam olarak sahiptir.
Dokümantasyon nerede bulunur?
Developer-MCP dokümantasyonunda, llms.txt'de ve Live-Postman Koleksiyonunda.
AB barındırma seçeneği var mı?
Evet — PaperOffice AB altyapısında işleme.

PaperOffice AI · Problem Solver

Bize anlatın, sizin için günlük olarak ne kadar zaman kaybına neden oluyor.

Basitçe açıklayın. Teknik terimlere gerek yok.

Veya bir örnek ile başlayın

PaperOffice’i nasıl kullanmak istersiniz?

Bilgisayar ve akıllı telefon bağlı: Bilgisayarda çalışma alanı, telefonda yakalama.

Nerede başlamak istersiniz?

Tam çalışma alanı bilgisayar için optimize edilmiştir. Mobil sürüm belgeleri yakalamak, incelemek ve onaylamak için uygundur.

Ücretsiz kayıt app.paperoffice.ai

Bilgisayarda başla

Kişisel erişim bağlantısını e-posta adresinize göndereceğiz.

PaperOffice Mobile'ı aç

Belgeleri doğrudan akıllı telefonla yakalayın ve düzenleyin.

Mobil sürümü aç