Laiye Adp Mcp

ADP MCP

AI エージェントが業務文書をネイティブに処理できるようにします。請求書、発注書、契約書、物流書類、財務諸表などのファイルから構造化データを抽出し、チャットセッション内でファイルのアップロード、解析、データ抽出、結果の照会を直接行えます。

---

ADP MCP サーバーについて

Laiye Agentic Document Processing（ADP）MCP サーバー

ADP MCP サーバーは、企業文書を AI エージェントが呼び出せるデータに変換します。ユーザーは、チャットの会話内で請求書、発注書、契約書、請求明細書、画像、スプレッドシートなどのファイルを直接アップロードできます。ADP はコンテンツ認識、フィールド抽出、構造化データの出力を自動的に実行し、手作業によるデータ入力、コピー＆ペースト、システム間の処理にかかる負担を軽減します。

複雑なレイアウト、明細行の表、スキャン文書、多言語の領収書、長文書など、実際の業務シナリオに最適化された ADP MCP サーバーは、より高い精度と一貫性のある構造化出力を実現します。文書レビュー、勘定照合、データ入力、ファイルのエクスポート、エンドツーエンドの業務プロセス自動化など、後続のワークフローを支えます。

---

クイックスタート

1. API キーを取得する

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

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

オプション A：ビジュアル設定 UI（推奨）

ほとんどの MCP クライアント（Cursor、Tongyi Lingma、Coze など）では、設定パネルから MCP サーバーを直接追加できます。ここでは Cursor を例に説明します。

1. Settings → MCP を開きます
2. Add new MCP server をクリックします
3. 以下を入力します：
   • Name：ADP（任意の名前）
   • Type：streamable-http
   • URL：https://adp.laiye.com/mcp?key=<YOUR-ADP-API-Key>
4. 保存すると、次回の会話から ADP ツールを利用できます

オプション B：設定ファイルを編集する

Claude Desktop の場合、以下を claude_desktop_config.json に追加します。どちらの接続方法にも対応しています。

リモート接続（Streamable HTTP）

{
  "mcpServers": {
    "adp": {
      "url": "https://adp.laiye.com/mcp?key=<YOUR-ADP-API-Key>",
      "transport": "streamable-http"
    }
  }
}

ローカルコマンド（npx、stdio）

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

同じパラメーターをすべての MCP クライアントに適用できます。

パラメーター	値
エンドポイント	https://adp.laiye.com/mcp
トランスポート	Streamable HTTP
認証	URL クエリパラメーター ?key=<YOUR-ADP-API-Key>

プライベート環境にデプロイする場合は、ドメインを実際のサーバーアドレスに置き換えてください。

3. 使用を開始する

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

• 「この PDF の構造を解析してください」
• 「この身分証明書から情報を抽出してください」
• 「この請求書から金額と日付を取り出してください」

---

ツール一覧

文書解析

ツール名	タイトル	説明
parse_document	一般文書解析	PDF、画像、Word、Excel、PPT などの文書を解析してレイアウトを分析し、構造化されたテキストブロック、表、読み取り順序、ページ上の座標を返します。文書の種類が不明で、後続処理のために生の構造が必要な場合に使用します。請求書、身分証明書など特定の種類の文書には、専用の抽出ツールを優先して使用してください。

請求書・注文書の抽出

ツール名	タイトル	説明
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 を呼び出し、抽出を実行します。

---

ツールの入力パラメーター

文書解析およびすぐに使える抽出ツール

すぐに使えるツールはすべて、統一された入力スキーマを共有します。

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

execute_custom_extract_app

上記のパラメーターに加えて、次のパラメーターがあります。

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

list_custom_extract_apps

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

ファイルの入力方法：

• URL：http://、https://、または file:// で始まるリンクを file として渡します
• Base64：Base64 エンコードされたファイルのコンテンツを file として渡します（URL ではない場合は自動検出されます）

同期と非同期：

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

---

ツールの出力

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）

ツールの出力を抽出する

{
  "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 .webp	カメラで撮影した写真をサポート
Word	.doc .docx	-
Excel	.xls .xlsx	-
PPT	.ppt .pptx	-

---

認証

ADP MCP Server は、URL クエリパラメーターで渡される API Key 認証を使用します。

https://adp.laiye.com/mcp?key=<YOUR-ADP-API-Key>

• API Key は ADP コンソールの My MCP ページから取得できます
• 各 API Key は単一のユーザーに紐付けられ、そのユーザーのアプリとデータにのみアクセスできます
• API Key がリクエスト本文やレスポンスに含まれることはありません

---

よくある質問

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: いずれも同等の機能を提供します。違いは連携方法です。

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

---

ライセンス

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

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

利用を開始する

---

サポートとお問い合わせ

• API ドキュメント： Open API ガイド
• 製品マニュアル： クラウド運用マニュアル
• メール： [email protected]
• ウェブサイト： Laiye