Agentic Document Parsing and Extraction (ADP)

ADP MCP サーバーについて

ADP MCP サーバーは、MCP 対応の AI クライアントを Laiye の Agentic Document Processing (ADP) プラットフォームに接続し、文書の解析、抽出、ワークフローアプリケーションを利用できるようにします。この Node.js パッケージはローカルで stdio 経由で動作するため、クライアントはツールを検出し、文書を処理して、会話から結果を照会できます。

ADP は Vision-Language Models（VLM）、Large Language Models（LLM）、自律型エージェントの意思決定技術を統合しています。従来のルールベースのフィールド抽出を、目標主導型のエンドツーエンドのインテリジェントな自動化に変えることで、従来の文書処理を再構築します。業務文書のインテリジェントな処理に特化しており、海外の請求書、国内の伝票、調達契約書、物流書類、財務諸表、売買契約書を自動的に分類し、主要なフィールドを正確に抽出します。また、表の解析、内容の検証、多言語認識にも対応しています。テンプレートの設定、データのラベリング、継続的なルールのメンテナンスが不要で、大量の文書処理タスクを効率的に処理できます。

---

クイックスタート

1. API キーを取得する

https://adp-global.laiye.com/ で登録し、個人設定の My MCP から API キーを取得します。

2. MCP クライアントを設定する

ADP MCP サーバーは stdio トランスポートで動作します。クライアントは npx を使ってローカルプロセスを起動し、環境変数経由で API キーを渡します。クライアントの MCP 設定ファイル（例：Claude Desktop の claude_desktop_config.json、Cursor の mcp.json）に次の内容を追加します。

{
  "mcpServers": {
    "adp": {
      "command": "npx",
      "args": ["-y", "@laiye-adp/mcp"],
      "env": {
        "ADP_API_KEY": "<YOUR-ADP-API-Key>",
        "API_SOURCE": "npm-mcp"
      }
    }
  }
}

次のパラメーターは、あらゆる MCP クライアントで共通です。

パラメーター	値
コマンド	npx
引数	["-y", "@laiye-adp/mcp"]
トランスポート	stdio
認証	環境変数 ADP_API_KEY=<YOUR-ADP-API-Key>
ソースマーカー	任意の環境変数 API_SOURCE。デフォルトは npm-mcp

任意の環境変数 ADP_ACCEPT_LANGUAGE（zh / en、デフォルトは zh）で、API の言語とドメインを切り替えます。 任意の環境変数 API_SOURCE は、OpenAPI リクエストヘッダー X-Api-Source を設定します。デフォルトは npm-mcp です。 Node.js 20+ がローカルにインストールされている必要があります。

3. 使用を開始する

接続すると、AI クライアントが利用可能な ADP ツールをすべて自動的に検出します。必要なことを自然言語で説明するだけです。

• 「このローカルファイルをアップロードして、返された URL からフィールドを抽出して」
• 「この PDF の構造を解析して」
• 「この ID カードから情報を抽出して」
• 「この請求書から金額と日付を取り出して」

---

ツール一覧

文書解析

ツール名	タイトル	説明
upload_temporary_file	一時ファイルをアップロード	chunk をアップロードして download_url を返します。data.download_url を file パラメーターとして解析または抽出ツールに渡します。
parse_document	一般文書解析	PDF、画像、Word、Excel、PPT などの文書を解析してレイアウトを分析し、構造化されたテキストブロック、表、読み取り順序、ページ座標を返します。文書の種類が不明で、後続処理のために生の構造が必要な場合に使用します。請求書、ID カードなど特定の種類の文書には、専用の抽出ツールを使用してください。

請求書・注文書の抽出

ツール名	タイトル	説明
extract_china_invoice	中国の請求書／領収書	電子発票、一般増値税発票、専用増値税発票、タクシーの領収書、列車の切符、航空旅程表、財政発票など、30種類以上の一般的な中国の伝票に対応します。請求書番号、日付、金額、購入者、販売者などの主要項目を抽出し、請求書の真偽確認にも対応しています。
extract_global_invoice	グローバルな請求書／領収書	海外の請求書、領収書、伝票から、請求書番号、日付、金額、税額、通貨、明細などの主要項目を PDF または画像形式で抽出します。越境取引、経費精算、買掛金処理の自動化に最適です。中国の増値税発票には、専用の中国請求書ツールを使用してください。
extract_purchase_order	購買／販売注文書	購買注文書または販売注文書から、注文番号、購入者／販売者の情報、注文日、商品詳細、数量、単価、合計金額、配送先住所などの主要項目を PDF または画像形式で抽出します。EC の注文入力、サプライチェーンの照合、倉庫管理の自動化に適しています。

