MCP, das Model Context Protocol, ist ein offener Standard, der KI-Anwendungen ermöglicht, sich über ein gemeinsames Protokoll mit externen Tools und Datenquellen zu verbinden. Der Revizto MCP-Server ermöglicht es Ihnen, Ihre KI-Tools sicher mit Ihren Revizto-Projektdaten zu verbinden. Sobald die Verbindung steht, können Sie Fragen stellen, Projekt-Einblicke erhalten und angeleitete Aktionen direkt über Ihren gewählten KI-Assistenten ausführen.

• Anforderungen
• Verbindungsparameter
• Revizto MCP-Server-URLs
• Einrichten der MCP-Verbindung
• Einschränkungen
• Bewährte Vorgehensweisen
• Fehlerbehebung

Siehe auch:

• Revizto-Entwicklerportal

Voraussetzungen

Bevor Sie eine Verbindung zum Revizto MCP-Server herstellen, vergewissern Sie sich, dass Folgendes vorhanden ist:

• Zugriff auf die Revizto-Region, in der Ihre Projektdaten gespeichert sind.
• Zugriff auf ein unterstütztes KI-Tool, das eine Verbindung zu Remote-MCP-Servern herstellen kann.
• Die Revizto MCP-Server-URL für Ihre Region.

Stellen Sie außerdem sicher, dass die App „Revizto MCP Server“ (Revizto MCP Server app) für Ihr Organisationskonto (organization account) aktiviert ist, bevor Sie den Server zu Ihrem KI-Tool hinzufügen (adding the server to your AI tool). So prüfen Sie, ob die App „Revizto MCP Server“ (Revizto MCP Server app) für Ihr Konto (account) aktiv ist:

• Kontoeigentümer und Administratoren: Gehen Sie zu Kontoinformationen verwalten > Entwicklerportal.
• Standardbenutzer: Gehen Sie zu Kontoinformationen > App-Integrationen.

Wenn die App „Revizto MCP Server“ (Revizto MCP Server app) nicht aktiv ist, bitten Sie Ihren Kontoeigentümer (account owner) oder Administrator, sie zu aktivieren. Kontoeigentümer und Administratoren können die App „Revizto MCP Server“ über das Entwicklerportal aktivieren, gemäß den Schritten in Revizto-Entwicklerportal.

Um die Sicherheit Ihrer Revizto-Daten zu gewährleisten, halten Sie sich stets an die internen Sicherheitsrichtlinien Ihrer Organisation.

• Stellen Sie nur in vertrauenswürdigen KI-Tools eine Verbindung zum Revizto MCP-Server her.
• Verwenden Sie die korrekte regionale Revizto MCP-Server-URL.
• Führen Sie Schreibaktionen überprüfungsbasiert aus. Fordern Sie den KI-Assistenten auf, geplante Änderungen anzuzeigen, bevor sie übernommen werden.
• Der Revizto MCP-Server verwendet Ihre Revizto-Zugriffsrechte. Administrative Aktionen erfordern Revizto-Zugriff auf Administratorebene.
• Befolgen Sie die KI-Nutzungsrichtlinien Ihrer Organisation. Vergewissern Sie sich, welche KI-Tools genehmigt sind, bevor Sie Revizto-Daten einbinden.

Verbindungsparameter

Der Revizto MCP-Server verwendet Streamable HTTP für die Verbindung. Obwohl spezifische Feldnamen je nach KI-Plattform variieren können, bleiben die wichtigsten Verbindungsanforderungen gleich. Zusätzlich richten einige cloudbasierte KI-Tools MCP-Server als benutzerdefinierte Connectors ein. Zur Vereinfachung des Authentifizierungsprozesses verwendet Revizto MCP eine OAuth-Client-ID. 

Verwenden Sie beim Einrichten Ihrer Verbindung die Parameterwerte in der Tabelle. 

Für Konfigurationsdateien verwenden Sie diese Standardstruktur für Streamable HTTP mit der URL für Ihre Region:

