Technische Dokumentation MCP

Der Shine MCP-Server verbindet deinen KI-Assistenten direkt mit deinen Shine-Rechnungs- und Buchhaltungsdaten, sodass du Rechnungen nachschlagen, sehen kannst, was Kunden dir schulden, und neue Rechnungen und Angebote erstellen kannst, ohne das Gespräch zu verlassen.

Kerndaten

Der Shine MCP-Server funktioniert mit jedem MCP-kompatiblen KI-Assistenten. Claude ist der Client, gegen den wir testen und den wir empfehlen: Die Einrichtung ist am einfachsten, und unser Support-Team kann dir dabei helfen.

Für die Verbindung brauchst du zwei Dinge: die Server-URL und die Anmeldung in deinem Browser.

Bei der ersten Nutzung öffnet dein Client eine Shine-Anmeldeseite. Du meldest dich an und bestätigst die Verbindung. Dein Client ist nun verbunden und einsatzbereit. Die Verbindung läuft nach 30 Tagen ab, danach musst du dich erneut anmelden.

Aktiviere zuerst den Entwicklermodus:

Füge dann den benutzerdefinierten Connector hinzu:

Probiere nach dem Verbinden zum Beispiel:

Oder echte Fragen wie:

Die Verbindung nutzt OAuth 2.1 mit PKCE. Du meldest dich mit deinem bestehenden Shine-Konto an: Es gibt keinen API-Schlüssel und kein Passwort, das du irgendwo kopieren, einfügen oder speichern musst.

Der Assistent handelt als du, nicht als Administrator oder Dienstkonto. Er übernimmt exakt deine Shine-Berechtigungen:

Jeder mit Zugriff auf deine Shine-Organisation kann den MCP-Server selbst verbinden. Was die Person damit tun kann, wird durch die eigene Berechtigungsstufe begrenzt, genau wie überall in Shine.

In der Praxis empfehlen wir, dass sich der Unternehmensinhaber zuerst verbindet. Die meisten KI-Clients, auch Claude, unterstützen nur eine aktive MCP-Verbindung gleichzeitig, und diese muss von der Person autorisiert werden, die sie einrichtet. Wenn sich zuerst der Inhaber verbindet, vermeidest du Verwirrung, falls mehrere Teammitglieder den MCP nutzen möchten.

Du musst nicht alles auf einmal erlauben. In Claude hat der Shine-Connector zum Beispiel eine eigene Einstellungsseite, auf der du einzelne Tools ein- oder ausschalten kannst. Wenn du lieber möchtest, dass der Assistent nur deine Daten liest und nie Entwürfe erstellt, kannst du die Tools zum Erstellen dort ausschalten.

Du kannst die Verbindung jederzeit über deinen KI-Client trennen, indem du den Shine-Connector in dessen Einstellungen entfernst. Das ist derzeit die einzige Möglichkeit, den Zugriff zu widerrufen: Wir bieten noch keine Möglichkeit an, die Verbindung in den Shine-Einstellungen selbst zu trennen.

Wenn du den Zugriff widerrufst, wird der Assistent sofort getrennt. Deine Shine-Daten sind davon nicht betroffen.

Der MCP-Server steht nur Kunden mit einem unserer kostenpflichtigen Tarife zur Verfügung: Smart, Plus und Complete.

Einen KI-Assistenten mit deinen Buchhaltungsdaten zu verbinden ist wirklich nützlich, bringt aber Abwägungen mit sich. Bitte lies das sorgfältig, bevor du die Verbindung autorisierst.

1. Du verbindest einen Dienst eines Drittanbieters. Der Shine MCP-Server wird von Shine entwickelt und gehostet und dient als kontrolliertes Gateway zwischen deinem Assistenten und deinem Shine-Konto. Der Assistent selbst, Claude, ChatGPT oder ein anderer, wird von einem anderen Unternehmen betrieben. Für seine Nutzung gelten die Bedingungen und die Datenschutzerklärung dieses Unternehmens, nicht unsere.

2. Deine Daten werden mit diesem Unternehmen geteilt. Wenn du deinem Assistenten eine Frage zu deinem Shine-Konto stellst, senden wir die zur Beantwortung nötigen Daten über die Verbindung. Diese Daten, darunter Kundendaten, Rechnungsbeträge und Finanzzahlen, werden anschließend vom KI-Anbieter deiner Wahl verarbeitet.

3. Dieses Unternehmen kann deine Daten für eigene Zwecke nutzen. Sobald die Daten bei deinem KI-Anbieter angekommen sind, hat er die Kontrolle, nicht wir. Lies die Bedingungen und die Datenschutzerklärung des Anbieters, bevor du dich verbindest, und prüfe, wie er mit Aufbewahrung, Speicherort und Zugriff umgeht. In den meisten Fällen kannst du widersprechen, damit das Unternehmen deine Daten nicht für das Training verwendet.

