Was passiert, wenn ich das Limit überschreite?

Anfragen über das Rate-Limit (120 pro Minute) hinaus erhalten HTTP 429 mit klarer Fehlermeldung. Monatliche Quotas werden zum Monatswechsel zurückgesetzt.

PathHub API & MCP-Server — KI-Agenten, REST und Webhooks

Q: In welchen Tarifen ist die API enthalten?

API-Zugang ist Teil von Pro (2.000 Aufrufe pro Monat) und Max (20.000 Aufrufe). Der Free-Plan enthält keine API.

Q: Sind die Webhooks signiert?

Ja. Jedes Webhook-Delivery wird mit HMAC-SHA256 signiert. Der Header X-PathHub-Signature enthält Timestamp und Signatur, sodass du sicher prüfen kannst, dass der Request von PathHub stammt.

Was du mit der API machen kannst

PathHub-Logik ist nicht in der App eingesperrt. Die meisten In-App-Funktionen sind 1:1 als REST-Endpoint verfügbar – inklusive aller KI-Features.

KI-Projektpläne aus Beschreibungen erzeugen

POST mit Beschreibung in 1-2 Sätzen, raus kommt ein vollständiger Path: Phasen, Aufgaben, Risiken, Budget, Compliance, Stakeholder.

Aufgaben programmatisch lesen & ändern

Listen, Sub-Ressourcen, PATCH auf einzelne Aufgaben. Status-Änderungen lösen Webhooks aus – ideal für Dashboards und Automationen.

Webhooks für Echtzeit-Events

Sieben Events (task.status_changed, project.created, risk.added …), HMAC-signiert, 3-fache Retry mit Backoff.

KI-Chat & Tools per API

RAG-Chat mit deinen Projektdokumenten, RACI/SWOT/Risikomatrizen/Gantt generieren, autonome Agenten starten – alles via einfacher POST-Calls.

Pläne nach Markdown exportieren

Vollständiger Path als Markdown – perfekt um Pläne an ChatGPT/Claude zu füttern oder in Notion/Confluence zu pasten.

Compliance-Bibliothek programmatisch

DSGVO, NIS2, ISO 27001, Branchenregeln – alle DE/AT/CH-Vorschriften filterbar nach Land, Branche und Unternehmensgröße abfragen.

KI-Agenten anbinden: MCP-Server

PathHub AI hat einen eigenen MCP-Server (Model Context Protocol). Damit nutzen Claude, ChatGPT, Claude Code, Cursor, VS Code und andere KI-Agenten PathHub direkt als Werkzeug: Pläne erstellen, Aufgaben abhaken, Risiken und Kosten pflegen, Compliance prüfen und Berichte schreiben lassen.

Endpunkt: https://app.pathhub.ai/mcp (Streamable HTTP)
Protokoll: MCP 2026-07-28 (zustandslos, server/discover) und ältere Versionen bis 2024-11-05.
Anmeldung: OAuth 2.1 mit PKCE, Client-ID-Dokumenten (CIMD) oder dynamischer Client-Registrierung, schon im Free-Plan (200 Aufrufe im Monat). Clients finden alles über /.well-known/oauth-protected-resource; du meldest dich an und wählst Arbeitsbereich und Zugriff (read, write, ai). Alternativ Header Authorization: Bearer phk_live_… mit einem API-Key aus der App (ab Pro).
Gleiche Regeln wie die API: Rechte, Kontingente, Webhooks und Protokoll gelten auch hier.

Das kannst du deinem Agenten sagen

„Erstelle in PathHub einen Plan für unsere ERP-Einführung mit 180 Mitarbeitenden, Go-live in 9 Monaten.“

„Hake im Path „CRM-Einführung“ alles ab, was in diesem Statusbericht als erledigt steht, und lege die neuen Risiken an.“

„Welche Pflicht-Compliance-Punkte sind in meinen Paths noch offen, und welche haben einen zu knappen Vorlauf?“

