MCP-Server

Der MCP-Server von Contracko verbindet Ihren Vertragsarbeitsbereich mit dem KI-Assistenten, den Sie bereits nutzen. Fragen Sie Claude, ChatGPT, Gemini oder Copilot nach Ihren Verträgen, und sie lesen die echten Datensätze: Parteien, Daten, Werte und die Dokumente selbst. Geben Sie ihnen Schreibzugriff, können sie Verträge importieren, Erinnerungen einrichten und neue Vereinbarungen für Sie anlegen.

Sie behalten die Kontrolle. Lesen und Schreiben sind getrennte Berechtigungen, Sie entscheiden, welche Sie erteilen, und Sie können die Verbindung jederzeit trennen.

In zwei Schritten verbinden

1. Fügen Sie die Skills hinzu, damit der Assistent weiß, wie er bei Verträgen helfen kann. Die Skills sind vier kurze Playbooks, veröffentlicht unter contracko/contracko-skills.
2. Fügen Sie die Verbindung hinzu, damit er auf Ihren Arbeitsbereich zugreifen kann. Fügen Sie diese Adresse ein, wenn Sie danach gefragt werden:

https://app.contracko.com/mcp

Ein Browserfenster öffnet sich. Melden Sie sich bei Contracko an, oder starten Sie auf diesem Bildschirm eine kostenlose Testversion, falls Sie noch kein Konto haben.

Das Hinzufügen der Skills stellt allein noch keine Verbindung zu Ihrem Arbeitsbereich her. Wenn Contracko bereits in der Connector-Liste Ihres Assistenten erscheint, überspringen Sie Schritt 2, statt es doppelt hinzuzufügen. Nutzen Sie Claude oder Claude Code? Folgen Sie dann den Claude-Schritten unter Ihren Assistenten verbinden: Contracko ist im Connector-Verzeichnis von Claude gelistet.

Aktivieren Sie beim Anmelden Read, damit der Assistent Fragen beantworten kann. Aktivieren Sie Write nur, wenn er Verträge hinzufügen oder ändern soll. Lassen Sie Write deaktiviert, wenn Sie das nicht möchten.

Lese- oder Schreibzugriff wählen

Berechtigung	Was sie erlaubt	Wann Sie sie erteilen sollten
Read	Verträge finden, extrahierte Daten, Werte und Parteien lesen, in Dokumenten suchen, KI-Analysen und Kommentare einsehen	Immer. Das reicht aus, um Fragen zu Ihrem Arbeitsbereich zu stellen.
Write	Verträge importieren, Felder aktualisieren, Dokumente und Kommentare hinzufügen, Vertragstypen und Gegenparteien anlegen, Ordner erstellen, umbenennen und verschieben, Verträge in für Sie sichtbaren Ordnern ablegen sowie Erinnerungen einrichten und ändern	Nur wenn der Assistent Änderungen vornehmen soll. Starten Sie ohne diese Berechtigung.

Mit Read kann der Assistent Ihnen auch zeigen, wer auf einen Vertrag oder Ordner zugreifen kann. Sie können die Vertragssuche auch auf einen für Sie sichtbaren Ordner beschränken. Zugriffsrechte ändern und Ordner löschen können Sie nur in der Contracko-App. Bitten Sie den Assistenten, vorgeschlagene Änderungen zu bestätigen, bevor er sie vornimmt. Er handelt als Sie und kann daher nur Verträge und Ordner erreichen, auf die auch Sie innerhalb der Berechtigungen Ihres Arbeitsbereichs Zugriff haben. Siehe Vertragsberechtigungen für die Frage, wie der Zugriff bestimmt wird.

Das ist etwas anderes als Clara AI, die innerhalb von Contracko arbeitet. Nutzen Sie Clara in der App, und verbinden Sie sich über MCP, wenn Sie von Claude, ChatGPT oder einem anderen bereits geöffneten Assistenten aus arbeiten möchten.

Finden Sie die Verträge, die Sie brauchen

