SkillDB mit Claude verwenden

SkillDB bringt einen MCP-Server mit. Einmal eingetragen, kann ein Agent die Sammlung durchsuchen, einen Skill in sein Projekt installieren und neue Stände zurückschreiben — ohne Kopieren von Hand. Diese Seite nennt die Adressen dieser Instanz; die Befehle lassen sich unverändert übernehmen.

Adressen dieser Instanz

MCP-Endpunkt: https://skilldb.acdp.at/mcp
REST-API: https://skilldb.acdp.at/api/v1
Oberfläche: https://skilldb.acdp.at/

Die Anmeldung ist aktiv: REST-API und MCP-Endpunkt nehmen nur Aufrufe mit einem API-Key im Kopf Authorization: Bearer <key> an. Den Key legst du unter API-Keys an; er erscheint genau einmal im Klartext.

Einrichten

Claude Code — der Weg im Firmennetz

Claude Code baut die Verbindung vom eigenen Rechner auf. Das ist der richtige Weg für eine Instanz, die nur im internen Netz steht. Einmalig im Projekt oder für den Benutzer eintragen:

claude mcp add --scope user --transport http skilldb https://skilldb.acdp.at/mcp \
  --header "Authorization: Bearer <key>"

--scope user macht den Eintrag in allen Projekten verfügbar. Ohne den Zusatz gilt er nur im aktuellen Verzeichnis; wer ihn dort schon angelegt hat, entfernt ihn vorher mit claude mcp remove skilldb. Prüfen lässt sich der Stand mit claude mcp list, im laufenden Gespräch mit /mcp.

Ein dritter Bereich, --scope project, schreibt den Eintrag in eine .mcp.json im Projekt — gedacht dafür, ihn mit dem Team zu teilen.

Andere Werkzeuge

Jeder Client, der MCP über streamable HTTP spricht, funktioniert — etwa Cursor oder OpenAI Codex. Eingetragen wird immer dieselbe Adresse. Es gilt dasselbe: Ein Client, der vom eigenen Rechner aus verbindet, erreicht auch eine interne Instanz.

Was der Agent dann kann

Die Werkzeuge des MCP-Servers
Werkzeug	Zweck
`search_skills`	Sammlung durchsuchen, nach Text, Typ, Kategorie, Tag oder Einheit.
`get_skill`, `get_skill_version`	Stammdaten, Versionen und den Anleitungstext lesen.
`get_skill_file`	Eine einzelne Begleitdatei lesen.
`install_skill`	Einen Skill in das Projekt schreiben — bei Claude Code nach `.claude/skills/<name>/`, samt Begleitdateien.
`get_prompt`	Einen Prompt mit eingesetzten Variablen holen.
`create_skill_draft`	Einen neuen Skill als Entwurf anlegen.
`create_version_draft`	Neue Entwurfsversion eines vorhandenen Skills — als Kopie samt Begleitdateien und Plattform-Varianten.
`update_skill_draft`	Text und Frontmatter eines Entwurfs ändern.
`upload_skill_files`, `delete_skill_file`	Begleitdateien eines Entwurfs hinzufügen oder entfernen.
`publish_version`	Einen Entwurf freigeben; danach ist er unveränderlich.
`database_status`, `server_info`	Zustand der Instanz; für die Fehlersuche.

Typische Abläufe

Einen Skill im Projekt verwenden

Einfach danach fragen — der Agent sucht und installiert selbst:

Suche in SkillDB nach einem Skill für Angebotsprüfung
und installiere ihn in dieses Projekt.

Der Skill landet unter .claude/skills/<name>/ im Projekt und steht ab dem nächsten Start zur Verfügung.

Einen Skill in allen Projekten verwenden

Ein eingetragener MCP-Server ist mit --scope user überall erreichbar — die Skills selbst liegen deswegen noch nicht überall. install_skill liefert projektrelative Pfade, und Claude schreibt sie in das aktuelle Projekt. Dauerhaft für alle Projekte gehören sie in das persönliche Skill-Verzeichnis:

Nur dieses Projekt: .claude/skills/<name>/
Alle Projekte: ~/.claude/skills/<name>/ unter Windows %USERPROFILE%\.claude\skills\<name>\

Dafür genügt es, das Ziel dazuzusagen:

Installiere aus SkillDB die Skills evva-corporate-identity und dark-ui-styling
nicht ins Projekt, sondern nach ~/.claude/skills/, damit sie überall gelten.

Claude holt die Dateien über install_skill und legt sie dort an. Nach dem nächsten Start stehen die Skills in jedem Projekt bereit; ein Skill gleichen Namens im Projekt geht vor.

Einen neuen Skill anlegen

create_skill_draft — Name, Beschreibung, Anleitungstext.
upload_skill_files — Skripte, Referenzen, Vorlagen.
publish_version — freigeben.

Einen veröffentlichten Skill ergänzen

Veröffentlichte Versionen sind unveränderlich, auch in ihren Dateien. Änderungen entstehen deshalb in einer neuen Version:

create_version_draft — übernimmt Text, Dateien und Varianten.
update_skill_draft und upload_skill_files — ändern.
publish_version — freigeben.

Große Dateien

Präsentationen, Bilder und andere Binärdateien gehören nicht in einen Werkzeugaufruf: Ein Modell müsste jedes Byte selbst schreiben. Zwei Wege führen stattdessen ans Ziel — in der Oberfläche ein ZIP hochladen (auch als neue Version eines vorhandenen Skills), oder je Datei über die REST-API in einen offenen Entwurf:

curl -F pfad=assets/vorlage.pptx -F datei=@vorlage.pptx \
  https://skilldb.acdp.at/api/v1/skills/<name>/versions/<version>/files

Ohne MCP

Jede Version lässt sich in der Oberfläche als ZIP für Claude Code, Cursor oder OpenAI Codex herunterladen — über Exportieren auf der Versionsseite. Entpackt in das Projekt, ist das Ergebnis dasselbe wie nach install_skill. Der umgekehrte Weg steht unter Importieren.

Wenn es nicht klappt

„Nicht erreichbar“ im Connector: Die Adresse ist intern. Den Zugang über Claude Code einrichten, wie oben beschrieben.
Nichts geht, auch Claude Code nicht: Prüfen, ob der Rechner im Firmennetz oder im VPN ist: https://skilldb.acdp.at/ muss sich im Browser öffnen lassen.
Eingetragen, aber keine Werkzeuge: claude mcp list zeigt den Zustand der Verbindung; im Gespräch tut das /mcp. Nach dem Eintragen einmal neu starten.
„401" oder „Unauthorized": Der API-Key fehlt oder ist zurückgezogen. Unter API-Keys einen neuen anlegen und den Eintrag mit --header erneut setzen.
Alles richtig, trotzdem Fehler: Der Betriebsendpunkt sagt, ob der Dienst selbst läuft: https://skilldb.acdp.at/api/v1/health. Er braucht keinen Key.

Grenzen

Je Datei höchstens 5 MiB — auf jedem Weg.
Je Version höchstens 1000 Begleitdateien und 64 MiB zusammen.
Erlaubt sind nur die Unterverzeichnisse scripts/, references/ und assets/; so sieht es die Agent-Skills-Spezifikation vor.
Ein Sammel-Upload gilt ganz oder gar nicht: Wird eine Datei beanstandet, wird keine gespeichert.