انتقل إلى المحتوى
أسئلة؟PaperOffice AI Phone Agent 24/7+49 69 3487102-0
نظرة عامة نظرة عامة أخبار أخبار
مشاركة

خادم MCP

حساب واحد. أكثر من 300 أداة MCP. مباشرة داخل أداة الدردشة.

يجلب خادم PaperOffice MCP المستندات والبحث وسير العمل والتحليلات إلى Claude وChatGPT وCursor.

اختيار أداة الدردشة. يوضح الدليل كل نقرة — OAuth 2.1، بدون تثبيت.

اختيار أداة دردشة بدء أول استدعاء لـ API
OAuth 2.1 عند الاتصال الأول خادم عنيف بدون تثبيت المعالجة في الاتحاد الأوروبي
حساب واحد. أكثر من 300 أداة MCP. مباشرة داخل أداة الدردشة.

بداية سريعة

اختيار أداة دردشة

يوضح الدليل كل نقرة في Claude وChatGPT أو Cursor. أدناه يوجد فقط القطعة البرمجية للنسخ.

الرمز البرمجي للنسخ

Claude سطح المكتب / Claude Code

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

عنوان URL لمجلد Claude — عمليات المستندات بدون تحويل النص إلى كلام (TTS). أضف /claude؛ لا يوجد رمز Bearer في القطعة البرمجية.

إعداد Claude إنشاء رمز المستخدم 300+ الأدوات جاهزة

نقاط النهاية

نسخ عنوان URL لعميل الذكاء الاصطناعي الخاص بكم

كل ملف تعريف يشير إلى نفس الخادم — لا يختلف إلا في نطاق الأدوات. أي URL يناسب أي غرض، موجود في الجدول أدناه.

  • DMS /dms

    عمليات المستندات — نفس الكتالوج الموجود على /dms و /cursor. العنوان الأساسي.

    https://mcp.paperoffice.ai/dms
  • Claude /claude

    دليل: عمليات المستندات بدون تحويل النص إلى كلام — رابط دليل Claude.

    https://mcp.paperoffice.ai/claude
  • ChatGPT /chatgpt

    موصل ChatGPT — مجموعة أدوات مختارة بعناية لوثائق الأعمال (الفواتير، العقود، إشعارات التسليم، الإيصالات) ومقالات قاعدة المعرفة، يتم سرد كل أداة على حدة. بدون تحويل النص إلى كلام ودون إلغاء القفل Workspace. الاسم المستعار: /openai.

    https://mcp.paperoffice.ai/chatgpt

    Alias: https://mcp.paperoffice.ai/openai

  • Cursor /cursor

    نفس كتالوج عمليات المستندات الموجود على /dms (بما في ذلك تحويل النص إلى كلام).

    https://mcp.paperoffice.ai/cursor
  • Meta Muse /muse

    موصل Meta-Muse — نفس الأدوات المختارة مثل /chatgpt، دون أداة تحميل المرفقات المتاحة فقط لـ ChatGPT. يتم سرد كل أداة بشكل فردي.

    https://mcp.paperoffice.ai/muse
  • خفيف /mcp

    مجموعة IDE خفيفة — ليس كتالوج عمليات المستندات على /cursor.

    https://mcp.paperoffice.ai/mcp
  • كامل /mcp-full

    جميع أدوات MCP (أكثر من 300 أداة) لسير العمل المتقدم.

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

/openai يبقى متاحًا كاسم مستعار لـ /chatgpt. المسارات غير النشطة للوحدة النمطية ترد بـ HTTP 410.

مصفوفة القدرات

أي عنوان URL يناسب؟

صف واحد لكل وظيفة: عنوان URL الموصى به والسبب وراء ذلك. هذا الجدول هو قائمة المسارات الكاملة الوحيدة في هذه الصفحة.

المهمة URL الموصى به السبب
عمليات المستندات (كانوني) /dms عمليات المستندات (أكثر من 300 أداة MCP) — نفس الكتالوج الموجود على /dms و /cursor.
Claude سطح المكتب / Claude الكود (URL الدليل) /claude الدليل: عمليات المستندات بدون TTS. العناوين والملاحظات في كل أداة.
Cursor بيئة التطوير المتكاملة أثناء البرمجة /cursor نفس كتالوج عمليات المستندات مثل /dms (بما في ذلك TTS).
ChatGPT-موصل /chatgpt موصل ChatGPT — أدوات مختارة لوثائق الأعمال ومقالات قاعدة المعرفة، يتم سرد كل منها على حدة (انظر مرجع الأدوات). الاسم المستعار: /openai.
موصل Meta-Muse /muse مجموعة /chatgpt بدون رفع المرفقات الحصرية لـ ChatGPT، مع ذكر كل أداة في مرجع الأدوات.
مجموعة IDE خفيفة /mcp مجموعة مكثفة للبحث والقراءة والتحليل، بالإضافة إلى رفع الملفات ومقالات قاعدة المعرفة — وليست كتالوج عمليات المستندات.
مهام متعددة الخطوات معقدة po_agents_ask في /mcp-full يبقى وكيل Host-LLM على السطح الكامل، وليس على /dms.
الهجرة / جميع أدوات MCP /mcp-full واجهة MCP الكاملة (أكثر من 300 أداة) لتصحيح الأخطاء والوكلاء التقليديين.

