feat(mcp): Ressourcen und Prompts fuer Claude Desktop, zwei Befunde behoben
MCP-ADAPTER 1.1
Werkzeuge ruft ein Modell von sich aus auf - Ressourcen und Prompts waehlt ein
MENSCH. In Claude Desktop sind das Anhang-Menue und Schraegstrich-Befehle, und
genau die fehlten.
- Vier Ressourcen: dc://roadmap (fertiger Markdown-Block),
dc://naechste-schritte, dc://projekte, dc://befunde.
- Vier Prompts: arbeit-aufnehmen, befunde-sichten, fehler-melden,
roadmap-pflegen. Ihr Wert liegt nicht in der gesparten Tipparbeit, sondern
darin, dass die Hausregeln mitkommen - erst nachsehen wer dransitzt,
Fremdmeldung nur mit Begruendung, Verworfenes nicht ohne neues Argument
wiedervorschlagen. Bisher standen die nur in Werkzeugbeschreibungen, und
die liest ein Modell erst, wenn es das Werkzeug schon gewaehlt hat.
- DC_PROJECT: worauf die Ressourcen zeigen. Werkzeuge nehmen project_slug je
Aufruf, Ressourcen haben keine Argumente.
- Ressourcen laufen durch dieselbe Fremddaten-Abgrenzung wie
Werkzeugergebnisse - sie sind eher ein Einfallstor, weil sie ungefragt im
Kontext landen.
- Einrichtung fuer claude_desktop_config.json dokumentiert.
Behoben: "initialize" spiegelte die verlangte Protokollfassung zurueck. Ein
Client, der 2025-06-18 anfragte, bekam sie bestaetigt, obwohl der Adapter
fuer 2024-11-05 geschrieben war. Jetzt wird gegen eine Liste tatsaechlich
bedienter Fassungen ausgehandelt.
Behoben: process.exit() mitten in schliessenden libuv-Handles. Unter Windows
eine Assertion und Rueckgabewert != 0 - ein sauber beendeter Server sah aus
wie ein abgestuerzter.
ZWEI BEFUNDE, DIE ERST DIE RESSOURCEN ZUTAGE FOERDERTEN
- roadmap.php?action=render lehnte fuer ein Werkbank-Token mit
"missing_project" ab. projectFilter() laesst es beim Lesen bewusst durch
(es soll die Landschaft sehen) und liefert null, also wurde der
Projektbezug "all". Betroffen war ausgerechnet der Tokentyp, den der
Adapter verlangt. Rueckfall ist jetzt das Heimatprojekt des Tokens.
- ProjectLinks::between() benutzte :a dreimal, forProject() :slug zweimal.
Bei ATTR_EMULATE_PREPARES = false unzulaessig -> HY093 und ein 500 auf
/api/bugtracker/v1/projects. Derselbe Fehler wie einst in der
Volltextsuche des Bugtrackers; ein Suchlauf ueber alle prepare()-Aufrufe
der Codebasis fand keine weitere Stelle.
WARUM BEIDE UNBEMERKT BLIEBEN
Beide Wege laufen nur mit einem Werkbank-Token (owner_type = dev_agent). Der
Testlauf hatte keines - es gibt keine API, so eines anzulegen, und in der
Produktion geschieht das von Hand. Ein Tokentyp, den kein Testfall benutzt,
ist ein Tokentyp, dessen Sonderwege niemand prueft.
testctl.php kann jetzt action=workbench_token; vier Testfaelle decken die Wege
ab, samt Gegenprobe, dass der Rueckfall aufs Heimatprojekt das Lesen ueber alle
Projekte nicht einschraenkt. 128 Faelle, alle gruen.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Deploymentcenter Bot
co-authored by
Claude Opus 5
Claude Opus 5
parent
1d5ac92051
commit
8b6d6a307e
@@ -437,6 +437,85 @@ def _(ctx):
|
||||
erwarte_erfolg(r)
|
||||
|
||||
|
||||
@test('roadmap', 'Werkbank-Token laesst sich anlegen')
|
||||
def _(ctx):
|
||||
"""
|
||||
Der Tokentyp, den MCP-Adapter und dc-testkit benutzen: dev_agent, an ein
|
||||
Projekt gebunden. Bis hierher benutzte ihn kein Testfall - und genau
|
||||
deshalb blieb der Fall darunter jahrelang ungeprueft.
|
||||
"""
|
||||
r = ctx.testctl('workbench_token', project_slug=PROJEKT, name='e2e-werkbank')
|
||||
erwarte_erfolg(r)
|
||||
erwarte(r.feld('raw_token'), 'Kein Token in der Antwort: %s' % r.kurz(300))
|
||||
ctx['werkbank_token'] = r.feld('raw_token')
|
||||
|
||||
|
||||
@test('roadmap', 'Werkbank-Token rendert seine Roadmap ohne Projektangabe')
|
||||
def _(ctx):
|
||||
"""
|
||||
BEFUND (29.08.2026): Beim Lesen laesst projectFilter() ein Werkbank-Token
|
||||
bewusst durch - es soll die ganze Landschaft sehen und liefert deshalb
|
||||
null. Damit wurde der Projektbezug zu "all", und action=render lehnte mit
|
||||
"missing_project" ab. Ausgerechnet der Tokentyp, den der MCP-Adapter
|
||||
verlangt, konnte seine eigene Roadmap nicht rendern.
|
||||
|
||||
Das Token ist trotzdem an ein Projekt gebunden. "Meine Roadmap" ohne
|
||||
Angabe heisst genau dieses Projekt.
|
||||
"""
|
||||
r = ctx.client.get('/api/bugtracker/v1/roadmap.php',
|
||||
query={'action': 'render'},
|
||||
token=ctx['werkbank_token'])
|
||||
erwarte_erfolg(r)
|
||||
erwarte(r.feld('project_slug') == PROJEKT,
|
||||
'Gerendert wurde %r statt des Heimatprojekts %r'
|
||||
% (r.feld('project_slug'), PROJEKT))
|
||||
erwarte('dc:roadmap' in (r.feld('markdown') or ''),
|
||||
'Im Ergebnis fehlt der Blockmarker: %s' % r.kurz(200))
|
||||
|
||||
|
||||
@test('roadmap', 'Werkbank-Token bekommt die Projektliste mit Beziehungen')
|
||||
def _(ctx):
|
||||
"""
|
||||
BEFUND (29.08.2026): ProjectLinks::between() und forProject() benutzten
|
||||
denselben Platzhalter mehrfach im Statement. Bei
|
||||
ATTR_EMULATE_PREPARES = false ist das nicht zulaessig - PDO zaehlt
|
||||
Parameter, statt sie zu benennen, und wirft HY093.
|
||||
|
||||
Die Abfrage laeuft nur, wenn ein Heimatprojekt gesetzt ist, also
|
||||
ausschliesslich mit einem Werkbank-Token. Fuer das Master-Token des
|
||||
Testlaufs wurde der Zweig uebersprungen - deshalb blieb ein sicherer
|
||||
500er unbemerkt, bis der MCP-Adapter die Ressource dc://projekte abrief.
|
||||
|
||||
Derselbe Fehler steckte schon in der Volltextsuche des Bugtrackers. Beim
|
||||
dritten Mal ist es kein Zufall mehr, sondern eine Falle des Frameworks -
|
||||
ein Suchlauf ueber alle prepare()-Aufrufe gehoert zur Durchsicht.
|
||||
"""
|
||||
r = ctx.client.get('/api/bugtracker/v1/projects', token=ctx['werkbank_token'])
|
||||
erwarte_erfolg(r)
|
||||
projekte = r.feld('projects', default=[]) or []
|
||||
erwarte(projekte, 'Leere Projektliste: %s' % r.kurz(300))
|
||||
|
||||
eigen = [p for p in projekte if p.get('slug') == PROJEKT]
|
||||
erwarte(eigen, 'Das eigene Projekt %r fehlt in der Liste.' % PROJEKT)
|
||||
erwarte((eigen[0].get('relation') or {}).get('kind') == 'self',
|
||||
'Das eigene Projekt sollte relation.kind="self" tragen, hat aber %r'
|
||||
% eigen[0].get('relation'))
|
||||
|
||||
|
||||
@test('roadmap', 'Werkbank-Token sieht weiterhin die ganze Landschaft')
|
||||
def _(ctx):
|
||||
"""
|
||||
Die Gegenprobe zum Fall darueber. Der Rueckfall aufs Heimatprojekt darf
|
||||
nur dort greifen, wo ein konkretes Projekt gebraucht wird - beim Lesen
|
||||
ueber alle Projekte hinweg waere er eine Einschraenkung, die es vorher
|
||||
nicht gab.
|
||||
"""
|
||||
r = ctx.client.get('/api/bugtracker/v1/roadmap.php',
|
||||
query={'action': 'list', 'project_slug': 'all'},
|
||||
token=ctx['werkbank_token'])
|
||||
erwarte_erfolg(r)
|
||||
|
||||
|
||||
@test('roadmap', 'Roadmap-Schreibzugriff verlangt Verwaltungsrecht')
|
||||
def _(ctx):
|
||||
r = ctx.client.post('/api/bugtracker/v1/roadmap.php',
|
||||
|
||||
@@ -194,6 +194,47 @@ switch ($action) {
|
||||
]);
|
||||
break;
|
||||
|
||||
// ------------------------------------------------------------------
|
||||
// Werkbank-Token (owner_type = dev_agent), an ein Projekt gebunden.
|
||||
//
|
||||
// Es gibt keine API, so eines anzulegen - in der Produktion geschieht das
|
||||
// von Hand in der Token-Verwaltung, und das ist auch richtig so. Fuer den
|
||||
// Testlauf fehlte damit aber ausgerechnet der Tokentyp, den der
|
||||
// MCP-Adapter und dc-testkit benutzen. Die Folge war ein Fehler, den
|
||||
// niemand fand: Beim Lesen laesst projectFilter() ein Werkbank-Token
|
||||
// bewusst durch, also war der Projektbezug leer - und
|
||||
// roadmap.php?action=render lehnte mit "missing_project" ab, obwohl das
|
||||
// Token sehr wohl an ein Projekt gebunden ist.
|
||||
//
|
||||
// Ein Tokentyp, den kein Testfall benutzt, ist ein Tokentyp, dessen
|
||||
// Sonderwege niemand prueft.
|
||||
// ------------------------------------------------------------------
|
||||
case 'workbench_token': {
|
||||
$slug = (string)(Http::str('project_slug') ?? '');
|
||||
if ($slug === '') {
|
||||
Http::fail(400, 'missing_project', 'project_slug wird gebraucht.');
|
||||
}
|
||||
|
||||
$manager = new TokenManager($db);
|
||||
$token = $manager->createMasterToken(
|
||||
(string)(Http::str('name') ?? 'Werkbank (Testlauf)'),
|
||||
$slug,
|
||||
null,
|
||||
'dev_agent',
|
||||
'testkit',
|
||||
['bugtracker:manage', 'supervisor:manage', 'watchdog:read', 'license:dev'],
|
||||
'all'
|
||||
);
|
||||
|
||||
Http::ok([
|
||||
'token_id' => $token['token_id'],
|
||||
'raw_token' => $token['raw_token'],
|
||||
'project_slug' => $slug,
|
||||
'owner_type' => 'dev_agent',
|
||||
]);
|
||||
break;
|
||||
}
|
||||
|
||||
// ------------------------------------------------------------------
|
||||
// Signierschluessel fuer den Updateservice. Er wird auf der Testinstanz
|
||||
// erzeugt und nie von der Produktion kopiert - ein Testlauf darf mit dem
|
||||
@@ -260,6 +301,7 @@ switch ($action) {
|
||||
// ------------------------------------------------------------------
|
||||
default:
|
||||
Http::fail(400, 'unknown_action', sprintf('Unbekannte Aktion "%s".', $action), null, [
|
||||
'actions' => ['status', 'wipe', 'migrate', 'reset', 'genkey', 'log', 'clearlog'],
|
||||
'actions' => ['status', 'wipe', 'migrate', 'reset', 'workbench_token',
|
||||
'genkey', 'log', 'clearlog'],
|
||||
]);
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user