PLANTA-MCP-Server

Diese Seite richtet sich an Administratoren und Customizer. Sie enthält technische Details zum MCP-Server (Model Context Protocol), die Installation und die verfügbaren MCP-Tools.

Überblick

Der PLANTA MCP-Server ermöglicht es, externe KI-Assistenten direkt mit PLANTA Project zu verbinden. Die KI kann strukturierte Aktionen direkt in PLANTA ausführen – Projekte erstellen, Vorgänge aktualisieren, Risiken erfassen usw.

Verfügbar ab Version DB 27.0.0.

Installation und Konfiguration

Docker-Setup

Den MCP-Server als Docker-Container deployen. Folgende Konfiguration zur docker-compose.yml hinzufügen:

CODE

mcp-server:
  image: registry.planta.services/project/mcp-server:latest
  environment:
    - "MCP_TRANSPORT=http"
    - "MCP_HOST=0.0.0.0"
    - "MCP_PORT=8000"
    - "PLANTA_BASE_URL=http://manager:23333"
    - "PLANTA_TIMEOUT=90"
  depends_on:
    manager:
      condition: service_healthy
  networks:
    - internal
  ports:
    - "8000:8000"

MCP-Token generieren

Für jeden Benutzer, der externe KI-Assistenten nutzen soll, muss ein MCP-Token generiert werden.

Vorgehensweise

System-Customizer → Benutzer, Rollen, Ressourcen → Benutzer aufrufen.
Mit der rechten Maustaste auf den gewünschten Benutzer-Datensatz klicken.
MCP-Token generieren auswählen.
Den generierten Token dem Benutzer zur Verfügung stellen.

Der Token ist wie ein Passwort zu behandeln. Er muss sicher übertragen und gespeichert werden.

Verfügbare MCP-Tools

Projekte

Tool-Name	Beschreibung	Parameter
`McpSearchProjects`	Gibt eine durchsuchbare Liste aller Projekte zurück. Mit `include_all` können auch alle untergeordneten Vorgänge und Anordnungsbeziehungen abgerufen werden.	`include_dates`, `include_all` (optional)
`McpGetProject`	Ruft ein einzelnes Projekt anhand der technischen oder funktionalen ID ab.	`pr_id` (erforderlich), `fields` (optional)
`McpCreateProject`	Erstellt ein oder mehrere neue Projekte. Neu erstellte Projekte sind standardmäßig gesperrt.	`projects` oder `subprojects` (erforderlich)
`McpUpdateProject`	Aktualisiert Felder eines vorhandenen Projekts.	`pr_id`, `updates` (erforderlich)

Vorgänge

Tool-Name	Beschreibung	Parameter
`McpGetProjectTasks`	Gibt alle Vorgänge eines Projekts zurück.	`pr_id` (erforderlich), `fields` (optional)
`McpGetTask`	Ruft einen einzelnen Vorgang anhand der ID ab.	`pr_id`, `task_id` (erforderlich), `fields` (optional)
`McpCreateTask`	Erstellt einen neuen Vorgang in einem Projekt.	`pr_id`, `name` (erforderlich)
`McpUpdateTask`	Aktualisiert Felder eines vorhandenen Vorgangs.	`pr_id`, `task_id`, `updates` (erforderlich)

Ressourcenzuordnungen

Tool-Name	Beschreibung	Parameter
`McpListResources`	Gibt eine Liste aller verfügbaren Ressourcen zurück.	keine erforderlich
`McpGetResourceAssignment`	Ruft eine Ressourcenzuordnung für einen bestimmten Vorgang ab.	`pr_id`, `task_id`, `resource_id` (erforderlich), `fields` (optional)
`McpCreateResourceAssignment`	Erstellt eine neue Ressourcenzuordnung für einen Vorgang.	`pr_id`, `task_id`, `resource_id` (erforderlich)
`McpUpdateResourceAssignment`	Aktualisiert eine Ressourcenzuordnung (z. B. Aufwand-Rest).	`pr_id`, `task_id`, `resource_id`, `updates` (erforderlich)

Arbeitsstundenerfassungen

Tool-Name	Beschreibung	Parameter
`McpGetWorkloads`	Gibt alle Arbeitsstundenerfassungen für einen Vorgang oder eine Ressourcenzuordnung zurück.	`pr_id`, `task_id` (erforderlich), `fields` (optional)
`McpCreateWorkload`	Erstellt einen neuen Arbeitsstundenerfassungs-Eintrag.	`pr_id`, `task_id`, `resource_id`, `workload_data` (erforderlich)

Anordnungsbeziehungen (AOBs)

