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

ボードはダッシュボードの外から完全に操作可能です。2つのルート、1つの権限モデル、そして画面と同じ動作を提供します。これは、同じコードを呼び出しているためです。

REST API

すべての操作は公開 OpenAPI 仕様に含まれており、TypeScript、Python、PHP、Go の生成クライアントが用意されているほか、CLI も同じ仕様から生成されます。ボード、列、カード、コメント、質問、ラベル、メンバー、共有リンクのすべてが網羅されています。

主に使用するエンドポイント:

• GET /v1/agency/boards — お客様のボード一覧
• GET /v1/agency/boards/{id} — 1つのボード (列とカードを含む)
• 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つのシステム間でのコピー＆ペーストではなく、単一の指示で完結します。

ツールについて知っておくべき2つのポイント:

• 特に指定のない限り、新しいカードは内部専用となります。 内部作業を要約するアシスタントが、指示がなかったからといってその要約をクライアントに公開してしまう事態を防ぐため、visibilityのデフォルトは内部 (internal) となっており、意図的にclientに設定する必要があります。
• リンクの取り消しには確認が求められます。 そのリンク経由で参加したすべてのユーザーも削除されるためです。ツールは単に成功を報告するだけでなく、対象となった人数も通知します。

必要な要件

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

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