Screvi MCP-Server - Screvi Docs

Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, der KI-Assistenten den Zugriff auf externe Daten erlaubt. Screvis MCP-Server gibt deinem Assistenten Zugang zu deinen Highlights, Quellen und gespeicherten Artikeln, damit du Fragen stellen kannst, die auf dem beruhen, was du gelesen hast, statt auf dem, woran sich das Modell halb erinnert.

Screvis Server liegt unter https://api.screvi.com/mcp. Er funktioniert mit jedem MCP-Client, der Remote-Server mit OAuth unterstützt, darunter Claude (Web, Desktop und Mobil), Claude Code, Cursor und ChatGPT.

Der MCP-Zugriff erfordert ein aktives Screvi-Abo oder eine Testphase.

Was dein Assistent kann

Deine Highlights durchsuchen, nach Bedeutung statt nur nach Stichwörtern. Filtern nach Favoriten, Quellentyp, Quellenname, Autor oder Tag.
Ein Highlight oder eine Quelle aufrufen, mit Tags, Notizen und jedem Highlight aus diesem Buch.
Einen gespeicherten Artikel vollständig lesen, samt deiner Highlights und Notizen dazu, und Fragen dazu stellen.
Deine Tags durchstöbern und die Highlights unter jedem davon abrufen.
Deine gespeicherten Artikel durchsuchen, nach Titel, Autor, Domain, Lesestatus, Eingang oder Später, Favoriten, Tag oder danach, ob du sie markiert hast.
Zufällige Highlights hervorholen für eine tägliche Wiederholung.
Links speichern und Highlights festhalten (optional): eine URL in deinen Eingang legen oder eine gefundene Passage als Highlight mit Notiz und Tags speichern.
Taggen und aufräumen (optional): Tags hinzufügen oder entfernen, Artikel archivieren, favorisieren oder nach Später verschieben, einen schlechten Titel korrigieren oder einen fehlerhaft gespeicherten Artikel neu abrufen.

Nichts im MCP-Server löscht Daten. Jede Schreibaktion lässt sich aus der App rückgängig machen.

Mit Claude verbinden

Geh zu claude.ai/settings/connectors und klicke auf Benutzerdefinierten Connector hinzufügen.
Nenne ihn Screvi und setze die MCP-Server-URL auf https://api.screvi.com/mcp. Klicke auf Hinzufügen.
Claude schickt dich zur Autorisierung zu Screvi. Melde dich an und klicke auf Genehmigen. Der Zustimmungsbildschirm listet genau, was du freigibst.
Starte eine neue Unterhaltung. Claude kann jetzt deine Lektüre durchsuchen.

Du kannst den Connector auch aus jedem Chat über den +-Button öffnen, dann Connectors. Zum Trennen entfernst du ihn auf derselben Einstellungsseite.

Mit anderen Clients verbinden

Jeder Client, der Remote-MCP-Server mit OAuth unterstützt, funktioniert genauso: Füge einen Server mit der URL https://api.screvi.com/mcp hinzu und schließe die Anmeldung ab, wenn der Client die Screvi-Autorisierungsseite öffnet.

Claude Code: claude mcp add --transport http screvi https://api.screvi.com/mcp, dann /mcp ausführen, um dich anzumelden.
Cursor: Füge die URL unter Einstellungen > MCP hinzu.
ChatGPT: Füge ihn als Connector unter Einstellungen > Connectors hinzu (Entwicklermodus).

Beispiel-Prompts

"Was habe ich über Entscheidungsfindung markiert?"
"Finde meine Lieblings-Highlights aus Selbstbetrachtungen von Marc Aurel."
"Zeig mir Artikel, die ich diesen Monat gespeichert und noch nicht angefangen habe."
"Welche Tags nutze ich am meisten, und gib mir fünf Highlights aus dem größten."
"Archiviere jeden Newsletter in meinem Eingang, der älter als zwei Wochen ist."
"Dieser Artikel wurde als 'Untitled' gespeichert. Korrigiere den Titel."

Verfügbare Tools

Lese-Tools funktionieren mit jeder Verbindung.