Fragen Sie nach einem Anbieter, Vertragstyp, Status, Zeitraum für Enddaten oder Zeitraum für Kündigungsdaten. Ihr Assistent kann die Vertragsliste eingrenzen, bevor er die Ergebnisse liest. Zum Beispiel: „Welche Acme-Verträge enden im nächsten Quartal oder benötigen eine Kündigung?“ Haben mehrere Anbieter denselben Namen, bestätigen Sie bitte, welchen Sie meinen.

Ihr Assistent sollte jede Seite mit passenden Verträgen prüfen, bevor er ein Ergebnis als vollständig meldet. Suchen nach Datum lassen Verträge ohne passendes Datum aus. Fragen Sie daher getrennt nach fehlenden Daten. Ein Enddatum allein bedeutet nicht, dass sich ein Vertrag automatisch verlängert. Fragen zu Beträgen, Währungen, fehlenden Feldern oder Klauseln können weitere Prüfungen erfordern.

Nutzen Sie Ihre bestehende Verbindung

OAuth ist die Standardmethode, um Contracko mit Ihrem Assistenten zu verbinden. Sie brauchen keine neue Verbindung, keinen Ersatz-API-Schlüssel und keine zusätzlichen Berechtigungen, um eine bessere Suche in bereits vorhandenen Tools zu nutzen. Zeigt Ihr Assistent noch alte Optionen, aktualisieren Sie seine Tools oder verbinden Sie den bestehenden Connector erneut.

Falls OAuth nicht verfügbar ist, können Sie einen eigenen MCP-API-Schlüssel verwenden. Senden Sie ihn bei jeder Anfrage im Header Authorization: Bearer <Ihr-MCP-API-Schlüssel>. Bewahren Sie den Schlüssel sicher auf und teilen Sie ihn nicht.

Verfügbare Aktionen hängen von Ihrer Verbindung und den Berechtigungen im Arbeitsbereich ab. Behalten Sie Read für Fragen. Erteilen Sie Write nur, wenn der Assistent Änderungen vornehmen soll. Fehlt eine Aktion, prüfen Sie den ausgewählten Arbeitsbereich und die Verbindungsberechtigungen oder wenden Sie sich an den Support.

Prüfen Sie unklare Änderungen, bevor Sie es erneut versuchen

Kann Ihr Assistent nicht bestätigen, ob eine Änderung erfolgreich war, prüfen Sie den Vertrag in Contracko, bevor Sie es erneut versuchen. Ein Fehler bedeutet nicht immer, dass nichts geändert wurde.

Agenten und Entwickler finden Tool-Argumente und Hinweise zur Verarbeitung von Antworten in den Anweisungen zur Agenteneinrichtung.

Ihren Assistenten verbinden

Wählen Sie das Produkt, das Sie nutzen. Jeder Weg endet gleich: Sie melden sich über das sich öffnende Browserfenster an.

Claude

Für Claude im Web, auf dem Desktop, auf dem Smartphone und in Cowork.

1. Öffnen Sie Contracko im Connector-Verzeichnis von Claude.
2. Wählen Sie Connect to Claude.
3. Melden Sie sich im sich öffnenden Browser bei Contracko an.

Das funktioniert mit jedem Claude-Tarif, auch mit Free. Bei Team und Enterprise muss ein Owner den Connector zuerst freischalten. Ein Connector, den Sie im Web oder auf dem Desktop hinzufügen, funktioniert auch in der mobilen Claude-App.

Ab Pro können Sie zusätzlich das Contracko-Plugin installieren (Customize → Plugins), um die vier Vertrags-Skills zu erhalten, und sich dann über dessen Tab Connectors verbinden.

Haben Sie Contracko früher als Custom Connector hinzugefügt? Entfernen Sie diesen, sonst sehen Sie jedes Tool doppelt.

ChatGPT

1. Gehen Sie zu Settings → Plugins → Import marketplace und geben Sie contracko/contracko-skills ein.
2. Aktivieren Sie den Developer mode.
3. Gehen Sie zu Settings → Apps → Create und fügen Sie https://app.contracko.com/mcp ein.
4. Melden Sie sich im sich öffnenden Browser an.

Grok

