ClaudeとReadwiseを連携する方法 — ハイライト検索とReaderの文書を会話で扱う

Readwiseのコネクタを使うと、Claudeが自分のハイライトとReaderの文書を直接検索し、新しいハイライトの作成やタグ付け、受信箱の整理まで会話の中で実行します。読んだ記事の中身をClaudeが把握した状態で質問できるのが最大の違いです。接続先はRemote MCPサーバー(https://mcp2.readwise.io/mcp)で、Readwiseアカウントでの認証が必要です。

接続の入口はプランで変わります。個人プランは自分で追加し、TeamとEnterpriseは管理者が先に有効化します。Claude Codeには、claude.aiのコネクタとして届く経路と、claude mcp add で足す経路の2本があります。

Readwiseコネクタとは何か

Readwiseコネクタとは、Readwise社が提供するMCPサーバーを通じて、ReadwiseのハイライトとReaderの文書をClaudeから扱えるようにする連携です。Claudeのコネクタ一覧では「Anthropic verified」と表示され、カテゴリは「Productivity」、提供元はReadwise Inc.です。サインインは必須です。

扱える対象は2つに分かれます。

• Readwiseのハイライト: 引用やメモ。検索、一覧、作成、更新、削除ができる
• Readerの文書: 保存したURLやHTML・テキストの文書。全文検索、保存、移動、タグ付けができる

提供元の説明では、ライブラリ全体を意味検索し、新しい文書の保存、ハイライトの作成、文書の移動、タグ付けを実行できるとされています。

プラン別の接続経路

接続の手順は、個人で使うか組織で使うかで分かれます。Readwiseは「Anthropic verified」のディレクトリ掲載コネクタなので、組織向けの経路はカスタムコネクタではなくディレクトリ側の手順になります。

TeamとEnterpriseで、ディレクトリにないURLを組織に足すなら話が変わります。この場合は「Organization settings」>「Connectors」で「Add」を押し、「Custom」にカーソルを合わせて「Web」を選びます。追加できるのはTeamではOwnerとPrimary Owner、Enterpriseではこの2者に加えて「Manage access to Libraries」を含むカスタムロールの持ち主です。

組織側が追加した後、メンバーは「Customize」>「Connectors」で一覧から該当のコネクタを探し、「Connect」を押して認証します。コネクタが使えるのはプライベートなプロジェクトだけで、同期した内容を含むチャットは共有できません。

個人プランで手動追加する手順

提供元のページは「名前とURLを入れて『Add』を押す」と案内しています。サポート記事では、URLの後に「Continue」で認証設定の確認画面が挟まります。そこではAuthenticationを3択から選びます。「Sign in now」「Sign in when needed」「No sign in」です。OAuth clientとRequest headersも設定できます。2つの案内で画面の数が違うのは、このためです。

追加後は、チャット左下の「+」から「Connectors」を開き、会話ごとにオン・オフを切り替えます。カスタムコネクタの設定は後から編集できず、直すときは一度削除して入れ直します。

Claude Coworkでも、Readwiseのページは同じ手順を案内しています。カスタムコネクタはClaude、Cowork、Claude Desktopで、無料・Pro・Max・Team・Enterpriseの各プランから使えます。無料プランのカスタムコネクタは1つまでです。

接続元と社内ネットワーク

カスタムコネクタへの接続は、手元のPCではなくAnthropicのクラウドから行われます。CoworkやClaude Desktopでも同じです。サポート記事は、プライベートネットワークやVPNの内側にあるサーバーはAnthropicのIPレンジを許可しない限り接続できないと説明しています。ReadwiseのコネクタURLは公開ホスト名なので、この条件が問題になるのは自前のMCPサーバーを足すときです。

Claude Codeから使う

Claude Codeでは、ターミナルで1行のコマンドを実行してMCPサーバーを追加します。

claude mcp add --transport http readwise \
  https://mcp2.readwise.io/mcp

追加後、Claude Codeを開いて /mcp を実行し、readwise を選んで「Authenticate」を押すと、ブラウザーでReadwiseの認可画面が開きます。Claude Codeの使い方全般はClaude Codeの全体像にまとめています。

追加先は既定でプロジェクト単位

Claude Code v2.1.289で、空のホームディレクトリと空のプロジェクトを使ってコマンドを実行しました。パスは読みやすいよう置き換えています。出力は次のとおりです。

$ claude mcp add --transport http readwise https://mcp2.readwise.io/mcp
Added HTTP MCP server readwise with URL: https://mcp2.readwise.io/mcp to local config
File modified: ~/.claude.json [project: ~/work/demo]

claude mcp add --help の -s, --scope は「local, user, or project」で、既定は local です。設定は ~/.claude.json の、そのプロジェクトのパスの下に書かれます。保存された内容は次の3行だけでした。

"readwise": {
  "type": "http",
  "url": "https://mcp2.readwise.io/mcp"
}

つまり、別のディレクトリで claude を起動すると readwise は出てきません。どのプロジェクトでも使いたいなら --scope user を付けます。チームで共有するなら --scope project で、リポジトリの .mcp.json に書き出されます。

claude.aiのコネクタとの関係

Claude Codeを使い始める前にclaude.aiでReadwiseを接続していた場合は、状況が違います。claude.aiのサブスクリプションでログインしていれば、/mcp に claude.ai 付きの名前でコネクタが自動で並び、追加の操作はいりません。

コネクタが /mcp に出ないときは /status で、いまの認証方式を確かめます。ANTHROPIC_API_KEY、apiKeyHelper、サードパーティのプロバイダー、claude setup-token で作ったトークンのいずれかが有効だと、claude.aiのコネクタは取得されません。

標準入出力型の代替も案内されています。MCPのリモート接続に対応していないアプリ向けに、npx -y mcp-remote https://mcp2.readwise.io/mcp を使う方法です。ターミナル型のエージェントには、MCP設定が不要なReadwise CLIも用意されています。

使えるツール22個の内訳

コネクタページには22個のツールが並びます。役割別に分けると次の4系統です。

ハイライト検索はベクトル検索と全文検索を組み合わせたハイブリッド検索で、Readerの文書検索もハイブリッド検索です。キーワードが一致しなくても、意味の近い記述を拾えます。

reader_get_document_details は文書のメタデータと全文をMarkdownで返します。Claudeが記事の中身を読んで答えられるのは、このツールがあるからです。reader_bulk_edit_document_metadata は1回で最大50件の文書を編集できます。reader_move_documents の移動先は、受信箱(inbox)、後で読む(later)、ショートリスト(shortlist)、アーカイブ(archive)、フィード(feed)の5つです。

reader_create_highlight は、文書内の「正確なテキスト」を指定してハイライトを作るツールです。ハイライトを付けさせるときは、対象の文を要約でなく原文のまま示すよう頼みます。

会話での使い方

提供元は、そのままコピーして使えるプロンプト例を7つ公開しています。代表的なものを取り上げます。

たとえば「先月保存した記事のうち、料金設計に触れているものを探して要点を3行ずつ」のように、期間とテーマを添えると絞り込みやすくなります。ハイライトの検索結果から元の文書を開き、全文を読ませて質問を重ねる、という往復もできます。

整理を任せる例も用意されています。Readerの受信箱の各項目に、タグと、ショートリスト・後で読む・アーカイブのどれにするかを提案させるプロンプトで、末尾に「変更する前に確認してください」にあたる一文が付いています。タグ付けや移動が一括で走るのを防ぐ書き方として、自分のプロンプトにも流用できます。

残りの1つは、ハイライト・文書・ノート・タグの大きなサンプルを読ませ、自分では気づいていない傾向を指摘させる使い方です。読み取り中心の使い方なので、書き込み系の権限を開けずに試せます。

書き込み系ツールの権限を管理する

Readwiseのツールには、読み取りだけでなく書き込みや削除が含まれます。readwise_delete_highlight はハイライトを削除し、reader_move_documents は文書の置き場所を変えます。

サポート記事の「Restrict actions within connected services」は、TeamとEnterpriseのOwner向けの設定です。「Customize」>「Connectors」でコネクタを選ぶと「Tool permissions」が出ます。読み取り専用や書き込み・削除といった種類ごと、またはツール単位で「Always allow」「Needs approval」「Blocked」を選べます。この設定は組織全体に効き、個人のユーザーは上書きできません。

Claude Codeでの効き方は、設定の値で変わります。

• Needs approval: 毎回の呼び出しで承認を求められる。auto や bypassPermissions でも確認が出て、許可ルールを書いても省略できない
• Blocked: ツールがClaudeの目に触れる前に取り除かれ、/mcp では「disabled by your organization」と表示される

コネクタ側の権限は、接続先のサービスの権限を超えません。Claudeでツールを許可しても、ReadwiseやReaderの側で本人に認められていない操作は実行できず、Claude側の制限は許可を狭めるだけです。

Claude Codeで読み取りだけ許可する設定例

個人で使う場合や組織の制限が無い場合は、Claude Code側の許可ルールで同じことができます。MCPツールのルールは mcp__<サーバー名>__<ツール名> の形で書きます。サーバー名は先ほどのコマンドで付けた readwise です。mcp__readwise と書くとそのサーバーの全ツール、mcp__readwise__* でも同じく全ツールに一致します。

検索と一覧だけを許可し、削除は拒否する設定は、たとえば次のような形になります(設定ファイルの書式は権限ドキュメントに沿った例です)。

{
  "permissions": {
    "allow": [
      "mcp__readwise__readwise_search_highlights",
      "mcp__readwise__readwise_list_highlights",
      "mcp__readwise__reader_search_documents",
      "mcp__readwise__reader_list_documents"
    ],
    "deny": [
      "mcp__readwise__readwise_delete_highlight"
    ]
  }
}

allowに載せなかった作成・移動・タグ付けのツールは、実行のたびに確認が出ます。読み取りは止めず、書き込みだけ人が見る構成になります。

サーバー名の部分は、接続の経路で変わります。claude mcp add で足したときは上のとおり readwise です。claude.aiのコネクタをClaude Codeが取得した場合、ツールは mcp__claude_ai_<サーバー名>__<ツール名> の形で現れます。経路によって名前の形が違うため、ルールは使っている経路に合わせて書き分けます。

ルールには、広く書ける場所に制約があります。allowのワイルドカードは mcp__readwise__ のようにサーバー名を文字どおり書いた後ろでだけ使え、mcp__* のような書き方は読み飛ばされて何も自動承認しません。denyとaskは、mcp__* で全MCPツールを対象にできます。

CLAUDE.mdに運用ルールを書いておく方法もあります。ここでは一例として、次のような数行を置きます。

## Readwiseの扱い
- 文書を移動・タグ付けする前に、対象の一覧を表で見せて確認を取る
- 検索結果を引用するときは、文書のタイトルとハイライトの本文を併記する
- ハイライトの削除は依頼されたときだけ行う

CLAUDE.mdは指示であって権限の制御ではないので、削除の禁止のような譲れない条件は、上の deny で止めるのが確実です。

日次レビューとエクスポートの使いどころ

readwise_get_daily_review は、間隔反復で選ばれたその日のハイライトを返します。朝の最初に「今日のレビューを出して、関連する保存済み記事があれば添えて」と頼むと、復習と関連文書の検索が1回の会話で済みます。

reader_export_documents は、Readerの全文書をMarkdownのZIPとして書き出す操作です。実行すると書き出しが始まり、reader_get_export_documents_status で状態を確認して、完了後にダウンロード用のURLを受け取ります。対象が全文書なので、一部の文書だけを取り出したいときは reader_list_documents で絞り込んで読む方が合います。

会話検索やメモリとの違い

Claudeの会話検索とメモリは、Claude上でこれまでに話した内容を対象にします。Readwiseコネクタが対象にするのは、Claudeの外で読んで集めた資料です。両者は補い合う関係にあり、使い分けはClaudeの会話検索とメモリの解説で確認できます。

社内文書の検索を目的にするなら、Confluence連携のように業務ツール側のコネクタが向きます。個人の読書ログと社内ナレッジは、別々のコネクタで別の問いに答える構成です。

ほかのアプリでも同じサーバーを使える

同じ https://mcp2.readwise.io/mcp は、ChatGPT、Codex、Cursor、Perplexityなどの手順も提供元のページに載っています。ChatGPTとCodexはアプリストアやプラグインから入れる案内で、URLを直接入れるのはClaude、Claude Code、Perplexityなどです。Perplexityでカスタムコネクタを使うには、Pro、Max、Enterpriseのいずれかの契約が必要です。ClaudeとほかのAIアプリを併用していても、ハイライトの置き場所はReadwiseの1か所のままです。

つまずいたときの切り分け

• 認可が通らない: 「Customize」>「Connectors」でいったん切断して接続し直す。サインイン画面では、使っているReadwiseのアカウントを確かめる
• 「This corporate identity…」と出る: 検証済みドメインを持つEnterprise組織が、外部アカウントからの接続を制限している。その組織のClaudeアカウントでサインインして接続する
• 手動追加で失敗する: URLの末尾まで正確に https://mcp2.readwise.io/mcp と入力する。トークンなしでこのURLにGETすると、HTTP 401が返り、WWW-Authenticate ヘッダーにOAuthの保護リソースメタデータの場所が示される。認証前にブラウザーで開いても内容は見えず、認可はClaude側の接続フローで行う
• 一括処理が怖い: 書き込み系を「Needs approval」にし、最初は少数の文書で試す
• コネクタの信頼性: 提供元の注意書きにあるとおり、Anthropicはコネクタの提供するツールを管理していない。接続する前に提供元を確認する

公式の一覧に「Anthropic verified」の表示があっても、ツールの挙動が変わる可能性はあります。ツール名は提供元が「安定している」と案内しているので、プロンプトに直接書いて呼び出せます。

Readwiseコネクタが向く使い方

向くのは、Readwiseに読書の蓄積があり、それを質問や整理の材料にしたい人です。検索窓では探しにくい「あの記事のどこかにあった話」を、Claudeなら意味で探せます。

一方で、Readwiseにまだ資料がほとんどない場合は、引ける情報が少ないぶん効果を感じにくくなります。まず保存とハイライトの習慣があってこそ活きる連携です。

数値の集計やCRMの更新のような業務データの操作は、Mixpanel連携やSupermetrics連携のような別のコネクタの領分です。Readwiseは、読んだものを会話に引き込むための入口と考えると整理しやすくなります。