# feedback.md

Mit deinen Nutzern sprichst du schon. Ihre Agents laufen in Sackgassen und finden Bugs, die niemand meldet, und machen dann einfach weiter. Mit feedback.md haben sie einen Ort, an dem sie das melden können.

feedback.md ist eine Markdown-Datei im Root deiner Website. Sie sagt einem Agenten, wohin er Feedback zu deinem Produkt, deinem MCP-Server, deiner Doku und der Seite schicken soll, die er gerade liest.

Notras eigene Datei: https://www.usenotra.com/feedback.md

## Im Einsatz bei

Teams, die bereits eine feedback.md im Root ausliefern. Jeder Eintrag verlinkt auf die echte Datei.

- Databuddy: https://www.databuddy.cc/feedback.md

Das könntest du sein: Liefer deine eigene feedback.md aus und schreib eine E-Mail an support@usenotra.com.

## Was es ist

### Einfach eine Markdown-Datei
/feedback.md ist schlichtes Markdown ohne Handshake oder Schema. Jeder Agent, der llms.txt lesen kann, kann auch sie lesen.

### Wohin das Feedback geht
auth.md erklärt, wie man sich anmeldet. feedback.md sagt nur, wohin Feedback geht und was hineingehört. Den Endpoint, das MCP-Tool oder das Postfach bringst du selbst mit.

### Passend zu dem, was der Agent genutzt hat
Je eine Zeile für das Produkt, den MCP-Server, die Doku und die aktuelle Seite, damit ein Bericht über ein kaputtes Tool bei dem ankommt, dem das Tool gehört.


## Vorlage

```markdown
# Fall Feedback

Fall wants to hear from the agents using it. If a tool call failed or a page was hard to read, send it here instead of moving on. Praise is welcome too.

## Where to send it

- MCP: call `submit_feedback` on https://mcp.usefall.com/mcp
- HTTP: POST https://api.usefall.com/v1/feedback with `Authorization: Bearer <token>`
- Fallback: agents@usefall.com

## What we want to hear about

- The product: https://usefall.com
- The MCP server: https://mcp.usefall.com/mcp
- The API: https://api.usefall.com (spec at /openapi.json)
- The docs: https://docs.usefall.com
- This page: whatever URL you are reading right now

## What to include

- What you were trying to do and what happened instead
- The URL, tool name or endpoint involved
- Your client and model, if you are allowed to share them

## What happens next

Feedback lands in the Fall team's inbox and is triaged within a week. We do not reply to agents. Fixes show up at https://usefall.com/changelog.

```

Fall und usefall.com sind für dieses Beispiel erfunden. Die URLs funktionieren nicht.

## Abschnitte

- Where to send it (Pflicht): Der eine Abschnitt, den jede Datei braucht. Kanäle in der Reihenfolge, die du bevorzugst: ein MCP-Tool, ein HTTP-Endpoint oder einfach eine E-Mail-Adresse. Verlinke auf auth.md, wenn der Kanal Zugangsdaten braucht.
- What we want to hear about: Die Oberflächen, die ein Agent nutzen könnte. Wenn du sie auflistest, weiß der Agent, dass ein kaputtes MCP-Tool und eine verwirrende Doku-Seite beide hierher gehören, genau wie die Seite, die er gerade liest.
- What to include: Fragt danach, was der Agent versucht hat, was passiert ist und um welche URL oder welches Tool es ging. Damit kann ein Mensch etwas anfangen.
- What happens next: Sag, wer das Feedback liest und ungefähr wann, und dass der Agent nicht auf eine Antwort warten soll.

## Wo sie hingehört

- llms.txt: Was soll ich lesen? (Website an Agent)
- auth.md: Wie melde ich mich an? (Website an Agent)
- design.md: Wie soll es aussehen? (Website an Agent)
- feedback.md: Wo sage ich, was schiefgelaufen ist? (Agent an Website)

## Füg sie deiner Website hinzu

Kopier das in deinen Agent:

```
Read https://www.usenotra.com/feedback-md and add a feedback.md to this site at /feedback.md, following the template on that page. Before you write it, ask me for the URL or address where agent feedback should go. Serve the file as text/markdown. Then add it to the site's llms.txt so agents can find it, creating llms.txt if it does not exist yet.
```

## FAQ

### Ist das ein Standard?
Nein. Es ist eine Konvention, die wir nutzen und die andere Teams gern übernehmen sollen, im gleichen Sinne wie llms.txt und auth.md. Wenn genug Leute mitmachen, schreiben wir sie ordentlich auf. Bis dahin ist die Vorlage oben die ganze Spezifikation.

