2Mind-MCP-Doku — Einrichtung, Scopes und Werkzeuge

Überblick

Der 2Mind-MCP-Server ist ein entfernter MCP-Server. Er gibt einem Assistenten Werkzeuge, um deine Notizen zu durchsuchen und zu lesen, deine Sammlungen und Aufgaben aufzulisten und Änderungen daran anzufragen. Er arbeitet mit demselben Konto und denselben Daten wie die 2Mind-Apps.

Lesen geschieht sofort. Schreiben geschieht nie still: Jedes Schreibwerkzeug legt eine Bestätigungsanfrage an, und die Änderung wird erst ausgeführt, wenn du zustimmst – es sei denn, du hast dieser Verbindung erlaubt, umkehrbare Änderungen selbst auszuführen.

Der Server nutzt den Streamable-HTTP-Transport im zustandslosen Modus. Jede Anfrage ist ein einzelner POST mit einem OAuth-Bearer-Token; es gibt keine Sitzungen und keinen Ereignisstrom, der offen gehalten werden muss.

Verbinden

Du brauchst ein 2Mind-Konto und einen Assistenten, der entfernte MCP-Server hinzufügen kann. Verwende diese Server-URL:

Server-URL

https://api.use2mind.com/mcp

Claude

Öffne die Connector-Einstellungen, wähle das Hinzufügen eines benutzerdefinierten Connectors, gib ihm einen Namen wie 2Mind und füge die Server-URL ein. In Organisationen muss ihn eventuell zuerst ein Owner hinzufügen.

ChatGPT

Schalte den Entwicklermodus ein und lege einen neuen Connector mit der Server-URL und OAuth-Authentifizierung an. Der Entwicklermodus hängt von deinem ChatGPT-Tarif und den Workspace-Einstellungen ab.

Andere Clients

Richte den Client auf die Server-URL. Er findet den Autorisierungsserver selbst über die OAuth-Metadaten des Servers; mehr ist nicht einzurichten.

Was beim Verbinden passiert

Dein Assistent öffnet die 2Mind-Anmeldeseite im Browser.
Du meldest dich mit Google, E-Mail und Passwort oder auf Apple-Geräten mit Apple an.
Du prüfst, was die App anfragt, und wählst eine Zugriffsstufe.
Du kehrst zu deinem Assistenten zurück, und die 2Mind-Werkzeuge erscheinen.

Zugriffsstufen

Wenn der Assistent Schreibzugriff anfragt, lässt dich der Zustimmungsdialog wählen. Die gewählte Stufe wird bei jedem einzelnen Aufruf geprüft, nicht nur beim Verbinden.

„Read only“ – nur lesen (Standard): Suchen, lesen und auflisten. Die Schreibwerkzeuge werden für diese Verbindung gar nicht erst angezeigt.
„Read and make changes“ – lesen und ändern: Fügt die Werkzeuge hinzu, die Änderungen anfragen. Jede Änderung wird weiterhin bestätigt.

Authentifizierung und Scopes

Der Server akzeptiert nur OAuth-2.0-Zugriffstoken, die im Authorization-Header als Bearer-Token gesendet werden. Es gibt keine API-Schlüssel, und kein Token wird je als Werkzeugargument übergeben.

Eine Anfrage ohne gültiges Token erhält 401 mit einem WWW-Authenticate-Header, der auf die Protected-Resource-Metadaten verweist. Von dort findet ein Client den Autorisierungsserver und startet einen Authorization-Code-Flow mit PKCE.

POST https://api.use2mind.com/mcp
GET https://api.use2mind.com/.well-known/oauth-protected-resource
issuer https://auth.use2mind.com

