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 연결은 해당 키를 생성한 사용자가 권한을 가진 조직 내에서 수행할 수 있는 작업만 실행할 수 있습니다. 어시스턴트가 생성한 공유 링크 역시 동일한 방식으로 제한되며, 권한을 부여하는 사용자 본인이 보유하지 않은 역할을 부여할 수 없습니다.