تحويل إعدادات MCP القديمة

المسارات القديمة للوحدة النمطية ترد بـ HTTP 410. استخدم /dms لعمليات المستندات.

  • استخدام /dms كعنوان أساسي لعمليات المستندات. تشترك /cursor في هذا الكتالوج (بما في ذلك تحويل النص إلى كلام).
  • المسارات القديمة للوحدة النمطية ترد الآن بـ HTTP 410 — انتقل إلى /dms أو /mcp.
  • استخدموا /mcp لمجموعة IDE المصغرة — /cursor يمثل عمليات المستندات الكاملة، نفسها مثل /dms.
  • استخدموا /chatgpt لـ ChatGPT (الاسم المستعار /openai). يدرج مجموعة أدوات مختارة بشكل فردي — بدون اكتشاف أو أدوات تنفيذ عامة، ولا تحويل النص إلى كلام، ولا أدوات OTP أو فك القفل.
  • احتفظ بـ /mcp-full للمستخدمين المتقدمين ووسائط/إدارة علاقات العملاء CRM فقط.
  • استخدم /muse لـ Meta Muse (الأدوات المختارة من /chatgpt بدون رفع المرفقات الحصرية لـ ChatGPT).

مرجع الأدوات

كل أدوات موصلات ChatGPT وMeta Muse

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

يتطلب كل أداة مصادقة OAuth 2.1 مع PKCE (النطاق mcp:tools) أو رمز مستخدم أو مجموعة PaperOffice (po_ut_ / po_gt_)؛ يتم رفض الرموز po_sk_ و po_pk_. يعمل الاستدعاء بصلاحيات المستخدم المتصل PaperOffice، ويتم التحقق من حججه مسبقاً ضد مخطط الإدخال المنشور قبل التنفيذ.

التصنيف

MCP. تحمل كل أداة التعليقات التوضيحية readOnlyHint و destructiveHint و idempotentHint و openWorldHint. يلخص التصنيف ما يترتب على الاستدعاء من آثار:

  • قراءةيقرأ البيانات ولا يقوم بأي تغييرات (readOnlyHint صحيح).
  • كتابةينشئ أو يعدل البيانات في حساب المستخدم PaperOffice، على سبيل المثال عند الحفظ، الإنشاء، الاستخراج، التحويل، النقل، النسخ، وضع العلامات أو استعادة المستندات.
  • كتابة حساسةتحذف البيانات (تنتهي المستندات في سلة المحذوفات) أو تكتب فوقها، وتتخذ قراراً نهائياً بشأن مهمة مشاركة، أو يمكنها إشعار شخص آخر، أو نشر محتوى في قاعدة معرفة عامة. يجب على العملاء الحصول على تأكيد المستخدم قبل استدعاء هذه الأدوات.

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