Scope	Erlaubt	Werkzeuge
`notes:read`	Notizen durchsuchen, auflisten und vollständig lesen; Tags auflisten.	`searchfetchlist_entrieslist_tags`
`collections:read`	Sammlungen auflisten und lesen; Tags auflisten.	`list_collectionsget_collectionlist_tags`
`todos:read`	Aufgaben mit Filtern auflisten.	`list_todos`
`notes:write`	Anlegen, Bearbeiten, Taggen, Verschieben und Löschen von Notizen anfragen.	`create_entryupdate_entrymove_entrydelete_entryundo_command`
`todos:write`	Anlegen, Bearbeiten, Umsortieren und Löschen von Aufgaben anfragen.	`create_todoupdate_tododelete_todoreorder_todosundo_command`
`collections:write`	Anlegen, Bearbeiten, Sortieren und Archivieren von Sammlungen anfragen.	`create_collectionupdate_collectionreorder_collectionsarchive_collectionunarchive_collectionundo_command`

Melde dich mit derselben Methode an wie in der App. Konten werden über Anmeldeanbieter hinweg nicht zusammengeführt; ein anderer Anbieter oder eine private Apple-Weiterleitungsadresse kann ein separates, leeres 2Mind-Konto anlegen.

Wie Änderungen funktionieren

Kein Schreibwerkzeug ändert deine Daten von selbst. Es liest die aktuelle Version des Ziels, erstellt einen genauen Plan und legt eine Bestätigungsanfrage an. Die Antwort ist ein Vorgang (Operation), den du verfolgen kannst.

Der Assistent stellt eine AnfrageEr ruft ein Schreibwerkzeug mit einer selbst erzeugten requestId auf. Der Server antwortet mit einem Vorgang im Status pending_approval und einer einzeiligen Zusammenfassung der Änderung.
Du bekommst eine MitteilungEine Mitteilung erreicht dein Handy. Dort bestätigst du die Änderung oder lehnst sie ab; der Assistent bestätigt nie in deinem Namen.
Die Änderung wird ausgeführtNach deiner Zustimmung wird die Änderung ausgeführt und protokolliert, damit sie später rückgängig gemacht werden kann. Unbeantwortete Anfragen verfallen nach 24 Stunden.
Der Assistent prüft das ErgebnisEr ruft get_operation mit der operationId auf, um zu sehen, ob die Änderung ausgeführt, abgelehnt, fehlgeschlagen oder verfallen ist.

Beispiel

Werkzeugaufruf

{
  "name": "create_todo",
  "arguments": {
    "requestId": "3f6c2a9e-8b1d-4c7a-9e2f-5a1b7d4c8e60",
    "collectionId": "b2e4d6f8-1a3c-4e5f-8a7b-9c0d1e2f3a4b",
    "content": "Zahnarzttermin vereinbaren",
    "dueDate": "2026-10-02T09:00:00+03:00"
  }
}

Ergebnis

{
  "operationId": "c81f0e2a-6d4b-4a9e-b3c7-1f2e3d4c5b6a",
  "action": "create_todo",
  "status": "pending_approval",
  "summary": "Aufgabe „Zahnarzttermin vereinbaren“ zu Erledigungen hinzufügen",
  "approvalUrl": "https://api.use2mind.com/connect/approvals/c81f0e2a-6d4b-4a9e-b3c7-1f2e3d4c5b6a",
  "expiresAt": "2026-10-01T09:00:00.000Z"
}

Das Vorgangsobjekt

`operationId`	Kennung, die an get_operation übergeben wird.
`action`	Das Werkzeug, das die Anfrage gestellt hat.
`status`	Wo die Anfrage gerade steht; siehe Tabelle unten.
`summary`	Eine vom Server geschriebene Zeile, die genau beschreibt, was sich ändert.
`approvalUrl`	Eine anmeldegeschützte Seite, auf der die Anfrage ebenfalls geprüft werden kann.
`expiresAt`	Wann eine unbeantwortete Anfrage verfällt.
`commandLogId`	Wird nach dem Ausführen gesetzt. Für undo_command verwenden.
`result`	Das Ergebnis einer ausgeführten Änderung, etwa die Kennung einer neuen Notiz.

Statuswerte

`pending_approval`	Wartet auf deine Zustimmung oder Ablehnung.
`applied`	Bestätigt und ausgeführt.
`failed`	Bestätigt, aber nicht ausführbar, zum Beispiel weil sich das Element inzwischen geändert hat.
`rejected`	Du hast abgelehnt.
`expired`	Nicht innerhalb von 24 Stunden beantwortet. Nichts wurde geändert.

