Yapay zekâ ajanları için pasaport OCR MCP sunucusu

Ajanınıza neler döner

Asıl önemli fark şu. Bir sayfa metin döndüren bir OCR aracı, modele yeniden ayrıştıracağı bir şey verir; bir tarihi yeniden ayrıştırması istenen bir model de er geç bir tarih uydurur. Bu araç alanları zaten ayrılmış olarak döndürür:

• Hamil: adlar, soyadı, doğum tarihi, cinsiyet, uyruk.
• Belge: tür, ülke, düzenleyen devlet, numara, seri, düzenlenme tarihi, son geçerlilik tarihi, süresinin dolup dolmadığı ve kaç gün kaldığı.
• Bulunan her alan, her biri kendi güven düzeyiyle, makinede okunabilir bölgeden (MRZ) ve basılı görsel bölgeden ayrı ayrı okunmuş olarak – böylece model iki okumanın uyuştuğunu varsaymak yerine görebilir.
• Bir hükümle birlikte makinede okunabilir bölge: geçti, başarısız ya da yok; nedeni ve satırların kendisiyle.
• Asistanın çalışırken size gösterebileceği tek satırlık bir özet.

Hatalar sessiz, boş bir sonuç olarak değil, bir hata bloğunda okunabilir tek bir satır olarak döner: asistan buna göre davranabilir ve bunu size gösterebilir. API'den gelen bir ret, API'nin kendi ifadesini, hata kodunu ve onu açıklayan sayfanın bağlantısını korur.

İstemcinize kurun

Bloğu istemcinizin MCP yapılandırmasına ekleyin ve istemciyi yeniden başlatın. DOC_CHEAP_API_KEY değişkenine kendi anahtarınızı atayın ya da hiç eklemeyin; bu durumda herkese açık sandbox anahtarı kullanılır.

{
  "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"
      }
    }
  }
}

• Bloğu ekledikten sonra istemciyi yeniden başlatın. Sunucuyu istemci başlatır; bu yüzden değişen bir yapılandırmayı ve değişen bir ortamı ancak yeniden başlatıldığında alır.
• DOC_CHEAP_API_KEY olmadan sunucu herkese açık sandbox anahtarına geri döner: taramalar bu anahtarın ücretsiz hakkı içinde çalışır ve bildirilecek bir bakiye olmaz. Çalıştığını görmenin en hızlı yolu budur.
• İsteğe bağlı ayarlar: DOC_CHEAP_DOCS_BASE (arama sonuçlarının bağlantı verdiği yer), DOC_CHEAP_DOCS_DIR (dokümantasyonun hangi kopyasında aranacağı) ve DOC_CHEAP_IMAGE_ROOT (aşağıdaki korumalara bakın).

Ya da barındırılan sunucuya bağlanın

Aynı üç araç https://mcp.doc.cheap/mcp adresinde Streamable HTTP üzerinden barındırılır; böylece bir URL'ye bağlanan bir istemcinin hiçbir şey kurmasına gerek kalmaz. Oturum açma yok: anahtarınızı X-Doc-Cheap-Api-Key ya da Authorization: Bearer olarak gönderin (ikisi birden gönderilirse adlandırılmış başlık geçerli olur) ya da hiç göndermeyin; bu durumda herkese açık sandbox anahtarı kullanılır. Barındırılan sunucu makinenizdeki dosyaları okuyamaz; bu yüzden görüntüyü base64 ya da bir https URL'si olarak alır.

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"
      }
    }
  }
}

Claude Desktop ve claude.ai içinde Settings, Connectors altında, özel bir bağlayıcı olarak https://mcp.doc.cheap/mcp URL'siyle ekleyin; anahtar olmadan sandbox anahtarıyla çalışır.

Üç araç

• scan_document görüntüyü image_base64, image_path veya image_url olarak alır ve doğrudan bir çağrının aldığı seçeneklerin aynısını kabul eder; bunlar arasında expect_country, return_portrait, reference ve idempotency_key vardır.
• search_docs, sunucuyla birlikte gelen dokümantasyon kopyasını okur; bu yüzden hiçbir ağ olmadan yanıt verir. Bu da ajanın alan sözlüğüne veya bir hata koduna bir çağrı harcamadan bakabileceği anlamına gelir.
• check_balance arkasında bir hesap olan bir anahtar gerektirir. Herkese açık sandbox anahtarıyla, okunmuş bir değer gibi görünen sıfırlarla yanıt vermek yerine bakiye olmadığını açıkça söyler.
• Her araç bir çıktı şeması bildirir ve ona uyan yapılandırılmış içerik döndürür; böylece bir ajan alanları metin ayrıştırmadan kullanabilir.
• Dokümantasyonun her sayfası aynı zamanda ajanın okuyabileceği bir kaynaktır; dört prompt da – bir belgeyi JSON'a okumak, bir son geçerlilik tarihini kontrol etmek, bir partiyi taramak, bir hata kodunu açıklamak – yaygın işleri tek adımda başlatır.

Ne kadar tutar

Tanınan belge başına $0.01. Sabit fiyat, her hesap için, her hacimde – tek bir rakam ve pazarlık edilecek hiçbir şey yok. Bir belge yalnızca tanındığında ücretlendirilir: hiçbir şey bulamayan, görüntüyü okuyamayan veya türü belirleyemeyen bir tarama hükmünü bildirir ve hiçbir ücret doğurmaz. Her sonuç hangisi olduğunu söyler; böylece ajan da siz de o çağrının bir şey harcayıp harcamadığını her zaman bilirsiniz.

Hesabınız olmadan önce: herkese açık sandbox anahtarı IP adresi başına toplam 10 ücretsiz tanınan belge çalıştırır; yanıt ne olursa olsun saatte en fazla 10 istek. Kayıt olmak 20 kredi daha ekler. Bir kredi bir senttir, bir sent de bir belgedir.

Tanıma, üretimde medyan olarak yaklaşık 275 ms sürer ve her sonuç kendi süre bilgisini taşır; böylece bir ajan döngüsü gerçek bir rakama göre bütçe yapabilir.

Doğrudan bir çağrıyla aynı fiyat, aynı anahtar ve aynı yanıt yapısı: faturalandırma nasıl işler ve alternatiflerle karşılaştırması.

Sunucu neyi bildirir

Sunucu varsayılan olarak hiçbir yere hiçbir şey bildirmez: hata raporlama, bir raporlama uç noktasını kendiniz ayarlamadığınız sürece kapalıdır ve uç nokta olmadan izleme kütüphanesi hiç yüklenmez bile.

Bilmeye değer iki koruma

Sunucu makinenizde sizin yetkilerinizle çalışır ve argümanlarını bir model seçer. Bu yüzden bunlardan ikisi sınırlandırılmıştır:

image_base64 bu kısıtlamaların hiçbirini taşımaz, çünkü çağıran taraf baytlara zaten sahiptir; yukarıdaki her ret de bu yüzden onu işaret eder.