feedly-mcp

Claude から Feedly の購読を読み取ります。「私の AI フィードに何か新しいものはある?」 と尋ねるだけで、ブラウザを開かずに答えが得られます。

⚠️ ここにあるものはまだ何もインストールできません

このリポジトリに現在あるものは、設計ドキュメントのみ — コードはありません。

npm パッケージも .mcpb バンドルも、リリースもありません。以下に あるコマンドはどれも今日の時点では失敗します。これらは意図する体を表したもので、実装が 作られる前にインストールの流れが設計されるようにと、先に書かれたものです。

変わりがあったら知りたければ、リポジトリをウォッチしてさい。

何ができるか

エージェントがあなたの Feedly account を読むためのの ツール:

何をしないの

これはコネクタであり、リーダーアプリではありません。リクエストを Feedly API コールに変換し、きれいな答えを返します。記事を保存したり、検索可能な アーカイブを構築したり、時間とともにランキングしたり、ダイジェストを送っ たりはしません。

それらはすべて望ましい機能です。しかし、この上に、Claude プロジェクト、スキル、スケジュールされたタスクとして構築してください。それらを 残さないことこそ、このツールを信頼できる大きさに保つのです。

プライバシー

すべては自分のマシン上で動作します。

• あなたの Feedly トークンはローカルに留まります。api.feedly.com 以外に送られることはありません。

• 私たちのアカウントは不要、仲介サーバーもテレメトリもありません。

• あなたが読んだ内容が保存されることはなく、短命のローカルキャッシュのみです。

要件

• Node.js 20 以上 — node --version で確認してください。

• Feedly account アカウント と API トークン(下記ステップ 1)

• Claude Desktop でも、Claude Code でも、その他の MCP クライアントても

ステップ 1 — Feedly API トークンを取得する

1. ブラウザで Feedly にログインします。

2. https://feedly.com/v3/auth/dev を訪れます。

3. そこで指示に従って、開発者アクセストークンを生成します。

4. 次以降のステップのため、トークンを安全な場所にコピーします。トークンはパスワードです。そのようにて扱ってください。

先に進む前に、2つ知っておいてください。

トークンには有効期限があります。 無料アカウントでは、開発者トークンは有効期限が約 30 日 で、期限切れになったらこのステップをもう一度実行します。有料プランでは自動的にリフレッシュできます。これは Feedly のポリシーであり、このツールが回避できるものではありません。

トークンの取得可否はご利用のプランに依存します。 Feedly 自身のドキュメントは、どのアカウント層が API トークンを自動発行できるかについて一貫していません。上記のページでトークンを取得できない場合、このコネクタはそのアカウントでは動作せず、Feedly に連絡する以外に回避策はありません。

ステップ 2 — インストール

Not available yet。 ペたがっての の3 つのパスすべてが公開済みの成果物 — npm パッケージや .mcpb — に依存していますが、どちらも存在していません。このセクションはプランであり、今日実行できる指示ではありません。

以下の 3 つのパスから 1 つ 選んでください。

オプション A — Claude Desktop、ワンクリック(最も簡単)

1. リポジジトリの Releases ページから最新の feedly-mcp.mcpb をダウンロードします (リリースはまだ公開されていません)。

2. Claude Desktop を開き、Settings → Extensions に移動します。

3. .mcpb ファイルをウィンドウにドラッグします。

4. 設定フォームが表示されるので、Feedly API token にトークンを貼り付けて、インストールをクリックします。

あなたのトークンは、オペレーティングシステムのキーチェーンに保存され、平文ファイルには保存されません。設定ドキュメント内のすべての設定は、このフォームから編集できます。

オプション B — Claude Desktop、手動設定

1. Claude Desktop の設定ファイルを開きます。

   OS	Path
   macOS	~/Library/Application Support/Claude/claude_desktop_config.json
   Windows	%APPDATA%\Claude\claude_desktop_config.json

   ファイルが存在しない場合は、内容を {} として新規作成します。

2. feedly エントリを追加します。

   {
     "mcpServers": {
       "feedly": {
         "command": "npx",
         "args": ["-y", "feedly-mcp"],
         "env": {
           "FEEDLY_TOKEN": "paste-your-token-here"
         }
       }
     }
   }

   mcpServers の下に他のサーバーがすでにありますか?その場合は、ブロックを置き換えらずに、feedly をそのとなりに追加してください。

3. Claude Desktop を完全に再起動します。 ウィンドウを閉じるだけでは不十分です。アプリケーションを終了します。

4. メッセージボックスのツールアイコンを探します。feedly がリストされるはずです。

オプション C — Claude Code

claude mcp add feedly --env FEEDLY_TOKEN=paste-your-token-here -- npx -y feedly-mcp

登録されていることを確認します:

claude mcp list

バージョンによって、環境変数に別のフラグが必要な場合は、claude mcp add --help を実行して確認してください。

ステップ 3 — 動作を確認する

Claude に何かを尋ねる前に、ターミナルから接続を確認します:

FEEDLY_TOKEN=paste-your-token-here npx -y feedly-mcp doctor

正常な結果は次のようなものです:

✓ Token found          (environment variable FEEDLY_TOKEN)
✓ Connected to Feedly   you@example.com
✓ 8 folders

  Tech                    70 feeds   user/<uuid>/category/Tech
  Tech - Research         11 feeds   user/<uuid>/category/<uuid>
  Tech - Tooling           6 feeds   user/<uuid>/category/<uuid>
  …

  API calls used today: 1 of 50   (resets in 11h34m)