Ohne Nachfrage ausführen

Unter „Connected apps“ hat jede Verbindung einen Schalter „Apply changes without asking“. Er ist standardmäßig aus. Ist er an, werden umkehrbare Änderungen dieser Verbindung sofort ausgeführt und als applied zurückgegeben. delete_entry und delete_todo warten trotzdem auf Zustimmung. Jede Änderung wird weiterhin protokolliert und lässt sich rückgängig machen.

Connected apps

Rückgängig machen

Eine ausgeführte Änderung kann der Assistent mit undo_command über commandLogId und version rückgängig machen, oder du selbst per Fingertipp unter „Recent changes“. Wurde das Element nach der Änderung bearbeitet, wird das Rückgängigmachen abgelehnt – deine neuere Arbeit wird also nie überschrieben.

Recent changes

Werkzeugreferenz

Eine Verbindung listet nur die Werkzeuge, die ihre Zugriffsstufe erlaubt. Jedes Schreibwerkzeug nimmt eine requestId: Ein erneuter Versuch mit derselben requestId liefert denselben Vorgang, statt eine zweite Änderung anzulegen.

Lesen

`search`

Nur lesenScope: notes:read

Durchsucht deine Notizen nach einem Stichwort oder Thema und liefert bis zu 20 Treffer mit Kennung, Titel und Link.

Parameter	Typ	Pflicht	Beschreibung
`query`	`string`	Ja	Das Stichwort oder Thema, nach dem gesucht wird.1–2.000 Zeichen

`fetch`

Nur lesenScope: notes:read

Liest eine Notiz anhand ihrer Kennung vollständig. Eine sehr lange Notiz kommt in Teilen; übergib die zurückgegebene nextId, um den nächsten Teil zu lesen.

Parameter	Typ	Pflicht	Beschreibung
`id`	`string`	Ja	Eine Notiz-Kennung aus search oder eine nextId aus einem vorherigen fetch, um eine lange Notiz fortzusetzen.bis zu 80 Zeichen

`list_entries`

Nur lesenScope: notes:read

Listet deine Notizen, neueste zuerst, wahlweise gefiltert nach Sammlung, Tag, einem Text in Titel oder Inhalt oder einem Erstellungszeitraum. Jede Zeile trägt einen Ausschnitt, alle Sammlungen der Notiz und ihre Tags. Seitenweise.

Parameter	Typ	Pflicht	Beschreibung
`collectionId`	`uuid`	Nein	Nur Notizen in dieser Sammlung.
`tag`	`string`	Nein	Nur Notizen mit diesem Tag, ohne Beachtung von Groß- und Kleinschreibung.1–100 Zeichen
`contains`	`string`	Nein	Nur Notizen, deren Titel oder Text diesen Ausdruck enthält, ohne Beachtung von Groß- und Kleinschreibung.1–200 Zeichen
`createdAfter`	`string (date-time)`	Nein	Nur Notizen, die zu oder nach diesem Zeitpunkt angelegt wurden. ISO 8601 mit Zeitzonenversatz.
`createdBefore`	`string (date-time)`	Nein	Nur Notizen, die zu oder vor diesem Zeitpunkt angelegt wurden. ISO 8601 mit Zeitzonenversatz.
`limit`	`integer`	Nein	Wie viele Einträge pro Seite geliefert werden.1–50 · Standard 20
`cursor`	`string (date-time)`	Nein	Der nextCursor-Wert der vorherigen Seite.

`list_collections`

Nur lesenScope: collections:read

Listet deine Sammlungen in deiner gespeicherten Reihenfolge, mit Typ, übergeordneter Sammlung, Archivstatus und ob sie Aufgaben enthält. Seitenweise.

