# Notion

> Gib einem Agenten Zugriff auf bestimmte Notion-Seiten und -Datenbanken – zum Lesen, Abfragen und Schreiben neuer Seiten.

Mit dem Notion-Connector kann ein Agent deinen Workspace durchsuchen, Seiten als reinen Text lesen, Datenbanken abfragen und Seiten erstellen oder erweitern.

## Wann du ihn nutzt

In Notion halten Teams den Kontext fest, den man einem Agenten sonst erst erklären müsste: Spezifikationen, Meetingnotizen, Projekt-Tracker. Ein Agent, der das lesen kann, fragt dich nicht mehr nach Hintergründen und kann seine Ergebnisse dort ablegen, wo der Rest des Teams ohnehin nachsieht.

## Verbinden

<Steps>

1. **Öffne Connectors** im [Agent Builder](/de/docs/build/agent-builder/) und wähle Notion.

2. **Melde dich an und wähle aus, was du teilst.** Der Zustimmungsbildschirm von Notion fragt, auf welche Seiten die Integration zugreifen darf. Das ist die Zugriffskontrolle, und sie liegt bei Notion.

3. **Weise die Verbindung dem Agenten zu.**

</Steps>

<Aside type="caution" title="Leere Ergebnisse bedeuten meist, dass eine Seite nicht geteilt wurde">
  Eine Suche ohne Treffer liegt häufiger am Teilen als an der Schreibweise. Wurde eine
  Seite bei der Autorisierung nicht einbezogen oder erst danach erstellt, teile sie über
  das Seitenmenü in Notion mit der Integration.
</Aside>

## Was ein Agent tun kann

| Operation | Freigabepflichtig |
| --- | --- |
| Seiten und Datenbanken nach Titel durchsuchen | Nein |
| Eine Seite als reinen Text lesen, inklusive verschachtelter Listen und Toggles | Nein |
| Eine Datenbank abfragen, gefiltert nach einer Eigenschaft | Nein |
| Eine Seite unter einer Seite oder in einer Datenbank erstellen | Nein |
| Inhalte an eine bestehende Seite anhängen | Nein |

In Notion ist standardmäßig nichts freigabepflichtig, denn keine dieser Operationen sendet etwas nach außen oder löscht Daten. Erstellen und Anhängen verändern aber deinen Workspace. Der Agent ist angewiesen, Ort und Titel vorher mit dir abzustimmen, doch die Schranke für [Freigaben](/de/docs/work/approvals/) hält ihn nicht auf.

## Damit arbeiten

- **Zuerst suchen.** Ein Agent braucht die ID einer Seite, bevor er sie lesen oder erweitern kann. Ein vages *„Aktualisiere die Roadmap-Seite“* kostet deshalb einen Suchschritt. Schneller geht es, wenn du den Link zur Seite einfügst.
- **Sehr lange Seiten werden gekürzt.** Beim Lesen kommt so viel zurück, wie passt, mit dem Hinweis, dass gekürzt wurde. Verweise den Agenten bei einem großen Dokument auf den Abschnitt.
- **Datenbankabfragen filtern nach einer Eigenschaft.** Komplexe Ansichten mit mehreren Bedingungen baust du besser in Notion und lässt den Agenten das Ergebnis lesen.

## Einschränkungen

- Der Agent sieht nur, was du in Notion mit der Integration geteilt hast.
- Beim Lesen kommt reiner Text zurück. Notion-spezifische Strukturen wie Datenbanken in Seiten, synchronisierte Blöcke oder komplexe Layouts werden abgeflacht, und Formatierungen überstehen den Hin- und Rückweg nicht exakt.
- Es gibt keine Löschoperation.
- Seiten, die der Agent erstellt, gehören der Notion-Integration und erscheinen so auch im Seitenverlauf.

## Siehe auch

<CardGrid>
  <LinkCard
    title="Connectors im Überblick"
    href="/de/docs/connect/overview/"
    description="Verbindung und Zuweisung sowie das Widerrufen von Zugriff."
  />
  <LinkCard
    title="Projekte"
    href="/de/docs/capabilities/projects/"
    description="Kontext in endue halten, statt ihn jedes Mal abzurufen."
  />
  <LinkCard
    title="Verfügbare Connectors"
    href="/de/docs/connect/available-connectors/"
    description="Linear, GitLab und der Rest des Katalogs."
  />
</CardGrid>