doctor はあなたのトークンを出力することはありません。ステップ 4 で scope を入力ときは、doctor が提供するフレルダリストを使用してください。

何か問題がある場合は、トラブルシューティングへ移動します。

ステップ 4 — 設定(任意)

デフォルトは妥当であり、ここはまるごとスキップできます。早いに検討する価値のある設定は scope だけです。これは Claude がどのフォルダを見られるか、 を指定します。

~/.config/feedly-mcp/config.toml を作成します:

[scope]
# Only these folders are visible to the agent. Leave empty for all of them.
include_folders = ["AI", "Longform"]

# Used when you ask about articles without naming a folder.
default_folder = "AI"

[defaults]
hours = 8          # how far back get_articles looks
limit = 100        # max articles per call

include_folders を設定する理由は 2 つあります:

• プライバシー. 作業用のフォルダがはエージェントに読取できる必要はありません。 フォーカス. フォルダが少ないほど応答が短くなり、尋ねていない資料に費やす文脈も少なくなります。

オプション A でインストールした場合は、代わりに拡張機能の設定フォームで編集してください — オプションは同じです。ファイルを探す必要はありません。

全設定の一覧: docs/configuration.md

使う

尋ねるだけでいいです。うまく機能する例:

• "Whatは、最近の私の AI 一無に新しいは?"

• "今週に AI - Research を読む価値があるものは?"

• "未読のアーティクルは何件、フォルダごとにどれくらい?"

• "ローのカル LLM 推論に関するフードを探して"

• "この 8 時間でエンゲージメン上部上位 5 件すつ要約して"

フォルダ ID を知っている必要はありません。フールダ名が使えますし、Claudeに 一覧にできます。

全ツール参考資料: docs/tools.md

"""

アプリ API クォータ — 必らず読んでください

1 日あたり API クォータは小さ — Feedlyのドキュメントが示唆するものより小さいです。

ライブ API で測定するいと、有料 Pro Plus アカウントで発行されるトークン 1 日 50 回 が上限と報告され、UTC ののの真夜中ころにリセットされます。Feedly 自身のドキュメントには、無料 250.pro という記述述がありまするが、50だと思定してください。

これは、エージェントが多弁だと1日約8回の会話に相当し、クォータはあなたのアカウントに触れるす他のすべてのもの**— ブラウザ内の Feedly も含めます** — と共有されます。エージェントがを使いきると、そちらも動でなくなります。

そこで、このツールはあなたに代わって予算を守ります:

• ロlderダと購読リストは 24時間ディスクに頻繁にキ シュされます。

• 15 分以内の同一リクエストはキ シュから返されます。

• 1 回の呼び出しでフールダ全体ま取得します — フィードごとに呼び出しはありません。

• 会話あたり 10、1 日あたり 40 回の上限を設け、あなたのために場を残します。

• 各応答で残クォータを通知します。10 を下回る警告がです。

• あなた自身の上限は doctor で確してください。実際にアカウントが報告上限を出します。もし 50 より高い値を示したら、設定 で予算を上げても安全です。

既読へマーする

mark_read は永続的です。Feedly には元に戻す方法はなく、回復るにはサポートにメア するしかありません。そのため、無効でシップされます。

1 件の記事だけを既読にするには:

[writes]
enabled = true

さらに、フォルダ全体を一度に既読にすることを許可するには — 影響範囲がはるかに大さい — 内意図的に 2 つ目のスのイッチ入れる必要があります:

[writes]
enabled = true
bulk_mark_read = true

購読解除は意図的にに実装しません。それは Feedly で行ってください。

トラブルシューティング

doctor が トークンがないと指摘する

サーバーはこの順序で探します:FEEDLY_TOKEN 環境変数、その次に feedly.token_file が指定するファイル。どちらを使ったにしてても、その場所にに入っているか確認してください。よくある原因は、設定ファイルを編集しても、Claude Desktop が渡す空の環境変数がそちらに優先されてしまうことです。

「トークンの有効期限切れ」または 401

無料アカウントのトークンは約30日で失効します。ステップ 1 を繰り返し、保存したトークンを更新してください。これは正常な動作で、繰り返し発生しますが、バグではありません。

Claude がツールを認識しない

Claude Desktop を完全に終了して開き直してください — ウィンドウを再起動しただけでは MCP サーバーは再読み込みされません。そのあと、JSON が正しいこと(末尾のカンマがよくある原因)、および node --version が 20 以上あることを確認してください。

"Rate limit exceeded" (429)

その日の Feedlyー クォータを使い切りました。リセットは Feedlyのスケジュールに従います。エラーメージにはリセット時刻が含まれています。サーバは自動的にリトラいません — 再試行するは、より深くく 状態を悪化せせるだけです。

"Daily budget exhausted"

上記とは違います。これは このツール自身の 上限であり、Feedly のクォータではありません。実際のクォータはまだあります。さらに必要なら budget.daily_calls を上げてください。

フォルダが "設定されたスコープの外" です

scope.include_folders が設定されており、そのフォルダがそのリストにありません。フルダを追加するか、リストを空にしてすべてを許可してください。

キッシュ済みデータが見知らぬアカウントのもののように見える

キャッシュをクリアして再試行してください:

rm -rf ~/.cache/feedly-mcp

コントリビュト

Issues とプルリクエストを歓迎します。設計の理 — 意図的に除外された機能も含めて — は feedlymcpspec.md にあります。機能を提案する前は、是非お読読みください。アイデアが「スコープ外」リストにある場合、それは見落としではななく決定であす。ただし、それに対し議議するのは歓迎です。

ラ天才

MIT