MerkwerkAgents verbinden
Die Adresse des Servers lautet https://mcp.merkwerk.io/mcp. Die Anmeldung läuft per OAuth im Browser, mit demselben Konto wie in der Web-App. Nach dem Login zeigt die Seite Agents verbinden alle Wege mit Kopierfeldern.
| Client | Weg |
|---|---|
| Cursor, VS Code | Ein Klick auf der Seite Agents verbinden |
| Claude Web und Desktop | Connectors, „Add custom connector“, Adresse eintragen |
| ChatGPT | Entwicklermodus in den Einstellungen, Connector anlegen |
| Perplexity | Settings, Connectors, eigener Remote-Connector mit Client-ID und Secret aus Merkwerk |
| Claude Code | claude mcp add --transport http merkwerk https://mcp.merkwerk.io/mcp |
| Codex | codex mcp add merkwerk --url https://mcp.merkwerk.io/mcp |
| Gemini CLI | gemini mcp add --transport http merkwerk https://mcp.merkwerk.io/mcp |
Werkzeuge
| Tool | Macht |
|---|---|
search | Sucht nach Bedeutung und Wortlaut, mit optionalem Stichtag |
read_note | Liest eine Notiz |
list_related | Zeigt Links, Rückverweise und Ablösungen |
briefing | Nennt bald ablaufende Fakten und neue Änderungen |
list_categories | Listet die Kategorien des Teams |
create_note | Legt eine Notiz an |
update_note | Ändert oder benennt eine Notiz um |
delete_note | Löscht eine Notiz, die Historie bleibt |
propose_note | Schlägt eine Änderung zur Prüfung vor |
Fakten
Eine Notiz ist Markdown mit optionalem Frontmatter:
---
type: preis
authority: authoritative
owner: produkt
valid_from: 2026-04-01
valid_until: 2026-12-31
supersedes: "[[Preise 2025]]"
---
# Preiseauthority ist authoritative, reviewed, draft, deprecated oder archived. Abgelaufene, archivierte oder abgelöste Notizen erscheinen nicht als Treffer, die Suche nennt sie aber mit Grund. Mit einem Stichtag antwortet Merkwerk aus dem Stand dieses Tages.
Rechte
Ohne Einschränkung sieht das ganze Team eine Notiz. Kategorien und einzelne Notizen lassen sich auf Personen beschränken, Owner und Admins sehen alles. Ein Agent hat die Rechte der angemeldeten Person, Service-Accounts sehen nur Offenes.
Schreiben durch Agents
Agents legen Notizen direkt an und ändern sie. Jede Änderung ist eine Version. Bei Notizen mit authoritative oder reviewed entsteht stattdessen ein Vorschlag, den Owner oder Admins prüfen.
Export
Owner und Admins exportieren alle Notizen als ZIP mit Markdown-Dateien, auf Wunsch mit Historie. Kategorien und Rechte gehören nicht zum Export.