Agentic Document Parsing and Extraction (ADP)

O ADP classifica automaticamente faturas internacionais, comprovantes nacionais, contratos de compras, documentos logísticos, demonstrações financeiras e contratos comerciais, e extrai com precisão campos-chave. Também suporta análise de tabelas, verificação de conteúdo e reconhecimento multilíngue. Sem necessidade de configuração de modelos, rotulagem de dados ou manutenção contínua de regras, ele lida eficientemente com tarefas de processamento de documentos em alto volume.

GitHub

Experimente este MCPPatrocinado

Documentação

Sobre o Servidor MCP ADP

O Servidor MCP ADP é o endpoint do Model Context Protocol para a plataforma Agentic Document Processing (ADP) da Laiye. Ele permite que qualquer cliente de IA compatível com MCP — Claude Desktop, Cursor, Copilot Chat, Tongyi Lingma, Coze e outros — invoque os recursos de análise e extração de documentos do ADP sem escrever uma única linha de código. Diferente da CLI, o Servidor MCP opera sobre transporte HTTP Streamable. Uma única conexão é tudo o que você precisa para descobrir ferramentas disponíveis, invocar processamento e consultar resultados — inteiramente dentro da sua janela de chat.

O ADP integra Modelos de Visão-Linguagem (VLM), Grandes Modelos de Linguagem (LLM) e tecnologias de tomada de decisão autônoma por agentes. Ele reformula o processamento tradicional de documentos ao transformar a extração convencional de campos baseada em regras em automação inteligente de ponta a ponta orientada a objetivos. Focado no processamento inteligente de documentos empresariais, o ADP classifica automaticamente faturas internacionais, comprovantes nacionais, contratos de compras, documentos logísticos, demonstrações financeiras e contratos comerciais, além de extrair com precisão os campos-chave. Ele também suporta análise de tabelas, verificação de conteúdo e reconhecimento multilíngue. Sem necessidade de configuração de modelos, rotulagem de dados ou manutenção contínua de regras, ele lida com eficiência em tarefas de processamento de documentos em alto volume.

Início Rápido

1. Obtenha Sua Chave de API

Cadastre-se em https://adp-global.laiye.com/ e recupere sua Chave de API em Meu MCP nas configurações pessoais.

2. Configure Seu Cliente MCP

O Servidor MCP ADP opera sobre transporte stdio: o cliente inicia um processo local via npx e passa sua Chave de API por meio de uma variável de ambiente. Adicione o seguinte ao arquivo de configuração MCP do seu cliente (ex.: claude_desktop_config.json do Claude Desktop, mcp.json do Cursor):

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

Os mesmos parâmetros se aplicam a qualquer cliente MCP:

Parâmetro	Valor
Comando	`npx`
Argumentos	`["-y", "@laiye-adp/mcp"]`
Transporte	stdio
Autenticação	Variável de ambiente `ADP_API_KEY=<YOUR-ADP-API-Key>`

A variável de ambiente opcional ADP_ACCEPT_LANGUAGE (zh / en, padrão zh) alterna o idioma da API e o domínio. Requer Node.js 20+ instalado localmente.

3. Comece a Usar

Uma vez conectado, seu cliente de IA descobrirá automaticamente todas as ferramentas ADP disponíveis. Basta descrever o que você precisa em linguagem natural:

"Envie este arquivo local e extraia os campos da URL retornada"
"Analise a estrutura deste PDF"
"Extraia as informações deste documento de identidade"
"Obtenha o valor e a data desta fatura"

Catálogo de Ferramentas

Análise de Documentos

Nome da Ferramenta	Título	Descrição
`upload_temporary_file`	Enviar Arquivo Temporário	Envia `chunk` e retorna `download_url`. Passe `data.download_url` para ferramentas de análise ou extração como o parâmetro `file`.
`parse_document`	Análise Geral de Documentos	Analisa PDF, imagem, Word, Excel, PPT e outros documentos para análise de layout, retornando blocos de texto estruturados, tabelas, ordem de leitura e coordenadas de página. Use quando o tipo de documento for desconhecido e você precisar da estrutura bruta para processamento posterior; para faturas, documentos de identidade ou outros tipos específicos, prefira a ferramenta de extração dedicada.

Extração de Faturas e Pedidos