{
  "mcpServers": {
    "<Ihr Servername>": {
      "type": "http",
      "url": "https://api.<Serverregion>.revizto.com/mcp",
      "oauth": {
        "clientID": "revizto-mcp"
      }
    }
  }
}

Revizto MCP-Server-URLs

Wenn Sie Ihr KI-Tool mit dem Revizto MCP-Server verbinden, müssen Sie die MCP-Server-URL für die Region verwenden, in der Ihre Revizto-Daten gehostet werden.

Wenn Sie Revizto-Konten in verschiedenen Regionen hosten, können Sie demselben KI-Tool mehr als einen Revizto MCP-Server hinzufügen. Fügen Sie für jede verwendete Region die MCP-Server-URL hinzu und autorisieren Sie anschließend jede Verbindung. Anschließend können Sie den KI-Assistenten beauftragen, über die verbundenen Regionen hinweg zu arbeiten, z. B. durch Vergleichen der Anzahl von Aufgaben, Zusammenfassen von Projektrisiken oder Erstellen eines Berichts zu regionsübergreifenden Koordination.

Dadurch kann das KI-Tool Daten aus mehreren autorisierten regionalen Verbindungen in einem Vorgang kombinieren. Revizto-Daten verbleiben weiterhin in ihrer ursprünglichen Region, und der Assistent kann nur auf die Konten, Lizenzen und Projekte zugreifen, auf die Ihr Revizto-Benutzer zugreifen darf.

Einrichten der MCP-Verbindung

Der Revizto MCP-Server ist ein Remote-MCP-Server, der HTTPS verwendet. In Tools, die nach einem Transporttyp fragen, verwenden Sie Streamable HTTP oder einen Remote-MCP-Server.

Die Einrichtungsschritte variieren je nach Tool, aber der typische Ablauf ist:

1. Öffnen Sie die Einstellungen des Tools.
2. Suchen Sie in den Einstellungen nach Connectors, Apps, MCP, Tools oder Integrationen.
3. Fügen Sie einen neuen benutzerdefinierten Connector, eine benutzerdefinierte App oder einen MCP-Server hinzu.
4. Suchen Sie die URL-Einstellung und geben Sie die Revizto MCP-Server-URL für Ihre Region an.
5. Suchen Sie das Feld für die OAuth-Client-ID und geben Sie die Revizto MCP-Client-ID an.
6. Lassen Sie das OAuth-Client-Geheimnis leer.
7. Speichern Sie die Verbindung.
8. Wenn Sie zur Authentifizierung aufgefordert werden, melden Sie sich bei Ihrem Revizto-Konto an.
9. Bitten Sie den KI-Assistenten, die verfügbaren Revizto-Tools aufzulisten oder die Verbindung zu bestätigen.

Je nach KI-Tool werden Sie möglicherweise sofort nach dem Hinzufügen des MCP-Servers oder nach der ersten Eingabe, die Revizto-Daten erfordert, aufgefordert, sich bei Ihrem Revizto-Konto anzumelden. Wenn die Authentifizierung startet, öffnet Ihr KI-Tool ein Revizto-Anmeldefenster. Melden Sie sich mit der für Ihr Revizto-Konto erforderlichen Authentifizierungsmethode an, z. B. E-Mail-Adresse und Passwort oder Single Sign-On.

Nach der Autorisierung erhält das KI-Tool ausschließlich den Zugriff für den authentifizierten Revizto-Benutzer. Dies bedeutet, dass es dem Konto, der Lizenz und den Projektzugriffsrechten (project access rights) dieses Benutzers folgt und nur mit den für diesen Benutzer zulässigen Daten und Aktionen arbeitet.

Die folgenden Abschnitte enthalten zusätzliche Einrichtungsdetails für gängige KI-Tools.

{
  "servers": {
    "<Ihr Servername>": {
      "type": "http",
      "url": "https://api.<Serverregion>.revizto.com/mcp",
      "oauth": {
        "clientId": "Revizto MCP"
      }
    }
  }
}