Parameter	Typ	Pflicht	Beschreibung
`limit`	`integer`	Nein	Wie viele Einträge pro Seite geliefert werden.1–50 · Standard 20
`cursor`	`string`	Nein	Der nextCursor-Wert der vorherigen Seite.bis zu 100 Zeichen
`includeArchived`	`boolean`	Nein	Auch archivierte Sammlungen liefern. Standardmäßig ausgeblendet.

`get_collection`

Nur lesenScope: collections:read

Liest eine Sammlung anhand ihrer Kennung: dieselben Felder wie list_collections, dazu die letzte Änderung, wie viele Notizen sie enthält und wie viele ihrer Aufgaben noch offen sind.

Parameter	Typ	Pflicht	Beschreibung
`collectionId`	`uuid`	Ja	Die zu lesende Sammlung.

`list_todos`

Nur lesenScope: todos:read

Listet deine Aufgaben, wahlweise gefiltert nach Sammlung, Erledigt-Status oder Fälligkeitszeitraum. Seitenweise.

Parameter	Typ	Pflicht	Beschreibung
`collectionId`	`uuid`	Nein	Nur Aufgaben in dieser Sammlung.
`completed`	`boolean`	Nein	Nur erledigte (true) oder offene (false) Aufgaben.
`dueAfter`	`string (date-time)`	Nein	Nur Aufgaben, die zu oder nach diesem Zeitpunkt fällig sind. ISO 8601 mit Zeitzonenversatz.
`dueBefore`	`string (date-time)`	Nein	Nur Aufgaben, die zu oder vor diesem Zeitpunkt fällig sind. ISO 8601 mit Zeitzonenversatz.
`limit`	`integer`	Nein	Wie viele Einträge pro Seite geliefert werden.1–50 · Standard 20
`cursor`	`string`	Nein	Der nextCursor-Wert der vorherigen Seite.bis zu 100 Zeichen

`list_tags`

Nur lesenScope: notes:read · collections:read

Listet dein Tag-Vokabular mit der Zahl der Notizen und Sammlungen je Tag, die meistgenutzten zuerst. Notizen und Sammlungen teilen sich ein Vokabular.

Parameter	Typ	Pflicht	Beschreibung

Notizen

`create_entry`

Braucht ZustimmungScope: notes:write

Fragt eine neue Notiz in einer bestehenden Sammlung an. Die Sammlung wird immer ausdrücklich gewählt.

Parameter	Typ	Pflicht	Beschreibung
`requestId`	`uuid`	Ja	Eine UUID, die der Assistent erzeugt. Bei Wiederverwendung kommt der bestehende Vorgang zurück.
`collectionId`	`uuid`	Ja	Die Sammlung, in der die Notiz angelegt wird. Über list_collections zu finden.
`content`	`string`	Ja	Der Text der Notiz.1–20.000 Zeichen
`title`	`string oder null`	Nein	Der Titel der Notiz. null entfernt ihn.bis zu 500 Zeichen
`tags`	`string[]`	Nein	Tags der neuen Notiz, ohne #. Verwende nach Möglichkeit Namen aus list_tags.bis zu 10 Einträge

`update_entry`

Braucht ZustimmungScope: notes:write

Fragt eine Änderung an Titel, Text oder Tags einer Notiz an.

Parameter	Typ	Pflicht	Beschreibung
`requestId`	`uuid`	Ja	Eine UUID, die der Assistent erzeugt. Bei Wiederverwendung kommt der bestehende Vorgang zurück.
`entryId`	`uuid`	Ja	Die zu ändernde Notiz.
`title`	`string oder null`	Nein	Der Titel der Notiz. null entfernt ihn.bis zu 500 Zeichen
`content`	`string oder null`	Nein	Der Text der Notiz.bis zu 20.000 Zeichen
`tags`	`string[]`	Nein	Die vollständige neue Tag-Menge, ohne #. Nicht genannte Tags werden entfernt; [] entfernt alle. Weglassen, um die Tags unverändert zu lassen.bis zu 10 Einträge

`move_entry`

Braucht ZustimmungScope: notes:write

Fragt eine neue Menge von Sammlungen für eine Notiz an. Die Notiz verlässt jede nicht genannte Sammlung, samt den Aufgaben, die sie dort angelegt hat.

