Steuern Sie Boards über die API oder über einen KI-Assistenten

Boards lassen sich vollständig von außerhalb des Dashboards steuern. Zwei Wege, ein Berechtigungsmodell und das gleiche Verhalten wie auf den Bildschirmen – da sie denselben Code aufrufen.

Die REST-API

Jede Operation ist in unserer öffentlichen OpenAPI-Spezifikation enthalten, mit generierten Clients in TypeScript, Python, PHP und Go, und die CLI wird aus derselben Spezifikation generiert. Boards, Spalten, Karten, Kommentare, Fragen, Labels, Mitglieder und Freigabelinks werden alle 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 – sie verschieben
• POST /v1/agency/boards/{id}/invites – einen Freigabelink erstellen

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

Der MCP-Server

Wenn Sie einen KI-Assistenten verwenden, der MCP unterstützt, verbinden Sie ihn und er erhält direkt Board-Werkzeuge: 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 „fasse diese Woche zusammen und sende Acme einen Link“ in eine einzige Anweisung statt in zwei Systeme und ein Kopieren und Einfügen.

Zwei wissenswerte Dinge über die Werkzeuge:

• Eine neue Karte ist intern, sofern Sie nichts anderes angeben. Ein Assistent, der Ihre interne Arbeit zusammenfasst, darf diese Zusammenfassung nicht für Ihren Kunden veröffentlichen, nur weil niemand gesagt hat, dass er es nicht tun soll; daher ist visibility standardmäßig intern 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 Werkzeug teilt Ihnen mit, wie viele Personen das waren, anstatt lediglich einen einfachen Erfolg zu melden.

Was erforderlich ist

API- und MCP-Zugriff ist 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 von einem Assistenten erstellter Freigabelink ist auf dieselbe Weise begrenzt: Er kann keine Rolle gewähren, die der autorisierende Mensch nicht selbst innehat.