カード・証明書の抽出

ツール名	タイトル	説明
extract_id_card	中国の身分証カード	中国本土の住民身分証カードの画像から、氏名、性別、民族、生年月日、身分証番号、住所、発行機関、有効期間などの主要項目を抽出します。表面と裏面の両方に対応しています。香港・マカオ・台湾の通行証またはパスポートには、該当するツールを使用してください。
extract_bank_card	銀行カード	銀行カード画像の表面から、カード番号、発行銀行、カードの種類、有効期限などの主要項目を抽出します。認識対象は公開されているカード表面の情報のみで、CVV などの機密情報は抽出しません。
extract_vehicle_cert	車両証明書	車両の適合証明書画像から、証明書番号、車両ブランド、モデル、VIN、エンジン番号、製造日などの主要項目を抽出します。車両登録、中古車取引、車両管理に適しています。
extract_account_permit	銀行口座許可証	法人の銀行口座開設許可証の画像から、会社名、基本口座番号、銀行名、承認番号、発行日などの主要項目を抽出します。
extract_driver_license	中国の運転免許証	中国の自動車運転免許証の画像から、氏名、性別、国籍、生年月日、免許証番号、運転可能な車両区分、初回発行日、有効期間などの主要項目を抽出します。主ページと補足ページの両方に対応しています。
extract_business_license	営業許可証	中国の営業許可証の画像から、会社名、統一社会信用コード、法定代表者、登録資本金、設立日、事業範囲、登録住所などの主要項目を抽出します。
extract_passport_cn	中国のパスポート	中華人民共和国のパスポート画像から、中国語氏名、ローマ字表記の氏名、性別、生年月日、パスポート番号、国籍、発行日、有効期間、発行機関などの主要項目を抽出します。外国のパスポートには対応していません。
extract_vehicle_license	車両免許証	中国の自動車免許証の画像から、ナンバープレート番号、車両の種類、所有者、VIN、エンジン番号、登録日、発行日などの主要項目を抽出します。主ページと補足ページの両方に対応しています。
extract_org_code_cert	組織コード証明書	組織コード証明書の画像から、組織名、組織コード、法定代表者、住所、発行日、有効期間などの主要項目を抽出します。新たに登録した企業には、代わりに営業許可証ツールを使用してください。
extract_household_book	戸籍簿	中国の戸籍簿（Hukou）の画像から、世帯番号、世帯の種類、住所、氏名・身分証番号・世帯主との続柄を含む家族構成員の一覧などの主要項目を抽出します。索引ページと個人ページの両方に対応しています。
extract_hk_macao_permit	香港・マカオ通行証	香港・マカオへの往来通行証の画像から、氏名、性別、生年月日、通行証番号、発行日、有効期間、発行機関などの主要項目を抽出します。

カスタム抽出

上記の標準ツールに加えて、MCP は ADP プラットフォームで作成したカスタム抽出アプリを操作するための固定ツールを 2 つ提供しています。

ツール名	タイトル	説明
list_custom_extract_apps	カスタム抽出アプリの一覧表示	現在のユーザーが作成したすべてのカスタム文書抽出アプリを一覧表示し、各アプリの ID、名前、説明、ラベル、出力フィールドの定義を返します。execute_custom_extract_app に必要な app_id を探すときに使用します。
execute_custom_extract_app	カスタム抽出アプリの実行	指定したカスタム文書抽出アプリを使用してファイルを処理します。まず list_custom_extract_apps を使用して app_id を取得してください。

ワークフロー： list_custom_extract_apps を呼び出して利用可能なアプリを確認し、対象の app_id を取得してから、app_id とファイルを指定して execute_custom_extract_app を呼び出し、抽出を実行します。

---

ワークフローアプリケーション

ツール名	説明
list_workflow_templates	search、offset、size を指定して、名前で公式テンプレートを検索します。カタログ ID は検索に使用します。
create_workflow_application_from_template	アカウントアプリケーションを作成して公開するか、対応する実行可能なアプリケーションを再利用します。
upload_temporary_file	ワークフロー用ファイルでは、作成した application_id と sharing_scope="application" を指定します。
execute_workflow_app	公開済みのアカウントアプリケーションを実行します。デフォルトでは同期実行です。明示的に非同期実行を要求する場合は wait=false を使用します。
query_workflow_run	run_id でワークフローを検索し、完全な output と error を保持します。