أدوات MCP المختارة بعناية مع العلامات، المدخلات، المخرجات والآثار الجانبية، بالإضافة إلى المكالمات المتوازية لكل جلسة
الأداةالعلامةيُستخدم عندالمدخلاتالمخرجات والآثار الجانبيةالمكالمات المتوازية لكل جلسة
po_workspaces_listList workspacesقراءةThe user names a workspace or asks which workspaces exist, or a workspace_id is needed.اختياريlimitoffsetsearchworkspace_idLists ID, name and document count. Locked workspaces are unlocked only in the PaperOffice app.4
po_documents_getGet document detailsقراءةThe user wants details of one document: type, sender, amounts, dates, summary, processing status. Stored data only; to extract invoice data use po_extraction_invoice.أحدهاpofiddocuments_idاختياريresolvecompactلا توجد آثار جانبية.4
po_extraction_invoiceExtract invoice dataكتابةThe user asks to extract invoice data (supplier, number, dates, line items, VAT, total). Not for personal ID numbers.أحدهاpofidfile_urlupload_idاختياريmodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_job_getGet job statusقراءةAn extraction or PDF tool returned a job_id.مطلوبjob_idReturns status and, once completed, the result. Poll until completed; stop if it failed.4
po_analytics_financial_summary_getSummarize document amountsقراءةThe user asks for totals or a summary of invoice amounts across documents, e.g. by currency.اختياريperiodworkspace_idSums extracted amounts of all documents (not only invoices) per currency, never mixing currencies.4
po_documents_create_from_contentCreate PDF from textكتابةThe user asks to create or write a PDF or document (notes, letter, report).مطلوبcontenttitleworkspace_idاختياري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 documentكتابة حساسةThe user wants to rename a document or change its file name.مطلوبnew_file_nameأحدهاpofiddocuments_idOverwrites the file name; the original extension (e.g. .pdf) is kept.1
po_documents_text_getRead document textقراءةThe user needs the full text or exact wording of a document.أحدهاpofiddocuments_idReturns its OCR text (only after processing); emails, phone and ID numbers are masked where detected.4
po_documents_creator_agents_listList Creator AgentsقراءةThe user wants a quote, letter or certificate on their own template, or asks which Creator Agents exist.لا شيءLists active agents (agent_id, name, template); then use po_documents_creator_agent_preview.4
po_documents_creator_agent_previewPreview agent documentكتابةThe user asks a Creator Agent to draft a document, e.g. a quote.مطلوبagent_idpromptاختياري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 documentكتابةThe user approved a Creator Agent preview and wants the document.مطلوبagent_idpreview_tokenconfirmاختياري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 attachmentsفقط /chatgptكتابةThe user wants to store files they attached in this chat. To create a PDF from text use po_documents_create_from_content.مطلوبfilesاختياريworkspace_idai_dms_tieron_duplicateOne result per file; retries never store twice; workspace auto-processing may apply. If ChatGPT cannot pass an attachment to this tool (for example BLOCKED_FILE_REFERENCE), call it with files: [] to receive upload_url.1
po_knowledge_graph_askAsk across documentsقراءةA question spans many documents, e.g. which contracts have a termination clause. Best effort; not for knowledge base articles (po_knowledge_search) or totals (po_analytics_financial_summary_get).مطلوبquestionاختياريpofidsearch_scopeworkspace_idworkspace_idsperiodلا توجد آثار جانبية.1
po_knowledge_get_articleRead knowledge articleقراءةThe user wants to read one knowledge base article in full, e.g. after a search hit.مطلوبidاختياريlanguageReturns its title, text and summary in each language.4
po_analytics_financial_overdue_getList overdue invoicesقراءةThe user asks which invoices are overdue.اختياري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 processingكتابة حساسةA stored document needs OCR and AI analysis, e.g. it has no text yet.مطلوبai_dms_tierأحدهاpofiddocuments_idاختياريconfirm_reprocessconfirm_tier_downgradeRuns in the background, costs credits; track via po_documents_get. Re-processing replaces the old analysis.1
po_documents_downloadGet download linkقراءةThe user wants to download or save a document's file, e.g. the PDF.أحدهاpofiddocuments_idReturns a temporary link to the stored file, valid for about 10 minutes.4
po_documents_update_indexUpdate index fieldsكتابة حساسةThe user wants to set or correct document metadata (index fields), e.g. document_type, sender_name, invoice_number, due_date, total_amount or currency.مطلوبfieldsأحدهاpofiddocuments_idاختياريidempotency_keyOnly the given fields are overwritten.1
po_documents_uploadUpload document from URLكتابةThe user gives a public file URL to store, or wants a browser upload page (omit file_url).اختياريupload_idfile_urlfile_nameworkspace_idai_dms_tierStores a new document; workspace auto-processing may apply.1
po_extraction_receiptExtract receipt dataكتابةThe user asks to extract receipt data (merchant, date, items, tax, total), e.g. for expenses.أحدهاpofidfile_urlupload_idاختياريmodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_extraction_delivery_noteExtract delivery note dataكتابةThe user asks to extract delivery note data (shipper, recipient, items, quantities, delivery date).أحدهاpofidfile_urlupload_idاختياريmodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_extraction_purchase_orderExtract purchase order dataكتابةThe user asks to extract purchase order data (order number, vendor, buyer, items, delivery date, total).أحدهاpofidfile_urlupload_idاختياريmodelidp_fieldsRuns a new extraction job (uses credits); poll po_job_get.1
po_tasks_list_my_tasksList my tasksقراءةThe user asks about their tasks or pending approvals.اختياريstatusprioritystep_typelimitoffsetLists tasks assigned to them, their role or group (default: open) with ID, status, priority and due date.4
po_tasks_get_task_detailsGet task detailsقراءةThe user asks what a specific task or approval is about.مطلوبtask_idاختياريinclude_interactionReturns description, status, due date, history and whether completing needs an approve decision.4
po_tasks_claim_taskClaim taskكتابة حساسةThe 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.مطلوبtask_idLocks it to them for 15 minutes and may notify the assignee.1
po_tasks_complete_taskComplete taskكتابة حساسةThe user approves a task or marks it done.مطلوبtask_idاختياري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 taskكتابة حساسةThe user rejects or declines a task or approval.مطلوبtask_idreasonاختياري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 documentكتابةThe user wants to move a document to another workspace.مطلوبtarget_workspace_idأحدهاpofiddocuments_idاختياريconfirmAll its versions move along and keep their pofids. Documents under retention or legal hold cannot be moved.1
po_documents_copyCopy documentكتابةThe user wants to copy or duplicate a document into a workspace.مطلوبtarget_workspace_idأحدهاpofiddocuments_idاختياريnew_file_nameEach call creates a new copy with its own pofid; a target workspace with automatic AI processing processes it, which costs credits.1
po_documents_tags_listList document tagsقراءةThe user asks which tags or labels a document has.أحدهاpofiddocuments_idReturns tag names and colors.4
po_documents_tags_createAdd document tagكتابةThe user wants to tag or label a document.مطلوبtag_nameأحدهاpofiddocuments_idاختياريtag_colorAdds one tag per call; a tag the document already has is rejected.1
po_documents_folders_listList document foldersقراءةThe user asks for document folders, i.e. bundles of related documents, in a workspace.مطلوبworkspace_idLists folders only; po_documents_search lists documents.4
po_documents_folders_createCreate document folderكتابةThe 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.مطلوبpofidsاختياريfolder_namefolder_descriptionA document can be in only one folder.1
po_vat_validateValidate EU VAT IDقراءةThe user wants to check if a company's EU VAT ID is valid.مطلوبvat_idChecks EU VIES or a recent cached result (check date returned); returns validity and, if disclosed, company name and address.4
po_currency_convertConvert currencyقراءةThe user asks to convert an amount to another currency.مطلوبfromtoاختياريamountUses the latest available rate (rate date returned); no historical rates.4
po_pdfstudio_mergeMerge PDFsكتابةThe user wants to merge or combine two or more PDF documents into one file.أحدهاpofidsfile_urlsاختياريorderoutput_filenameStarts a job; po_job_get returns the download link.1
po_pdfstudio_splitSplit PDFكتابةThe user wants to split a PDF into single pages or page ranges.أحدهاpofidfile_urlupload_idاختياريmodesplitsoutput_prefixStarts a job; po_job_get returns the download link(s).1
po_pdfstudio_compressCompress PDFكتابةThe user wants to compress a PDF or reduce its file size.أحدهاpofidfile_urlupload_idاختياريqualityremove_metadataStarts a job; po_job_get returns the download link.1
po_dataripper_office2pdfConvert Office to PDFكتابةThe user wants to convert a Word, Excel or PowerPoint file to PDF.أحدها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 versionsقراءةThe user asks for earlier versions or the version history of a document.مطلوبpofidاختياريinclude_trashedReturns its versions with number, pofid, date, comment and which is current.4
po_documents_audit_trail_getGet change historyقراءةThe user asks what changed in a document or workspace, or for an audit trail or change log.اختياريpofiddocuments_idactionworkspace_idlimitoffsetOnly revision-secure documents log changes; returns the latest entries with action, field, old and new value.4
po_documents_trash_listList recycle binقراءةThe user asks what is in the recycle bin or trash, or looks for a deleted document.اختياريworkspace_idpageper_pageReturns deleted documents (newest first, 50 per page) with pofid and days left before permanent deletion.4
po_documents_restoreRestore documentكتابةThe user wants to restore or undelete a document from the recycle bin.أحدهاpofiddocuments_idاختياري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 documentكتابة حساسةThe user wants to delete a document and all its versions (not a tag or folder entry).أحدهاpofiddocuments_idاختياريconfirmPermanent in standard workspaces, recycle bin in business and compliance ones. Retention or legal hold blocks it.1
po_knowledge_list_basesList knowledge basesقراءةThe user asks which knowledge bases they have or a knowledge base ID is needed.اختياريinclude_archivedReturns ID, name, visibility and languages of each active knowledge base.4
po_knowledge_list_articlesList knowledge articlesقراءةThe user wants to browse or list the articles of a knowledge base instead of searching.اختياريkb_idpagelimitcategory_idlanguagesearchReturns articles (50 per page) with IDs, titles, status and content.4
po_knowledge_categoriesList knowledge categoriesقراءةThe user asks which categories their knowledge base articles are sorted into.اختياريkb_idlanguageReturns each category's ID, name and article count.4
po_knowledge_get_baseGet knowledge baseقراءةThe user asks about one knowledge base's settings, visibility or languages.مطلوبidReturns its details with article and category counts.4
po_knowledge_add_articleCreate knowledge articleكتابة حساسةThe user asks to add or write a new knowledge base article.مطلوبkb_idtitlecontentlanguageاختياريcategory_idtypeSaves it and indexes it for search; in a public knowledge base it is published at once.1
po_knowledge_update_articleUpdate knowledge articleكتابة حساسةThe user asks to edit or rewrite a knowledge base article.مطلوبidlanguageأحدها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 articleكتابة حساسةThe user asks to translate a knowledge base article.مطلوبidtarget_languageاختياري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 baseكتابة حساسةThe user asks to create a new knowledge base for help articles.مطلوبnameاختياري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 baseكتابة حساسةThe user asks to rename a knowledge base, change its description or make it public or internal.مطلوبidأحدهاnamedescriptionvisibilityprimary_languageenabled_languagesOverwrites the given fields; public puts its published articles online, internal takes them offline.1
po_knowledge_delete_articleDelete knowledge articleكتابة حساسةThe user asks to delete a knowledge base article.مطلوبidPermanently removes it in all languages, also from search and the help center; cannot be undone.1

