Servidor MCP de OCR de passaportes para agentes de IA

O que o seu agente recebe

Esta é a diferença que importa. Uma ferramenta de OCR que devolve uma página de texto entrega ao modelo algo para interpretar de novo, e um modelo a quem se pede para interpretar uma data de novo acaba inventando uma. Esta ferramenta devolve os campos já separados:

• O titular – nomes, sobrenome, data de nascimento, sexo, nacionalidade.
• O documento – tipo, país, Estado emissor, número, série, data de emissão, data de validade, se está vencido e quantos dias faltam.
• Cada campo encontrado, cada um com a sua própria confiança, lido separadamente da zona de leitura mecânica (MRZ) e da zona visual impressa – para que o modelo possa ver que as duas leituras concordam, em vez de supor isso.
• A zona de leitura mecânica com um veredito: aprovada, reprovada ou ausente, com o motivo, e as próprias linhas.
• Um resumo de uma linha que o assistente pode mostrar a você enquanto trabalha.

As falhas voltam como uma linha legível em um bloco de erro, nunca como um resultado vazio e silencioso: o assistente pode agir a partir dela e mostrá-la a você. Uma recusa da API mantém o texto da própria API, o código de erro dela e o link para a página que o explica.

Instale no seu cliente

Adicione o bloco à configuração MCP do seu cliente e reinicie-o. Defina DOC_CHEAP_API_KEY com a sua própria chave, ou deixe-a de fora e a chave pública do sandbox será usada.

{
  "mcpServers": {
    "doc-cheap": {
      "command": "npx",
      "args": [
        "-y",
        "@doc-cheap/mcp"
      ],
      "env": {
        "DOC_CHEAP_API_KEY": "sk_live_your_key"
      }
    }
  }
}

claude mcp add-json doc-cheap '{"command":"npx","args":["-y","@doc-cheap/mcp"],"env":{"DOC_CHEAP_API_KEY":"sk_live_your_key"}}'

{
  "mcpServers": {
    "doc-cheap": {
      "command": "npx",
      "args": [
        "-y",
        "@doc-cheap/mcp"
      ],
      "env": {
        "DOC_CHEAP_API_KEY": "sk_live_your_key"
      }
    }
  }
}

{
  "servers": {
    "doc-cheap": {
      "command": "npx",
      "args": [
        "-y",
        "@doc-cheap/mcp"
      ],
      "type": "stdio",
      "env": {
        "DOC_CHEAP_API_KEY": "sk_live_your_key"
      }
    }
  }
}

{
  "mcpServers": {
    "doc-cheap": {
      "command": "npx",
      "args": [
        "-y",
        "@doc-cheap/mcp"
      ],
      "env": {
        "DOC_CHEAP_API_KEY": "sk_live_your_key"
      }
    }
  }
}

{
  "mcpServers": {
    "doc-cheap": {
      "command": "npx",
      "args": [
        "-y",
        "@doc-cheap/mcp"
      ],
      "env": {
        "DOC_CHEAP_API_KEY": "sk_live_your_key"
      }
    }
  }
}

{
  "mcpServers": {
    "doc-cheap": {
      "command": "npx",
      "args": [
        "-y",
        "@doc-cheap/mcp"
      ],
      "disabled": false,
      "autoApprove": [
        "check_balance",
        "search_docs"
      ],
      "env": {
        "DOC_CHEAP_API_KEY": "sk_live_your_key"
      }
    }
  }
}

• Reinicie o cliente depois de adicionar o bloco. O servidor é iniciado pelo cliente, então ele só pega uma configuração ou um ambiente alterados ao iniciar do zero.
• Sem DOC_CHEAP_API_KEY, o servidor recorre à chave pública do sandbox: as leituras rodam dentro da cota gratuita dela e não há saldo para informar. É o jeito mais rápido de ver funcionando.
• Configurações opcionais: DOC_CHEAP_DOCS_BASE (para onde os resultados de busca apontam), DOC_CHEAP_DOCS_DIR (qual cópia da documentação é pesquisada) e DOC_CHEAP_IMAGE_ROOT (veja as proteções abaixo).

