EveryPage

everypage-mcp

EveryPage 用の MCP サーバーです。AI アシスタントが PDF を追跡可能な共有リンクに変換し、誰が実際に読んだのか、どこまで読んだのか、どれくらい時間をかけたのか、どのページで読むのをやめたのかを確認できます。

「この提案書を Jane と Bob に共有して、明日、どちらかが料金ページより先まで読んだか教えてください。」

§ 01 インストール

インストール不要：ホスト型サーバー。 EveryPage では、このサーバーを https://everypage.co/mcp（Streamable HTTP、OAuth サインイン、API キー不要）で提供しています。Claude で「カスタマイズ」→「コネクタ」→「カスタムコネクタを追加」を開き、その URL を貼り付けます。Claude Code では、claude mcp add --transport http everypage https://everypage.co/mcp を実行します。 everypage.co/integrations/claude をご覧ください。 こちらへのアップロードには、ローカルファイルのパスではなく https リンクを指定します。

このパッケージ（stdio）。 everypage.co/account から API キーを取得します。キーは ep_live_… のような形式です。その後、クライアントからサーバーに接続します。

Claude Code

claude mcp add everypage --env EVERYPAGE_API_KEY=ep_live_... -- npx -y everypage-mcp

Claude Desktop、Cursor、VS Code、および JSON 設定を読み込むその他のツール

{
  "mcpServers": {
    "everypage": {
      "command": "npx",
      "args": ["-y", "everypage-mcp"],
      "env": { "EVERYPAGE_API_KEY": "ep_live_..." }
    }
  }
}

Node 20 以降が必要です。

§ 02 できること

ツール	機能
everypage_share_pdf	PDF（ローカルパスまたは https URL）をアップロードし、共有設定を同時に適用して、追跡可能なリンク、埋め込みコード、QR URL を取得します
everypage_list_files	ドキュメントの一覧を表示します。名前による絞り込みも可能です
everypage_get_file	1 つのドキュメントのリンク、保護設定、ステータスを取得します
everypage_update_file_settings	パスコード、有効期限、ダウンロード、閲覧モード、メールゲート、閲覧回数制限、ページ範囲、スラッグを変更します
everypage_delete_file	ドキュメントをゴミ箱に移動するか、完全に削除します
everypage_replace_content	公開中のリンクと履歴を維持したまま、そのリンクに紐づく PDF を差し替えます · Pro
everypage_get_readership	誰が読んだか、どこまで読んだか、どこで読むのをやめたかを確認します
everypage_list_events	ポーリングカーソル付きで、最近の閲覧、ダウンロード、または取得したリードを表示します
everypage_create_variants	受信者ごとに追跡可能なリンクを作成し、閲覧を名前ごとに記録します · Pro
everypage_list_variants	それらのリンクとステータスを表示します
everypage_update_variant	受信者のリンクの名前を変更、取り消し、または復元します · Pro
everypage_delete_variant	受信者のリンクを削除するか、GDPR に基づいて受信者名を削除します · Pro
everypage_list_webhooks	Webhook エンドポイントと配信状況を表示します
everypage_manage_webhook	Webhook エンドポイントを作成、テスト、または削除します
everypage_account	接続中のアカウント、そのプラン、およびプランで利用できる機能を確認します

スラッシュコマンドとして 2 つのプロンプトが用意されています。readership_digest（直近 N 日間に起きたこと）と send_tracked_copies（受信者ごとにリンクを作成し、適切に送信）です。

§ 03 知っておくと便利なこと

ドキュメントの指定方法は自由です。 file を受け取るすべてのツールで、UUID、短いリンク ID、ブラウザーから直接コピーした共有 URL を使用できます。/embed/ リンクや ?via= を含むリンクも使えるため、あらかじめ ID を調べる必要はありません。

アップロードはストリーミングで行われます。 ローカルパスのファイルはメモリに読み込まず、ディスクから読み取るため、Pro プランで 2 GB のドキュメントをアップロードしてもプロセスのメモリ使用量は増えません。ファイルは送信前に、PDF のマジックバイトとプランのサイズ上限に照らして検証されます。

URL の取得に認証情報は使われません。 url 経由では、指定したホストから EveryPage のヘッダーを一切使わずにダウンロードし、その後バイト列をアップロードします。API キーがサードパーティのホストに送られることはありません。

閲覧状況は要約され、生データはそのまま出力されません。 ツールは最も急なリーチファネルの低下や、最も再読されたページなどの分析結果を計算し、グラフ化したい場合に備えて生データの行を structuredContent に格納します。

イベントカーソルはストリームごとに管理されます。 everypage_list_events は nextCursor を返します。このカーソルは同じ type に対してのみ有効です。3 つのストリームはそれぞれ独立した ID の連番を持つため、異なるストリーム間でカーソルを使うと、通知されないまま誤った期間のデータが返されます。

削除はデフォルトで取り消し可能です。 everypage_delete_file はファイルをゴミ箱に移動し、そのことを明示します。取り消しできない操作は purge: true です。元に戻せないツールには MCP の destructiveHint が設定されるため、確認プロンプトに対応したクライアントは実行前に確認を求めます。

§ 04 設定

変数	必須	デフォルト	意味
EVERYPAGE_API_KEY	はい	—	ep_live_… API キー、または ep_at_… OAuth トークン（許可されたスコープに制限されます）
EVERYPAGE_BASE_URL	いいえ	https://everypage.co	セルフホストまたは開発用インスタンスの API オリジン
EVERYPAGE_READ_ONLY	いいえ	false	true の場合、読み取り専用の 7 つのツールのみを公開します

§ 05 プラン

一部の機能はプランによって制限されており、利用を拒否する場合は必要なプランが示されます。 everypage_account では、現在のプランと、そのプランで利用制限される機能を確認できます。

	Free	Basic	Pro
アップロードサイズ	20 MiB	200 MiB	2 GiB
ライブドキュメント	3	100	無制限
トラッキングリンク、共有設定、ウェブフック	✓	✓	✓
パスコード、閲覧上限、閲覧通知、ページごとの統計		✓	✓
受信者ごとのリンク、メールアドレス取得ゲート、コンテンツ置換、ウォーターマーク、ページ範囲			✓

API では、キーごとに 1 分あたり 120 件のリクエストが許可されます。

§ 06 含まれない機能

/files/claim と Canva 公開経路（アプリの配線処理であり、エージェント向けの機能ではありません）、ブランディングアセットとホットスポット（大容量の Pro ペイロードで、エージェントに適した用途がありません）、および認証が必要な QR の取得機能です。各ツールが返す qr_url は公開されており、認証情報は不要です。これらの機能を希望する場合は、Issue を作成してください。

§ 07 開発

npm ci
npm run typecheck
npm test
npm run build
npm run inspector      # drive the tools by hand in the MCP inspector

ツールのインターフェースは test/schemas.test.ts でスナップショット化されています。ツール名や入力項目の名前を変更すると、保存済みのプロンプトや、その名前を指定するエージェント設定すべてが壊れるため、意図的に CI が失敗します。

フィールド名と出力形式は、EveryPage の Zapier、Make、n8n 連携と共有されている統合間契約で固定されています。変更する場合は、まずその契約を変更してください。

§ 08 リンク

• EveryPage · MCP 連携ページ
• 開発者向け API · OpenAPI 仕様
• ドキュメント · サポート

ライセンス

MIT