Um zu bestätigen, dass die Einrichtung korrekt funktioniert hat, verwenden Sie die folgende Eingabeaufforderung: 

Überprüfe meine Revizto MCP-Verbindung. Nenne mir, auf welches Revizto-Konto und welche Region du zugreifen kannst, und liste anschließend die verfügbaren Revizto-Tools in einfacher Sprache auf.

Wenn der KI-Assistent angibt, dass er nicht auf Revizto zugreifen kann, prüfen Sie Folgendes:

• Der Revizto MCP-Server ist für Ihr Konto aktiv. Standard-Kontomitglieder (standard account members) können App-Integrationen (App Integrations) prüfen. Kontoeigentümer und Kontoadministratoren können das Entwicklerportal prüfen.
• Sie haben die korrekte regionale URL verwendet.
• Sie haben die Revizto-OAuth-Anmeldung abgeschlossen.
• Ihr KI-Tool unterstützt Remote-MCP-Server.
• Ihr Revizto-Benutzer hat Zugriff auf das Konto, die Lizenz und die Projekte, nach denen Sie fragen.

Einschränkungen

Obwohl der Revizto MCP-Server viele Koordination-Workflows abdeckt, gibt es einige aktuelle Einschränkungen zu beachten.

• Modell- und Objekteigenschaften sind über MCP nicht verfügbar, einschließlich Objektsuche, geänderten Elementen, Lesen von Objekteigenschaften und Aufgaben-zu-Objekt-Schlussfolgerungen. (Bald verfügbar!)
• Screenshots und Bilder sind über MCP nicht verfügbar.
• Ereignisabonnements und Webhooks sind über MCP nicht verfügbar.
• Projekt-, Lizenz- und Konto-Protokolle sind über MCP nicht verfügbar.
• Modell-Import und -Export sind über MCP nicht verfügbar.
• Große Projekte können eine sorgfältige Filterung erfordern, um langsame oder teure KI-Antworten zu vermeiden.
• Einige KI-Tools begrenzen, wie viele MCP-Tools sie gleichzeitig verwenden können. Wenn Tools fehlen (missing), deaktivieren Sie ungenutzte MCP-Server oder ungenutzte Tools in Ihrem KI-Tool.

Bewährte Vorgehensweisen

Nachdem der Revizto MCP-Server eingerichtet wurde, kann Ihr KI-Assistent Revizto-Tools verwenden, um Koordinationsdaten wie Aufgaben, Kommentare, Kollisionen, Pläne, Berichte, Workflows, Stempelvorlagen, Lizenzen, Projekte und Benutzer zu lesen. Je nach Ihren Zugriffsrechten und der finalen Release-Konfiguration kann der Assistent ggf. auch dabei helfen, ausgewählte Aktualisierungen vorzubereiten oder anzuwenden.

Der Revizto MCP ist für drei Arten von Workflows nützlich.

Große Projekte können viele Daten enthalten. Beginnen Sie mit einer fokussierten Eingabeaufforderung und stellen Sie anschließend Nachfragen. So bleiben die Antworten schneller, klarer und kostengünstiger in KI-Tools, die nach Token-Nutzung abrechnen.

Für bessere Ergebnisse befolgen Sie diese Tipps:

• Beginnen Sie mit einem Projekt, einem Gewerk, einer Zone oder einem Beauftragten.
• Fragen Sie zuerst nach Anzahlen und Zusammenfassungen, bevor Sie nach langen Listen fragen.
• Bitten Sie den Assistenten, die verwendeten Filter anzuzeigen.
• Fragen Sie zunächst nach den Top-10-Beispielen und erweitern Sie bei Bedarf.
• Fügen Sie bei Schreibaktionen „vor dem Anwenden von Änderungen auf Freigabe warten“ in Ihre Eingabeaufforderung ein.
• Vermeiden Sie bei großen Projekten Eingaben, die gleichzeitig nach allen Aufgaben, Kommentaren, Kollisionen und Plänen fragen.
• Wenn das Ergebnis überraschend aussieht, bitten Sie den Assistenten, die verwendeten Quelldatensätze anzuzeigen.