„Buche die Rechnung über 3.600 € auf die Budgetposition „Externe Beratung“.“

Claude Code

Ohne --header meldest du dich stattdessen über /mcp im Browser an.

terminalbash

claude mcp add --transport http pathhub https://app.pathhub.ai/mcp \
  --header "Authorization: Bearer phk_live_..."

Claude (Web, Desktop, App)

Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen. Danach meldest du dich bei PathHub an, ein API-Key ist nicht nötig.

Connector-URLURL

https://app.pathhub.ai/mcp

Cursor

In ~/.cursor/mcp.json oder .cursor/mcp.json im Projekt.

mcp.jsonjson

{
  "mcpServers": {
    "pathhub": {
      "url": "https://app.pathhub.ai/mcp",
      "headers": { "Authorization": "Bearer phk_live_..." }
    }
  }
}

VS Code (Copilot)

In .vscode/mcp.json; der Key wird beim Start abgefragt und nicht gespeichert.

.vscode/mcp.jsonjson

{
  "servers": {
    "pathhub": {
      "type": "http",
      "url": "https://app.pathhub.ai/mcp",
      "headers": { "Authorization": "Bearer ${input:pathhub-key}" }
    }
  },
  "inputs": [{ "id": "pathhub-key", "type": "promptString",
               "description": "PathHub API key", "password": true }]
}

ChatGPT

Als eigener Connector (je nach Tarif im Entwicklermodus) mit OAuth. Alternativ als GPT-Aktion mit der OpenAPI-Beschreibung.

ChatGPTSchritte

Einstellungen → Apps & Connectors → Erstellen
URL: https://app.pathhub.ai/mcp
Authentifizierung: OAuth

GPT-Aktion (Alternative):
  https://app.pathhub.ai/api/v1/openapi

Lesen

Paths, Abschnitte (Phasen, Aufgaben, Budget, Risiken, Stakeholder, Compliance, Meilensteine), Export als Markdown, Dokumente durchsuchen, Compliance-Bibliothek, Vorlagen, Unternehmenskontext, Verbrauch.

Bearbeiten

Paths, Phasen, Aufgaben (auch mehrere auf einmal abhaken), Kommentare, Risiken, Stakeholder, Meilensteine, Budgetpositionen, Kostenbuchungen, Compliance-Status, nächste Schritte, Unternehmenskontext, Webhooks.

KI

Kompletten Plan erstellen (als Auftrag, ohne Zeitüberschreitung), Agenten wie Statusbericht, Wochenplan, Risiko-Scan oder Lenkungsausschuss-Bericht, Planungs-Tools wie RACI, SWOT oder Projektstrukturplan, Empfehlungen, Fragen an einen Path.

Prompt-Vorlagen

Fertige Abläufe, die Agenten anbieten: plan_initiative, weekly_status, sync_status_update (Statusbericht einspielen) und compliance_check.

Sicherheit: Agenten sehen nur den Arbeitsbereich der Verbindung bzw. des Keys und können nur, was die angemeldete Person darf. Löschende Werkzeuge sind als solche gekennzeichnet, damit der Agent vorher nachfragt. Phasen mit Aufgaben werden nur mit ausdrücklicher Bestätigung gelöscht. Verbindungen und Keys lassen sich jederzeit in der App trennen bzw. widerrufen. Überblick mit Beispielen: PathHub für KI-Agenten · alle 74 Werkzeuge.

In 3 Schritten startklar

Vom „noch nie probiert" bis zum ersten erfolgreichen Aufruf in unter fünf Minuten.

1

Key erstellen

In der App unter Tools › Entwickler / API. Wähle Scope (read, write oder ai). Key wird genau einmal angezeigt – sicher speichern.

2

Anfrage senden

Header Authorization: Bearer phk_live_…. Basis-URL: https://app.pathhub.ai/api/v1. Antworten sind immer JSON oder Markdown.

3

