第7章 再試行と冪等性p. 142
7.3 タイムアウトした要求を再送する
応答が届かなくても、相手側で処理が済んでいることはある。要求ごとに冪等キーを付けて結果を記録すれば、再送しても反映は一度で済む。キーは、再送しうる最長の時間より長く残す。
MCP サーバ · Claude / Cursor / Claude Code
BookLens は、許諾を得た本だけを検索する MCP サーバです。
返す抜粋には、必ず著者・書名・ページ番号の出典が付きます。連携はいつでも解除できます。
第7章 再試行と冪等性p. 142
7.3 タイムアウトした要求を再送する
応答が届かなくても、相手側で処理が済んでいることはある。要求ごとに冪等キーを付けて結果を記録すれば、再送しても反映は一度で済む。キーは、再送しうる最長の時間より長く残す。
第4章 合意アルゴリズムp. 87
4.2 リーダーが応答しないとき
フォロワーは一定の時間リーダーからの通知を受け取らないと候補者になり、任期の番号を進めて投票を求める。過半数の票を集めた候補者が、次のリーダーになる。候補者は同じ任期で二重に投票できないよう、票の記録を永続化する。
第11章 データベース接続管理p. 219
11.4 プール枯渇を連鎖させない
待機キューに上限を設けないと、遅延したクエリがスレッドを占有し続ける。接続の取得に短い待ち時間の上限を置き、超過時は即座に失敗させて呼び出し側へ戻す。失敗の通知が速いほど、上流の負荷制御が早く効く。
01 / How it works
Claude が search_passages を呼び、該当ページから短い抜粋と出典だけを受け取って回答します。
Claude・Cursor・Claude Code に MCP サーバの URL を 1 つ足し、ブラウザで BookLens にログインして連携を認める。
いつもどおりエージェントに質問する。本を引いたほうがよいとき、エージェントが BookLens で本文を検索する。
BookLens が返す抜粋には、必ず「著者『書名』PDF n ページ目」の出典がつく。気になったら、そのページを開いて確かめられる。
Claude + BookLens
MCP TOOL CALLPOST /mcp
search_passages({ query: "タイムアウト 再送 冪等キー" })
← 1 件: 架空の著者『実践 分散システム設計』PDF 142ページ目
要求ごとに冪等キーを付け、サーバ側でキーと結果を記録しておきます。そうすれば再送しても、処理が反映されるのは一度だけです。キーは、クライアントが再送しうる最長の時間より長く残してください。
第7章 再試行と冪等性p. 142
7.3 タイムアウトした要求を再送する
応答が届かなくても、相手側で処理が済んでいることはある。要求ごとに冪等キーを付けて結果を記録すれば、再送しても反映は一度で済む。キーは、再送しうる最長の時間より長く残す。
架空の著者『実践 分散システム設計』PDF 142ページ目
※ デモの書名・著者・本文は架空のものです。
02 / Connect
BookLens は MCP サーバとして検索を提供します。使うには招待制の BookLens アカウントが必要です。初回だけ、ブラウザでログインと同意画面が開きます。
https://app.booklens.xyz/mcp~/.cursor/mcp.json(またはプロジェクトの .cursor/mcp.json)に下の設定を足す。booklens からログインする。{
"mcpServers": {
"booklens": { "url": "https://app.booklens.xyz/mcp" }
}
}/mcp を開き、booklens を選んで認証する。claude mcp add --transport http booklens https://app.booklens.xyz/mcp連携中のエージェントは、アプリの「連携中のエージェント」に並びます。そこで解除すると、そのエージェントのトークンはすぐに使えなくなります。
03 / Trust
SPECIFICATION · 3 PROMISES
検索できるのは、権利者から利用の許諾を得た本だけです。抜粋は短く切って返し、1 冊ごとに読める量に上限があります。
抜粋には必ず「著者『書名』PDF n ページ目」が付きます。エージェントの答えが本のどこから来たのか、自分の目で確かめられます。
連携中のエージェントはアプリの一覧に並び、そこで解除するとトークンはすぐに使えなくなります。検索の語句はログにも残しません。
04 / FAQ
招待制のしくみ、収録書籍、データとプライバシーの扱いについて。
いまは招待制です。アカウントを作れるのは、招待を受けたメールアドレスだけです。下の「招待を申し込む」から申し込めます。
権利者から利用の許諾を得た本だけです。いまは検索できる本を準備しているところです。許諾が取れた本から順に加えます。検索できる本の一覧は、つないだあとに list_books で確かめられます。
料金の仕組みはまだありません。決まったら、このページとブログでお知らせします。
検索の語句と返した抜粋は、ログにもデータベースにも残しません。残すのは、上限の管理に必要な記録(検索の日時と字数、Web かどのエージェントからか、本ごとに読んだ字数)と、検索ごとの丸めた IP アドレスです。ログインの記録には、不正利用を防ぐため IP アドレスの上位の一部(IPv4 は上位 24 ビット、IPv6 は上位 48 ビット)が残ります。ブラウザの情報は残しません。
メールアドレス、「何に使いたいか」(書いた場合)、申し込みのリンクに付いていた utm_source と utm_campaign、直前に見ていたページのホスト名(パスやクエリは残しません)と、申し込み・更新・招待メールを送った日時です。もう一度申し込むと、送った内容を新しいもので置き換えます(最初の申し込み日時は残ります)。メールアドレスは招待の連絡にだけ使います。メールは、はじめての申し込みのときに受け付けのお知らせを 1 通、承認したときに招待のメールを送ります。それ以外には送りません。申し込みの件数は分析ツールの PostHog で数えますが、メールアドレスや書いた内容は送りません。
申し込みの記録は、アカウントを作った時点で消します。承認する前の申し込みと、招待のメールを送ったまま使われなかった申し込みは、最後に申し込んだ日(申し込み直したならその日)と招待のメールを送った日の、遅いほうから 180 日たつと、毎日の処理で消します。退会したときも、そのメールアドレスの申し込みはすぐに消します。
それより前に消してほしいときは、アプリのお問い合わせから、申し込んだメールアドレスを添えてご連絡ください。
出典のページ番号は PDF の通しページ番号です。紙の本に印刷されたページ番号とは一致しないことがあります。
Early Access · Invitation Only
BookLens はいま招待制です。申し込みを確かめたうえで、順にご案内します。