feat(mcp): serve the read-only tools over remote Streamable HTTP at /mcp

Bridge the existing transport-agnostic MCP server factory to a Next.js
route at /mcp using the SDK's Web-standard Streamable HTTP transport, so a
remote client can connect with a manually-minted hlk_ Bearer token. The
same tool/resource layer the local stdio transport serves is reused
verbatim — no duplicated tool logic.

The route owns four gates in front of the transport:

- Auth: Authorization: Bearer hlk_… resolved by the same validator the
  HTTP edge uses, so revoked/expired/scope semantics never drift. A cookie
  is never consulted, so the cookie-only admin boundary stays unreachable
  here regardless of token scope.
- Rate limit: the Postgres limiter keyed by the <userId>:<tokenId> binding
  (mcp:<binding>), so a single shared credential cannot drain the account.
- Module gate: a new opt-in mcp module, OFF by default. With it off the
  endpoint answers 404 and reveals nothing — a self-hoster who never opts
  in gets zero new exposure. The Modules settings hub renders the toggle.
- Transport: a fresh stateless server + transport per request.

Read-only by construction (only read tools are registered) and same-origin
by construction (no CORS headers). The proxy lets /mcp skip the page cookie
redirect since it authenticates by header, mirroring the webhook surfaces.
This commit is contained in:
Marc-André Bombeck committed 2026-06-27 13:47:24 +02:00
1 parent d947bb1104
commit 03d41bc5c0
17 files changed
+599 -2

No files matched your search

+52
View File
@@ -21,6 +21,7 @@ import {
import {
isCoreDomain,
isModuleKey,
isOptInModule,
moduleDelegatesTo,
MODULE_KEYS,
CORE_DOMAIN_KEYS,
@@ -309,6 +310,57 @@ describe("resolveModuleEnabled — operator layer (two-layer AND)", () => {
});
});
describe("resolveModuleEnabled — mcp module (opt-in, default-OFF)", () => {
it("is OFF when no preference is recorded (inverse of the default-on siblings)", () => {
expect(resolveModuleEnabled("mcp", inputs(), false, ALL_AVAILABLE)).toBe(
false,
);
});
it("stays OFF on an explicit false", () => {
expect(
resolveModuleEnabled(
"mcp",
inputs({ modulePreferences: { mcp: false } }),
false,
ALL_AVAILABLE,
),
).toBe(false);
});
it("turns ON only on an explicit true (opt-in)", () => {
expect(
resolveModuleEnabled(
"mcp",
inputs({ modulePreferences: { mcp: true } }),
false,
ALL_AVAILABLE,
),
).toBe(true);
});
it("operator-off short-circuits even when the user opted in", () => {
expect(
resolveModuleEnabled(
"mcp",
inputs({ modulePreferences: { mcp: true } }),
false,
operator({ mcp: false }),
),
).toBe(false);
});
});
describe("registry — opt-in marker", () => {
it("marks only the mcp module opt-in (every other module is default-on)", () => {
expect(isOptInModule("mcp")).toBe(true);
for (const key of MODULE_KEYS) {
if (key === "mcp") continue;
expect(isOptInModule(key)).toBe(false);
}
});
});
describe("resolveOperatorAvailability — disabled allowlist (default-available)", () => {
it("treats null / non-object / array as all-available", () => {
for (const raw of [null, undefined, "nope", ["mood"]]) {