feedly-mcp

Claude에서 내 Feedly 구독을 함어 보세요. *"내 AI 피드에 뭐가 새나 있지?"*라고 물으면 브라우저를 열지 않고 답을 받을 수 있습니다.

모든: 아직 설치할 수 있는 것은 없습니다

이 저장소에는 아직 설계 문서만 있습니다 — 코도는 없습니다.

NPM 패이지도, .mcpb 밴들도, 를리즈도 없습니다. 아랫 의 모든 명은 오늘 실패합니다. 이 명들은 의도된 경험을 설계하며, 시설 흐름이 만든어고기 전에 설계될 수 있도록 먼저 작된 것입니다. 이 변경 시점을 알면 워치해.

What it does(일를 설명)

에이전트가 다른 Feedly 계정을 읽을 수 있것 하는 여섯 가지:

하지 않는 일

This is a connector, not a reader app, it output converts your request into a Feedly API 갖고, give back a 됸끝을. It tool never stores story, searchable, doesn't archive, ranks, and doesn't send digests.

Entire are good features you need. Build them against this, in Claude Projecte, a Skill, or scheduled 작업. That's what --remove them-- the software enough 신을 만크며, small.

개인정보 보호

모든 것이 내 기디에서 실행됩니다.

• Feedly 토큰은 로컬에만유지. 우리와 계정관계가 없다(만커서버, 원격모두 탐지).

• it is not sent to any destination else api.feedly.com.

• 당신의 reading 행적에 대한 것는 매우 짧은 시간 동안 로칼 캐 외에 저장되지 않았습니다.

요구

• Node.js 20 or never# — 신확인 with node --version

• Feedly 계정 and API token (아래 1단계)

• Cluade Desktop, Claude Code, 혹은 기타 MCP client

Step 1 — Feedly API 토큰 발급

1. 브라우저에서 Feedly에 로그인.

2. **https://feedly.com/v3/auth/dev**로 이동.

3. 따라 개발자 토큰 생성.

4. 다음 계단계를 위해 안전하게 보안. This is pasword — treate it like one.

진행 전 두 가지 알아 두기.

토큰은 자동으로 만료됩니다. 무료 계정은 토큰 유효기한 30일이고, 이후 이 계단계를 다시 반복하세요. 유로 플로은 자동생신 수 있습니다. Feedly의 정책이고, 도구가 해결할 수 없는 것입다.

**토큰을 내놓으는 것은 계획 단가에 따라 달ла집니다. Feedly 문서 상에서 어느 티이 API 토큰을 자가 발급할 수 있는지 어도 이 문가가 inconsistent 함. 그래서 이 페이지에서 토큰이 생성되지 않으면, connector로 나의 계정에 working없습니다. 페edly 문의가로의에 해결은 없습니다.

2단계 — 설치

사용불가. 아래의 세 가지의 approach are 모두 공개된 packaged code — делают npm package or .mcpb bundle — 그리고 is not exist any one. So 이번 역은 is plan, not guide가 아닙니다.

아래 세 가지 방법 하나 만 선택:

**### Option A — Claude Desktop, single-button shortest

1. 저장소의 Releases 페이지에서 latest feedly-mcp.mcpb 다운부. (아직 Released 없음.)

2. Claude Desktop ope데스크톱 설정 → Extension.

3. A .mcpb file to the inline.

4. After setup form is displayed, paste Feedly API token.

Note paste your token and install.

Your token is kept in system keychain — not in plain text file. All in Configuration you can make changes directly with this form.

Option B — Claude Desktop manually/ (수동 설정)

1. Open Claude Desktop의 설정 파일:

설정 file이 없이면 {}로 내용체 생성.

2. feedle entry을 넣으세요:

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

mcpServers 안에 이미 other server have? feedle가장에 넣기 — no needs to replace the 낟것.

3. Claude Desktop를 완전히 재첩작합니다. Window close만으로는 부족하니, application end 해.

4. Message창의 아이콘이 **Tools 아이콘이 있. feedly있목록이 보이여야한다.

Option C — Claude Code

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

verify fits on:

claude mcp list

claude mcp add --help run if my version requires other env var flag.

Step 3 — Connectivity check :

시작하기전, 미널에서 연결:

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

표준한 output result:

✓ 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 will never never prontprint token. 4단계의 scope input when list the felders.

If you see an error go to 문제 해결.

** 4단계 — Select (Optional)

기본 would. It skip. First to see setting은 'scope' — surrounds 어떤 folder를 Claude가 볼 수 있지.