対応するテンプレートキー：

テンプレート	template_key
買掛金	finance_payable
経費精算	expense_reimbursement
財務レポート抽出	financial_report_extraction

対応するテンプレートを使用して、まずアプリケーションを作成して公開してから、返されたアカウントの application_id を使用してアップロードと実行を行います。作成時にテンプレートカタログで can_run=true である必要はありません。作成を繰り返すと、既存の実行可能なアプリケーションが再利用され、テンプレートのバージョンも保持されます。カタログの application_id を使用して実行しないでください。

create_workflow_application_from_template を呼び出します。

{"template_key":"financial_report_extraction"}

成功時の data には、template_key、template_version、application_id、application_name、release_version_id、application_status="published"、can_run=true が含まれます。返された ID を保存してください。次に upload_temporary_file を呼び出します。

{"chunk":"/path/to/report.pdf","application_id":"<created application_id>","sharing_scope":"application"}

アップロードのレスポンスにある download_url、file_name、content_type、および任意の file_size を使用して execute_workflow_app を呼び出します。

{
  "application_id":"<created application_id>",
  "files":[{"url":"https://files.example.com/report.pdf","name":"report.pdf","mime_type":"application/pdf"}]
}

非同期で実行する場合は "wait":false を追加し、data.run_id を保存して、{"run_id":"<returned run_id>"} を指定して query_workflow_run を呼び出します。実行が成功したとみなされるのは status="succeeded" の場合のみです。また、出力がユーザーの要求に沿っているか確認してください。ワークフローの実行には、文書の task_id 検索ツールを使用しないでください。作成、アップロード、実行のレスポンスが不確かな場合は、自動的に再送信しないでください。

現在、ワークフローの変更には ADP のウェブサイトのインターフェースが必要です。API からアプリケーションを再度実行する前に、そこでテストして再公開してください。これらのツールは公式テンプレートからのアプリケーション作成に対応しています。カスタムワークフローの作成とワークフローの編集は、引き続きウェブサイトで行う必要があります。

ワークフローツールは accept_language と timeout_seconds を受け付けます。作成、アップロード、実行、検索では同じアカウントリージョンを使用してください。zh は中国サービス、en はグローバルサービスを選択します。または、ADP_ACCEPT_LANGUAGE を一貫して設定してください。

ツール入力パラメーター

ドキュメント解析・OOTB 抽出ツール

OOTB ツールで共通する入力パラメーター：

パラメーター	型	必須	説明
file	string	はい	ファイルの URL または Base64 エンコードされたコンテンツ
file_name	string	いいえ	ファイル名（拡張子を含む）
with_rec_result	boolean	いいえ	OCR の中間結果を含めるかどうか。デフォルトは true です
wait	boolean	いいえ	結果を同期的に待機するかどうか。デフォルトは true です
timeout_seconds	integer	いいえ	同期待機のタイムアウト（秒）。デフォルトは 300、範囲は 1～900 です

extract_china_invoice は、さらに次のパラメーターをサポートします：

パラメーター	型	必須	説明
enable_invoice_verify	boolean or null	いいえ	この抽出に限り、検証を有効（true）または無効（false）にします。省略または null の場合は、保存済みのアプリ設定を使用し、変更しません。

extract_global_invoice、extract_global_invoice_fast、extract_sea_invoice_fast は、さらに次のパラメーターをサポートします：

パラメーター	型	必須	説明
enable_multi_ticket	boolean	いいえ	1 つのファイル内の複数の請求書を個別の結果に分割します。デフォルトは true です。アプリ設定を変更せず、国際および東南アジア向けの高速モードにのみ適用されます。
enable_field_value_translation	boolean or null	いいえ	この抽出に限り、フィールド値の翻訳を有効（true）または無効（false）にします。省略または null の場合は、保存済みのアプリ設定を使用し、変更しません。対象言語は accept_language または ADP_ACCEPT_LANGUAGE に従います。

upload_temporary_file

パラメーター	型	必須	説明
chunk	string	はい	アップロードするファイル。ローカルファイルパス、file:// URL、または Base64 エンコードされたコンテンツ
application_id	string	いいえ	作成済みアカウントのワークフローアプリケーション ID。sharing_scope="application" の場合は必須です
sharing_scope	string	いいえ	ワークフローファイルの場合は application、一時ドキュメントファイルの場合は user
accept_language	string	いいえ	アカウントのリージョンと言語。zh または en
timeout_seconds	integer	いいえ	リクエストのタイムアウト（秒）。デフォルトは 300、範囲は 1～900 です

