APIまたはAIアシスタントからボードを操作します

ボードはダッシュボードの外から完全に操作可能です。2つのルート、1つの権限モデル、そしてスクリーンと同じ動作を備えています。同じコードを呼び出すためです。

REST API

すべての操作は、当社のパブリックなOpenAPI仕様に含まれており、TypeScript、Python、PHP、Go向けの生成済みクライアントが用意されています。CLIも同じ仕様から生成されます。ボード、列、カード、コメント、質問、ラベル、メンバー、共有リンクのすべてが対象となります。

よく使用されるエンドポイント：

• GET /v1/agency/boards — お客様のボード
• GET /v1/agency/boards/{id} — カラムとカードを含む特定のボード
• POST /v1/agency/boards/{id}/cards — 作業の追加
• POST /v1/agency/boards/{id}/cards/{id}/move — 作業の移動
• POST /v1/agency/boards/{id}/invites — 共有リンクの発行

共有リンクのトークンは最後の呼び出しでのみ返され、その時以外は取得できません。システムにはそのフィンガープリントのみが保存されるため、後から読み出せるエンドポイントはありません。スクリプトでリンクが必要な場合は、レスポンスから保存しておいてください。

MCPサーバー

MCPに対応したAIアシスタントをご利用の場合、接続するだけで直接ボードツールを利用できるようになります。ボードの一覧表示、詳細の読み込み、ボードの作成、カードの追加、カードの移動、コメント、共有リンクの作成と無効化が可能です。これにより、「今週のまとめを作成してAcme社にリンクを送る」という指示を、2つのシステムとコピペを経由することなく、1つの指示で実行できるようになります。

ツールに関して知っておくべき2つのポイント：

• 新しいカードは、明示的に指定しない限り内部用になります。 社内作業をまとめるアシスタントが、指示がなかったという理由だけでそのまとめをクライアントに公開してしまわないよう、visibilityのデフォルトはinternalに設定されており、意識してclientに変更する必要があります。
• リンクの無効化には確認が求められます。 そのリンク経由で参加したメンバーも同時に削除されるためであり、単に正常終了を報告するのではなく、対象となった人数がツールから通知されます。

必要な条件

APIおよびMCPへのアクセスは、Boards BusinessおよびすべてのAgencyホスティングプランに含まれています。Boards FreeおよびBoards Proでは、ボードのエンドポイントはその旨を示すメッセージを返します。

APIキーやMCP接続で実行できる操作は、それを作成したユーザーが属する組織内でそのユーザーに許可されている権限の範囲内に制限されます。アシスタントが作成する共有リンクも同様に制限され、承認を行った人間が自分自身で保持していないロールを付与することはできません。