Webhook abonnieren (optional)

POST auf /v1/webhooks mit deiner HTTPS-URL. PathHub signiert jedes Delivery mit HMAC-SHA256 – Verify-Snippet steht in der Doku.

Beispiele

Curl-Snippets für die häufigsten Use-Cases – ohne weitere Erklärung copy-paste-fähig.

Projektplan generieren

Aus einer 1-Satz-Beschreibung wird ein vollständiger Path.

generate-plan.shcurl

curl -X POST https://app.pathhub.ai/api/v1/ai/generate-plan \
  -H "Authorization: Bearer phk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Internes Wiki einführen, ~15 MA, 6 Wochen.",
    "title": "Internes Wiki",
    "desired_timeline_weeks": 6
  }'

Aufgabe abhaken

Löst gleichzeitig einen Webhook task.status_changed aus.

patch-task.shcurl

curl -X PATCH \
  https://app.pathhub.ai/api/v1/tasks/<task_id> \
  -H "Authorization: Bearer phk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"checked": true}'

Webhook anlegen

Antwort liefert secret nur einmal – sofort speichern.

create-webhook.shcurl

curl -X POST https://app.pathhub.ai/api/v1/webhooks \
  -H "Authorization: Bearer phk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhook",
    "events": ["task.status_changed"]
  }'

Endpoint-Übersicht

32 Operationen, gruppiert nach Funktion. Vollständige Beschreibungen inkl. Request/Response-Schemas in der interaktiven Referenz.

GET/v1/projects

GET/v1/projects/{id}

GET/v1/projects/{id}/{resource}

GET/v1/projects/{id}/export

PATCH/v1/tasks/{id}

GET/v1/documents

POST/v1/documents/search

GET/v1/webhooks

POST/v1/webhooks

DELETE/v1/webhooks/{id}

POST/v1/ai/generate-plan

POST/v1/ai/projects/{id}/chat

POST/v1/ai/projects/{id}/tools/{tool}

POST/v1/ai/projects/{id}/agents/{task}

POST/v1/ai/projects/{id}/recommendations

GET/v1/ai/agents

GET/v1/compliance-rules

GET/v1/project-templates

GET/v1/usage

POST/v1/projects

PATCH/v1/projects/{id}

POST/v1/projects/{id}/{resource}

PATCH/v1/projects/{id}/{resource}/{itemId}

DELETE/v1/projects/{id}/{resource}/{itemId}

POST/v1/projects/{id}/budget/{itemId}/costs

GET/v1/tasks/{id}

DELETE/v1/tasks/{id}

POST/v1/tasks/{id}/comments

GET/v1/workspace

PATCH/v1/workspace

POST/v1/ai/plan-jobs

GET/v1/ai/plan-jobs/{id}

Live ausprobieren: jeden Endpoint mit „Try it out"-Button testen.

Interaktive Referenz öffnen

Funktioniert mit jeder iPaaS-Plattform

Die REST-API + Webhooks sind generisch genug, dass alle gängigen No-Code-Tools sie ohne dedizierte App nutzen können.

Zapier

Make

n8n

Power Automate

Eigener Code (Node, Python, Go, …)

Konkrete Use Cases — so verbinden andere Teams PathHub

Sechs typische Automatisierungen, alle in 10–15 Minuten im jeweiligen No-Code-Tool umsetzbar.

Zapier

Status-Bericht jeden Montag in Slack

Wenn: Montag 09:00 Uhr (Schedule) → PathHub: POST /v1/ai/projects/{id}/agents/status_report → Dann: Slack-Channel-Post mit Markdown-Render

Spart dem PM eine Stunde pro Woche und der Lead sieht den Status, bevor er fragt.

Make

Vertriebs-Formular → Projektplan

Wenn: neue Typeform-/HubSpot-Antwort → PathHub: POST /v1/ai/generate-plan mit Beschreibung aus dem Form-Feld → Dann: Onboarding-Path für neuen Kunden