レスポンスには data.download_url が含まれます。これを解析ツールまたは抽出ツールの file として直接渡せます。

execute_custom_extract_app

上記のパラメーターに加えて、次のパラメーターを指定します：

パラメーター	型	必須	説明
app_id	string	はい	カスタム抽出アプリ ID（list_custom_extract_apps で取得）

list_custom_extract_apps

入力パラメーターは不要です。

解析・抽出におけるファイル入力方法：

• URL：http:// または https:// で始まるリンクを file として渡します
• Base64：Base64 エンコードされたファイルコンテンツを file として渡します（URL でない場合は自動検出されます）
• ローカルファイル：最初に upload_temporary_file を呼び出し、返された data.download_url を解析ツールまたは抽出ツールに渡します。

同期処理と非同期処理：

• wait=true（デフォルト）：処理が完了するまで待機し、結果を直接返します
• wait=false：すぐに task_id を返し、後からステータスを照会できます

---

ツールの出力

upload_temporary_file の出力

{
  "code": "success",
  "message": "",
  "tips": null,
  "data": {
    "id": "ade6dcfd9b9c11f1be34d85ed35661fd",
    "file_name": "invoice.pdf",
    "file_size": 123,
    "content_type": "application/pdf",
    "download_url": "https://adp.laiye.com/web/agentic_doc_processor/laiye/file/ade6dcfd9b9c11f1be34d85ed35661fd",
    "status": "success"
  }
}

フィールド	型	説明
code	string	業務ステータスコード。成功時は通常 success です
message	string	レスポンスメッセージ
tips	string | null	追加メッセージ
data.id	string	ファイル ID
data.file_name	string	ファイル名
data.file_size	integer	ファイルサイズ（バイト）
data.content_type	string	MIME タイプ
data.download_url	string	ダウンロード URL。この値を解析ツールまたは抽出ツールの file として渡します
data.status	string	ファイルのステータス。利用可能な場合に返されます

parse_document の出力

{
  "task_id": "fabd7f0a4e7211f1bbc4d85ed35661fd",
  "status": 4,
  "message": "",
  "doc_recognize_result": [
    {
      "page_num": 1,
      "document_content": "Full text content of this page...",
      "document_details": [
        {
          "type": "Text",
          "text": "Paragraph content...",
          "position": [{"points": [{"x": 311, "y": 50}, {"x": 500, "y": 50}, {"x": 500, "y": 80}, {"x": 311, "y": 80}]}],
          "ocr_confidence": {
            "ocr_mean_confidence": 0.999,
            "ocr_min_confidence": 0.998,
            "is_overall_confidence": 1
          }
        },
        {
          "type": "Table",
          "text": "Column A\tColumn B\nValue 1\tValue 2",
          "position": [{"points": [...]}],
          "ocr_confidence": {...}
        },
        {
          "type": "Picture",
          "text": "https://adp.laiye.com/web/.../file/abc123",
          "position": [{"points": [...]}],
          "ocr_confidence": {...}
        }
      ]
    }
  ]
}

フィールド	型	説明
task_id	string	タスク ID
status	integer	タスクのステータスコード
message	string	ステータスメッセージ
doc_recognize_result	array	ページごとの認識結果
doc_recognize_result[].page_num	integer	ページ番号（1 始まり）
doc_recognize_result[].document_content	string	読み取り順に並んだページの全文
doc_recognize_result[].document_details	array	要素レベルの詳細
document_details[].type	string	要素の種類：Text、Table、または Picture
document_details[].text	string	テキスト内容。Picture 型の場合は画像 URL
document_details[].position	array	バウンディングボックスの座標（4 つの角の点）
document_details[].ocr_confidence.ocr_mean_confidence	float	OCR の平均信頼度（0～1）
document_details[].ocr_confidence.ocr_min_confidence	float	OCR の最小信頼度（0～1）

extract ツールの出力