Parameter	Typ	Pflicht	Beschreibung
`requestId`	`uuid`	Ja	Eine UUID, die der Assistent erzeugt. Bei Wiederverwendung kommt der bestehende Vorgang zurück.
`entryId`	`uuid`	Ja	Die zu ändernde Notiz.
`collectionIds`	`uuid[]`	Ja	Die vollständige neue Menge an Sammlungen für die Notiz.1–5 Einträge
`primaryCollectionId`	`uuid`	Nein	Die Hauptsammlung. Muss in collectionIds enthalten sein; Standard ist die erste.

`delete_entry`

Braucht immer ZustimmungScope: notes:write

Fragt das Löschen einer Notiz und der verknüpften Aufgaben an. Braucht immer Zustimmung.

Parameter	Typ	Pflicht	Beschreibung
`requestId`	`uuid`	Ja	Eine UUID, die der Assistent erzeugt. Bei Wiederverwendung kommt der bestehende Vorgang zurück.
`entryId`	`uuid`	Ja	Die zu ändernde Notiz.

Aufgaben

`create_todo`

Braucht ZustimmungScope: todos:write

Fragt eine neue Aufgabe am Ende einer Aufgabenliste an.

Parameter	Typ	Pflicht	Beschreibung
`requestId`	`uuid`	Ja	Eine UUID, die der Assistent erzeugt. Bei Wiederverwendung kommt der bestehende Vorgang zurück.
`collectionId`	`uuid`	Ja	Eine Sammlung, bei der carriesTodos in list_collections true ist.
`content`	`string`	Ja	Der Aufgabentext.1–2.000 Zeichen
`dueDate`	`string (date-time) oder null`	Nein	Die Fälligkeit, ISO 8601 mit Zeitzonenversatz. null entfernt sie.

`update_todo`

Braucht ZustimmungScope: todos:write

Fragt eine Änderung an Text, Erledigt-Status oder Fälligkeit einer Aufgabe an.

Parameter	Typ	Pflicht	Beschreibung
`requestId`	`uuid`	Ja	Eine UUID, die der Assistent erzeugt. Bei Wiederverwendung kommt der bestehende Vorgang zurück.
`todoId`	`uuid`	Ja	Die zu ändernde Aufgabe.
`content`	`string oder null`	Nein	Der Aufgabentext.bis zu 20.000 Zeichen
`isCompleted`	`boolean`	Nein	Aufgabe als erledigt (true) oder offen (false) markieren.
`dueDate`	`string (date-time) oder null`	Nein	Die Fälligkeit, ISO 8601 mit Zeitzonenversatz. null entfernt sie.

`delete_todo`

Braucht immer ZustimmungScope: todos:write

Fragt das Löschen einer Aufgabe an. Braucht immer Zustimmung.

Parameter	Typ	Pflicht	Beschreibung
`requestId`	`uuid`	Ja	Eine UUID, die der Assistent erzeugt. Bei Wiederverwendung kommt der bestehende Vorgang zurück.
`todoId`	`uuid`	Ja	Die zu ändernde Aufgabe.

`reorder_todos`

Braucht ZustimmungScope: todos:write

Fragt eine neue Reihenfolge der Aufgaben in einer Sammlung an, die wichtigste zuerst. Es genügt, nur die Aufgaben zu nennen, die sich bewegen; die übrigen behalten dahinter ihre Reihenfolge.

Parameter	Typ	Pflicht	Beschreibung
`requestId`	`uuid`	Ja	Eine UUID, die der Assistent erzeugt. Bei Wiederverwendung kommt der bestehende Vorgang zurück.
`collectionId`	`uuid`	Ja	Die Sammlung, deren Aufgaben umsortiert werden. Jede Kennung muss zu ihr gehören.
`orderedIds`	`uuid[]`	Ja	Aufgaben-Kennungen in der neuen Reihenfolge, aus list_todos. Nicht genannte Aufgaben behalten dahinter ihre Reihenfolge.1–100 Einträge