minddy MCP

Verbinden Sie einen externen Assistenten mit minddy, steuern Sie den Zugriff und lernen Sie verfügbare MCP-Tools und sichere Änderungsverfahren kennen.

minddy MCP ermöglicht einem externen Assistenten den Werkzeugzugriff mit den Berechtigungen Ihres Kontos. Verbinden Sie ihn über die Einrichtung Ihrer Instanz und prüfen oder widerrufen Sie seinen Zugriff in den Kontoeinstellungen. Lesen Sie vor Änderungen an Tickets, Seiten oder Routinen die aktuellen Werkzeugschemas.

Einen externen Assistenten mit minddy MCP verbinden

Öffnen Sie die öffentliche MCP-Einrichtungsseite Ihrer Instanz und wählen Sie die Client-Anleitung. Nutzen Sie den dort angezeigten Endpunkt mit /api/mcp. Bei Self-Hosting verwenden Sie Ihre Instanzadresse statt Cloud. Der Client muss die beschriebene entfernte MCP-Verbindung und OAuth unterstützen.

Melden Sie sich im Browser an und prüfen Sie die Freigabe. Die Verbindung handelt als Ihr minddy-Konto und erhält keinen Zugriff auf gesperrte Projekte. Beginnen Sie mit dem Lesen eines bereits zugänglichen Tickets und prüfen Sie das zurückgegebene Projekt.

Wähle deinen Client, um dessen Installationsbefehl oder Konfiguration anzuzeigen.

MCP-Verfügbarkeit und Netzwerkzugriff

MCP ist in selbst gehostetem minddy enthalten und startet mit der Anwendung. Es funktioniert sofort unter /api/mcp an der mit MINDDY_PUBLIC_APP_URL konfigurierten Instanzadresse. OAuth-Erkennung und dynamische Client-Registrierung sind enthalten: Ein separater MCP-Server, eine eigene OAuth-Anwendung oder ein minddy-Cloud-Proxy ist nicht erforderlich. Verbinden Sie Ihren MCP-Client mit dem Endpunkt Ihrer Instanz, melden Sie sich an und erteilen Sie den Zugriff im Browser.

Die Verfügbarkeit des Dienstes garantiert keine Erreichbarkeit im Netzwerk. Sowohl der MCP-Client als auch der Browser für die Autorisierung müssen die bekannt gegebenen MCP- und OAuth-URLs erreichen können. Wenn Sie OAUTH_ISSUER ausdrücklich überschreiben, muss auch diese Adresse erreichbar sein. Der Client muss die Verbindung, den OAuth-Ablauf und den gewählten Netzwerkweg unterstützen; manche Clients verlangen auch in privaten Netzwerken HTTPS.

Derselbe Computer: http://localhost:6463/api/mcp funktioniert für einen kompatiblen Client auf dem Computer, der die lokale Instanz betreibt. localhost und 127.0.0.1 bezeichnen den Computer, der die Verbindung aufbaut. Der Start lokaler Instanzen über die Desktop-App bindet nur an die Loopback-Schnittstelle; ein anderer Computer oder ein gehosteter Cloud-Agent kann sie nicht direkt erreichen. Die localhost-URL des Servers zeigt auf einem anderen Computer auf diesen anderen Computer.
LAN oder VPN: Eine mit http://192.168.1.50 konfigurierte Instanz gibt http://192.168.1.50/api/mcp bekannt. Ein Client im LAN oder über VPN kann sie verwenden, wenn Bindungsadresse, konfigurierte Instanzadresse, Anwendungsport, Firewall und Routing den Zugriff zulassen. Der Browser muss dieselben bekannt gegebenen Autorisierungs-URLs erreichen. Dafür ist eine erreichbare Serverinstallation erforderlich; allein das Ändern der Client-URL macht einen auf Loopback beschränkten Prozess nicht erreichbar.
Außerhalb des privaten Netzwerks: Verwenden Sie eine erreichbare HTTPS-Adresse, etwa https://tickets.example.com/api/mcp, oder einen anderen vom Client unterstützten Netzwerkweg. Ein gehosteter Agent benötigt einen eigenen Netzwerkweg zur Instanz; ein VPN auf dem Computer des Browsers allein bietet ihm diesen Weg nicht. Lokales Hosting macht minddy nicht automatisch im Internet erreichbar.

Umfang und Widerruf

Externe Clients verwenden verfügbare Tools für Tickets, Pläne, Kommentare, Seiten, Feedback, Zyklen, Routinen und Notizbuch innerhalb ihrer Rechte. Die Tools folgen bei jedem Aufruf Ihrer aktuellen Rolle im jeweiligen Projekt, eine Rollenänderung gilt also ohne erneutes Verbinden. Als Leser erhalten Sie die Lesetools und zusätzlich die Kommentartools, wenn der Eigentümer Darf kommentieren für Sie aktiviert hat. MCP ist in jedem Cloud-Tarif verfügbar; KI des Clients hängt weiterhin von dessen Einrichtung und Kosten ab.

Der Bereich minddy MCP in den Kontoeinstellungen zeigt externe Zugriffe und Widerrufsmöglichkeiten. Widerrufen Sie ungenutzte oder nicht mehr vertrauenswürdige Clients. Die Karte MCP für Numo im Tab KI & Numo verbindet dagegen Numo mit anderen Diensten. Kopieren Sie keine Zugriffstoken in Tickets, öffentliche Beiträge oder Screenshots.

Dieses Beispiel verbindet sich mit minddy Cloud. Verwenden Sie bei Selbsthosting den Ursprung Ihrer eigenen Instanz; der angezeigte Befehl wurde für diese Aufnahme nicht ausgeführt.

minddy MCP nutzen und aktuelle Werkzeuge entdecken

