AIエージェント向けパスポートOCR MCPサーバー

エージェントが受け取るもの

ここが重要な違いです。1ページ分のテキストを返すOCRツールは、モデルに再解析の作業を渡すことになり、日付の再解析を任されたモデルは、いずれ日付をでっち上げます。このツールは、すでに分割されたフィールドを返します。

• 所持人：名、姓、生年月日、性別、国籍。
• 書類：種類、国、発行国、番号、シリーズ、発行日、有効期限、期限切れかどうか、残り日数。
• 見つかったすべてのフィールド。それぞれに信頼度が付き、機械読み取りゾーン（MRZ）と印字された視覚ゾーンから別々に読み取られます。そのため、モデルは2つの読み取り結果が一致していると仮定するのではなく、一致していることを確認できます。
• 判定付きの機械読み取りゾーン。判定は合格、不合格、なしのいずれかで、理由と、読み取った行そのものが付きます。
• 作業中にアシスタントが表示できる1行の要約。

失敗は、空の結果として黙って返されることはなく、エラーブロック内の読みやすい1行として返ります。アシスタントはそれに基づいて対応でき、ユーザーに表示することもできます。APIからの拒否は、API自身の文言、エラーコード、説明ページへのリンクをそのまま保持します。

クライアントにインストールする

このブロックをクライアントのMCP設定に追加し、クライアントを再起動してください。DOC_CHEAP_API_KEY にご自身のキーを設定します。省略した場合は公開サンドボックスキーが使われます。

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

• ブロックを追加したら、クライアントを再起動してください。サーバーはクライアントが起動するため、変更した設定や環境変数は、起動し直したときにしか反映されません。
• DOC_CHEAP_API_KEY を設定しない場合、サーバーは公開サンドボックスキーを使います。スキャンはその無料枠の範囲内で実行され、報告する残高はありません。動作を確認するには、これが最も手早い方法です。
• オプション設定：DOC_CHEAP_DOCS_BASE（検索結果のリンク先）、DOC_CHEAP_DOCS_DIR（検索対象にするドキュメントのコピー）、DOC_CHEAP_IMAGE_ROOT（下記の安全策を参照）。

またはホスト型サーバーに接続する

同じ3つのツールが https://mcp.doc.cheap/mcp でStreamable HTTP経由でホストされているため、URLに接続するタイプのクライアントなら何もインストールする必要はありません。ログインも不要です。キーは X-Doc-Cheap-Api-Key または Authorization: Bearer として送信します（両方送った場合は名前付きのヘッダーが優先されます）。何も送らなければ公開サンドボックスキーが使われます。ホスト型サーバーはお使いのマシン上のファイルを読めないため、画像はbase64またはhttpsのURLで受け取ります。

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とclaude.aiでは、Settings、Connectorsからカスタムコネクタとして、URL https://mcp.doc.cheap/mcp を指定して追加します。キーがなければサンドボックスキーで動作します。

3つのツール

• scan_document は画像を image_base64、image_path、image_url のいずれかで受け取り、直接呼び出しと同じオプション（expect_country、return_portrait、reference、idempotency_key など）を受け付けます。
• search_docs はサーバーと一緒に配布されるドキュメントのコピーを読むため、ネットワークなしで回答します。つまりエージェントは、呼び出しを消費せずにフィールドの一覧やエラーコードを調べられます。
• check_balance には、アカウントに紐づいたキーが必要です。公開サンドボックスキーでは、実際の値のように見えるゼロを返すのではなく、残高がないことをはっきり伝えます。
• すべてのツールが出力スキーマを宣言し、それに沿った構造化コンテンツを返すため、エージェントはテキストを解析せずにフィールドを利用できます。
• ドキュメントの各ページは、エージェントが読めるリソースでもあります。また、4つのプロンプト（書類をJSONに読み取る、有効期限を確認する、まとめてスキャンする、エラーコードを説明する）で、よくある作業を1ステップで始められます。

料金

認識できた書類1件あたり$0.01。定額で、すべてのアカウントに、どの処理量でも同じです。料金は1つだけで、交渉の余地もありません。課金されるのは書類を認識できた場合だけです。何も見つからない、画像を読み取れない、種類を識別できないスキャンは、判定結果を返すだけで料金はかかりません。すべての結果にどちらだったかが示されるため、エージェントもあなたも、その呼び出しで料金が発生したかどうかを常に把握できます。

アカウントを作る前でも、公開サンドボックスキーでIPアドレスごとに合計10件の書類を無料で認識できます。リクエストは結果にかかわらず1時間あたり最大10件です。登録すると20クレジットが追加されます。1クレジットは1セントで、1セントは書類1件です。

本番環境での認識時間は中央値で約275 msです。各結果には処理時間が含まれるため、エージェントのループは実際の数値をもとに時間の見積もりを立てられます。

直接呼び出す場合と同じ料金、同じキー、同じレスポンス形式です。課金の仕組みと他サービスとの比較をご覧ください。

サーバーが送信する情報

デフォルトでは、サーバーはどこにも何も報告しません。障害の報告は、ご自身で報告先を設定しない限りオフで、設定がなければトラッカーのライブラリは読み込まれることすらありません。

知っておきたい2つの安全策

サーバーはお使いのマシン上で、あなたの権限で動作し、その引数はモデルが選びます。そのため、2つの引数には制限を設けています。

image_base64 にはこれらの制約がありません。呼び出し側がすでにバイト列を持っているからです。上記のどの拒否も image_base64 を案内するのはそのためです。