Gestione tableros desde la API o desde un asistente de IA

Los paneles se pueden gestionar por completo desde fuera del panel de control. Dos rutas, un modelo de permisos y el mismo comportamiento que las pantallas, ya que llaman al mismo código.

La API REST

Todas las operaciones se encuentran en nuestra especificación OpenAPI pública, con clientes generados en TypeScript, Python, PHP y Go, y la interfaz de comandos (CLI) se genera a partir de la misma especificación. Los paneles, columnas, tarjetas, comentarios, preguntas, etiquetas, miembros y enlaces para compartir están completamente cubiertos.

Los puntos de conexión que utilizará con más frecuencia:

• 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 del mismo, por lo que no hay ningún punto de conexión que pueda recuperarlo; si su script necesita el enlace, guárdelo de la respuesta.

El servidor MCP

Si utiliza un asistente de inteligencia artificial compatible con MCP, conéctelo para que obtenga directamente herramientas de paneles: listar paneles, leer uno por completo, crear un panel, añadir una tarjeta, mover una tarjeta, comentar, crear un enlace para compartir y revocarlo. Esto convierte "resume esta semana y envíale 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 dicho resumen para su cliente solo porque no se indicó lo contrario, por lo que visibility se establece por defecto en interno y debe configurarse deliberadamente como client.
• Revocar un enlace solicita confirmación, ya que también elimina a cualquier persona que se haya unido a través de dicho enlace, y la herramienta le indica cuántas personas eran, en lugar de informar de un éxito sin más.

Qué se necesita

El acceso a la API y a MCP está incluido en Boards Business y en todos los planes de alojamiento de Agency. En Boards Free y Boards Pro, los puntos de conexión de paneles responden con un mensaje que lo indica.

Una clave de API o una conexión MCP solo pueden realizar las acciones que la persona que las creó tiene permitidas, en las organizaciones en las que puede realizarlas. Un enlace para compartir que crea un asistente está limitado de la misma manera: no puede conceder un rol que el humano que lo autoriza no posea por sí mismo.