Create ~/.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 should 사용 two을:

• Priv. 작업 폴더가 아닌 에이전트에게 나.읽을 수 없은 것이.

• Focus. 폴더가 적으면 답볼이الن 짧시지고, ask하지 않은 것에 consumed 문맥.

If you installed through 옵션 A, instead edit this in the extension's setting form — same function, file을 찾을 필요 no.

모들 설정 see: docs/configuration.md

Using it

Asking is enough. Actually 동작할 수 있는 예:

• "What ever since yesterday from my AI 지糯미?"

• "Anthing worth reading in AI Research - this week?" *? *"지난주에 AI–Research해 but enough reading?"

Let me write these correctly in Korean:

• "어제 후 나의 AI 피드에 뭐가 새로운 것?"

• "이번 주 AI - Research에서 읽을 가치가 있는 거?"

• "읽지 않은 기사 수를 폴더별로 알려 줘."

• "로컬 LLM 추론 관련 피드를 찾아줘."

• "지난 8시간동안 참여도가 높은 5개를 요약해 줘."

폴더 IDs... Do not need:

노드.

폴더의 ID까지 몰라도 된다. 폴더이름을 사용할 수 있고, Claude가 열거해 준다.

All tool 참조는: docs/tools.md

API quota — 꼭 읽어주세.

**your daily API quota has been implemented at a larger limit — such as sums are less than official.

실제 API와의 대비 측정에서 Pro Plus paid account의 dev token한 발행량의 ceiling은 하루 50 call이며, UTC자정 hour에 리셋. Feedly의 own doc는 무료 250/Pop500에 say. 그런데 50로 간주하세요.

Then there is whatever heavy, roughly 약 8회 대화, syetem이 사용자 계정 전체입니다 — 즉 browser Feedly 포함에, agent가 소진해 브라우저 못 씀.

그리하여:

• 폴더 및 구독 목록 24시간 캐시.

• 15분 안에 반복 혹은 동일한 요청 은 cache.

• 하나의 호출에 folder당 전체를 one, never one feed.

• Session당 채팅 10, daily 40 — 남기는 것.

매 response에서 잔여 quota 표시합니다. below 10이면 경고.

own limit도 doctor로 — 실제로 나오는 limit을출. 50보다 크면 configuration에서 raising safe.

기사를 읽음으로 표시

mark_read는 영구적. Feedly에서 되돌릴 수 없고, 복구는 support에 이메일. 그래서 초기에는 비활성.

To enable read single:

[writes]
enabled = true

전체 folder 한번 read — большой 폭발 반경 — 그 후 별도.

[writes]
enabled = true
bulk_mark_read = true

unsubscribe는 목적적으로 비구현. 그 작업은 Feedly에서.

Trouble shooting

doctor 보고서 token missing

서버가 다음 순서로: 우선 env FEEDLY_TOKEN, then feedly.token_file이 가리키는 해당 파일. 사용된 그 곳에 token이 잘 들어 있으며? 일반적원인은 설정파일 편집하면서 CLAUDE DESKTOP env 변수를 empty로 전달해서 우선권을 가질 수 있습니다.

"Token 만료" 인가 401

Free account token lasts 30 days. 반복 1단계 and update. 이건 예상된 것, 그리고 다시 발발 수 있음 — 아님.

Claude가 도구를 안 보임

완전히 종료 후 재실행 — 창을 re-open 하면 MCP server가 리로드되지 않음 — JSON 의 유효성 검사 (트레일링 컨마가 자주 원인) 및 node 20 이상.

"Rate limit..." (429)

오늘의 Feedly 할당량을 소모했습니다. 리셋시간이 error message에 찾습니다. 서버가 자동으로 retry하지 않으면 — 재시도가게 더 들어지만 악해.

"일일 다 사용"

이 위에 것과 다 — 이거는 도구 own의 own's superl, Feedly의 것이 아님. 실제 веще의 남은것이 있습니다. budget.daily_calls 올리세요.

폴더 "scope" out

scope.include_folders가 존재하며 folder 선택 목록에 없습니다. 그폴더를 add를 하시거나, list를 비워서 전체 허용하세요.

캐시가 타 계정 처럼 보임

캐시를 지운 후 retry:

rm -rf ~/.cache/feedly-mcp

Contribute

프리하게 Issue and PR 。

What is included — spec: **** excluded deliberately — in feedlymcpspec.md. Read before propose; 만약 아이디어가 "not in scope"인 목록이에 있다면 from oversight 아니, 결정. Worth you argum 가능합니다.

License

MIT