1. Öffnen Sie grok.com/connectors.
2. Fügen Sie https://app.contracko.com/mcp hinzu.
3. Melden Sie sich im sich öffnenden Browser an.

Claude Code

Sind Sie mit Ihrem Claude-Konto angemeldet? Dann ist ein in Claude hinzugefügter Connector hier bereits verfügbar, und Sie müssen nichts hinzufügen.

Für die Skills installieren Sie das Plugin. Es registriert auch die Verbindung:

/plugin marketplace add https://github.com/contracko/contracko-skills.git
/plugin install contracko@contracko

Verwenden Sie die vollständige GitHub-Adresse, nicht eine kurze owner/repo-Angabe. Geben Sie dann in der Sitzung /mcp ein und melden Sie sich an.

Nutzen Sie einen API-Schlüssel ohne das Plugin? Führen Sie Folgendes nur aus, wenn claude mcp list keinen Contracko-Eintrag zeigt:

claude mcp add --transport http contracko https://app.contracko.com/mcp

Geben Sie danach /mcp ein und melden Sie sich an.

Codex

npx skills@latest add contracko/contracko-skills
codex mcp add contracko --url https://app.contracko.com/mcp
codex mcp login contracko

Cursor

npx skills@latest add contracko/contracko-skills

Fügen Sie dann Folgendes zu .cursor/mcp.json in Ihrem Projekt hinzu und legen Sie die Datei an, falls sie noch nicht existiert:

{ "mcpServers": { "contracko": { "url": "https://app.contracko.com/mcp" } } }

Starten Sie Cursor neu, falls die Verbindung nicht übernommen wird.

GitHub Copilot in VS Code

npx skills@latest add contracko/contracko-skills

Fügen Sie dann Folgendes zu .vscode/mcp.json hinzu:

{ "servers": { "contracko": { "type": "http", "url": "https://app.contracko.com/mcp" } } }

Gemini CLI

npx skills@latest add contracko/contracko-skills

Fügen Sie dann Folgendes zu ~/.gemini/settings.json hinzu:

{ "mcpServers": { "contracko": { "httpUrl": "https://app.contracko.com/mcp" } } }

OpenClaw

npx skills@latest add contracko/contracko-skills
openclaw mcp set contracko '{"url":"https://app.contracko.com/mcp","transport":"streamable-http"}'
openclaw mcp configure contracko --auth oauth
openclaw mcp login contracko

Hermes

npx skills@latest add contracko/contracko-skills

Fügen Sie dann Folgendes zu ~/.hermes/config.yaml hinzu:

mcp_servers:
  contracko:
    url: "https://app.contracko.com/mcp"
    auth: oauth

Führen Sie hermes mcp login contracko aus und melden Sie sich an.

Jeder andere Assistent

Fügen Sie Folgendes in den Assistenten ein und lassen Sie ihn die Anweisungen ausführen:

Fetch and execute https://contracko.com/mcp/install/prompt.md

Wenn Sie die Verbindung lieber selbst hinzufügen möchten: Die Adresse ist weiterhin https://app.contracko.com/mcp.

Beispiele zum Ausprobieren

Sobald die Verbindung steht, sprechen Sie mit dem Assistenten wie mit einer Kollegin oder einem Kollegen.