Nome da Ferramenta	Título	Descrição
`extract_china_invoice`	Fatura / Comprovante da China	Abrange mais de 30 tipos comuns de comprovantes chineses: e-faturas totalmente digitalizadas, faturas de IVA gerais, faturas de IVA especiais, recibos de táxi, bilhetes de trem, itinerários aéreos, faturas fiscais, etc. Extrai número da fatura, data, valor, comprador, vendedor e outros campos-chave; também suporta verificação de autenticidade da fatura.
`extract_global_invoice`	Fatura / Recibo Global	Extrai campos-chave (número da fatura, data, valor, impostos, moeda, itens de linha, etc.) de faturas, recibos ou comprovantes internacionais em formato PDF ou imagem. Ideal para comércio transfronteiriço, reembolsos e automação de contas a pagar; para faturas de IVA chinesas, use a ferramenta dedicada de fatura da China.
`extract_purchase_order`	Pedido de Compra / Venda	Extrai campos-chave (número do pedido, informações do comprador/vendedor, data do pedido, detalhes dos itens, quantidade, preço unitário, valor total, endereço de entrega, etc.) de pedidos de compra ou venda em formato PDF ou imagem. Adequado para entrada de pedidos de e-commerce, conciliação na cadeia de suprimentos e automação de gerenciamento de armazém.

Extração de Cartões e Certificados

Nome da Ferramenta	Título	Descrição
`extract_id_card`	Documento de Identidade da China	Extrai campos-chave (nome, gênero, etnia, data de nascimento, número do documento, endereço, órgão emissor, período de validade, etc.) de imagens de documentos de identidade de residentes da China continental. Suporta frente e verso. Para autorizações de HK/Macau/Taiwan ou passaportes, use a ferramenta correspondente.
`extract_bank_card`	Cartão Bancário	Extrai campos-chave (número do cartão, banco emissor, tipo de cartão, data de validade, etc.) da parte frontal da imagem de um cartão bancário. Apenas informações públicas da face do cartão são reconhecidas; campos sensíveis como CVV não são extraídos.
`extract_vehicle_cert`	Certificado de Veículo	Extrai campos-chave (número do certificado, marca do veículo, modelo, VIN, número do motor, data de fabricação, etc.) de imagens de certificados de conformidade de veículos. Adequado para registro de veículos, transações de veículos usados e gerenciamento de frotas.
`extract_account_permit`	Autorização de Conta Bancária	Extrai campos-chave (nome da empresa, número da conta básica, nome do banco, número de aprovação, data de emissão, etc.) de imagens de autorizações de abertura de conta bancária corporativa.
`extract_driver_license`	Carteira de Habilitação da China	Extrai campos-chave (nome, gênero, nacionalidade, data de nascimento, número da habilitação, classe de veículo permitida, data da primeira emissão, período de validade, etc.) de imagens de carteiras de habilitação de veículos motorizados chinesas. Suporta páginas principal e complementar.
`extract_business_license`	Licença Comercial	Extrai campos-chave (nome da empresa, código de crédito social unificado, representante legal, capital registrado, data de estabelecimento, escopo de negócios, endereço registrado, etc.) de imagens de licenças comerciais chinesas.
`extract_passport_cn`	Passaporte da China	Extrai campos-chave (nome em chinês, nome romanizado, gênero, data de nascimento, número do passaporte, nacionalidade, data de emissão, período de validade, órgão emissor, etc.) de imagens de passaportes da RPC. Passaportes estrangeiros não são suportados.
`extract_vehicle_license`	Licenciamento de Veículo	Extrai campos-chave (número da placa, tipo de veículo, proprietário, VIN, número do motor, data de registro, data de emissão, etc.) de imagens de licenciamentos de veículos motorizados chineses. Suporta páginas principal e complementar.
`extract_org_code_cert`	Certificado de Código de Organização	Extrai campos-chave (nome da organização, código da organização, representante legal, endereço, data de emissão, período de validade, etc.) de imagens de certificados de código de organização. Para empresas recém-registradas, use a ferramenta de Licença Comercial.
`extract_household_book`	Registro de Família	Extrai campos-chave (número do registro, tipo de registro, endereço, lista de membros da família incluindo nome, número do documento e relação com o chefe da família, etc.) de imagens de registros de família chineses (Hukou). Suporta páginas de índice e individuais.
`extract_hk_macao_permit`	Autorização de Viagem HK/Macau	Extrai campos-chave (nome, gênero, data de nascimento, número da autorização, data de emissão, período de validade, órgão emissor, etc.) de imagens de Autorizações de Entrada e Saída para Viagens a Hong Kong e Macau.

