Boards über die API oder einen KI-Assistenten steuern

Boards lassen sich vollständig von außerhalb des Dashboards steuern. Zwei Routen, ein Berechtigungsmodell und das gleiche Verhalten wie die Screens — da sie denselben Code aufrufen.

Die REST-API

Jeder Vorgang ist in unserer öffentlichen OpenAPI-Spezifikation enthalten, mit generierten Clients für TypeScript, Python, PHP und Go, und die CLI wird aus derselben Spezifikation generiert. Boards, Spalten, Karten, Kommentare, Fragen, Labels, Mitglieder und Freigabelinks werden vollständig abgedeckt.

Die Endpunkte, die Sie am häufigsten verwenden werden:

• GET /v1/agency/boards — Ihre Boards
• GET /v1/agency/boards/{id} — ein Board mit seinen Spalten und Karten
• POST /v1/agency/boards/{id}/cards — Arbeit hinzufügen
• POST /v1/agency/boards/{id}/cards/{id}/move — verschieben
• POST /v1/agency/boards/{id}/invites — einen Freigabelink erstellen

Das Token des Freigabelinks wird bei diesem letzten Aufruf und nur bei diesem Aufruf zurückgegeben. Wir speichern einen Fingerabdruck davon, sodass es keinen Endpunkt gibt, der es wieder auslesen kann — wenn Ihr Skript den Link benötigt, bewahren Sie ihn aus der Antwort auf.

Der MCP-Server

Wenn Sie einen KI-Assistenten verwenden, der MCP unterstützt, verbinden Sie ihn und er erhält direkt Board-Tools: Boards auflisten, eines vollständig lesen, ein Board erstellen, eine Karte hinzufügen, eine Karte verschieben, kommentieren, einen Freigabelink erstellen und einen widerrufen. Das verwandelt „Fassen Sie diese Woche zusammen und senden Sie Acme einen Link“ in eine einzige Anweisung anstelle von zwei Systemen und einem Copy-Paste.

Zwei Dinge, die Sie über die Tools wissen sollten:

• Eine neue Karte ist intern, es sei denn, Sie sagen etwas anderes. Ein Assistent, der Ihre interne Arbeit zusammenfasst, darf diese Zusammenfassung nicht für Ihren Kunden veröffentlichen, nur weil niemand das Gegenteil gesagt hat; daher ist visibility standardmäßig auf intern eingestellt und muss bewusst auf client gesetzt werden.
• Das Widerrufen eines Links erfordert eine Bestätigung, da dadurch auch alle Personen entfernt werden, die über diesen Link beigetreten sind — und das Tool teilt Ihnen mit, wie viele Personen das waren, anstatt einen schlichten Erfolg zu melden.

Was dafür erforderlich ist

API- und MCP-Zugriff sind in Boards Business und in jedem Agency-Hosting-Tarif enthalten. Bei Boards Free und Boards Pro antworten die Board-Endpunkte mit einer entsprechenden Meldung.

Ein API-Schlüssel oder eine MCP-Verbindung kann nur das tun, was die Person tun kann, die ihn oder sie erstellt hat, und zwar in den Organisationen, in denen sie dazu berechtigt ist. Ein Freigabelink, den ein Assistent erstellt, unterliegt denselben Einschränkungen: Er kann keine Rolle vergeben, die der autorisierende Mensch nicht selbst innehat.