Zum Inhalt springen

Doku

Agenten verbinden

NEWWORK Projects zu Cursor, Claude Code, Codex, VS Code oder jedem MCP-Client hinzufügen, mit einer URL und einem persönlichen Token.

NEWWORK Projects ist ein MCP-Server. Ihr Agent verbindet sich mit einer URL und einem persönlichen Token und bekommt den Brief, die Checks und über 30 Werkzeuge für die Arbeit rund um den Code. Das funktioniert in jedem Plan, auch in Free, und MCP-Aufrufe werden nie gezählt oder abgerechnet.

1. Einen Token erstellen

Öffnen Sie Workspace-Einstellungen → Agents & MCP und wählen Sie Create token. Der Token:

  • handelt als Sie, mit Ihren Berechtigungen, in diesem einen Workspace;
  • wird einmal angezeigt, beginnt mit nwmcp_ und gilt 90 Tage;
  • lässt sich jederzeit auf derselben Seite widerrufen, die auch zeigt, wann er zuletzt benutzt wurde.

Geben Sie jedem Agenten oder Rechner einen eigenen Token, damit Sie einen widerrufen können, ohne die anderen zu treffen.

2. Ihrem Agenten hinzufügen

Der Endpunkt ist https://app.newworkprojects.com/api/mcp über Streamable HTTP, mit dem Token als Bearer-Token. Ersetzen Sie nwmcp_… durch Ihren Token.

In .cursor/mcp.json im Repository oder ~/.cursor/mcp.json für alle Projekte:

{
  "mcpServers": {
    "newwork-projects": {
      "url": "https://app.newworkprojects.com/api/mcp",
      "headers": {
        "Authorization": "Bearer nwmcp_…"
      }
    }
  }
}

Die Einstellungsseite zeigt dieselben Snippets mit Ihrem Token bereits eingesetzt, und für Cursor die Schaltfläche Add to Cursor.

3. Nach Arbeit fragen

Nimm mein nächstes bereites Ticket in NEWWORK Projects und setze es um.

Ein typischer Ablauf: pm-my-work findet Ihre Tickets mit ihrer Readiness, pm-item-get liest den Brief und seine Checks, pm-item-start setzt das Ticket auf In progress und schlägt einen Branch-Namen und ein Commit-Präfix vor, pm-check-tick besteht jeden Check mit dem Pull Request oder Test, der ihn belegt, und pm-item-status schiebt das Ticket mit der gebuchten Zeit in den Review.

Ist ein Brief nicht bereit, sagt pm-item-start, was fehlt, damit der Agent Sie fragen kann, statt zu raten.

Die Werkzeuge

Bereich Werkzeuge
Arbeit finden pm-my-work, pm-projects-list, pm-items-list, pm-item-get, pm-users-search
Arbeit erledigen pm-item-start, pm-item-status, pm-check-tick, pm-pr-link
Schreiben pm-item-upsert, pm-items-create-batch, pm-brief-check, pm-comment-add, pm-attachment-add, pm-item-watch, pm-item-link
Zeit pm-timer-start, pm-timer-status, pm-timer-update, pm-timer-stop, pm-time-log, pm-time-list
Auf dem Laufenden bleiben pm-activity, pm-notifications-list, pm-notifications-read
Doku pm-docs-search, pm-doc-get, pm-doc-proposal-get, pm-doc-proposal-request, pm-doc-proposal-submit, pm-doc-proposal-apply

pm-docs-search und pm-doc-get lesen die Dokumentation eines Produkts in jedem Plan. Die vier Vorschlagswerkzeuge brauchen Business: Ein Agent, der ein Ticket umgesetzt hat, kann die Doku-Änderung selbst vorschlagen, jede Änderung mit einem Zitat aus dem Diff, und ein Mensch übernimmt sie.

Agenten arbeiten unter Ihrem Namen: Tickets, die sie ändern, Kommentare, die sie schreiben, und Zeit, die sie buchen, tragen Ihren Namen. Timer und Checks, die über MCP kamen, sind mit „via AI agent“ markiert.

Regeln, denen Agenten folgen

  • Ein Nachweis für jeden bestandenen Check. Agenten müssen den Pull Request, den Commit, den Testlauf oder einen Link anhängen. Ein fehlgeschlagener Check braucht eine Notiz, was fehlgeschlagen ist.
  • Erst der Brief, dann das Bauen. pm-brief-check bewertet einen Entwurf nach denselben Regeln wie die App, sodass ein Agent, der Tickets schreibt, sie vorher bereit machen kann.
  • Nichts außerhalb Ihres Zugriffs. Der Token sieht, was Sie sehen. Nur-Team-Projekte, in denen Sie nicht sind, gibt es für ihn nicht.

Clients, die nur lokale Server starten

Manche Clients starten MCP-Server als lokale Befehle. Nutzen Sie dafür das Paket newwork-projects-mcp, das Node.js 18.17 oder neuer braucht:

{
  "mcpServers": {
    "newwork-projects": {
      "command": "npx",
      "args": ["-y", "newwork-projects-mcp"],
      "env": { "NEWWORK_PROJECTS_TOKEN": "nwmcp_…" }
    }
  }
}

NEWWORK_PROJECTS_MCP_URL richtet es auf einen anderen Endpunkt, zum Beispiel einen Test-Workspace.