ProjectHub · MCP-server

Zeg het tegen je AI. ProjectHub doet de rest.

De ProjectHub MCP-server geeft een AI-assistent 18 tools om projecten, taken, releases, epics en stories te lezen, toe te voegen, te bewerken en te verwijderen. Je typt gewoon wat je wilt; de AI kiest de juiste tool en het bord past zich aan. Hieronder speelt een demo met voorbeelddata.

01 / 06 Lezen
AI Chat met je assistent projecthub verbonden
Dashboard › Bakkerij Vos
Webshop voorbeelddata
Wachten op de eerste opdracht

Alle tools

Wat de AI kan doen, per onderdeel. Tools die in de demo voorbijkomen, lichten op.

0 van 18 gebruikt in de demo

Ingebouwde spelregels

De server controleert elke wijziging zelf. Als iets niet mag, krijgt de AI een foutmelding terug en legt het uit, zoals in hoofdstuk 6.

Versies als x.y.zEen release zonder geldige versie zoals 1.2.0 wordt geweigerd.
Eén parent per taakEen taak hangt onder een story, een epic of een release, nooit onder twee tegelijk.
Archiveren pas als alles klaar isEen release gaat pas naar het archief als alle taken eronder op Klaar staan.
Verwijderen is definitiefEen release, epic of story verwijderen neemt alles eronder mee. De AI kiest liever Klaar, tenzij je echt wilt verwijderen.

Koppelen

Twee manieren om de server aan je AI-client te hangen. Beide gebruiken dezelfde database als de app.

Via HTTP (server, homelab)

Start de server en geef de client het token als Bearer-header. Het endpoint is /mcp, met /health als check.

# in de ProjectHub-map
MCP_API_TOKEN=… bun run mcp

# in Claude Code
claude mcp add --transport http projecthub \
  http://localhost:3100/mcp \
  --header "Authorization: Bearer $MCP_API_TOKEN"
MCP_API_TOKEN
verplicht, het gedeelde token
MCP_PORT
standaard 3100
MCP_HOST
standaard 0.0.0.0
MCP_ALLOWED_HOSTS
komma-lijst van toegelaten Host-headers, standaard alleen localhost

Via stdio (lokaal)

De client start de server zelf als subproces. Geen token nodig; de server leest DATABASE_URL uit .env.

claude mcp add projecthub -- \
  bun run /pad/naar/ProjectHub/mcp/stdio.ts

Testen zonder AI kan met bun run mcp:test, of alle tools in één keer met bun mcp/test-all-tools.ts.