listify/readme.md

docker build -t listify:local . docker run --env-file .\listify-api.env -p 8080:80 listify:local

MCP-Agent anbinden

Das Backend stellt einen Remote-MCP-Endpunkt unter /mcp bereit. Der Endpunkt nutzt denselben Bearer-JWT wie die REST-API, d. h. ein Agent muss sich zuerst ueber die normale Auth-API anmelden und den accessToken bei allen MCP-Requests als Authorization: Bearer <accessToken> mitsenden.

Lokal laeuft der MCP-Endpunkt bei der API standardmaessig unter:

http://localhost:3000/mcp

Im Docker-Setup mit obigem Port-Mapping ist er erreichbar unter:

http://localhost:8080/mcp

Verfügbare MCP-Tools:

• list_existing_lists: liest die Listen des angemeldeten Users.
• list_templates: liest die Listenvorlagen des angemeldeten Users.
• suggest_lists: erzeugt strukturierte Vorschlaege für neue Listen, schreibt aber nichts in die Datenbank.
• create_list: erstellt eine neue Liste mit optionalen Start-Items.
• add_list_item: fügt ein Item zu einer bestehenden Liste hinzu.
• create_template: erstellt ein neues Template mit optionalen Start-Items.
• add_template_item: fügt ein Item zu einem bestehenden Template hinzu.

Weitere Details und Beispiel-Requests stehen in listify-api/README.md.