Tool-Name	Beschreibung	Parameter
`McpGetAobs`	Gibt alle Anordnungsbeziehungen (AOBs) für ein Projekt oder einen Vorgang zurück.	`pr_id`, `task_id` (optional)
`McpCreateAob`	Erstellt eine neue Anordnungsbeziehung zwischen zwei Vorgängen.	`pr_id`, `source_task_id`, `target_task_id`, `dependency_type` (erforderlich)

Risiken

Tool-Name	Beschreibung	Parameter
`McpGetProjectRisks`	Gibt alle Risiken eines Projekts zurück.	`pr_id` (erforderlich), `fields` (optional)
`McpGetRisk`	Ruft ein einzelnes Risiko anhand der ID ab.	`pr_id`, `risk_id` (erforderlich), `fields` (optional)
`McpCreateRisk`	Erstellt ein neues Risiko für ein Projekt (Datentabelle DT810).	`pr_id`, `risks` (erforderlich)
`McpUpdateRisk`	Aktualisiert Felder eines vorhandenen Risikos.	`pr_id`, `risk_id`, `updates` (erforderlich)

Risikomaßnahmen

Tool-Name	Beschreibung	Parameter
`McpGetRiskMeasures`	Gibt alle Maßnahmen zu einem bestimmten Risiko zurück.	`pr_id`, `risk_id` (erforderlich), `fields` (optional)
`McpGetRiskMeasure`	Ruft eine einzelne Risikomaßnahme anhand der ID ab.	`pr_id`, `risk_id`, `measure_id` (erforderlich), `fields` (optional)
`McpCreateRiskMeasure`	Erstellt eine neue Maßnahme für ein Risiko (Datentabelle DT811).	`pr_id`, `risk_id`, `measures` (erforderlich)
`McpUpdateRiskMeasure`	Aktualisiert Felder einer vorhandenen Risikomaßnahme.	`pr_id`, `risk_id`, `measure_id`, `updates` (erforderlich)

Chancen

Tool-Name	Beschreibung	Parameter
`McpGetProjectChances`	Gibt alle Chancen eines Projekts zurück.	`pr_id` (erforderlich), `fields` (optional)
`McpGetChance`	Ruft eine einzelne Chance anhand der ID ab.	`pr_id`, `chance_id` (erforderlich), `fields` (optional)
`McpCreateChance`	Erstellt eine neue Chance für ein Projekt (Datentabelle DT812).	`pr_id`, `chances` (erforderlich)
`McpUpdateChance`	Aktualisiert Felder einer vorhandenen Chance.	`pr_id`, `chance_id`, `updates` (erforderlich)

Lessons Learned

Tool-Name	Beschreibung	Parameter
`McpGetProjectLessonsLearned`	Gibt alle Lessons Learned eines Projekts zurück.	`pr_id` (erforderlich), `fields` (optional)
`McpGetLessonsLearned`	Ruft einen einzelnen Lessons-Learned-Eintrag anhand der ID ab.	`pr_id`, `ll_id` (erforderlich), `fields` (optional)
`McpCreateLessonsLearned`	Erstellt einen neuen Lessons-Learned-Eintrag (Datentabelle DT814).	`pr_id`, `lessons_learned` (erforderlich)
`McpUpdateLessonsLearned`	Aktualisiert Felder eines vorhandenen Eintrags.	`pr_id`, `ll_id`, `updates` (erforderlich)

Weitere Tools

Tool-Name	Beschreibung	Parameter
`McpRunScheduling`	Startet die PLANTA-Terminplanung für ein oder mehrere Projekte.	`pr_ids` (optional), `calc_portfolios` (optional, bool)
`McpGetEntityFields`	Gibt die verfügbaren Felder für einen bestimmten Objekttyp zurück.	`entity_type` (erforderlich)

Berechtigungen und Sicherheit

Die KI-Aktionen verwenden die Benutzerrechte des angemeldeten Benutzers (über den MCP-Token). Die KI kann nur das ausführen, was der Benutzer selbst darf.

Alle KI-Aktionen werden über die normale PLANTA-Geschäftslogik auditierbar durchgeführt. Alle Änderungen sind im Änderungsprotokoll sichtbar.

Schreibzugriffe können auf Produktebene deaktiviert werden. Für die Konfiguration den PLANTA-Support kontaktieren.

Best Practices

Separate MCP-Token pro Benutzer: Ermöglicht korrektes Auditing und Berechtigungsmanagement.
Tokens sicher behandeln: MCP-Token verschlüsselt übertragen und nicht in Logs oder Versionskontrolle hinterlassen.
Token-Rotation: Nicht mehr benötigte MCP-Tokens invalidieren.