4. Wir steuern und begrenzen, was die Verbindung tun kann. Wir entscheiden, welche Aktionen über diese Verbindung verfügbar sind, und können sie jederzeit einschränken oder widerrufen. Sensible Aktionen wie das Versenden von Dokumenten, das Freigeben von Buchungen, das Bewegen von Geld und das Einreichen von Meldungen sind bewusst nicht verfügbar. Siehe Abschnitt 7.

5. KI-Assistenten machen Fehler. Auch wenn wir die richtigen Daten liefern, kann dein Assistent sie falsch lesen, falsch zusammenfassen oder eine Antwort geben, die überzeugend klingt, aber falsch ist. Antworten werden unabhängig von deinem KI-Anbieter erzeugt und von uns nicht geprüft. Prüfe alles Wichtige direkt in Shine, bevor du danach handelst.

6. Du bist dafür verantwortlich, alles zu prüfen, was der Assistent entwirft. Entwürfe, die er erstellt, sind echte Datensätze in deinem Shine-Konto. Prüfe sie, bevor du sie freigibst oder versendest.

7. Die Sicherheit hängt zum Teil von deinem KI-Konto ab. Wenn jemand Zugriff auf dein KI-Assistenten-Konto erhält oder dein KI-Anbieter eine Datenpanne hat, könnte diese Person auf die über den Assistenten geteilten Shine-Informationen zugreifen. Nutze ein Assistenten-Konto, dem du vertraust, und prüfe dessen Sicherheitseinstellungen, bevor du dich verbindest.

8. Sei vorsichtig mit allem, was du sonst noch verbindest. Wenn du die Shine-Verbindung neben anderen MCP-Servern oder Tools nutzt, denen du nicht vertraust, kann ein schädlicher Server in derselben Sitzung möglicherweise die von uns zurückgegebenen Daten lesen. Verbinde nur Tools aus Quellen, denen du vertraust.

9. Das ist keine Finanz-, Buchhaltungs-, Steuer- oder Rechtsberatung. Informationen, die du über diese Verbindung erhältst, sind keine Beratung oder Empfehlung von Shine und ersetzen keine Prüfung durch eine qualifizierte Fachperson. Du hast deinen Assistenten selbst und unabhängig gewählt, und Entscheidungen auf Grundlage seiner Antworten triffst du selbst.

10. Du bist dafür verantwortlich, wie die Verbindung genutzt wird. Dazu gehört die Wahl des Assistenten, die Entscheidung, ob du dich überhaupt verbindest, und sicherzustellen, dass jeder, der die Verbindung im Namen deiner Organisation nutzt, berechtigt ist, die betroffenen Daten zu sehen.

Unten steht alles, was der Assistent heute kann. Hier ist das Dokument auf Deutsch. Die Toolnamen bleiben unverändert.

Diese erste Beta-Version unterstützt nichts davon. Wir arbeiten an zusätzlichen Funktionen, mit denen einiges davon möglich werden könnte, falls du weitere Automatisierung erkunden möchtest.

Der Connector lässt sich nicht hinzufügen, oder ich erhalte „couldn’t connect to server”?

Die Anmeldeseite öffnet sich, aber der Zugriff wird verweigert oder die Verbindung schlägt fehl?

Er hat sich mit dem falschen Unternehmen oder dem falschen Benutzer verbunden?

Mein Client meldet, dass bereits eine andere MCP-Verbindung aktiv ist?

Es heißt, die Authentifizierung sei abgelaufen, oder Tools schlagen plötzlich fehl?

Es funktioniert nicht mehr, nachdem meine Testphase abgelaufen ist oder ich zum kostenlosen Tarif gewechselt habe?

Ich erhalte Berechtigungsfehler, nachdem sich mein Shine-Tarif oder meine Berechtigungen geändert haben?

Neue Tools wurden veröffentlicht, aber ich sehe sie nicht?

Ich sehe einige angekündigte Tools nicht, woran liegt das?

Der Assistent nutzt Shine nicht oder verwendet einen anderen Connector?

Lesen funktioniert, aber Erstellen nicht (oder umgekehrt)?

Der Assistent sagt, er könne etwas nicht versenden, freigeben, als bezahlt markieren oder stornieren?

Das Tool hat einen Teil meiner Daten nicht zurückgegeben (Rechnungen, Angebote, Kunden, Artikel …)?

Ich erhalte leere Ergebnisse?

Die Beträge stimmen nicht mit dem überein, was ich in Shine sehe?

Ich finde den vom Assistenten erstellten Entwurf nicht?

Der Upload eines Belegs schlägt fehl?

Wende dich an den Shine-Support und gib dabei an: deinen KI-Client und dessen Version, die genaue Fehlermeldung, den ungefähren Zeitpunkt des Problems und deine Shine-Organisation. Sende keine Screenshots, die sensible Kunden- oder Finanzdaten zeigen.