From 77b186c3a599297da0cf19e923c66607ad7d74e7 Mon Sep 17 00:00:00 2001
From: Chen Ye <cye@alumni.brown.edu>
Date: Sun, 8 Feb 2026 16:07:31 -0800
Subject: feat(mcp): Support custom configurable HTTP headers (#2436)

* feat(mcp): Support custom configurable HTTP headers

* docs(mcp): Add KARAKEEP_CUSTOM_HEADERS documentation

* fix(mcp): Prioritize default headers and safely parse custom headers

* docs(mcp): Correct capitalization of Cloudflare headers
---
 apps/mcp/src/shared.ts | 12 ++++++++++++
 1 file changed, 12 insertions(+)

(limited to 'apps/mcp/src')

diff --git a/apps/mcp/src/shared.ts b/apps/mcp/src/shared.ts
index a80c3620..b2ffff05 100644
--- a/apps/mcp/src/shared.ts
+++ b/apps/mcp/src/shared.ts
@@ -6,9 +6,21 @@ import { createKarakeepClient } from "@karakeep/sdk";
 const addr = process.env.KARAKEEP_API_ADDR;
 const apiKey = process.env.KARAKEEP_API_KEY;
 
+const getCustomHeaders = () => {
+  try {
+    return process.env.KARAKEEP_CUSTOM_HEADERS
+      ? JSON.parse(process.env.KARAKEEP_CUSTOM_HEADERS)
+      : {};
+  } catch (e) {
+    console.error("Failed to parse KARAKEEP_CUSTOM_HEADERS", e);
+    return {};
+  }
+};
+
 export const karakeepClient = createKarakeepClient({
   baseUrl: `${addr}/api/v1`,
   headers: {
+    ...getCustomHeaders(),
     "Content-Type": "application/json",
     authorization: `Bearer ${apiKey}`,
   },
-- 
cgit v1.2.3-70-g09d2