> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://knowledge.buildagil.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# buildagil openCDE MCP Server

||| Bei dieser Funktion handelt es sich um eine Vorabversion. Es ist deshalb möglich, dass sie sich nicht wie erwartet verhält oder dass sich die Funktion noch ändert. Die Freischaltung dieser Funktion erfolgt vorläufig ausschliesslich für Projektadministratoren.

* [Möglichkeiten](#3-moglichkeiten)
* [Verwendung](#3-verwendung)
* [Limitierungen](#3-limitierungen)
* [Authentifizierung](#3-authentifizierung)
* [Sichtbarkeiten & Berechtigungen](#3-sichtbarkeiten-berechtigungen)
* [Umgebung](#3-umgebung)
* [Rate Limits](#3-rate-limits)
* [Nutzungsbedingungen](#3-nutzungsbedingungen)

| Allgemeine Informationen zum Einsatz von Künstlicher Intelligenz (KI) in buildagil finden Sie in folgendem Artikel: [Künstliche Intelligenz](/de/article/kunstliche-intelligenz-1ragnz2/).

||| Bitte beachten Sie die [Nutzungsbedingungen](#3-nutzungsbedingungen) bei der Verwendung des openCDE MCP Servers. Gehen Sie insbesondere verantwortungsvoll mit Inhalten aus buildagil um und stellen Sie einen ausreichenden Datenschutz sicher. buildagil hat keinen Einfluss auf die Verarbeitung von Inhalten ausserhalb von buildagil (einschliesslich externer KI-Umgebungen).

### Möglichkeiten
Der buildagil openCDE MCP Server ermöglicht die Verwendung von Inhalten in buildagil durch Künstliche Intelligenz (KI) über das Model Context Protocol (MCP). Inhalte können dadurch durch externe KI-Anwendungen in natürlicher Sprache gesucht, abgefragt und analysiert werden.

Der buildagil openCDE MCP Server bietet u.a. folgende Möglichkeiten:
* Inhalte projektübergreifend oder innerhalb eines Projekts suchen
* Persönliche Aufgaben abrufen
* Projektinformationen abrufen
* Aufgaben & Themen abrufen
* Dokumente abrufen
* Metadaten zu Dokumenten abrufen
* Sitzungen abrufen
* Meilensteine abrufen
* Benutzer abrufen
* Links aus buildagil verwenden

| Die Möglichkeiten werden laufend erweitert, wie z.B. das Abrufen von Verknüpfungen, Anhängen, Sitzungsprotokollen und Dokumentversionen sowie das Erstellen oder Ändern von Inhalten.

### Verwendung
Der buildagil openCDE MCP Server kann mit beliebigen externen KI-Umgebungen verwendet werden, welche den MCP-Standard unterstützen. Nachfolgend ist die Verbindung mit ausgewählten Umgebungen beschrieben:
* [Verbindung mit Microsoft Copilot](/de/article/1wk2ge3/)
* [Verbindung mit Claude](/de/article/wurx01/)
* [Verbindung mit ChatGPT](/de/article/1qfw3f2/)

In anderen KI-Umgebungen kann die Verbindung über die Server-URL `https://openapi.buildagil.com/mcp` hergestellt werden.

| Eine externe KI-Anwendung kann über den KI-Assistent direkt aus buildagil heraus geöffnet und verwendet werden. Weitere Informationen hierzu sind im folgenden Artikel zu finden: [KI-Assistent](/de/article/ki-assistent-168qu3s/)

### Limitierungen
Es werden nur Dokumente bis zu einer Dateigrösse von 50 MB unterstützt. Pro Dokument werden die ersten 400’000 Zeichen ausgelesen, damit die Datenmenge für die KI verarbeitbar ist. Es wird ausschliesslich Text ausgewertet, Bilder und Grafiken werden nicht berücksichtigt.

Folgende Dokumenttypen werden unterstützt:
- Dokumente: PDF, DOCX, DOCM, ODT
- Präsentationen: PPTX, ODP
- Tabellen: XLSX, XLSM, CSV
- Modelle: IFC
- E-Mails: EML, MSG
- Textdateien: TXT, JSON, XML, MD, HTML, HTM

Bei allen nicht unterstützten Dokumenttypen (z. B. ONE, DOC, XLS, PPT, DWG, ZIP) werden die Metadaten zurückgegeben.

### Authentifizierung
Die Authentifizierung basiert auf der Microsoft Identity Platform und erfolgt über den OAuth 2.0 Authorization Code Flow mit benutzerbasiertem Login. Jede Anmeldung ist entsprechend einem einzelnen Benutzer zugeordnet. Weitere Informationen zum Authorization Code Flow finden Sie in folgendem Artikel: [Microsoft identity platform and OAuth 2.0 authorization code flow](https://learn.microsoft.com/en-us/entra/identity-platform/v2-oauth2-auth-code-flow).

Für die Authentifizierung am buildagil openCDE MCP Server kontaktieren Sie bitte den Support unter Angabe eines Callback URL, um die Client ID und den Client Secret zu erhalten.

### Sichtbarkeiten & Berechtigungen
Für das Abrufen und Ändern von Inhalten über den buildagil openCDE MCP Server gelten dieselben benutzerbasierten Sichtbarkeiten und Berechtigungen wie sonst auf buildagil. Details dazu sind unter [Sichtbarkeiten & Berechtigungen](/de/article/sichtbarkeiten-berechtigungen-1fvsl6f/) zu finden.

| Der Zugriff über den buildagil openCDE MCP Server auf buildagil kann projektbasiert eingeschränkt werden. Bitte wenden Sie sich dazu an den Support. In naher Zukunft wird diese Option in den Projekteinstellungen zur Verfügung stehen.

### Umgebung
Für den buildagil openCDE MCP Server steht ausschliesslich eine Produktivumgebung zur Verfügung.

### Rate Limits
Der buildagil openCDE MCP Server verwendet ein benutzerbasiertes, dynamisches Rate Limiting. Bei einer hohen Nutzung kann es vorkommen, dass diese benutzerbasiert gedrosselt werden.

### Nutzungsbedingungen
Der MCP Server wird für die oben beschriebenen Zwecke nach dem Fair-Use-Prinzip zur Verfügung gestellt. Funktionen, Datenstrukturen, Endpunkte sowie technische oder nutzungsbezogene Einschränkungen können im Rahmen der Weiterentwicklung angepasst oder geändert werden. Geplante und durchgeführte Änderungen werden in den [Neuigkeiten & Updates](https://knowledge.buildagil.com/de/category/neuigkeiten-updates-1q0366c/) veröffentlicht.

Anwenderinnen und Anwender des MCP Servers sind für die sichere Aufbewahrung der Zugangsdaten und Tokens sowie für die sichere und ordnungsgemässe Verwendung des MCP Servers verantwortlich. Sicherheitsmechanismen, Zugriffsbeschränkungen und Rate Limits dürfen nicht umgangen werden.

Anwenderinnen und Anwender sind ferner dafür verantwortlich, verantwortungsvoll und angemessen mit den über den MCP Server erhaltenen Daten umzugehen und jederzeit alle rechtlichen sowie sicherheits- und datenschutztechnischen Anforderungen einzuhalten. buildagil hat keinen Einfluss auf die Verarbeitung von Daten ausserhalb von buildagil (einschliesslich externer KI-Umgebungen). Anwenderinnen und Anwender sind zudem für sämtliche über den MCP Server ausgelösten Aktionen verantwortlich, unabhängig davon, ob diese manuell oder automatisiert (einschliesslich durch KI) ausgelöst werden.

Im Übrigen gelten die [Allgemeinen Nutzungsbedingungen für buildagil](https://www.buildagil.com/legal/terms).