Probieren Sie zunächst einmal die folgenden Beispieleingaben aus:  

• Wie viele Zeichnungspläne gibt es in <Projektname>?
• Wie viele kritische und offene Aufgaben gibt es in <Projektname>?
• Weise die Aufgaben mit Status Offen von <Benutzer A> <Benutzer B> neu zu und vermerke im Kommentar „von <Benutzer A> neu zugewiesen“ in <Projektname>  
• Schließe gelöste Aufgaben für <Benutzer A>, die vor mehr als 30 Tagen erstellt wurden, in <Projektname>.
• Setze als Termin den nächsten Freitag für die offenen Aufgaben von <Benutzer A> in <Projektname>.
• Verschiebe die Aufgaben mit Status Offen für <Benutzer A> in den Status „In Bearbeitung“ in <Projektname> 
• Setze die Aufgaben mit dem Status Offen in Luftkanäle vs. Tragwerk für <Benutzer A> in <Projektname> auf „kritisch“.

Fehlerbehebung

F: Das KI-Tool kann keine Verbindung zum Revizto MCP-Server herstellen. 

A: Vergewissern Sie sich, dass die regionale URL korrekt ist und das KI-Tool Remote-MCP-Server unterstützt. 

F: Ich habe mehrere Revizto-Konten, die unterschiedliche SSO-Authentifizierungsmethoden verwenden, und der MCP-Server hat sich nicht mit allen verbunden. Wie authentifiziere ich diese Konten?

A: Der Revizto MCP-Server kann nur auf Konten zugreifen, die den während des letzten Autorisierungsablaufs verwendeten Authentifizierungsmethoden entsprechen. Um Konten (accounts) mit einer anderen Authentifizierungsmethode zu autorisieren, gehen Sie zu Ihrem Profil im Revizto Workspace, dann zu Aktive Sitzungen > API, und autorisieren Sie die benötigten Konten (accounts).

F: Das KI-Tool fordert mich auf, mich erneut anzumelden. 

A: Schließen Sie den Revizto-Anmeldevorgang ab. Wenn Sie mehrere Revizto-Konten (Revizto accounts) mit unterschiedlichen SSO-Authentifizierungsmethoden haben, autorisieren Sie das benötigte Konto (account) über Ihr Profil im Revizto Workspace unter Aktive Sitzungen > API.

F: Der KI-Assistent kann ein Projekt nicht sehen.

A: Stellen Sie sicher, dass die App „Revizto MCP-Server“ für Ihr Konto aktiv ist, dass Sie in der korrekten Region für das Projekt angemeldet sind und dass der authentifizierte Revizto-Benutzer Zugriff auf dieses Projekt hat. Wenn der Revizto MCP-Server aktiviert werden muss, authentifizieren Sie sich im KI-Tool erneut, um sicherzustellen, dass auf das Konto über MCP zugegriffen werden kann. 

F: Einige Tools sind nicht verfügbar.

A: Ihr KI-Tool begrenzt möglicherweise aktive Tools, oder Sie haben in Revizto nicht die entsprechenden Berechtigungen, um diese Tools zu verwenden. 

F: Eine Schreibaktion ist fehlgeschlagen. 

A: Bestätigen Sie, dass Ihre Revizto-Rolle diese Aktion im Konto, in der Lizenz oder im Projekt zulässt, in das Sie schreiben. 

F: Die Antwort ist langsam oder zu teuer. 

A: Grenzen Sie die Eingabe nach Projekt, Datum, Status, Verantwortlichem (assignee), Zone, Priorität oder Anzahl-Limit ein. Weitere Tipps finden Sie unter Bewährte Vorgehensweisen.