Beispiel	Was es bewirkt
Wir sind beim Onboarding. Zieh alle PDFs aus diesem Ordner in Contracko.	Findet die Dateien, gleicht die Auswahl mit Ihnen ab, importiert sie und lässt Contracko Daten, Parteien und Typen extrahieren.
Ich will keine stillschweigenden Verlängerungen. Was braucht eine Kündigung, läuft aus oder verlängert sich automatisch im nächsten Quartal? Setz dafür überall Erinnerungen.	Listet die relevanten Fristen auf und legt anschließend Erinnerungen an, damit Sie rechtzeitig benachrichtigt werden.
Vergleich den Rahmenvertrag von Acme mit dem von Beta. Wer hat die bessere Haftungsobergrenze, Kündigungsregelung und Datenverarbeitungsklausel?	Stellt beide Datensätze mit zitierten Klauseln nebeneinander.
Prüf unsere Lieferantenverträge auf unbegrenzte Haftung, einseitige Freistellungen und fehlende Kündigungsfristen.	Geht das Portfolio durch und zitiert den Satz hinter jedem Fund.
Unsere Ablage ist ein Chaos. Hilf mir, eine Ordnerstruktur für MSA, NDA, SOW und DPA abzustimmen, richte sie dann ein und lege unsere Verträge darin ab.	Stimmt die Struktur mit Ihnen ab, erstellt dann die Ordner und legt Verträge ab, auf die Sie Zugriff haben. Richtet außerdem die Typen, Felder und Gegenparteien ein, die Sie nutzen.
Worauf sollten wir diesen Monat achten? Was ist dringend, und was übersehen wir?	Ordnet den Arbeitsbereich nach Dringlichkeit und Lücken.
Führ mich durch eine neue NDA, schick sie zur Unterschrift und leg das unterschriebene PDF ab, sobald es zurückkommt.	Führt den Fragebogen aus und legt anschließend die unterschriebene Fassung ab.

Sie müssen keinen Skill namentlich nennen. Es reicht, in normaler Sprache zu fragen.

Was die Skills tun

Skill	Wofür Sie ihn nutzen
contracko	Verbinden und anschließend Vertragstypen, benutzerdefinierte Felder, Gegenparteien und Ordner organisieren
contracko-import	PDFs und Word-Dateien von der Festplatte, aus Drive, SharePoint, Box oder per Link einbringen
contracko-review	Kündigungsfristen, Erinnerungen, Vergleiche, Risikosprache und was als Nächstes zu prüfen ist
contracko-create	Eine neue Vereinbarung, von den Fragen bis zur Ablage des unterschriebenen PDFs

Stattdessen mit einem Token verbinden

Nutzen Sie für die meisten Verbindungen die Browser-Anmeldung (OAuth). Kann Ihr Client oder Ihre Automatisierung sie nicht verwenden, erstellen Sie unter Contracko Settings → Integrations → API keys einen eigenen MCP-API-Schlüssel. Konfigurieren Sie Ihren Client so, dass er ihn als Authorization: Bearer-Header an https://app.contracko.com/mcp sendet. Bewahren Sie den Schlüssel in den Geheimnis-Einstellungen des Clients auf, nicht in Chats oder gemeinsam genutzten Dateien. Beide Verbindungsmethoden folgen den von Ihnen erteilten Zugriffsrechten und den Berechtigungen Ihres Arbeitsbereichs.

Verbindungen in Contracko verwalten

Nach der Freigabe erscheint der Assistent unter MCP Connections auf Settings → Integrations. Sie sehen, wer die Verbindung hergestellt hat, welchen Zugriff sie hat und wann sie zuletzt genutzt wurde.

Sie können jede aufgeführte Verbindung trennen. Nur die Person, die sie hergestellt hat, kann zusätzlichen OAuth-Zugriff genehmigen. Nur Inhaber und Admins können API keys erstellen, ändern oder widerrufen.

Eine Verbindung ansehen

1. Öffnen Sie Settings, dann Integrations.
2. Finden Sie den Assistenten unter MCP Connections.
3. Öffnen Sie das Zeilenmenü und wählen Sie Manage connection.

Der Dialog zeigt Connected by, Last used und Current access.

Einen Assistenten trennen

1. Wählen Sie Disconnect im Zeilenmenü, oder öffnen Sie Manage connection und nutzen Sie die Schaltfläche zum Trennen.
2. Bestätigen Sie Disconnect.

Dieser Assistent verliert den Zugriff auf diesen Arbeitsbereich. Andere Verbindungen bleiben bestehen. Entfernen Sie den Connector auch im Assistenten, sonst fordert er Sie erneut zur Anmeldung auf.

Zugriff ändern oder die Freigabe rotieren

OAuth-Berechtigungen können Sie in diesem Bildschirm nicht ändern. Um Read oder Write zu wechseln, stellen Sie die Verbindung im Assistenten neu her und genehmigen Sie die Berechtigungen erneut.