Ou conecte-se ao servidor hospedado

As mesmas três ferramentas estão hospedadas em https://mcp.doc.cheap/mcp via Streamable HTTP, então um cliente que se conecta a uma URL não precisa instalar nada. Sem login: envie a sua chave como X-Doc-Cheap-Api-Key ou como Authorization: Bearer – se as duas forem enviadas, vale o cabeçalho com nome próprio – ou não envie nenhuma e a chave pública do sandbox será usada. O servidor hospedado não consegue ler arquivos da sua máquina, então recebe a imagem em base64 ou como uma URL https.

https://mcp.doc.cheap/mcp

claude mcp add --transport http doc-cheap https://mcp.doc.cheap/mcp --header "Authorization: Bearer sk_live_your_key"

{
  "mcpServers": {
    "doc-cheap": {
      "url": "https://mcp.doc.cheap/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key"
      }
    }
  }
}

{
  "servers": {
    "doc-cheap": {
      "type": "http",
      "url": "https://mcp.doc.cheap/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key"
      }
    }
  }
}

No Claude Desktop e no claude.ai, adicione em Settings, Connectors, como conector personalizado com a URL https://mcp.doc.cheap/mcp; sem chave, ele roda com a chave do sandbox.

As três ferramentas

• scan_document recebe a imagem como image_base64, image_path ou image_url, e as mesmas opções de uma chamada direta, entre elas expect_country, return_portrait, reference e idempotency_key.
• search_docs lê uma cópia da documentação distribuída junto com o servidor, então responde sem rede nenhuma – o que significa que o agente pode consultar o vocabulário de campos ou um código de erro sem gastar uma chamada.
• check_balance precisa de uma chave com uma conta por trás. Com a chave pública do sandbox, ela diz com clareza que não há saldo, em vez de responder com zeros que parecem uma leitura.
• Cada ferramenta declara um esquema de saída e devolve conteúdo estruturado que o segue, então um agente pode usar os campos sem interpretar texto.
• Cada página da documentação também é um recurso que o agente pode ler, e quatro prompts – ler um documento para JSON, conferir uma data de validade, ler um lote, explicar um código de erro – iniciam as tarefas comuns em um passo.

Quanto custa

$0.01 por documento reconhecido. Preço fixo, para toda conta, em qualquer volume – um único número, e nada para negociar. Um documento só é cobrado quando foi reconhecido: uma leitura que não encontra nada, não consegue ler a imagem ou não consegue identificar o tipo responde com o seu veredito e não custa nada. Cada resultado diz qual foi o caso, então o agente – e você – sempre sabem se aquela chamada gastou alguma coisa.

Antes de ter uma conta: a chave pública do sandbox executa 10 documentos reconhecidos grátis por endereço IP no total, com no máximo 10 requisições por hora, seja qual for a resposta, e o cadastro acrescenta 20 créditos. Um crédito é um centavo de dólar, que é um documento.

O reconhecimento leva cerca de 275 ms na mediana em produção, e cada resultado traz os seus próprios tempos, então um loop de agente pode planejar com base em um número real.

O mesmo preço, a mesma chave e o mesmo formato de resposta de uma chamada direta: como funciona a cobrança e como se compara.

O que o servidor reporta

Por padrão, o servidor não envia relatório nenhum para lugar nenhum: o envio de falhas fica desligado a menos que você mesmo configure um destino, e sem ele a biblioteca de rastreamento nem chega a ser carregada.

Duas proteções que vale conhecer

O servidor roda na sua máquina com os seus privilégios, e os argumentos dele são escolhidos por um modelo. Por isso, dois deles têm cerca:

image_base64 não tem nenhuma dessas restrições, porque quem chama já tem os bytes – e é por isso que cada recusa acima aponta para ela.