MCP-Integration

Kundenfeedback, direkt in deinen KI-Coding-Agenten.

Jede Notiz, die Kund:innen auf der Seite hinterlassen, trägt das Element, auf das sie zeigt, seinen Selektor und die berechneten Styles — plus dein Briefing, was sich ändern soll. SpotNote stellt das Claude Code, Cursor, Codex oder VS Code als MCP-Tools bereit, und der Agent arbeitet die Queue in deinem Repository ab.

Kostenlos startenZum Setup ↓
Nichts zu installierenKein API-Token nötigAuf ein Projekt begrenzt
So funktioniert's

Von der Kundennotiz zum Pull Request

01
Notiz sichten
Den Kommentar der Kund:in einmal lesen, „KI übernimmt" wählen und ein Briefing in deinen Worten schreiben. Das Briefing ist, was der Agent umsetzt — nicht die Formulierung der Kund:in.
02
Editor verbinden
Im Projekt „Verbinden" öffnen, Client wählen, eine Zeile kopieren. Die URL enthält bereits das Projekt, die Anmeldung läuft im Browser.
claude mcp add --transport http \
  spotnote "https://app.spotnote.ninja/mcp?project=…"
03
Der Agent arbeitet die Queue ab
Dein Agent listet die ihm übergebenen Notizen, liest Element und Briefing, ändert den Code und markiert jede Notiz als erledigt — dein Posteingang zieht mit.
list_feedbackget_feedbackset_feedback_status
Setup

Verbinden mit einem Befehl

Der Dialog „Verbinden" in SpotNote zeigt die exakte URL für jedes Projekt. Das sind die Snippets, die er ausgibt — gleich für Staging, Preview oder Produktion.

Der Endpoint deines Projektshttps://app.spotnote.ninja/mcp?project=<project-id>
Claude CodeDoku ↗
Im Repository ausführen
claude mcp add --transport http spotnote "https://app.spotnote.ninja/mcp?project=<project-id>"

Befehl ausführen, dann in Claude Code /mcp eingeben, spotnote wählen und anmelden.

CursorDoku ↗
Eintragen in .cursor/mcp.json
{
  "mcpServers": {
    "spotnote": {
      "url": "https://app.spotnote.ninja/mcp?project=<project-id>"
    }
  }
}

Oder den Ein-Klick-Button im Dialog „Verbinden" nutzen. Die Anmeldung bestätigen, wenn Cursor fragt.

CodexDoku ↗
Im Repository ausführen
codex mcp add spotnote --url "https://app.spotnote.ninja/mcp?project=<project-id>"
Im Repository ausführen
codex mcp login spotnote

Der zweite Befehl öffnet den Browser zur Anmeldung.

VS CodeDoku ↗
Eintragen in .vscode/mcp.json
{
  "servers": {
    "spotnote": {
      "type": "http",
      "url": "https://app.spotnote.ninja/mcp?project=<project-id>"
    }
  }
}

Der Root-Key heißt „servers", nicht „mcpServers" — beim falschen Key schweigt VS Code einfach.

Die Tools

Vier Tools. Mehr Oberfläche gibt es nicht.

Absichtlich klein: Ein Agent, der Notizen auflisten, lesen und schließen kann, hat alles, was er braucht — und nichts, womit er sich verlaufen könnte.

list_projects
Die Websites in deinem Workspace, mit Sessions und offenen Notizen pro Projekt. Damit findet der Agent das Projekt, das zum Repository passt, in dem er sitzt.
list_feedback
Die Arbeitsliste. Standardmäßig genau die Notizen, die du der KI zugewiesen hast und die noch offen sind — mit deinem Briefing, dem Kundenkommentar und dem Element, auf das jede zeigt.
get_feedback
Alles zu einer Notiz: jedes Element unter der Annotation mit Tag, sichtbarem Text, Selektor, Klassen, Data-Attributen und berechneten Styles, plus Link zum Seitenbild. Der Abruf setzt die Notiz auf deinem Board auf „in Arbeit".
set_feedback_status
Hält fest, was passiert ist. Der Agent setzt „erledigt", nachdem die Änderung gemacht ist — und nie von sich aus „wird nicht behoben", denn Kundenfeedback abzulehnen bleibt deine Entscheidung.
Auf Vertrauen gebaut

