Betterplan mit einem KI-Agenten verbinden (MCP)
Betterplan bietet einen MCP-Server (Model Context Protocol). Damit kann ein KI-Assistent wie Claude in deinem Namen mit Betterplan arbeiten: Projekte und Tickets lesen, Tickets anlegen und ändern, kommentieren oder Iterationen und Insights abfragen. Du bleibst dabei in der Oberfläche der KI und musst Tickets nicht von Hand übertragen.
Diese Funktion wird schrittweise freigeschaltet. Siehst du sie noch nicht, ist sie für dein Konto noch nicht aktiv. Ohne Freischaltung kann sich ein Client zwar verbinden, erhält aber keine Werkzeuge und die Aufrufe werden abgelehnt.
Wie die Verbindung funktioniert
Der MCP-Server läuft getrennt von der Betterplan-Oberfläche unter einer eigenen Adresse. Die Adresse der gehosteten Version lautet https://mcp-app.yourbetterplan.com. Betreibst du Betterplan selbst oder bist du auf einer anderen Instanz, nutze die Adresse, die dein Administrator dir nennt.
Die Anmeldung läuft über OAuth. Du gibst dem KI-Client kein Passwort, sondern erteilst ihm einmalig eine Freigabe:
- Du trägst die Adresse des MCP-Servers im KI-Client ein.
- Der Client öffnet deinen Browser. Bist du bei Betterplan nicht angemeldet, meldest du dich zuerst an.
- Betterplan zeigt die Seite Authorize access: Sie nennt den Namen der anfragenden Anwendung und die angeforderten Berechtigungen, zum Beispiel deine Identität und deine E-Mail-Adresse.
- Mit Allow erteilst du die Freigabe, mit Deny lehnst du ab. Danach kehrst du automatisch zum Client zurück.
Die Freigabeseite ist derzeit nur auf Englisch verfügbar, auch wenn Betterplan auf Deutsch eingestellt ist. Ein Bildschirmfoto fehlt hier, weil die Seite nur innerhalb eines echten Freigabevorgangs einen Inhalt zeigt.
Mit Claude verbinden
Die genauen Menüs unterscheiden sich je nach Client und Version. Halte dich im Zweifel an die Anleitung des Clients zu Remote MCP Servers bzw. Connectors. Das Prinzip ist immer gleich: Du fügst einen Remote-MCP-Server per URL hinzu und schließt die Anmeldung im Browser ab.
- Claude (Web und Desktop): Füge in den Einstellungen unter den Connectors einen eigenen Connector hinzu, trage die Adresse des MCP-Servers ein und folge der Anmeldung.
- Claude Code: Füge den Server mit dem Befehl
claude mcp addals HTTP-Server hinzu, zum Beispielclaude mcp add --transport http betterplan <MCP-URL>. Setze für<MCP-URL>die oben genannte Adresse ein. Anschließend startest du im Programm mit/mcpdie Anmeldung für den Server. - Andere Clients: Jeder Client, der Remote-MCP-Server mit OAuth unterstützt, funktioniert nach demselben Muster.
Wenn die Verbindung steht, kannst du den Agenten bitten, zuerst das Werkzeug ping aufzurufen. Es nimmt eine Nachricht (message) entgegen und antwortet mit der E-Mail-Adresse deines Kontos und deiner Nachricht. So bestätigt es Verbindung und Anmeldung.
Was ein Agent tun kann
Ein Agent arbeitet nur mit den Werkzeugen, die der Server anbietet. Das sind derzeit folgende, nach Bereich gruppiert:
| Bereich | Werkzeuge | Wirkung |
|---|---|---|
| Verbindung | ping | Prüft Verbindung und Anmeldung, nur lesend |
| Projekte | list_projects, get_project, create_project, update_project | Projekte auflisten und lesen, neue Projekte anlegen, Projekteinstellungen ändern |
| Tickets | list_tasks, get_task, create_task, update_task, list_task_references | Tickets suchen und lesen, anlegen und ändern, Erwähnungen (#Nummer) eines Tickets in anderen Tickets, Diskussionen und Aktivitäten finden |
| Kommentare | list_task_comments, create_task_comment | Kommentare lesen und schreiben |
| Diskussionen | get_discussion, create_discussion, add_discussion_comment | Diskussionen lesen, starten und beantworten |
| Abhängigkeiten | list_dependencies, create_dependency, delete_dependency | Abhängigkeiten lesen, anlegen und löschen |
| Buckets | get_bucket, create_bucket, update_bucket | Buckets lesen, anlegen und ändern |
| Releases | get_release, create_release, update_release, delete_release | Releases lesen, anlegen, ändern und löschen |
| Iterationen | list_iterations, get_iteration | Iterationen lesen, nur lesend |
| Insights | get_progress_insights, get_flow_insights | Fortschritts-Auswertung sowie Cycle Time, Lead Time und Durchsatz abfragen |
| Anhänge | list_attachments, get_attachment_download_url, get_attachment_thumbnail_url, upload_attachment, delete_attachment | Anhänge auflisten, Download-Links holen, hochladen und löschen |
| Team | list_my_teams, list_team_members | Eigene Teams und deren Mitglieder lesen |
Wie ein Client die Werkzeuge anzeigt, ist unterschiedlich. Viele fragen vor schreibenden Aufrufen nach deiner Bestätigung.
Ein Agent findet ein Ticket über list_tasks mit der Ticketnummer (#570) oder mit Filtern wie Typ, Status, Tag oder Titel. Das ist viel sparsamer, als das ganze Projekt mit allen Beschreibungen zu laden.
Sicherheit und Berechtigungen
- Der Agent hat deine Rechte. Er handelt unter deinem Konto und kann nur sehen und ändern, was du selbst sehen und ändern darfst. Hast du in einem Projekt nur Leserechte, kann er dort nichts schreiben. Mehr dazu in Teams und Rollen.
- Schreibende Werkzeuge ändern echte Daten. Dazu gehören Anlegen, Ändern und Löschen von Tickets, Releases, Abhängigkeiten und Anhängen. Ein Agent kann sich irren. Prüfe, was er vorhat, bevor du schreibende Aufrufe freigibst, und lass ihn im Zweifel zuerst nur lesen.
- Teile die Freigabe nicht. Die Freigabe gilt nur für dich. Gib Zugangsdaten eines Clients nicht an andere weiter.
- Die Anmeldung läuft ab. Das Zugriffstoken des Clients ist zeitlich begrenzt (etwa eine Stunde). Danach musst du dich gegebenenfalls neu anmelden (manche Clients erneuern den Zugang automatisch); der Client führt dich dann erneut durch die Freigabe.
Zugriff widerrufen
Entferne den Betterplan-Server im KI-Client (Connector trennen bzw. MCP-Server löschen) und erlaube dem Client nicht, sich neu anzumelden. Ohne gültiges Token kann er nichts mehr abrufen. Ein bereits ausgestelltes Token bleibt bis zu seinem Ablauf gültig. Brauchst du einen sofortigen Entzug, wende dich an den Support.
Betterplan-Skills für Agenten
Zusätzlich zum MCP-Server gibt es Betterplan-Skills: Anleitungen, die einem Agenten beibringen, wie Betterplan gedacht ist, damit er Tickets in der richtigen Form anlegt. Sie nutzen den MCP-Server, wenn er verbunden ist, und geben sonst Markdown zum Einfügen aus.
| Skill | Wofür |
|---|---|
betterplan-workflow | Ordnet Arbeit dem richtigen Baustein zu und enthält die gemeinsamen Regeln |
betterplan-create-initiative | Formuliert und legt eine Initiative an |
betterplan-create-epic | Legt ein Epic unter einer Initiative an |
betterplan-create-story | Legt eine User, Project oder Devteam Story an |
betterplan-create-workitem | Zerlegt eine Story in Workitems und erfasst Bugs |
betterplan-implement-story | Lässt einen Coding-Agenten Stories umsetzen, die mit dem Tag project:Agent in der aktuellen Iteration liegen, und hält das Iteration Board aktuell |
Die Skills und ihre Installation (Claude Code und weitere Agenten) sind unter github.com/yourbetterplan/skills beschrieben. Mehr zur Methode dahinter findest du im Abschnitt Methode.