[PR #1971] feat: Improved MCP functionality #1939

New issue

Open

opened 2026-03-02 11:59:51 +03:00 by kerem · 0 comments

kerem commented

2026-03-02 11:59:51 +03:00

Owner

📋 Pull Request Information

Original PR: https://github.com/karakeep-app/karakeep/pull/1971
Author: @CaseyRo
Created: 9/22/2025
Status: 🔄 Open

Base: main ← Head: main

📝 Commits (9)

f221c51 docs(mcp): restore claude manifest guidance
0b3131b Merge pull request #1 from CaseyRo/codex/expand-mcp-component-for-http-streamable
7bb043d feat(mcp): verify API key during startup
bf3928b fix: handle api key verification response correctly
bdc4044 Merge pull request #2 from CaseyRo/codex/implement-health-check-for-api-key-usage
6460f55 Improve MCP startup error messaging
7940a30 Merge pull request #3 from CaseyRo/codex/improve-error-feedback-for-mcp-server
effbb4c docs: add MCP build instructions
f7ae0ff Merge pull request #4 from CaseyRo/codex/update-documentation-for-building-from-source

📊 Changes

11 files changed (+951 additions, -31877 deletions)

View changed files

📝 apps/mcp/README.md (+72 -2)
📝 apps/mcp/package.json (+2 -0)
📝 apps/mcp/src/bookmarks.ts (+153 -149)
📝 apps/mcp/src/index.ts (+204 -8)
📝 apps/mcp/src/lists.ts (+118 -115)
📝 apps/mcp/src/shared.ts (+200 -8)
📝 apps/mcp/src/tags.ts (+62 -59)
📝 docs/docs/09-mcp.md (+67 -1)
📝 docs/versioned_docs/version-v0.27.0/09-mcp.md (+67 -1)
📝 packages/trpc/routers/subscriptions.ts (+1 -1)
📝 pnpm-lock.yaml (+5 -31533)

📄 Description

MCP server can now run over either stdio or the HTTP streamable transport with per-session handling plus user-facing startup hints for common misconfiguration errors.
Startup configuration now enforces the required Karakeep environment variables, normalizes the API URL, logs the selected transport, provisions the SDK client, and verifies API credentials up front, confirming the authenticated identity before serving requests.
Documentation now highlights the supported MCP capabilities and walks users through launching the integration from Claude Desktop, terminal workflows, Docker images, and the HTTP streamable mode.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/karakeep-app/karakeep/pull/1971 **Author:** [@CaseyRo](https://github.com/CaseyRo) **Created:** 9/22/2025 **Status:** 🔄 Open **Base:** `main` ← **Head:** `main` --- ### 📝 Commits (9) - [`f221c51`](https://github.com/karakeep-app/karakeep/commit/f221c51b1457d36df6463cd15d95b7ed2bdfb950) docs(mcp): restore claude manifest guidance - [`0b3131b`](https://github.com/karakeep-app/karakeep/commit/0b3131b8fd96ffb63523fd18777e180baf2cbc70) Merge pull request #1 from CaseyRo/codex/expand-mcp-component-for-http-streamable - [`7bb043d`](https://github.com/karakeep-app/karakeep/commit/7bb043dc03b718fa38166063b4a238a4b0d32330) feat(mcp): verify API key during startup - [`bf3928b`](https://github.com/karakeep-app/karakeep/commit/bf3928b023b09b2c87b08428aa205e156a7a4b6a) fix: handle api key verification response correctly - [`bdc4044`](https://github.com/karakeep-app/karakeep/commit/bdc404414e741bb6b9f06f4ef48e07681cb10ac6) Merge pull request #2 from CaseyRo/codex/implement-health-check-for-api-key-usage - [`6460f55`](https://github.com/karakeep-app/karakeep/commit/6460f55b908135a9111350fb5ea94aa78ccbb062) Improve MCP startup error messaging - [`7940a30`](https://github.com/karakeep-app/karakeep/commit/7940a30f9bca0ccd01019a21140f333f8872ab34) Merge pull request #3 from CaseyRo/codex/improve-error-feedback-for-mcp-server - [`effbb4c`](https://github.com/karakeep-app/karakeep/commit/effbb4ce030999e5dfecdd93cbf77b11dfd2dea2) docs: add MCP build instructions - [`f7ae0ff`](https://github.com/karakeep-app/karakeep/commit/f7ae0ffc822fb8aa4883c43c6c98e7915797971d) Merge pull request #4 from CaseyRo/codex/update-documentation-for-building-from-source ### 📊 Changes **11 files changed** (+951 additions, -31877 deletions) <details> <summary>View changed files</summary> 📝 `apps/mcp/README.md` (+72 -2) 📝 `apps/mcp/package.json` (+2 -0) 📝 `apps/mcp/src/bookmarks.ts` (+153 -149) 📝 `apps/mcp/src/index.ts` (+204 -8) 📝 `apps/mcp/src/lists.ts` (+118 -115) 📝 `apps/mcp/src/shared.ts` (+200 -8) 📝 `apps/mcp/src/tags.ts` (+62 -59) 📝 `docs/docs/09-mcp.md` (+67 -1) 📝 `docs/versioned_docs/version-v0.27.0/09-mcp.md` (+67 -1) 📝 `packages/trpc/routers/subscriptions.ts` (+1 -1) 📝 `pnpm-lock.yaml` (+5 -31533) </details> ### 📄 Description 1. MCP server can now run over either stdio or the HTTP streamable transport with per-session handling plus user-facing startup hints for common misconfiguration errors. 2. Startup configuration now enforces the required Karakeep environment variables, normalizes the API URL, logs the selected transport, provisions the SDK client, and verifies API credentials up front, confirming the authenticated identity before serving requests. 3. Documentation now highlights the supported MCP capabilities and walks users through launching the integration from Claude Desktop, terminal workflows, Docker images, and the HTTP streamable mode. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

kerem added the

pull-request

label

2026-03-02 11:59:51 +03:00

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

starred/karakeep#1939

No description provided.

Rows
Columns