Die Kund:in meldet. Du briefst. Der Agent folgt dir.

Zwei Arten von Text, sauber getrennt
Jedes Tool-Ergebnis kennzeichnet den Kundenkommentar als Problembericht und dein Briefing als Anweisung. Was auch immer Kund:innen ins Widget tippen — der Agent behandelt es als Daten, nie als Befehl.
Dein Code verlässt deinen Rechner nicht
SpotNote liefert nur Notizen. Der Agent läuft in deinem Editor und ändert dein Repository — wir sehen weder Quellcode noch Tokens noch Build.
Ein Projekt pro Verbindung
Die Endpoint-URL ist an ein einzelnes Projekt gebunden. Ein Agent, der an der Restaurant-Seite arbeitet, kann keine Notizen der Kanzlei-Seite lesen.
Anmeldung, die du widerrufen kannst
SpotNote ist sein eigener OAuth-Authorization-Server: nur PKCE, Tokens an den registrierten Client gebunden, rotierende Refresh-Tokens mit Wiederverwendungs-Erkennung. Client widerrufen — und er ist draußen.
Elementdaten statt Raten
Selektor, sichtbarer Text und berechnete Styles reisen mit jeder Notiz. „Fetter bitte" kommt mit dem aktuellen font-weight, also ändert der Agent das Richtige um das richtige Maß.
REST, wenn du es brauchst
Dasselbe Feedback gibt es über eine REST-API mit Workspace-Tokens — für Skripte, CI oder ein eigenes Agenten-Framework.
FAQ

Was Agenturen fragen

Welche KI-Coding-Agenten unterstützt SpotNote über MCP?

Claude Code, Cursor, OpenAI Codex und VS Code (Copilot Agent Mode) stehen mit fertigen Snippets im Dialog „Verbinden". Jeder Client, der MCP über Streamable HTTP mit OAuth spricht, funktioniert genauso — der Endpoint ist Standard.

Muss ich ein API-Token in meine Editor-Konfiguration einfügen?

Nein. Das Snippet enthält nur die Endpoint-URL. Bei der ersten Nutzung öffnet dein Editor den Browser, du meldest dich bei SpotNote an und bestätigst den Client. Tokens werden für diesen Client ausgestellt und lassen sich jederzeit widerrufen.

Bekommt der KI-Agent über SpotNote Zugriff auf meinen Quellcode?

Nicht über uns. Der Agent läuft ohnehin in deinem Editor mit deinem Repository. SpotNote liefert nur die Notizen — Kommentar, Briefing, Elementdaten, Snapshot — und speichert den Status, den der Agent zurückmeldet.

Können Kund:innen den Agenten direkt anweisen?

Nein. In der Arbeitsliste erscheinen nur Notizen, die du der KI zugewiesen hast, und jede trägt dein Briefing als maßgebliche Anweisung. Der Kundenkommentar wird als Bericht geliefert und ausdrücklich als Nicht-Anweisung markiert.

Was genau sieht der Agent zu einer Notiz?

Den Kundenkommentar, dein Briefing und jedes Element unter der Annotation mit Tag, sichtbarem Text, CSS-Selektor, Klassen, Data-Attributen und berechneten Styles — plus einen Link zum aufgenommenen Seitenbild, wenn es eines gibt.

Gibt es eine lokale oder selbst gehostete Variante?

Der gehostete Endpoint auf app.spotnote.ninja ist der Standardweg. Dieselben Tools sind über die REST-API mit einem Workspace-Token erreichbar, sodass du eine eigene Brücke bauen kannst, wenn dein Agent nicht mit unseren Servern sprechen soll.

Was kostet die MCP-Integration?

Nichts extra. Während der Beta ist SpotNote kostenlos, und der MCP-Endpoint gehört zu jedem Projekt.

Lass die Seite deinen Agenten briefen.

Pack SpotNote auf deine nächste Übergabe, sichte einmal und gib die mechanischen Fixes an deinen Editor.

Kostenlos starten