Compare commits
16
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
ba9d8fbe60 | ||
|
|
c12250fd11 | ||
|
|
8361a5b8e2 | ||
|
|
04b964a866 | ||
|
|
6b28e1d6c8 | ||
|
|
73391a5823 | ||
|
|
9486518832 | ||
|
|
b35a465303 | ||
|
|
54c29d182d | ||
|
|
1728752ce1 | ||
|
|
1fed65a187 | ||
|
|
7d4e8daaaf | ||
|
|
60cfb19772 | ||
|
|
2a1e81d80a | ||
|
|
8dff061faf | ||
|
|
02fadb0955 |
@@ -1,16 +1,16 @@
|
||||
{
|
||||
"$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
|
||||
"name": "dnspegasus",
|
||||
"description": "Self-hosted Claude Code plugins for the dnspegasus.net infrastructure.",
|
||||
"name": "cybercove-labs",
|
||||
"description": "Open-source Claude Code plugins released by CyberCove Labs.",
|
||||
"owner": {
|
||||
"name": "jknapp",
|
||||
"url": "https://repo.anhonesthost.net/jknapp/shared-memory"
|
||||
"name": "CyberCove Labs",
|
||||
"url": "https://repo.anhonesthost.net/cybercove-labs/shared-memory"
|
||||
},
|
||||
"plugins": [
|
||||
{
|
||||
"name": "shared-memory",
|
||||
"source": "./plugin",
|
||||
"description": "Shared persistent memory and snippet library for Claude Code sessions, backed by memory.dnspegasus.net and authenticated with Authentik OIDC."
|
||||
"description": "Shared persistent memory and snippet library for Claude Code sessions, backed by your own shared-memory server and authenticated with OIDC."
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
@@ -31,11 +31,28 @@ ACME_EMAIL=you@example.com
|
||||
# resource server). See README.md for exact provider settings.
|
||||
# -----------------------------------------------------------------------------
|
||||
OIDC_ISSUER=https://auth.example.com/application/o/shared-memory/
|
||||
# Issuer of MCP access tokens, when the MCP endpoint is a separate application
|
||||
# in your IdP (it usually is). Authentik stamps each token with its own app
|
||||
# slug, so verifying MCP tokens against OIDC_ISSUER fails with
|
||||
# "claim invalid: iss". Defaults to OIDC_ISSUER.
|
||||
OIDC_ISSUER_MCP=https://auth.example.com/application/o/shared-memory-mcp/
|
||||
OIDC_CLIENT_ID_WEB=replace-me
|
||||
OIDC_CLIENT_SECRET_WEB=replace-me
|
||||
OIDC_CLIENT_ID_MCP=replace-me
|
||||
OIDC_AUDIENCE=shared-memory
|
||||
|
||||
# Marketplace this instance's Claude Code plugin is published from. When set,
|
||||
# the CLI tokens page shows the one-command plugin install so people only mint
|
||||
# a bearer token when a browser sign-in genuinely isn't possible.
|
||||
#PLUGIN_MARKETPLACE_URL=https://your-git-host/you/shared-memory.git
|
||||
#PLUGIN_MARKETPLACE_NAME=shared-memory
|
||||
# Scope whose IdP mapping emits `aud: <OIDC_AUDIENCE>`. Advertised in
|
||||
# /.well-known/oauth-protected-resource so MCP clients request it — without
|
||||
# that, Authentik never evaluates the mapping and every token 401s with
|
||||
# "claim invalid: aud". Defaults to aud-<OIDC_AUDIENCE>; set only if you
|
||||
# named the scope mapping something else.
|
||||
#OIDC_AUDIENCE_SCOPE=aud-shared-memory
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# Database (Postgres 16 + pgvector — pgvector/pgvector:pg16 image)
|
||||
# -----------------------------------------------------------------------------
|
||||
|
||||
@@ -144,6 +144,10 @@ Copy `.env.example` and fill in the values below.
|
||||
| `OIDC_CLIENT_SECRET_WEB` | both | Client secret of the Web-UI client. |
|
||||
| `OIDC_CLIENT_ID_MCP` | both | Client ID of the MCP resource-server client in your IdP. |
|
||||
| `OIDC_AUDIENCE` | both | Audience string the MCP access token must carry in its `aud` claim. Recommended: `shared-memory`. |
|
||||
| `OIDC_ISSUER_MCP` | optional | Issuer of MCP access tokens when the MCP endpoint is a separate IdP application (Authentik stamps each app's tokens with its own slug). Defaults to `OIDC_ISSUER`. |
|
||||
| `PLUGIN_MARKETPLACE_URL` | optional | Marketplace URL for this instance's plugin. Shown as a one-command install on the CLI tokens page. Hidden when unset. |
|
||||
| `PLUGIN_MARKETPLACE_NAME` | optional | Marketplace name used in `shared-memory@<name>`. Defaults to `shared-memory`. |
|
||||
| `OIDC_AUDIENCE_SCOPE` | optional | Name of the IdP scope whose mapping emits that `aud` claim. Advertised in `scopes_supported` so clients request it. Defaults to `aud-<OIDC_AUDIENCE>`. |
|
||||
| `POSTGRES_USER` / `POSTGRES_PASSWORD` / `POSTGRES_DB` | both | Local Postgres credentials. |
|
||||
| `NEXTAUTH_SECRET` | both | Session-cookie signing key. Generate with `openssl rand -base64 32`. |
|
||||
| `EMBEDDER_URL` | both | Phase 2 embedder sidecar. Leave empty in Phase 1. |
|
||||
@@ -297,16 +301,52 @@ The MCP endpoint requires the access token's `aud` claim to equal
|
||||
reliable pattern:
|
||||
|
||||
1. Create a **scope mapping** (Customisation → Property Mappings → Create →
|
||||
Scope Mapping) named `aud-shared-memory` with expression:
|
||||
Scope Mapping) named `aud-shared-memory`, **scope name** `aud-shared-memory`,
|
||||
with expression:
|
||||
```python
|
||||
return {"aud": "shared-memory"}
|
||||
```
|
||||
2. On the MCP provider, add this scope mapping under **Scopes** and tick it
|
||||
so it's emitted for the default scope.
|
||||
2. On the MCP provider, add this scope mapping under **Scopes**.
|
||||
3. Make sure the app advertises that scope name. It is derived automatically
|
||||
as `aud-<OIDC_AUDIENCE>`; override with `OIDC_AUDIENCE_SCOPE` if you named
|
||||
the mapping differently.
|
||||
|
||||
> If you skip this, the MCP route will return 401 with
|
||||
> `error_description="claim invalid: aud"`. Check `docker compose logs app`
|
||||
> for the exact failure.
|
||||
> **Attaching the mapping is not sufficient.** Authentik evaluates a scope
|
||||
> mapping only when the client explicitly *requests* that scope, and an MCP
|
||||
> client only requests the scopes listed in `scopes_supported` from
|
||||
> `/.well-known/oauth-protected-resource`. If the audience scope isn't
|
||||
> advertised there, the mapping silently never runs, the access token carries
|
||||
> no `aud`, and every MCP call fails with 401
|
||||
> `error_description="claim invalid: aud"` — even though the OAuth handshake,
|
||||
> consent, and PKCE all succeeded. Verify with:
|
||||
>
|
||||
> ```bash
|
||||
> curl -s https://memory.example.com/.well-known/oauth-protected-resource \
|
||||
> | jq .scopes_supported # must include aud-<your audience>
|
||||
> ```
|
||||
>
|
||||
> **Second trap, same failure surface:** the MCP endpoint is a *separate
|
||||
> application* from the Web UI, and Authentik's default `per_provider` issuer
|
||||
> mode stamps each token with its own application slug. So MCP tokens carry
|
||||
> `iss: .../application/o/shared-memory-mcp/` while `OIDC_ISSUER` points at
|
||||
> `.../application/o/shared-memory/`, and verification fails with
|
||||
> `claim invalid: iss` even once `aud` is correct. Set `OIDC_ISSUER_MCP` to the
|
||||
> MCP application's issuer. Confirm which one your tokens actually carry:
|
||||
>
|
||||
> ```bash
|
||||
> curl -s https://auth.example.com/application/o/shared-memory-mcp/.well-known/openid-configuration | jq .issuer
|
||||
> ```
|
||||
>
|
||||
> **Identity note:** the app verifies MCP tokens against `OIDC_ISSUER_MCP` but
|
||||
> keys the user record on `OIDC_ISSUER`. Authentik's `sub` is `user.uid`, which
|
||||
> is stable across providers, so the same person resolves to the same row
|
||||
> whether they arrive via the Web UI or the MCP endpoint. Without that
|
||||
> normalization the MCP path silently creates a second, empty account instead
|
||||
> of failing visibly.
|
||||
>
|
||||
> Note also that Claude Code sends an RFC 8707 `resource` parameter on the
|
||||
> authorize request; Authentik 2026.5 ignores it, so it cannot be relied on
|
||||
> for audience binding. The scope mapping is what sets `aud`.
|
||||
|
||||
Then create an **Application** for the MCP provider (same as Step A), slug
|
||||
e.g. `shared-memory-mcp`.
|
||||
@@ -322,9 +362,55 @@ prompt, never reaching the app.
|
||||
|
||||
## Connecting Claude Code
|
||||
|
||||
Two paths, in order of preference:
|
||||
Three paths, in order of preference:
|
||||
|
||||
### A. OAuth flow (recommended — picks up your IdP credentials)
|
||||
### A. Plugin (recommended — one command, no flags to remember)
|
||||
|
||||
This repo doubles as a Claude Code plugin marketplace. `plugin/.mcp.json` ships a
|
||||
**pre-registered** OAuth client, so Claude Code never needs RFC 7591 Dynamic Client
|
||||
Registration — which matters because most self-hosted IdPs (Authentik included, as of
|
||||
2026.5) don't implement it.
|
||||
|
||||
`main` carries placeholders, so install from `main` only after pointing it at your own
|
||||
instance. Fork or clone, then edit `plugin/.mcp.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"shared-memory": {
|
||||
"type": "http",
|
||||
"url": "https://memory.example.com/api/mcp",
|
||||
"oauth": {
|
||||
"clientId": "<OIDC_CLIENT_ID_MCP>",
|
||||
"callbackPort": 33418
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
`clientId` is the **Public** (PKCE) client from step B above — it is not a secret and is
|
||||
meant to be committed. `callbackPort` must match a redirect URI your IdP accepts; with
|
||||
the loopback regex from the setup step, any port works.
|
||||
|
||||
Then:
|
||||
|
||||
```bash
|
||||
claude plugin marketplace add https://your-git-host/you/shared-memory.git
|
||||
claude plugin install shared-memory@cybercove-labs
|
||||
```
|
||||
|
||||
To keep a filled-in copy on a branch instead of forking, commit it to e.g.
|
||||
`instance/<name>` and install with a `#ref` fragment:
|
||||
|
||||
```bash
|
||||
claude plugin marketplace add https://your-git-host/you/shared-memory.git#instance/<name>
|
||||
```
|
||||
|
||||
The `#ref` suffix is undocumented in `claude plugin marketplace add --help` but is
|
||||
honored and persisted in `known_marketplaces.json` (verified on Claude Code 2.1.220).
|
||||
|
||||
### B. OAuth flow (manual, per-machine)
|
||||
|
||||
```bash
|
||||
claude mcp add --transport http --scope user \
|
||||
@@ -350,7 +436,7 @@ your MCP client's **Redirect URIs** list. Authentik users with the regex
|
||||
pattern from the setup step (`^http://(127\.0\.0\.1|localhost):\d+/.*$`)
|
||||
can use any port without re-registering.
|
||||
|
||||
### B. Manual-paste fallback (when loopback isn't reachable)
|
||||
### C. Manual-paste fallback (when loopback isn't reachable)
|
||||
|
||||
Sealed containers, devboxes without port forwarding, etc. The redirect URI
|
||||
in this case is hosted by *this* server:
|
||||
@@ -372,7 +458,7 @@ Claude Code's prompt to complete the flow.
|
||||
The manual-fallback URI must be registered on your MCP client too:
|
||||
`https://memory.example.com/auth/cli-callback`.
|
||||
|
||||
### C. Static bearer token (no browser at all)
|
||||
### D. Static bearer token (no browser at all)
|
||||
|
||||
For fully headless / CI scenarios, mint a long-lived HMAC token at
|
||||
`https://memory.example.com/connect` and pass it via `--header`. See
|
||||
|
||||
@@ -63,7 +63,9 @@ export default async function SettingsPage() {
|
||||
</CardHeader>
|
||||
<CardBody className="text-sm text-fg-muted">
|
||||
OIDC group memberships from your IdP, refreshed at sign-in. Used
|
||||
by the upcoming sharing feature to scope project visibility.
|
||||
to scope project sharing — memories and snippets in a shared
|
||||
project are readable by member groups and editable by read-write
|
||||
groups.
|
||||
</CardBody>
|
||||
</Card>
|
||||
</div>
|
||||
|
||||
@@ -108,6 +108,44 @@ async function revokeTokenAction(formData: FormData) {
|
||||
revalidatePath("/settings/tokens");
|
||||
}
|
||||
|
||||
/**
|
||||
* Points people at the plugin before they mint a token they don't need.
|
||||
*
|
||||
* Rendered only when this instance knows which marketplace it's published
|
||||
* from — showing a copyable command that points nowhere is worse than showing
|
||||
* nothing.
|
||||
*/
|
||||
function PluginHint({
|
||||
marketplaceUrl,
|
||||
marketplaceName,
|
||||
}: {
|
||||
marketplaceUrl: string | undefined;
|
||||
marketplaceName: string;
|
||||
}) {
|
||||
if (!marketplaceUrl) return null;
|
||||
return (
|
||||
<Card className="mb-6">
|
||||
<CardHeader className="text-sm font-medium text-fg">
|
||||
If this machine has a browser, install the plugin instead
|
||||
</CardHeader>
|
||||
<CardBody>
|
||||
<p className="text-sm text-fg-muted mb-3">
|
||||
The plugin signs you in through {" "}
|
||||
<span className="text-fg">your usual login</span>, so there's no
|
||||
token to copy, store, or rotate. Generate a token below only when a
|
||||
browser sign-in isn't possible.
|
||||
</p>
|
||||
<pre className="text-xs !whitespace-pre-wrap !break-all select-all">
|
||||
{[
|
||||
`claude plugin marketplace add ${marketplaceUrl}`,
|
||||
`claude plugin install shared-memory@${marketplaceName}`,
|
||||
].join("\n")}
|
||||
</pre>
|
||||
</CardBody>
|
||||
</Card>
|
||||
);
|
||||
}
|
||||
|
||||
export default async function TokensPage() {
|
||||
const session = await auth();
|
||||
const userId = session!.user.id;
|
||||
@@ -144,7 +182,12 @@ export default async function TokensPage() {
|
||||
<Container className="pt-6 max-w-3xl">
|
||||
<PageHeader
|
||||
title="CLI tokens"
|
||||
description={`Long-lived bearer tokens for MCP clients without browser access. ${ttlDays}-day expiry per token.`}
|
||||
description={`For machines that can't complete a browser sign-in — headless containers, CI runners, sealed devboxes. Tokens last ${ttlDays} days and can be revoked one at a time.`}
|
||||
/>
|
||||
|
||||
<PluginHint
|
||||
marketplaceUrl={env().PLUGIN_MARKETPLACE_URL}
|
||||
marketplaceName={env().PLUGIN_MARKETPLACE_NAME}
|
||||
/>
|
||||
|
||||
<Card className="mb-6">
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
import { NextResponse } from "next/server";
|
||||
import { env } from "@/lib/env";
|
||||
import { mcpIssuer } from "@/lib/auth/jwt";
|
||||
|
||||
export const runtime = "nodejs";
|
||||
export const dynamic = "force-dynamic";
|
||||
@@ -12,10 +13,21 @@ export const dynamic = "force-dynamic";
|
||||
*/
|
||||
export function GET() {
|
||||
const resource = env().PUBLIC_URL.replace(/\/$/, "");
|
||||
|
||||
// The audience scope MUST be advertised. Authentik only evaluates a scope
|
||||
// mapping when the client requests that scope by name, and the client only
|
||||
// learns scope names from this document. Omit it and every access token
|
||||
// arrives without `aud`, which jwt.ts rejects as "claim invalid: aud".
|
||||
const audienceScope =
|
||||
env().OIDC_AUDIENCE_SCOPE ?? `aud-${env().OIDC_AUDIENCE}`;
|
||||
|
||||
return NextResponse.json({
|
||||
resource,
|
||||
authorization_servers: [env().OIDC_ISSUER],
|
||||
scopes_supported: ["openid", "profile", "email"],
|
||||
// The MCP application's issuer, which is not necessarily the Web UI's —
|
||||
// see mcpIssuer(). Advertising the wrong one sends clients to a discovery
|
||||
// document whose tokens this endpoint will then reject on `iss`.
|
||||
authorization_servers: [mcpIssuer()], // as configured, slash and all
|
||||
scopes_supported: ["openid", "profile", "email", audienceScope],
|
||||
bearer_methods_supported: ["header"],
|
||||
resource_documentation: `${resource}/`,
|
||||
});
|
||||
|
||||
@@ -0,0 +1,16 @@
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="shared-memory">
|
||||
<title>shared-memory</title>
|
||||
<rect width="64" height="64" rx="14" fill="#11151b"/>
|
||||
<!--
|
||||
Three retrieval signals - vector, full-text, tags - converging on a single
|
||||
memory. The direct match runs straight through at full strength; the two
|
||||
ranked neighbours fall back, which is the fusion the search actually does.
|
||||
Opacity is held equal on the outer pair so the mark stays balanced at 16px.
|
||||
-->
|
||||
<g fill="none" stroke-linecap="round" stroke-width="7">
|
||||
<path d="M13 15C25 15 26 32 35 32" stroke="#0092fd" opacity=".55"/>
|
||||
<path d="M13 32H35" stroke="#49a9ff"/>
|
||||
<path d="M13 49C25 49 26 32 35 32" stroke="#0092fd" opacity=".55"/>
|
||||
</g>
|
||||
<circle cx="45" cy="32" r="7.5" fill="#76c0ff"/>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 847 B |
@@ -23,13 +23,39 @@ type GlobalWithJwks = typeof globalThis & {
|
||||
};
|
||||
const g = globalThis as GlobalWithJwks;
|
||||
|
||||
/**
|
||||
* Issuer of MCP access tokens. The MCP endpoint is a separate application in
|
||||
* the IdP from the Web UI, and Authentik stamps each token with its own
|
||||
* application slug, so this is NOT interchangeable with OIDC_ISSUER.
|
||||
*/
|
||||
export function mcpIssuer(): string {
|
||||
return env().OIDC_ISSUER_MCP ?? env().OIDC_ISSUER;
|
||||
}
|
||||
|
||||
/**
|
||||
* Issuer values accepted for the `iss` claim.
|
||||
*
|
||||
* jose compares `iss` by exact string, and IdPs are inconsistent about the
|
||||
* trailing slash: Authentik emits `.../application/o/<slug>/` while the same
|
||||
* value is routinely configured without it. Normalizing to one form and
|
||||
* comparing against that fails whenever the two disagree — which is exactly
|
||||
* how this broke: the URL-safe (stripped) form was reused for the claim check
|
||||
* against a token whose `iss` ended in a slash.
|
||||
*
|
||||
* Accept both spellings rather than making correctness depend on how someone
|
||||
* typed an env var.
|
||||
*/
|
||||
function acceptedIssuers(): [string, string] {
|
||||
const bare = mcpIssuer().replace(/\/$/, "");
|
||||
return [bare, `${bare}/`];
|
||||
}
|
||||
|
||||
function jwks() {
|
||||
if (g.__sharedMemoryJwks) return g.__sharedMemoryJwks;
|
||||
// Authentik discovery is at `${issuer}/.well-known/openid-configuration`;
|
||||
// the JWKS URI is normally `${issuer}/jwks/` or `${issuer}/.well-known/jwks.json`.
|
||||
// Authentik canonically serves `${issuer}/jwks/`.
|
||||
const issuer = env().OIDC_ISSUER.replace(/\/$/, "");
|
||||
const url = new URL(`${issuer}/jwks/`);
|
||||
const url = new URL(`${mcpIssuer().replace(/\/$/, "")}/jwks/`);
|
||||
g.__sharedMemoryJwks = createRemoteJWKSet(url, {
|
||||
cacheMaxAge: 10 * 60 * 1000, // 10 min
|
||||
cooldownDuration: 30 * 1000,
|
||||
@@ -118,7 +144,7 @@ export async function authenticateBearer(authHeader: string | null): Promise<Aut
|
||||
}
|
||||
|
||||
const { payload } = await jwtVerify(token, jwks(), {
|
||||
issuer: env().OIDC_ISSUER,
|
||||
issuer: acceptedIssuers(),
|
||||
audience: env().OIDC_AUDIENCE,
|
||||
});
|
||||
if (!payload.sub) {
|
||||
@@ -127,7 +153,24 @@ export async function authenticateBearer(authHeader: string | null): Promise<Aut
|
||||
buildWwwAuthenticate("invalid_token", "missing sub"),
|
||||
);
|
||||
}
|
||||
return { ...payload, groups: extractGroupsClaim(payload) } as AuthenticatedClaims;
|
||||
// Normalize the issuer for identity purposes.
|
||||
//
|
||||
// The token was just verified against mcpIssuer() — that check is done.
|
||||
// But identity is keyed on (oidc_iss, oidc_sub), and the Web UI signs
|
||||
// people in through a DIFFERENT application whose tokens carry
|
||||
// OIDC_ISSUER. Authentik's `sub` is stable across providers (it is
|
||||
// `user.uid`, a user-level value), so the only thing that differs is the
|
||||
// issuer.
|
||||
//
|
||||
// Leave it un-normalized and userContextFromClaims — which UPSERTS rather
|
||||
// than failing — quietly creates a SECOND user row for the same human:
|
||||
// MCP writes would land in an account with none of their memories, and
|
||||
// nothing would look broken. Pin identity to the canonical issuer.
|
||||
return {
|
||||
...payload,
|
||||
iss: env().OIDC_ISSUER,
|
||||
groups: extractGroupsClaim(payload),
|
||||
} as AuthenticatedClaims;
|
||||
} catch (err) {
|
||||
if (err instanceof UnauthorizedError) throw err;
|
||||
const desc =
|
||||
|
||||
@@ -4,6 +4,16 @@ const Bool = z
|
||||
.union([z.boolean(), z.enum(["true", "false", "1", "0"])])
|
||||
.transform((v) => v === true || v === "true" || v === "1");
|
||||
|
||||
/**
|
||||
* Treat an empty string as "not set".
|
||||
*
|
||||
* docker-compose renders `${VAR:-}` as an empty string rather than omitting
|
||||
* the key, so an unset optional var arrives as "" and would otherwise fail
|
||||
* `.url()` / `.min(1)` validation and take the whole app down at boot.
|
||||
*/
|
||||
const optional = <T extends z.ZodTypeAny>(schema: T) =>
|
||||
z.preprocess((v) => (v === "" ? undefined : v), schema.optional());
|
||||
|
||||
const envSchema = z.object({
|
||||
NODE_ENV: z.enum(["development", "test", "production"]).default("development"),
|
||||
LOG_LEVEL: z.enum(["debug", "info", "warn", "error"]).default("info"),
|
||||
@@ -13,11 +23,35 @@ const envSchema = z.object({
|
||||
|
||||
// Authentik OIDC
|
||||
OIDC_ISSUER: z.string().url(),
|
||||
|
||||
// Issuer of MCP *access tokens*, when it differs from OIDC_ISSUER.
|
||||
//
|
||||
// The Web UI and the MCP endpoint are two separate applications in the IdP,
|
||||
// and Authentik's default `per_provider` issuer mode stamps each token with
|
||||
// its own application slug. So the web app issues
|
||||
// `.../application/o/<slug>/` while the MCP provider issues
|
||||
// `.../application/o/<slug>-mcp/`, and verifying MCP tokens against
|
||||
// OIDC_ISSUER fails with "claim invalid: iss".
|
||||
//
|
||||
// Set this to the MCP application's issuer. Defaults to OIDC_ISSUER for
|
||||
// single-application setups.
|
||||
OIDC_ISSUER_MCP: optional(z.string().url()),
|
||||
OIDC_CLIENT_ID_WEB: z.string().min(1),
|
||||
OIDC_CLIENT_SECRET_WEB: z.string().min(1),
|
||||
OIDC_CLIENT_ID_MCP: z.string().min(1),
|
||||
OIDC_AUDIENCE: z.string().min(1),
|
||||
|
||||
// Name of the IdP scope whose mapping emits `aud: <OIDC_AUDIENCE>`.
|
||||
//
|
||||
// Most IdPs (Authentik included) only evaluate a scope mapping when the
|
||||
// client actually requests that scope. The MCP client learns which scopes
|
||||
// to request from `scopes_supported` in our protected-resource metadata,
|
||||
// so this name has to be advertised there or the mapping never runs and
|
||||
// every token arrives without an `aud` claim (-> 401 "claim invalid: aud").
|
||||
//
|
||||
// Defaults to the `aud-<audience>` convention used in the README setup.
|
||||
OIDC_AUDIENCE_SCOPE: optional(z.string().min(1)),
|
||||
|
||||
// Database
|
||||
DATABASE_URL: z.string().url(),
|
||||
|
||||
@@ -33,6 +67,13 @@ const envSchema = z.object({
|
||||
// every issued CLI token at once.
|
||||
CLI_TOKEN_SECRET: z.string().min(32, "CLI_TOKEN_SECRET must be at least 32 chars"),
|
||||
|
||||
// Plugin marketplace this instance is published from. When set, the CLI
|
||||
// tokens page shows the one-command plugin install, so people only mint a
|
||||
// bearer token when their machine genuinely can't complete a browser
|
||||
// sign-in. Left unset, that hint is hidden rather than shown wrong.
|
||||
PLUGIN_MARKETPLACE_URL: optional(z.string().url()),
|
||||
PLUGIN_MARKETPLACE_NAME: z.string().min(1).default("shared-memory"),
|
||||
|
||||
// Behavior flags
|
||||
ALLOW_INSECURE_HTTP: Bool.optional().default(false),
|
||||
});
|
||||
@@ -76,6 +117,7 @@ function buildPhaseStub(): Env {
|
||||
EMBEDDING_DIM: 384,
|
||||
NEXTAUTH_SECRET: "build-phase-secret-not-used-at-runtime-xxxxxxxx",
|
||||
CLI_TOKEN_SECRET: "build-phase-secret-not-used-at-runtime-xxxxxxxx",
|
||||
PLUGIN_MARKETPLACE_NAME: "shared-memory",
|
||||
ALLOW_INSECURE_HTTP: false,
|
||||
};
|
||||
}
|
||||
|
||||
@@ -0,0 +1,14 @@
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="shared-memory">
|
||||
<title>shared-memory</title>
|
||||
<!--
|
||||
Transparent, currentColor variant of the mark for in-app use - inherits
|
||||
the surrounding text color so it works on any surface. The tile version
|
||||
used as the favicon lives at app/icon.svg.
|
||||
-->
|
||||
<g fill="none" stroke="currentColor" stroke-linecap="round" stroke-width="7">
|
||||
<path d="M13 15C25 15 27 32 37 32" opacity=".45"/>
|
||||
<path d="M13 32H37"/>
|
||||
<path d="M13 49C25 49 27 32 37 32" opacity=".7"/>
|
||||
</g>
|
||||
<circle cx="43" cy="32" r="8" fill="currentColor"/>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 648 B |
@@ -113,6 +113,12 @@ services:
|
||||
OIDC_CLIENT_SECRET_WEB: ${OIDC_CLIENT_SECRET_WEB:?required}
|
||||
OIDC_CLIENT_ID_MCP: ${OIDC_CLIENT_ID_MCP:?required}
|
||||
OIDC_AUDIENCE: ${OIDC_AUDIENCE:?required}
|
||||
# Optional. This block is an explicit allow-list, not env_file — a var
|
||||
# added to .env but not listed here never reaches the container.
|
||||
OIDC_ISSUER_MCP: ${OIDC_ISSUER_MCP:-}
|
||||
OIDC_AUDIENCE_SCOPE: ${OIDC_AUDIENCE_SCOPE:-}
|
||||
PLUGIN_MARKETPLACE_URL: ${PLUGIN_MARKETPLACE_URL:-}
|
||||
PLUGIN_MARKETPLACE_NAME: ${PLUGIN_MARKETPLACE_NAME:-shared-memory}
|
||||
|
||||
DATABASE_URL: postgres://${POSTGRES_USER}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB}
|
||||
|
||||
|
||||
@@ -2,9 +2,9 @@
|
||||
"$schema": "https://anthropic.com/claude-code/plugin.schema.json",
|
||||
"name": "shared-memory",
|
||||
"version": "0.1.0",
|
||||
"description": "Shared persistent memory and snippet library for Claude Code sessions, backed by memory.dnspegasus.net and authenticated with Authentik OIDC.",
|
||||
"description": "Shared persistent memory and snippet library for Claude Code sessions, backed by your own shared-memory server and authenticated with OIDC.",
|
||||
"author": {
|
||||
"name": "jknapp"
|
||||
"name": "CyberCove Labs"
|
||||
},
|
||||
"homepage": "https://memory.dnspegasus.net"
|
||||
"homepage": "https://repo.anhonesthost.net/cybercove-labs/shared-memory"
|
||||
}
|
||||
|
||||
+2
-2
@@ -2,9 +2,9 @@
|
||||
"mcpServers": {
|
||||
"shared-memory": {
|
||||
"type": "http",
|
||||
"url": "https://memory.dnspegasus.net/api/mcp",
|
||||
"url": "https://memory.example.com/api/mcp",
|
||||
"oauth": {
|
||||
"clientId": "5rkRS3rJhn3Ci9swWkxYMIrZ9OggsjOGy3cIOhYY",
|
||||
"clientId": "<OIDC_CLIENT_ID_MCP>",
|
||||
"callbackPort": 33418
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user