Extração Personalizada

Além das ferramentas prontas para uso acima, o MCP fornece duas ferramentas fixas para trabalhar com aplicativos de extração personalizados que você cria na plataforma ADP:

Nome da Ferramenta	Título	Descrição
`list_custom_extract_apps`	Listar Aplicativos de Extração Personalizados	Lista todos os aplicativos de extração de documentos personalizados criados pelo usuário atual, retornando o ID, nome, descrição, rótulos e definições de campos de saída de cada aplicativo. Use isso para encontrar o `app_id` necessário para `execute_custom_extract_app`.
`execute_custom_extract_app`	Executar Aplicativo de Extração Personalizado	Processa um arquivo usando um aplicativo de extração de documentos personalizado especificado. Use `list_custom_extract_apps` primeiro para obter o `app_id`.

Fluxo de trabalho: Chame list_custom_extract_apps para navegar pelos aplicativos disponíveis e obter o app_id alvo, depois chame execute_custom_extract_app com o app_id e o arquivo para realizar a extração.

Parâmetros de Entrada das Ferramentas

Ferramentas de Análise de Documentos e Extração Prontas para Uso

Todas as ferramentas prontas para uso compartilham um esquema de entrada unificado:

Parâmetro	Tipo	Obrigatório	Descrição
`file`	string	Sim	URL do arquivo ou conteúdo codificado em Base64
`file_name`	string	Não	Nome do arquivo (com extensão)
`with_rec_result`	boolean	Não	Se deve incluir resultados intermediários de OCR, padrão `true`
`wait`	boolean	Não	Se deve aguardar sincronamente pelo resultado, padrão `true`
`timeout_seconds`	integer	Não	Tempo limite de espera síncrona em segundos, padrão `300`, intervalo 1–900

upload_temporary_file

Parâmetro	Tipo	Obrigatório	Descrição
`chunk`	string	Sim	Arquivo a ser enviado. Caminho de arquivo local, URL `file://` ou conteúdo codificado em Base64

A resposta contém data.download_url, que pode ser passado diretamente para ferramentas de análise ou extração como file.

execute_custom_extract_app

Além dos parâmetros acima:

Parâmetro	Tipo	Obrigatório	Descrição
`app_id`	string	Sim	ID do aplicativo de extração personalizado (obtido de `list_custom_extract_apps`)

list_custom_extract_apps

Nenhum parâmetro de entrada necessário.

Métodos de entrada de arquivo para análise/extração:

URL: passe um link começando com http:// ou https:// como file
Base64: passe o conteúdo do arquivo codificado em Base64 como file (detectado automaticamente quando não é uma URL)
Arquivos locais: chame upload_temporary_file primeiro, depois passe o data.download_url retornado para a ferramenta de análise ou extração.

Síncrono vs Assíncrono:

wait=true (padrão): bloqueia até que o processamento seja concluído, retorna o resultado diretamente
wait=false: retorna imediatamente com um task_id para consultas de status posteriores

Saída das Ferramentas

Saída de 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"
  }
}

Campo	Tipo	Descrição
`code`	string	Código de status do negócio. O sucesso geralmente é `success`
`message`	string	Mensagem de resposta
`tips`	string \| null	Mensagem adicional
`data.id`	string	ID do arquivo
`data.file_name`	string	Nome do arquivo
`data.file_size`	integer	Tamanho do arquivo em bytes
`data.content_type`	string	Tipo MIME
`data.download_url`	string	URL de download. Passe este valor para ferramentas de análise ou extração como `file`
`data.status`	string	Status do arquivo, retornado quando disponível

Saída de 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": {...}
        }
      ]
    }
  ]
}

Campo	Tipo	Descrição
`task_id`	string	ID da tarefa
`status`	integer	Código de status da tarefa
`message`	string	Mensagem de status
`doc_recognize_result`	array	Resultados de reconhecimento por página
`doc_recognize_result[].page_num`	integer	Número da página (indexado a partir de 1)
`doc_recognize_result[].document_content`	string	Texto completo da página em ordem de leitura
`doc_recognize_result[].document_details`	array	Detalhes em nível de elemento
`document_details[].type`	string	Tipo de elemento: `Text`, `Table` ou `Picture`
`document_details[].text`	string	Conteúdo do texto; URL da imagem para tipo Imagem
`document_details[].position`	array	Coordenadas da caixa delimitadora (4 pontos de canto)
`document_details[].ocr_confidence.ocr_mean_confidence`	float	Confiança média do OCR (0–1)
`document_details[].ocr_confidence.ocr_min_confidence`	float	Confiança mínima do OCR (0–1)