مرر مؤشر الفأرة فوق اسم الإدخال لعرض النوع والوصف. يعرض العمود الأخير عدد المكالمات التي يمكن أن يعمل فيها أداة معينة بشكل متزامن في جلسة MCP واحدة.

خطأ

يُرجع خطأ الأداة نتيجة أداة MCP مع isError: true. يتوفر نفس كائن JSON في structuredContent وفي كتلة المحتوى النصي الأولى:

{
  "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
رمز مستقر وقابل للقراءة آلياً. يتم عكس قيمته في code و details.error_code لأن بعض العملاء قد يعيدون كتابة error_code.
message
شرح موجه للبشر.
details
سياق إضافي مثل http_status، retryable / retry_safe، suggested_backoff_ms، validation_errors أو المعرفات المرسلة.
hint
الخطوة التالية، مصاغة للنموذج.
retryablehttp_status
حقول اختيارية على المستوى العلوي مُعلنة في مخططات الإخراج.
الرمزالمعنىإعادة المحاولة؟
INVALID_PARAMSلم تمر الحجج بفحص المخطط؛ يشير details.validation_errors إلى الحقول المعنية.لا — تصحيح الحجج
TOOL_UNKNOWNلا توجد أداة بهذا الاسم على هذا الاتصال؛ يرجى استخدام الاسم الموجود في قائمة أدوات الموصل (Connector).لا
TOOL_NOT_ON_THIS_CONNECTORتوجد الأداة في PaperOffice، ولكن ليس على هذا الموصل. يشير التلميح إلى المسار: عبر /dms و /cursor باستخدام po_mcp_tools_call_read أو po_mcp_tools_call_write، أو خلاف ذلك عبر تطبيق PaperOffice.لا — اتبع التلميح
WORKSPACE_ACCESS_DENIEDليس للاتصال حق الوصول إلى Workspace أو المستند.لا
DOCUMENT_NOT_FOUNDمعرف pofid أو documents_id غير معروف.لا
CONFIRMATION_REQUIREDتتطلب العملية تأكيداً، مثل الإجراءات الجماعية التي تبدأ من 6 عناصر، أو إلغاء المشاركة، أو رفع الحجز القانوني. تتضمن معاينة للعناصر المتأثرة؛ بعد التأكيد، يرجى إعادة استدعاء الأمر باستخدام confirm=true.بعد تأكيد المستخدم
APP_ONLY_ACTIONINSTANT_DELETE_APP_ONLYFOLDER_DELETE_NOT_ALLOWEDالخطوات النهائية تتم فقط في تطبيق PaperOffice: الحذف النهائي، تفريغ سلة المحذوفات، حذف Workspace، تغيير الاحتفاظ في سلة المحذوفات، أو حذف مجلد كامل. تنتهي المستندات المحذوفة عبر MCP في سلة المحذوفات.لا — قم بإنجازها في التطبيق
LEGAL_HOLD_ACTIVEUNDER_RETENTIONWORM_PROTECTEDالمستند محمي؛ تم رفض التغيير.لا
GROUP_RESTRICTIONتفتقر مجموعة الرمز المميز (Token) إلى هذا الصلاحية، على سبيل المثال لحذف المستند.لا
PLAN_UPGRADE_REQUIREDهذه الميزة متاحة فقط في الخطط الأعلى؛ يحدد الحقل details.required_plan الخطة المطلوبة، بينما يشير details.plans_url إلى صفحة الأسعار الخاصة بالتطبيق.لا — بعد ترقية الخطة فقط
INSUFFICIENT_CREDITSرصيد غير كافٍ من Credits (HTTP 402); لم يتم احتساب أي رسوم.بعد الشحن
TASK_REQUIRES_APP_REVIEWCLAIM_SESSION_MISMATCHTASK_CLAIM_EXPIREDلم يتم حفظ قرار مهمة الموافقة؛ يشير التلميح إلى الخطوة التالية.كما هو موضح في التلميح
TRANSLATION_IN_PROGRESSترجمة قيد التنفيذ في قاعدة المعرفة.نعم، بعد حوالي 60 ثانية بنفس المعاملات
WRITE_OUTCOME_UNKNOWNلم يتلقَ عملية الكتابة في قاعدة المعرفة ردًا ضمن المهلة الزمنية؛ ومن المرجح أنه تم الحفظ.التحقق أولاً، ثم إعادة المحاولة
TRANSIENT_TRANSPORT_ERRORانتهت المهلة في الخلفية (408) أو HTTP 429، 502، 503 أو 504؛ قيمة details.retryable هي true، وdetails.suggested_backoff_ms هي 2000، وتوضح details.http_status السبب.نعم، مع انتظار مؤقت
SESSION_BUSYACCOUNT_BUSYتم الوصول إلى حد للمكالمات المتزامنة (انظر حدود المعدل)؛ قيمة retry_safe هي true، وقيمة retry_after_ms موجودة.نعم، بعد مرور retry_after_ms
MCP_MAINTENANCEصيانة أو إعادة تشغيل الخادم؛ retry_after_ms يساوي 2000.نعم
SECRET_ARGUMENT_REJECTEDبدت حجة ما وكأنها تاريخ وصول؛ لا يجوز أن تحتوي حجج الأدوات على رموز أو كلمات مرور.لا
TOOL_ERRORخطأ عام يحدث عندما لا ينطبق رمز محدد.يعتمد على الرسالة

ليس خطأً: إذا كانت مدخلات الملفات مفقودة، تُرجع الأدوات القائمة على الملفات (الاستخراج، PDF) نتيجة نصية عادية تبدأ بـ FILE_UPLOAD_REQUIRED وتذكر المدخلات المقبولة أو صفحة تحميل المتصفح.

على مستوى النقل، يحصل المصادق غير الموجود أو غير الصالح أو المنتهي أو الملغي على استجابة HTTP 401 مع رأس WWW-Authenticate (إعادة إجراء OAuth). طالما أن تسجيل الدخول أو كتالوج الأدوات غير متاحين مؤقتاً، يرد الخادم باستجابة HTTP 503 مع Retry-After (2–5 ثوانٍ).

حدود المعدلات والحصص

  • لكل جلسة MCP (Mcp-Session-Id): ما يصل إلى 8 استدعاء أداة في وقت واحد. تعمل الأدوات التي تحمل الرقم 1 في العمود الأخير بشكل متسلسل: يؤدي الاستدعاء المتزامن الثاني فوراً إلى SESSION_BUSY (إعادة المحاولة بعد حوالي 300 مللي ثانية، وبعد 500 مللي ثانية بالنسبة لـ po_knowledge_graph_ask). تعمل الأدوات الأخرى بحد أقصى 4 استدعاءات متوازية وتنتظر حتى 15 ثوانٍ للحصول على مكان متاح.
  • بالنسبة لكل رمز وصول: الحد الأقصى لعدد استدعاءات الأدوات المتزامنة عبر جميع الجلسات هو 24 (حالة ACCOUNT_BUSY).
  • تخضع كل استدعاءة أداة لحدود الطلب الخاصة بـ PaperOffice API: تحصل رموز الزوار والرموز المجانية على حد أدنى قدره 5 طلبات في الثانية، و30 في الدقيقة، و100 في الساعة، و500 في اليوم؛ وقد تكون قيم الخطط أعلى. الخطط المدفوعة المتبقية Credits تقيد الرصيد ولا تقيد معدل الطلب. لا تُحسب الاستدعاءات المقيدة بالسرعة؛ بل تعيد خطأ TRANSIENT_TRANSPORT_ERROR مع تفاصيل http_status 429 ووقت الانتظار في الرسالة.
  • حدود الوقت: يتم إلغاء استدعاء الخادم الخلفي بعد 90 ثانية (تُرجع عمليات الكتابة في قاعدة المعرفة WRITE_OUTCOME_UNKNOWN أو TRANSLATION_IN_PROGRESS بدلاً من إعادة المحاولة بشكل أعمى); يتوقف po_knowledge_graph_ask بعد 120 ثانية.
  • الحدود المذكورة في وصف الأدوات: حتى 10 ملفات لكل استدعاء لـ po_documents_upload_files (فقط /chatgpt)، ملفان PDF أو أكثر لكل دمج، حتى 500 نتيجة بحث لكل صفحة، حتى 200 Workspaces لكل صفحة، و10-200 عنصر في سلة المهملات لكل صفحة. تنتهي صلاحية روابط التنزيل بعد حوالي 10 دقائق، وتبقى المهمة المستلمة مقفلة لمدة 15 دقيقة.
  • الفوترة: تُحسب استدعاءات MCP كاستدعاءات لـ REST API في Credits. الأدوات التي يذكر وصفها أنها "تستهدي ائتمانات" أو "تستخدم ائتمانات" تبدأ معالجة الذكاء الاصطناعي وتستهلك المزيد من Credits.

أدوات

ست عائلات، كتالوج واحد

تم تجميع أدوات MCP حسب المهام. يرى العميل هذه الأدوات مع العنوان والوصف المختصر ويختار الأداة المناسبة بنفسه.

  • Document AI

    المستندات، OCR، IDP، البحث، عمليات PDF، التوقيعات و DMS بالذكاء الاصطناعي.

    document-ai

  • Workflow AI

    سير العمل، المهام، الوظائف، HITL، الموافقات وأتمتة العمليات.

    workflow-ai

  • Relations AI

    إدارة علاقات العملاء، الشركاء، الفرص، خدمة العملاء والمواعيد.

    relations-ai

  • Analytics AI

    التحليلات، ذكاء الأعمال، رسم المعرفة الكائنات وRAG.

    analytics-ai

  • Media AI

    استوديو الصور، تحويل النص إلى كلام (TTS)، تحويل الكلام إلى نص (STT) والترجمة.

    media-ai

  • الذكاء الاصطناعي للبيانات

    التحقق، ضريبة القيمة المضافة، العملات، البيانات الجغرافية وعمليات البحث الأمني.

    data-ai

المناطق المغطاة

  • إدارة المستندات البحث، القراءة، الرفع، التعديل، النقل، النسخ، الحذف
  • البحث الذكي النص الكامل، التشابه الدلالي، البحث المتقدم، الإحصائيات
  • التوقيع الإلكتروني طلبات التوقيع، القوالب، التحقق، الروابط المتنقلة
  • المعالجة بالذكاء الاصطناعي AI-OCR، تحليل المستندات، اكتشاف المعلومات الشخصية، إخفاء الهوية
  • ذكاء المستندات الكيانات، العلاقات، الملخصات، الحقول الوصفية، التضمينات
  • التحليلات الاتجاهات، المالية، الخرائط الحرارية، مركز التدقيق
  • Knowledge Graph حالات الأعمال، الخطوط الزمنية، المراجع، العلاقات
  • ذكاء إدارة علاقات العملاء الحسابات، العملاء المحتملون، الفرص، المشاعر
  • ذكاء الأعمال لوحات المعلومات، تحليل الحقول، مقاييس Workspace
  • Webhooks والأحداث الاشتراك، الاختبار، الإدارة، اشتراكات الوظائف
  • الملاحظات والعلامات والتعليقات تعليقات نصية وملاحظات — إنشاء، عرض القائمة، الحل، الحذف
  • الإصدار والتدقيق المراجعات، الاحتفاظ القانوني، سجل التدقيق

أمثلة

ما تقوله — أي أداة تعمل

أربع جمل يومية والأداة MCP التي يستدعيها العميل لها. تأتي الأذونات من Workspace الخاص بك، وليس من الدردشة.

  • استخرج جميع البيانات من الفاتورة المرفقة.

    أداة MCP po_aiocr_analyze

    تم تحليل الفاتورة — البيانات المستخرجة:

  • أعد تسمية هذا المستند إلى فاتورة-2026-0042.

    أداة MCP po_documents_rename

    تم إعادة تسمية المستند:

  • إضافة تعليق مراجعة في الصفحة 2.

    أداة MCP po_documents_comments_create

    تم إنشاء التعليق:

  • كيف تطور حجم مستنداتنا؟

    أداة MCP po_analytics_trends_get

    تحليل الاتجاه لآخر 6 أشهر:

نقاط القوة

ما يميز خادم MCP

خادم MCP ليس غلافًا حول واجهة برمجة التطبيقات REST — إنه نفس النواة مع أذونات حسابكم، Workspaces والاعتمادات.

  • OAuth 2.1 ورمز المستخدم

    OAuth لـ Claude وChatGPT؛ رموز المستخدمين (po_ut_ / po_gt_) لـ Cursor — po_sk_ محظور.

  • بحث هجين مع تضمينات

    تعمل تضمينات PaperOffice والبحث النصي الكامل معًا، مما يتيح للعميل العثور على الأداة المناسبة.

  • تخزين مؤقت للرفع وتحميل الملفات

    روابط رفع موقعة مسبقًا — لا يوجد Base64 في الدردشة.

  • Knowledge Graph

    حالات الأعمال والجداول الزمنية وعلاقات المستندات عبر اللغة الطبيعية.

  • التحليلات وذكاء الأعمال

    الاتجاهات، والمالية، وخرائط الحرارة، ومقاييس Workspace عند الطلب.

  • المعالجة في الاتحاد الأوروبي

    المعالجة في بنية الاتحاد الأوروبي الخاصة بنا — نفس الأذونات و Workspaces كما في التطبيق.

llms.txt لبيئة التطوير المتكاملة الخاصة بكم بدء أول استدعاء لـ API

حالات الاستخدام

انظر إلى PaperOffice MCP في 30 ثانية

أربع سير عمل حقيقية مع Claude — فيديو قصير لكل منها. مقالات تفصيلية مرتبطة أدناه.

Claude Fable 5 × MCP DMS — full article

الأسئلة الشائعة

كل شيء عن خادم PaperOffice MCP

كيف يقوم خادم MCP بالمصادقة؟
يبدأ Claude وChatGPT بـ OAuth 2.1. كبديل، رمز مستخدم أو مجموعة (po_ut_ / po_gt_) — po_sk_ وpo_pk_ محظوران لـ MCP.
كم يكلف الاستخدام عبر MCP؟
تقوم استدعاءات MCP بموازنة Credits مثل REST-API. يمكن استعلام Credits والاستخدام عبر نقاط نهاية الفوترة.
أي نقطة نهاية توفر أي أدوات؟
/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.
هل يتم دعم OAuth 2.1؟
نعم. يبدأ OAuth 2.1 عند أول اتصال. أو رمز مستخدم أو مجموعة (po_ut_ / po_gt_) — تم حظر po_sk_ و po_pk_ لـ MCP.
ما هو نظام إدارة المستندات بالذكاء الاصطناعي (AI-DMS) الأصلي لـ MCP؟
نظام إدارة المستندات بالذكاء الاصطناعي whose القدرات متاحة بشكل أصلي عبر بروتوكول سياق النموذج — نفس الأذونات و Workspaces كما في التطبيق.
أي العملاء مدعومون؟
بما في ذلك Claude وChatGPT وCursor وملفات تعريف DMS غير التفاعلية — انظر صفحات الاتصال.
ما سرعة الاتصال؟
في بضع دقائق: OAuth 2.1 عند أول اتصال أو رمز مستخدم/مجموعة (po_ut_ / po_gt_)، ثم تحرير الأدوات. تم حظر po_sk_ لـ MCP.
هل تختلف الملفات الشخصية؟
نعم — يعتمد نطاق الأداة على نقطة النهاية. ما يمكن للاستدعاء القيام به تحدده صلاحيات المستخدم المتصل؛ ورمز المجموعة (po_gt_) يتمتع بصلاحيات مجموعة المستخدمين الخاصة به تمامًا.
أين توجد الوثائق؟
في توثيق MCP الخاص بالمطورين، بالإضافة إلى llms.txt ومجموعة Postman المباشرة.
هل يوجد استضافة في الاتحاد الأوروبي؟
نعم — تتم المعالجة في بنية PaperOffice للاتحاد الأوروبي.

المحطة التالية

كيف تستمر

الخطوة التالية الموصى بها في قمع المطورين وفرعان مناسبان.

Cookbookوصفات مطالبات للتكاملاتأول استدعاء APIاحصلوا على مفتاح، أرسلوا طلباً، تفحصوا الاستجابةوصفات الشركاءما يمكن بناؤه على طبقة المستندات — قطاعات وتطبيقات ووكلاء.

العودة إلى بداية المطور

PaperOffice AI · Problem Solver

أخبرنا, ما الذي يستهلك وقتك يومياً.

صفوه فقط. لا حاجة لمصطلحات تقنية.

أو ابدأ بمثال

كيف ترغبون في استخدام PaperOffice؟

تم ربط الكمبيوتر والهاتف الذكي: مساحة العمل على جهاز الحاسوب، والالتقاط عبر الهاتف.

من أين ترغبون في البدء؟

تم تحسين مساحة العمل الكاملة لأجهزة الكمبيوتر. وتُعد النسخة المحمولة مناسبة لالتقاط المستندات ومراجعتها والموافقة عليها.

التسجيل مجاناً app.paperoffice.ai

البدء على الكمبيوتر

سنرسل رابط الدخول الشخصي الخاص بك إلى بريدك الإلكتروني.

التسجيل مجاناً فتح التطبيق تطبيق PaperOffice المنتج الكامل: ويب وسطح مكتب وجوال. التقاط المستندات وتنظيمها والبحث فيها والعمل عليها مع الفريق. يلزم حساب مجاني
يعمل في Claude · تم التحقق منه بواسطة Anthropic Claude ومساعدو الذكاء الاصطناعي ابحثوا في المستندات وحلّلوها في Claude — جرّبوا دون حساب. متاح أيضًا في ChatGPT أو Grok. استخدمه في Claude
فتح الأدوات أدوات مجانية تحرير ملفات PDF، والتحقق من الفواتير الإلكترونية وإنشاؤها، واستخراج النصوص من الصور، وحساب المواعيد النهائية – فورًا ودون تسجيل. لا حاجة لحساب، مباشرة في المتصفح
مفتاح API مطلوب API واجهة API كاملة في كل خطة، وتُحتسب بـ Credits. يُنشأ المفتاح في الـ App بعد التحقق عبر الهاتف؛ ويصف llms.txt الواجهة. يلزم حساب مجاني

غير متأكدون بعد؟ وصفا مشكلتكم وسيعرض لكم Problem Solver المكان المناسب للبدء.