Sales schliesst — PM hat 2 Minuten später den vollständigen Plan im richtigen Workspace.

Power Automate

Neue Risiken in Microsoft Teams alerten

Wenn: Webhook risk.added → PathHub: sendet HMAC-signiertes JSON → Dann: Adaptive Card im Teams-Channel

Kritische Risiken erscheinen sofort — nicht erst im nächsten Status-Meeting.

Trello

PathHub-Tasks zu Trello synchronisieren

Wenn: Webhook task.created → PathHub: Task-Daten im Payload → Dann: Trello-Karte im Board „Backlog“

Fürs Execution-Team, das schon in Trello arbeitet — Planung bleibt in PathHub, Doing in Trello.

n8n (self-hosted)

Wochenbericht als PDF per E-Mail

Wenn: Freitag 16:00 Uhr (Cron) → PathHub: GET /v1/projects/{id}/export?format=markdown → Dann: Markdown → PDF (Node) → E-Mail an Lenkungskreis

Keine Datei auf US-Servern — alles läuft on-prem oder in der eigenen Cloud.

Eigener Code

Phase-Completion in BI-Dashboard zählen

Wenn: Webhook phase.completed → PathHub: Event-Payload → eigener Service → Dann: Insert in BigQuery / Snowflake

Portfolio-KPIs über alle Projekte sehen — PM-Throughput, Risk-Burn-down, Phase-Cycle-Time.

FAQ

Die häufigsten Fragen zu Tarifen, Limits und Sicherheit.

In welchen Tarifen ist die API enthalten?

API-Zugang ist Teil von Pro (2.000 Aufrufe/Monat) und Max (20.000 Aufrufe/Monat). Der Free-Plan enthält keine API. Enterprise-Quotas auf Anfrage.

Wie funktioniert die KI-Quota in Kombination mit der API?

KI-Aufrufe (Plan-Generierung, Chat, Tools, Agenten) zählen sowohl gegen das API-Request-Kontingent als auch gegen die geteilte KI-Quota des Arbeitsbereichs (50/Monat im Pro, 500/Monat im Max). Pure Lese-Aufrufe (Projekte, Aufgaben, Compliance) zählen nur gegen das API-Limit.

Brauche ich eigenen Code, um PathHub anzubinden?

Nein. Die REST-API ist mit Zapier, Make, n8n und Power Automate kompatibel. Eigener Code (Node, Python, Go etc.) ist nur nötig, wenn du tieferes Verhalten brauchst – z.B. Custom-Mappings auf interne Systeme.

Sind die Webhooks signiert?

Ja. Jedes Webhook-Delivery wird mit HMAC-SHA256 signiert. Der Header X-PathHub-Signature: t=<unix_ts>,v1=<mac> enthält Timestamp und Signatur. Fertiges Verify-Snippet in Node.js findest du in der ausführlichen Doku. Replay-Schutz: Deliveries älter als 5 Minuten ablehnen.

Was passiert, wenn ich das Rate-Limit überschreite?

Anfragen über 120/Minute hinaus erhalten HTTP 429 mit Code rate_limit_exceeded. Monatliche Quotas resetten zum Monatswechsel. Aktuelle Nutzung jederzeit per GET /v1/usage abrufbar.

Sind die API-Keys an einen Arbeitsbereich gebunden?

Ja. Jeder Key gehört zu genau einem Arbeitsbereich und sieht nur dessen Daten. Wenn du mehrere Arbeitsbereiche hast (z.B. mehrere Kunden), erstellst du pro Arbeitsbereich einen eigenen Key. Keys können jederzeit widerrufen werden.

Gibt es eine offizielle OpenAPI-Spec?

Ja, unter /api/v1/openapi liegt die vollständige OpenAPI-3.0-YAML. Direkt importierbar in Postman, Insomnia, Stoplight oder als Quelle für Code-Generatoren.

PathHub über REST ansprechen