minddy bietet /api/mcp mit Streamable HTTP, zustandslosen Werkzeugen und OAuth 2.1. Verbinden Sie Ihr Konto durch Browserzustimmung; alte statische mdyk_-Schlüssel gelten nicht. Starten Sie minddy_list_projects für zugängliche Projekt-UUIDs und lesen Sie Schemas des verbundenen Servers. /llms-full.txt wird daraus erzeugt und nennt genaue aktuelle Parameter. Erraten Sie Werkzeuge nicht anhand alter Kopien. Projektwerkzeuge prüfen Zugriff erneut und geben stabile Fehlercodes zurück.

Vor Planänderungen lesen

Um ein Ticket zu finden, rufen Sie minddy_list_issues mit query auf: Die Suche erfasst Wörter aus Titel und Beschreibung, eine Kennung oder eine Nummer. Textübereinstimmungen und exakte Kennungen stehen zuerst; eine beschreibende Anfrage kann danach inhaltlich gefundene Tickets desselben Projekts ergänzen, markiert mit match: "semantic". Lesen Sie ein solches Ticket, bevor Sie danach handeln. Die inhaltliche Suche wird Ihrem Konto als Problemsuche berechnet und entfällt, wenn Sie Vorgänge indexieren ausgeschaltet haben.

minddy_get_issue akzeptiert eine Ticket-UUID, eine Ticketkennung wie DEMO-42 oder eine Ticketnummer; project_id wird separat angegeben. plan_tasks liefert nullbasierte task_index-Werte. minddy_update_plan_task nimmt tasks mit pending, in_progress, completed oder cancelled an; ein ungültiger Index lehnt den ganzen Satz ab. Ergänzen Sie mit minddy_append_to_plan und ändern Sie Passagen mit minddy_edit_issue_text sowie eindeutigen exakten old_string/new_string. Lesen Sie bei veralteter Passage neu. Gesamtersatz kann fremden Fortschritt überschreiben. Fragen unter ## Questions zählen nicht als Aufgaben.

Lesevorgänge, die Text mit Bildern liefern (minddy_get_issue, minddy_get_objective, minddy_get_page, minddy_get_feedback, minddy_get_scratchpad), führen diese unter images auf, jeweils mit src und Alternativtext. Übergeben Sie dieses src unverändert an minddy_get_image: Das Werkzeug prüft Ihren Zugriff auf das Projekt des Bildes oder dass ein Notizbuchbild Ihnen gehört, und liefert das Bild bis 10 MB direkt mit einer signierten download_url, die etwa zehn Minuten gilt. Ein außerhalb von minddy gehostetes Bild kommt nur als URL zurück.

Versionen und Eigentum beachten

minddy_list_pages zeigt die Hierarchie, minddy_search_pages findet Textausschnitte und minddy_get_page liest das vollständige Markdown, Kommentare und Datenbankwerte. Bevorzugen Sie gezielte Teiländerungen und verwenden Sie beim vollständigen Ersetzen die aktuelle Version, um zwischenzeitliche Änderungen zu erkennen. Behalten Sie Datei- und Bild-URLs unverändert bei. minddy_create_page mit database=true erstellt eine Seitendatenbank. minddy_update_page_database verlangt die Schema-Revision und den vorherigen Wert für Zelländerungen.

Geben Sie für eine Konvertierung operation=convert, propertyId, targetType, revision und zunächst preview=true an. Prüfen Sie incompatibleCount und senden Sie dann dieselben Konvertierungseinstellungen mit preview=false und dem zurückgegebenen token. Setzen Sie confirmLoss=true nur, wenn der Benutzer dem Verlust inkompatibler Werte ausdrücklich zugestimmt hat.

Mit den Routinenwerkzeugen, die nur Eigentümern zur Verfügung stehen, erstellen, ändern, pausieren und entfernen Sie Routinen, die ein Zeitplan, ein Ereignis oder ein neuer Datenbankeintrag auslöst. Lesen Sie vorhandene Routinen, bevor Sie eine neue erstellen, um doppelte Aufträge zu vermeiden. minddy_add_resource begrenzt Dateien auf 10 MB; Seitenwerkzeuge erfinden keine URLs.

Mit einem Beispiel überprüfen

Das bereinigte Beispiel ändert die erste Aufgabe eines zuvor gelesenen Plans. Ersetzen Sie Projekt-UUID und Ticket durch entdeckte Werte; task_index muss aus der letzten Lektüre stammen. Prüfen Sie zurückgegebene plan_tasks und plan_progress. Bei Zugriffsfehlern prüfen Sie Konto/Projekt, bei veraltetem Konflikt lesen Sie erneut und ändern nur das Gewünschte. Wiederholen Sie unklare externe Mutationen nicht vor Ergebniskontrolle.

JSON

{
  "project_id": "00000000-0000-4000-8000-000000000001",
  "issue": "DEMO-42",
  "tasks": [{"task_index": 0, "state": "in_progress"}]
}

Ein Ziel für Feedback wählen

Feedback-Lesezugriffe enthalten objective_id; minddy_list_feedback unterstützt einen optionalen Zielfilter (null wählt Anfragen ohne Ziel). Verwenden Sie minddy_link_feedback_objective mit project_id, feedback_post_id und objective_id nur auf ausdrücklichen Wunsch des Benutzers; null entfernt die Zuordnung. Das Ziel muss aktiv sein und zum selben Projekt gehören. Zieldetails enthalten linked_feedback. Eigentümer können objective_id bei minddy_create_integration für Feedback-Schlüssel angeben oder die Vorgabe mit minddy_update_integration_objective ändern. Bestehendes Feedback bleibt unverändert. Die Umwandlung übernimmt Ziel und Kategorien; Numo weist bei der Prüfung niemals ein Ziel zu.