Tool	Was es tut
`search`	Semantische und Stichwortsuche über alle Highlights. Filter: Favoriten, Quellentyp, Quelle oder Autor, Tag.
`get-highlight`	Ein Highlight mit Quelle, Tags und Notizen.
`get-source`	Eine Quelle (Buch, Podcast, Video) mit all ihren Highlights.
`get-article`	Der vollständige Text eines gespeicherten Artikels, mit deinen Tags, deiner Notiz und deinen Highlights. Lange Artikel kommen in Abschnitten.
`list-tags`	Jeder Tag mit Anzahl an Highlights und Artikeln.
`get-highlights-by-tag`	Highlights unter einem Tag, optional als Zufallsstichprobe.
`random-highlights`	Eine Zufallsauswahl an Highlights, optional beschränkt auf Favoriten, einen Typ, einen Tag oder eine Quelle.
`search-articles`	Gespeicherte Artikel nach Titel, Autor, Domain, Lesestatus, Eingang oder Später, Favoriten, Tag oder Anzahl der Highlights.

Schreib-Tools funktionieren nur, wenn die Verbindung mit Schreibzugriff genehmigt wurde. Sie ändern den Status von Artikeln, nie den Inhalt, und keines davon löscht etwas.

Tool	Was es tut
`save-article`	Eine URL in deinen Eingang speichern, optional mit Tags. Die Seite wird im Hintergrund abgerufen.
`create-highlight`	Eine Passage als Highlight speichern, auf Wunsch an eine Quelle oder einen Artikel gehängt, mit Notiz und Tags.
`add-tags`	Highlights und/oder Artikel taggen. Neue Tag-Namen werden angelegt.
`remove-tags`	Tags von Highlights und/oder Artikeln entfernen.
`update-highlight`	Eine Notiz hinzufügen oder ändern, favorisieren oder den Text eines bestehenden Highlights korrigieren.
`update-tag`	Einen Tag umbenennen oder umfärben.
`archive-articles`	Artikel archivieren oder in den Eingang zurückholen.
`set-articles-later`	Artikel nach Später verschieben oder zurück in den Eingang.
`favorite-articles`	Artikel favorisieren oder Favorit entfernen.
`update-article-details`	Titel oder Auszug eines Artikels korrigieren.
`reparse-article`	Einen Artikel von seiner URL neu abrufen, wenn die gespeicherte Kopie abgeschnitten oder voller Navigationstext ist.

Nur lesen oder lesen und schreiben?

Ob eine Verbindung etwas ändern kann, wird bei der Autorisierung entschieden. Screvis Zustimmungsseite zeigt, was der Client angefragt hat: nur Lesezugriff oder Lesen plus Artikelverwaltung. Clients, die vor der Einführung des Schreibzugriffs verbunden wurden, bleiben schreibgeschützt.

Meldet dein Assistent "Diese Verbindung ist schreibgeschützt", trenne Screvi im Client und verbinde es erneut. Genehmige die neue Anfrage, wenn sie Schreibzugriff enthält.

Datenschutz und Sicherheit

OAuth 2.0 mit PKCE. Du meldest dich auf Screvis eigener Seite an. Dein Passwort erreicht den KI-Client nie.
Abgestufter Zugriff. Lesen und Schreiben sind getrennte Freigaben. Nichts kann Highlights, Quellen oder Artikel löschen.
Abruf auf Anfrage. Screvi liefert nur, was eine Anfrage verlangt. Screvi speichert deine Unterhaltungen nicht.
MCP-Tokens sind keine App-Logins. Das Token, das ein KI-Client hält, funktioniert nur auf dem MCP-Server. Es kann sich nicht in der Screvi-App anmelden, dein Konto ändern oder API-Schlüssel erstellen.
Jederzeit widerrufbar. Öffne Einstellungen > API > Verbundene KI-Apps in Screvi, um jeden verbundenen Client zu sehen und einen zu trennen. Der Zugriff endet sofort, auch wenn der Client sein Token noch hat. Den Connector im KI-Client zu entfernen funktioniert ebenfalls.

Fehlerbehebung

Der Connector verlangt eine erneute Anmeldung. Verbindungen erneuern sich im Hintergrund und laufen erst nach 90 Tagen ohne Nutzung ab, oder wenn du die App in Screvi trennst. Melde dich noch einmal an und die Verbindung läuft weiter.

"Abo erforderlich". MCP braucht einen aktiven Plan oder eine Testphase. Prüfe deinen Plan auf der Preisseite.

Die Suche liefert nichts. Neue Highlights werden innerhalb weniger Minuten nach dem Import indexiert. Ist die Bibliothek frisch, warte kurz und versuch es erneut.

„Der Artikeltext wird noch abgerufen“. Über MCP gespeicherte Artikel werden im Hintergrund verarbeitet. Frag ein paar Sekunden später noch einmal.