Geniads MCP · lokal server

Lokal MCP-server der giver Claude Desktop adgang til Geniads' skill-bibliotek.

Den kalder skill-platformens REST-API direkte fra din egen maskine i stedet for at gå gennem den hostede MCP-connector, hvor omkring 37 % af alle kald fejler.

Installation

curl -fsSL https://raw.githubusercontent.com/Geniads-GitHub/geniads-mcp-local/main/install.sh | bash

Du bliver bedt om din API-nøgle. Den findes under Settings → API Keys på platformen og starter med sk_.

Genstart Claude Desktop bagefter. Configfilen læses kun ved opstart.

Krav

• macOS

• Node.js 18.17 eller nyere — hent LTS her

Install-scriptet tjekker Node og siger til hvis den mangler.

Related MCP server: PromStack MCP Server

Hvad der bliver installeret

Nøglen gemmes i Keychain, ikke i Claude Desktops configfil, som ligger i klartekst. Configfilen flettes — andre connectors du har sat op, bevares, og der tages en backup før hver ændring.

Scriptet er idempotent: kør det igen for at opdatere.

Adgang

Din rolle ligger på platformen og styrer hvad du kan.

• Alle kan læse alle skills

• Admin og team leads kan desuden oprette, opdatere og slette

Rettighedstjekket sker på platformen ved hvert kald, ikke lokalt.

Har du fået en ny rolle?

Værktøjslisten hentes når serveren starter. Er du blevet opgraderet, dukker skriveværktøjerne først op efter en genstart af Claude Desktop.

Når noget går galt

Serveren skelner mellem fire ting, fordi de kræver hver sin handling:

Udvikling

npm install
npm test          # unit-tests
npm run typecheck
npm run build     # → dist/geniads-mcp.cjs
bash test/install.test.sh

Værktøjsdefinitionerne er ikke i dette repo. De hentes fra GET /api/tools ved opstart, filtreret på brugerens rolle, så et nyt værktøj kun skal laves ét sted. Kan platformen ikke nås, starter serveren ikke.

Arkitektur

Claude Desktop  ──stdio──>  denne server  ──HTTPS──>  platformen  ──>  Supabase + GitHub

Serveren er en tynd REST-klient. To ting er værd at kende:

• src/api.ts er det eneste modul der kender API-nøglen. Den tages ind i constructoren og forlader aldrig klassen — heller ikke i en fejlbesked.

• src/errors.ts er et selvstændigt modul med egne tests. At slå en afvist nøgle, en upstream-fejl og en netværksfejl sammen har tidligere kostet dage af fejlsøgning.

Status

Midlertidig løsning mens en sag kører hos Netlify om fejlraten på den hostede connector. Bliver den løst, flytter vi tilbage.