Saída da Ferramenta 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"
              }
            ]
          }
        ]
      ]
    }
  ]
}

Campo regular (sem table_values):

Campo	Tipo	Descrição
`field_key`	string	Identificador de campo legível por máquina
`field_name`	string	Nome do campo legível por humanos
`field_values`	array	Valores extraídos
`field_values[].field_value`	string	O valor extraído
`field_values[].field_confidence`	float	Pontuação de confiança (0–1)

Campo de tabela (possui table_values):

Campo	Tipo	Descrição
`field_key`	string	Identificador da tabela
`field_name`	string	Nome da tabela
`table_values`	array[array]	Matriz 2D: linhas de células, cada célula possui `field_name`, `field_key`, `field_values`

Como distinguir: O objeto de campo contém table_values → campo de tabela; apenas field_values → campo regular.

Resposta Assíncrona (`wait=false`)

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

Códigos de Status da Tarefa

Código de Status	Status MCP	Descrição
0	running	Desconhecido
1	running	Pronto / Na fila
2	running	Processando
4	success	Sucesso
5	failed	Falhou
6	failed	Cancelado

Formatos de Arquivo Suportados

Formato	Extensões	Observações
PDF	`.pdf`	Suporta tanto digitalizados quanto eletrônicos
Imagem	`.jpg` `.jpeg` `.png` `.bmp` `.tiff` `.webp`	Suporta fotos de câmera
Word	`.doc` `.docx`	-
Excel	`.xls` `.xlsx`	-
PPT	`.ppt` `.pptx`	-

Autenticação

O ADP MCP Server usa autenticação por API Key, passada por meio da variável de ambiente ADP_API_KEY:

"env": {
  "ADP_API_KEY": "<YOUR-ADP-API-Key>"
}

A API Key está disponível na página My MCP no console da ADP
Cada API Key está vinculada a um único usuário e só pode acessar os aplicativos e dados desse usuário
A API Key é passada apenas como variável de ambiente para o processo local e nunca aparece nos corpos de requisições ou respostas

FAQ

P: Algumas ferramentas de cartão/certificado não aparecem após a conexão?

R: A lista de ferramentas é gerada dinamicamente com base nos seus aplicativos inicializados. Na primeira conexão, o sistema inicializa automaticamente todos os aplicativos prontos para uso. Atualize a lista de ferramentas após a inicialização ser concluída para ver todas as ferramentas disponíveis.

P: Uma ferramenta de cartão retorna "falha na extração"?

R: Certifique-se de que o arquivo enviado corresponde ao tipo da ferramenta (por exemplo, use extract_id_card para imagens de documentos de identidade, não extract_vehicle_cert). O arquivo deve estar em um formato de imagem ou PDF suportado.

P: Como lidar com timeouts?

R: O timeout padrão é de 300 segundos (5 minutos). Você pode ajustá-lo por meio do parâmetro timeout_seconds (máximo 900). Para arquivos grandes ou documentos complexos, use wait=false para o modo assíncrono e consulte os resultados posteriormente usando o task_id.

P: Como o MCP se compara ao ADP CLI / OpenAPI?

R: Os três oferecem funcionalidade equivalente — a diferença está no método de integração:

Método	Melhor Para
MCP Server	Clientes de IA (Claude Desktop, Cursor, etc.) — sem necessidade de código
ADP CLI	Terminal, scripts, integração com AI Skill
OpenAPI	Integração com sistemas empresariais, chamadas de serviços de backend

Licença

MCP Server: Gratuito para conectar, fornecido como parte da plataforma ADP
ADP Service: Processamento de documentos de IA baseado em nuvem, cobrança baseada no uso

Camada gratuita: novos usuários recebem 100 créditos gratuitos por mês ao se registrarem

Comece agora

Suporte e Contato

Documentação da API: Guia da API Aberta
Manual do Produto: Manual de Operações em Nuvem
E-mail: mkt@laiye.com
Site: Laiye