StoryVault

Die StoryVault-Integration verbindet Ihr persönliches StoryVault-Konto mit dem MCP. Sie greift nur auf Organisationen und Inhalte zu, für die Ihr StoryVault-Benutzer aktuell berechtigt ist. Der Service muss zusätzlich Ihrem MCP-Mandanten zugewiesen und für Sie freigegeben sein.

Voraussetzungen

• Sie besitzen einen aktiven StoryVault-Account mit bestätigter E-Mail-Adresse.
• In mindestens einer StoryVault-Organisation ist der API-Zugriff aktiviert und Ihre Rolle oder Berechtigung erlaubt die API-Nutzung.
• StoryVault ist im MCP für Ihren Mandanten und Ihren Benutzer freigegeben.

Persönliche Verbindung

Die OAuth-Verbindung gehört nur zu Ihrem Benutzer. Sie ist kein gemeinsam genutzter Mandantenzugang und erweitert Ihre Rechte in StoryVault nicht.

StoryVault verbinden

1. Öffnen Sie Persönlicher Zugang > Meine Verbindungen.
2. Öffnen Sie StoryVault und wählen Sie StoryVault verbinden.
3. Melden Sie sich auf der StoryVault-Seite mit Microsoft oder Ihren StoryVault-Zugangsdaten an.
4. Nach der Rückkehr zum MCP prüfen Sie, ob die Verbindung als Verbunden angezeigt wird.
5. Rufen Sie zuerst list_tenants auf. Testen Sie anschließend list_projects für eine der angezeigten Organisationen.

StoryVault verwendet den OAuth-Autorisierungscode-Flow. Es gibt keine zusätzliche frei wählbare Scope-Liste: Der wirksame Zugriff folgt Ihrer aktuellen StoryVault-Mitgliedschaft, dem aktivierten API-Modul und Ihren dortigen Rollen oder Berechtigungen.

Funktionen und Grenzen

Projekte, Sessions und Transkripte

• list_projects, list_sessions und search_sessions suchen in zugänglichen Projekten und Sessions.
• get_session liefert Details zu einer Session.
• get_transcript liest das wirksame Transkript. StoryVault-Datenschutz- und Governance-Regeln gelten auch im MCP.

Kurse, Chats und qualitative Codierung

• Kurse und Lektionen lassen sich mit list_courses, get_course und get_lesson lesen.
• list_chats und get_chat lesen zugängliche KI-Unterhaltungen.
• Codebücher, Codiersegmente, Memos und Dokumentsets lassen sich je nach StoryVault-Berechtigung lesen und bearbeiten.
• Schreibwerkzeuge wie create_code, create_coding_segment oder create_memo ändern StoryVault-Daten. Sie funktionieren nur, wenn Ihre StoryVault-Rolle die jeweilige Aktion erlaubt.

Mehrere StoryVault-Organisationen

list_tenants zeigt alle Organisationen, die Sie über die Integration verwenden dürfen. Sind mehrere verfügbar, geben Sie bei weiteren Tool-Aufrufen den zurückgegebenen tenantSlug an. Ohne eindeutige Organisation lehnt StoryVault den Aufruf ab, statt Daten verschiedener Mandanten zu vermischen.

Zugriff entziehen

Öffnen Sie Persönlicher Zugang > Meine Verbindungen und wählen Sie bei StoryVault Verbindung trennen. Damit entfernt das MCP die gespeicherte Verbindung. Wird Ihr Benutzer in StoryVault deaktiviert, aus einer Organisation entfernt oder verliert dort die API-Berechtigung, sind entsprechende Aufrufe ebenfalls nicht mehr möglich.

Fehlerbehebung

• Kein freigegebener API-Zugriff: Prüfen Sie in StoryVault Organisation, API-Modul und Ihre Rolle beziehungsweise API-Berechtigung.
• Mehrere Organisationen gefunden: Rufen Sie list_tenants auf und übergeben Sie bei der nächsten Anfrage den passenden tenantSlug.
• Projekt, Session oder Transkript fehlt: Prüfen Sie Ihre StoryVault-Mitgliedschaft, Projektfreigabe und geltende Governance-Regeln.
• Verbindung abgelaufen oder getrennt: Verbinden Sie StoryVault unter Meine Verbindungen erneut.
• Tool fehlt oder Zugriff verweigert: Prüfen Sie zusätzlich die Service- und Toolfreigabe im MCP.

Mehr zum persönlichen Zugang: Mein MCP und Dienst-Verbindungen. Weitere Statuscodes: Fehlerbehebung.