{
  "task_id": "91283e544e7111f18cd6d85ed35661fd",
  "status": 4,
  "message": "",
  "extraction_result": [
    {
      "field_key": "invoice_number",
      "field_name": "Invoice Number",
      "field_values": [
        {
          "field_value": "24VLT0591617",
          "field_confidence": 1.0,
          "references": []
        }
      ]
    },
    {
      "field_key": "line_items",
      "field_name": "Product Details",
      "references": [],
      "field_confidence": 1.0,
      "table_values": [
        [
          {
            "field_name": "Description",
            "field_key": "line_items_description",
            "field_values": [
              {
                "field_value": "TESLA MODEL 3",
                "field_confidence": 1.0,
                "references": "Description: TESLA MODEL 3"
              }
            ]
          }
        ]
      ]
    }
  ]
}

通常のフィールド（table_values なし）：

フィールド	型	説明
field_key	string	機械可読なフィールド識別子
field_name	string	人間が読めるフィールド名
field_values	array	抽出された値
field_values[].field_value	string	抽出された値
field_values[].field_confidence	float	信頼度スコア（0～1）

テーブルフィールド（table_values あり）：

フィールド	型	説明
field_key	string	テーブル識別子
field_name	string	テーブル名
table_values	array[array]	2 次元配列：セルの行。各セルには field_name、field_key、field_values が含まれます

見分け方： フィールドオブジェクトに table_values が含まれる場合はテーブルフィールド、field_values のみの場合は通常のフィールドです。

非同期レスポンス（wait=false）

{
  "task_id": "fabd7f0a4e7211f1bbc4d85ed35661fd",
  "status": "running"
}

---

タスクステータスコード

ステータスコード	MCP ステータス	説明
0	running	不明
1	running	準備完了／キュー内
2	running	処理中
4	success	成功
5	failed	失敗
6	failed	キャンセル済み

---

サポートされているファイル形式

形式	拡張子	備考
PDF	.pdf	スキャン文書と電子文書の両方をサポート
画像	.jpg .jpeg .png .bmp .tiff	カメラで撮影した写真をサポート
Word	.doc .docx	-
Excel	.xls .xlsx	-
PPT	.ppt .pptx	-

---

認証

ADP MCP Server は API キー認証を使用し、ADP_API_KEY 環境変数を介して渡します。

"env": {
  "ADP_API_KEY": "<YOUR-ADP-API-Key>",
  "API_SOURCE": "npm-mcp"
}

• API キーは、ADP コンソールの My MCP ページから取得できます
• 各 API キーは 1 人のユーザーに紐付けられ、そのユーザーのアプリとデータにのみアクセスできます
• API キーはローカルプロセスに環境変数としてのみ渡され、リクエストボディやレスポンスには含まれません
• API_SOURCE は X-Api-Source リクエストヘッダーとして OpenAPI に送信されます。省略した場合のデフォルト値は npm-mcp です

---

よくある質問

Q: 接続後に一部のカード／証明書ツールが表示されないのはなぜですか？

A: ツールリストは、初期化済みのアプリに基づいて動的に生成されます。初回接続時に、システムは標準搭載のアプリをすべて自動的に初期化します。初期化が完了したら、ツールリストを更新して、利用可能なすべてのツールを表示してください。

Q: カードツールで「抽出に失敗しました」と表示されるのはなぜですか？

A: アップロードしたファイルがツールの種類に合っていることを確認してください（例：IDカードの画像には extract_id_card を使用し、extract_vehicle_cert は使用しないでください）。ファイルは、サポートされている画像形式またはPDF形式である必要があります。

Q: タイムアウトにはどう対処すればよいですか？

A: デフォルトのタイムアウトは300秒（5分）です。timeout_seconds パラメーターで調整できます（最大900秒）。大きなファイルや複雑なドキュメントの場合は、wait=false を指定して非同期モードを使用し、後で task_id を使って結果を取得してください。

Q: MCP と ADP CLI／OpenAPI の違いは何ですか？

A: 3つとも同等の機能を提供します。違いは統合方法にあります。

方法	最適な用途
MCP Server	AI クライアント（Claude Desktop、Cursor など）。コードは不要です
ADP CLI	ターミナル、スクリプト、AI Skill との統合
OpenAPI	業務システムとの統合、バックエンドサービスの呼び出し

---

ライセンス

• MCP Server：無料で接続でき、ADP プラットフォームの一部として提供されます
• ADP Service：クラウドベースの AI ドキュメント処理サービス。使用量に応じて課金されます

無料プラン：新規ユーザーは登録時に毎月 100 クレジットを受け取れます

利用を開始する

---

サポートとお問い合わせ

• API ドキュメント： Open API Guide
• 製品マニュアル： Cloud Operations Manual
• メール： [email protected]
• ウェブサイト： Laiye