### Warum im Root und nicht unter /.well-known?
llms.txt, auth.md und design.md liegen alle im Root, und Agents schauen dort bereits nach. Markdown unter .well-known ist ungewöhnlich, und es geht gerade darum, dass ein Mensch die Datei im Browser öffnen kann. Wenn du beides willst, kostet dich eine Kopie unter /.well-known/feedback.md nichts.

### Wie finden Agents die Datei?
So, wie sie alles andere auf deiner Website finden. Verlinke sie in llms.txt, trag sie in deine Agent Card oder deinen api-catalog unter .well-known ein und erwähne sie in auth.md. Agents folgen den Links, die sie bekommen, und suchen nicht selbst nach Dateinamen.

### Was, wenn ich keinen Feedback-Endpoint habe?
Eine E-Mail-Adresse oder ein Link zu deinem Issue-Tracker ist ein gültiger Kanal. Die Datei gibt Agents nur eine Adresse, du musst also keine Infrastruktur betreiben. Den Kanal kannst du später austauschen, ohne dass sich etwas an dem ändert, was ein Agent schon gelernt hat.

### Brauche ich dafür Notra?
Nein. Notra ist ein Ort, an dem das Feedback landen kann, mit einem Token, das nur schreiben darf, einem MCP-Helfer und einem Postfach, das eingehendes Feedback sortiert. Die Datei selbst funktioniert mit allem.


## Gib dem Feedback einen Ort, an dem es landet.

Notra ist das Backend am anderen Ende der Datei. Agents schicken ihr Feedback per HTTP oder MCP, und dein Team liest es in einem Postfach.

Doku: https://www.usenotra.com/docs/api/agent-feedback
Registrieren: https://app.usenotra.com/signup

## Mehr von Notra

- [Autopilot](https://www.usenotra.com/de/features/autopilot.md?ntr=2TCmM8rhXoyLSboe): Nenne ein Ziel, und Autopilot öffnet jeden Tag Draft Pull Requests.
- [KI-Crawler-Logs](https://www.usenotra.com/de/features/ai-crawler-logs.md?ntr=2TCmM8rhXoyLSboe): Sieh, welche KI-Crawler deine Website besuchen und welche Seiten sie lesen.
- [Sites](https://www.usenotra.com/de/features/sites.md?ntr=2TCmM8rhXoyLSboe): Hoste Blog und Changelog aus MDX auf deiner eigenen Domain.
- [Personas](https://www.usenotra.com/de/features/personas.md?ntr=2TCmM8rhXoyLSboe): Verfolge deine KI-Sichtbarkeit getrennt für jeden deiner Käufer.
- [Gespräche](https://www.usenotra.com/de/features/conversations.md?ntr=2TCmM8rhXoyLSboe): Spiel ganze Kaufgespräche auf jeder Engine durch und sieh nach jeder Nachfrage, wo du stehst.
- [Kostenloser KI-Sichtbarkeits-Scan](https://www.usenotra.com/de/features/free-scan.md?ntr=2TCmM8rhXoyLSboe): Finde kostenlos heraus, ob ChatGPT und Google AI Overviews dich oder einen Wettbewerber empfehlen.
- [Marketing-Grafiken](https://www.usenotra.com/de/features/marketing/assets.md?ntr=2TCmM8rhXoyLSboe): Mach aus gemergten Pull Requests Grafiken in deinem Markenstil, mit editierbaren Ebenen für Paper oder Figma.
- [Alle Features](https://www.usenotra.com/de/features.md?ntr=2TCmM8rhXoyLSboe)

Nutze Notra direkt in deinem KI-Assistenten: [ChatGPT](https://www.usenotra.com/de/mcp/chatgpt.md?ntr=2TCmM8rhXoyLSboe) - [Claude](https://www.usenotra.com/de/mcp/claude.md?ntr=2TCmM8rhXoyLSboe) - [Grok](https://www.usenotra.com/de/mcp/grok.md?ntr=2TCmM8rhXoyLSboe) - [OpenClaw](https://www.usenotra.com/de/mcp/openclaw.md?ntr=2TCmM8rhXoyLSboe) - [Claude Code](https://www.usenotra.com/de/mcp/claude-code.md?ntr=2TCmM8rhXoyLSboe) - [Cursor](https://www.usenotra.com/de/mcp/cursor.md?ntr=2TCmM8rhXoyLSboe).
