Servidor MCP de OCR de passaportes para agentes

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 seis 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 seis 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. Ela guarda um registro de cada leitura por um ano, então use só imagens de teste, nunca um documento real. Uma conta recebe 100 documentos grátis todo mês, usados antes dos créditos pagos. 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.