API나 AI 어시스턴트를 통해 보드를 제어하세요

보드는 대시보드 외부에서도 완전히 제어할 수 있습니다. 두 개의 라우트, 하나의 권한 모델, 화면과 동일한 동작 방식을 제공합니다. 이는 동일한 코드를 호출하기 때문입니다.

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 — 공유 링크 생성

공유 링크의 토큰은 마지막 호출 시에만 반환되며 오직 그때만 확인할 수 있습니다. 당사는 해당 토큰의 지문(fingerprint)만 저장하므로 이를 다시 읽어올 수 있는 엔드포인트는 존재하지 않습니다. 스크립트에서 링크가 필요한 경우 응답에서 직접 보관해야 합니다.

MCP 서버

MCP를 지원하는 AI 어시스턴트를 사용하는 경우, 이를 연결하면 보드 도구를 직접 사용할 수 있습니다. 보드 목록 조회, 보드 전체 내용 조회, 보드 생성, 카드 추가, 카드 이동, 댓글 작성, 공유 링크 생성 및 폐기가 가능합니다. 이를 통해 "이번 주 요약해서 Acme에 링크 보내줘"라는 요청을 두 개의 시스템과 복사-붙여넣기 과정 없이 하나의 명령어로 처리할 수 있습니다.

해당 도구와 관련하여 알아두어야 할 두 가지 사항:

• 새 카드는 별도로 지정하지 않는 한 내부용으로 설정됩니다. 내부 작업을 요약하는 어시스턴트가 별도의 지시가 없다고 해서 해당 요약본을 클라이언트에게 공개해서는 안 되므로, visibility의 기본값은 내부용으로 설정되며 의도적으로 client로 지정해야 합니다.
• 링크 폐기 시 확인을 거칩니다. 해당 링크를 통해 가입한 모든 사용자도 함께 제거되기 때문이며, 도구는 단순한 성공 메시지를 반환하는 대신 영향을 받는 인원이 몇 명인지 알려줍니다.

필요 조건

API 및 MCP 액세스는 Boards Business 및 모든 Agency 호스팅 플랜에 포함되어 있습니다. Boards Free 및 Boards Pro에서는 보드 엔드포인트가 이를 알리는 메시지를 반환합니다.

API 키나 MCP 연결은 이를 생성한 사용자가 속한 조직에서 해당 사용자가 수행할 수 있는 권한 범위 내에서만 동작합니다. 어시스턴트가 생성하는 공유 링크 역시 동일한 방식으로 제한되며, 인증을 수행한 사람이 실제로 보유하지 않은 권한을 부여할 수는 없습니다.