Controle quadros a partir da API ou de um assistente de IA

Os quadros são totalmente gerenciáveis fora do painel. Dois caminhos, um modelo de permissão e o mesmo comportamento das telas — porque chamam o mesmo código.

A REST API

Cada operação está em nossa especificação pública OpenAPI, com clientes gerados em TypeScript, Python, PHP e Go, e a CLI é gerada a partir da mesma especificação. Quadros, colunas, cartões, comentários, perguntas, etiquetas, membros e links de compartilhamento estão todos cobertos.

Os endpoints que o senhor mais utilizará:

• GET /v1/agency/boards — seus quadros
• GET /v1/agency/boards/{id} — um quadro com suas colunas e cartões
• POST /v1/agency/boards/{id}/cards — adicionar trabalho
• POST /v1/agency/boards/{id}/cards/{id}/move — movê-lo
• POST /v1/agency/boards/{id}/invites — gerar um link de compartilhamento

O token do link de compartilhamento é retornado nessa última chamada e apenas nessa chamada. Armazenamos uma impressão digital dele, portanto não há endpoint que possa lê-lo de volta — se o seu script precisar do link, guarde-o a partir da resposta.

O servidor MCP

Se o senhor usa um assistente de IA compatível com MCP, conecte-o e ele receberá as ferramentas de quadro diretamente: listar quadros, ler um quadro na íntegra, criar um quadro, adicionar um cartão, mover um cartão, comentar, criar um link de compartilhamento e revogar um. Isso transforma "resuma esta semana e envie um link para a Acme" em uma única instrução em vez de dois sistemas e copiar e colar.

Duas coisas que vale a pena saber sobre as ferramentas:

• Um novo cartão é interno, a menos que o senhor especifique o contrário. Um assistente que resume seu trabalho interno não deve publicar esse resumo para o seu cliente só porque ninguém disse para não fazê-lo, portanto visibility tem como padrão interno e precisa ser definido deliberadamente como client.
• Revogar um link solicita confirmação, pois isso também remove qualquer pessoa que tenha entrado por meio desse link — e a ferramenta informa quantas pessoas foram afetadas, em vez de relatar um simples sucesso.

Do que ele precisa

O acesso à API e ao MCP está incluído no Boards Business e em cada plano de hospedagem Agency. No Boards Free e no Boards Pro, os endpoints de quadros respondem com uma mensagem informando isso.

Uma chave de API ou conexão MCP só pode fazer o que a pessoa que a criou pode fazer, nas organizações em que ela tiver permissão para fazê-lo. Um link de compartilhamento criado por um assistente é limitado da mesma forma: ele não pode conceder uma função que o próprio humano autorizador não possua.