Gestione paneles mediante la API o desde un asistente de IA

Los paneles se pueden controlar completamente desde fuera del panel de control. Dos rutas, un modelo de permisos y el mismo comportamiento que en las pantallas, porque llaman al mismo código.

La API REST

Cada operación se encuentra en nuestra especificación pública OpenAPI, con clientes generados en TypeScript, Python, PHP y Go, y la CLI se genera a partir de la misma especificación. Paneles, columnas, tarjetas, comentarios, preguntas, etiquetas, miembros y enlaces para compartir están cubiertos.

Los extremos que más utilizará:

• GET /v1/agency/boards: sus paneles
• GET /v1/agency/boards/{id}: un panel con sus columnas y tarjetas
• POST /v1/agency/boards/{id}/cards: añadir trabajo
• POST /v1/agency/boards/{id}/cards/{id}/move: moverlo
• POST /v1/agency/boards/{id}/invites: generar un enlace para compartir

El token del enlace para compartir se devuelve en esa última llamada y únicamente en esa llamada. Almacenamos una huella digital de este, por lo que no existe ningún extremo que pueda volver a leerlo; si su script necesita el enlace, consérvelo a partir de la respuesta.

El servidor MCP

Si utiliza un asistente de IA compatible con MCP, conéctelo y obtendrá herramientas de paneles directamente: listar paneles, leer uno al completo, crear un panel, añadir una tarjeta, mover una tarjeta, comentar, crear un enlace para compartir y revocarlo. Eso convierte «resume esta semana y envía un enlace a Acme» en una sola instrucción en lugar de dos sistemas y un copiar y pegar.

Dos cosas que conviene saber sobre las herramientas:

• Una tarjeta nueva es interna a menos que indique lo contrario. Un asistente que resuma su trabajo interno no debe publicar ese resumen para su cliente porque nadie haya indicado que no lo haga, por lo que visibility se establece de forma predeterminada como interna y debe cambiarse a client deliberadamente.
• Revocar un enlace solicita confirmación, ya que también elimina a cualquiera que se haya unido a través de dicho enlace, y la herramienta le indica cuántas personas eran, en lugar de informar simplemente de una acción realizada con éxito.

Qué se necesita

El acceso a la API y a MCP está incluido en Boards Business y en cada plan de alojamiento Agency. En Boards Free y Boards Pro, los extremos de paneles responden con un mensaje indicándolo.

Una clave de API o una conexión MCP solo pueden hacer lo que la persona que la creó puede hacer, en las organizaciones en las que pueda hacerlo. Un enlace para compartir que crea un asistente está delimitado de la misma manera: no puede otorgar un rol que la persona que lo autoriza no posea por sí misma.