1. Öffnen Sie in Contracko Manage connection und wählen Sie Connection setup, wenn Sie die MCP-Adresse oder die Client-Schritte brauchen.
2. Verbinden Sie Contracko im Assistenten erneut und melden Sie sich an.
3. Aktivieren Sie auf dem Freigabebildschirm Read. Aktivieren Sie Write nur, wenn der Assistent Verträge ändern soll.
4. Trennen Sie die ungenutzte Verbindung in Contracko mit Disconnect, damit derselbe Assistent nicht zweimal erscheint.

Die Verbindung neu herzustellen ist auch der Weg, die OAuth-Freigabe zu rotieren. Es gibt keine eigene Schaltfläche zum Rotieren des Tokens.

Einen API-Schlüssel rotieren oder widerrufen

Token-Verbindungen verwalten Sie unter API keys auf derselben Seite, nicht unter MCP Connections.

1. Erstellen Sie einen neuen MCP server-Schlüssel, wenn Sie weiterhin ein Token brauchen. Kopieren Sie das Geheimnis einmal.
2. Tragen Sie das neue Geheimnis in den Authorization: Bearer-Header des Clients ein.
3. Öffnen Sie den alten Schlüssel und wählen Sie Revoke key.

Über Manage key können Sie Zugriff hinzufügen, ohne das Geheimnis zu ändern. Schlüssel laufen nach 12 Monaten ab.

Häufige Probleme beheben

„Ihre Contracko-Verbindung muss erneuert werden." Die Verbindung ist abgelaufen. Stellen Sie sie in den Connector-Einstellungen Ihres Assistenten erneut her und melden Sie sich wieder an.

Der Assistent sagt, er kann kein Tool finden. Prüfen Sie den ausgewählten Arbeitsbereich und die Berechtigungen der Verbindung. Aktualisieren Sie dann die Tools des Assistenten. Erteilen Sie Write nur, wenn der Assistent Änderungen vornehmen soll. Wenden Sie sich an den Support, falls die Aktion weiterhin fehlt.

Der Assistent kann einen Vertrag nicht sehen, den Sie sehen können. Prüfen Sie, ob Sie sich beim richtigen Arbeitsbereich angemeldet haben und ob der Vertrag mit Ihnen in Contracko geteilt ist.

Contracko erscheint doppelt. Sie haben zwei Verbindungen zum selben Server. Entfernen Sie in Claude den früher hinzugefügten Custom Connector und behalten Sie den aus dem Connector-Verzeichnis. Wenn Sie in Claude Code das Plugin installiert und zusätzlich claude mcp add ausgeführt haben, führen Sie claude mcp remove contracko aus. Entfernen Sie in anderen Assistenten den doppelten Connector. Das Hinzufügen der Skills und das Hinzufügen der Verbindung sind getrennte Schritte, und die Verbindung zweimal hinzuzufügen erzeugt zwei Einträge.

Bevor Sie echte Verträge teilen

Contracko trainiert keine Modelle mit Ihren Verträgen, und unsere Analyse läuft unter kommerziellen API-Bedingungen mit Zero Data Retention, wo verfügbar.

Einen Assistenten zu verbinden ist etwas anderes. Wenn Claude, ChatGPT oder ein anderes Produkt Contracko aufruft, wird Ihr Vertragstext an dieses Produkt gesendet, und Contracko kann dort nicht kontrollieren, was damit geschieht. Deaktivieren Sie das Modelltraining in diesem Produkt, bevor Sie es mit echten Verträgen nutzen. Siehe Sicherheit dafür, wie wir Ihre Daten auf unserer Seite handhaben.

Hilfe erhalten

Bei Fragen zu Contracko selbst lesen Sie die Dokumentation oder kontaktieren Sie uns.

Bei einer Frage zu den Skills, einem Vorschlag oder einer Verbesserung eröffnen Sie ein Issue im Skills-Repository.

Wenn Sie die maschinenlesbare Version dieser Dokumentation für einen Agenten oder Crawler wünschen, siehe Agent-Zugriff.