BoardMark

Tablero de incidencias para equipos: permite que tu agente de IA encuentre, cree y mueva incidencias, ejecute sprints de Scrum, comente y mantenga documentos del proyecto, con tus propios permisos (OAuth).

Ver en boardmark.aiPrueba este MCPPatrocinado

Servidor MCP alojado

npx add-mcp 'https://mcp.boardmark.ai/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

¿Cómo conecto un agente de IA a BoardMark?

Añade BoardMark como servidor MCP e inicia sesión a través de tu navegador — sin necesidad de copiar ningún token. O usa un token de acceso personal para CI y máquinas sin navegador. El agente trabaja exactamente con tus permisos — solo tus proyectos, nunca administración.

paridad de usuario — nunca administración

Envía un enlace a cualquier asistente de IA

La guía para agentes de IA es un solo archivo Markdown: qué es BoardMark, cómo usarlo paso a paso, las reglas, los precios y las preguntas frecuentes. Pega el enlace en ChatGPT, Gemini, Copilot o cualquier otro asistente y podrá ayudarte a usar BoardMark de inmediato, con o sin MCP. Si el asistente es compatible con MCP, la guía también le muestra cómo conectarse.

Guía para agentes de IA

https://www.boardmark.ai/agents.md

O pega este mensaje

Guía para agentes de IA

Read https://www.boardmark.ai/agents.md and help me use BoardMark.

Abrir la guía (agents.md)

  1. Añade BoardMark como servidor MCP

    En Claude Code, ejecuta (Streamable HTTP) — no se necesita token: Claude CodeCopiar

    claude mcp add --transport http boardmark https://mcp.boardmark.ai/mcp

  2. Inicia sesión y elige la empresa

    Claude Code abre tu navegador para iniciar sesión en BoardMark y elegir la empresa en la que trabajará el agente. (Si no se abre el navegador, ejecuta /mcp en Claude Code y selecciona este servidor para iniciar sesión). Cada inicio de sesión es para una empresa.

  3. Revísalo y revócalo en cualquier momento

    Las aplicaciones con sesión iniciada aparecen en la página de acceso de Agente y MCP de la aplicación web. Si cierras la sesión de una, pierde el acceso de inmediato. Abrir la aplicación web

  4. Crea un token en la aplicación

    En Acceso de Agente y MCP, crea un token nuevo, asígnale un nombre y elige 30, 90, 180 o 365 días. Los tokens empiezan con board_pat_ y se muestran una sola vez — guárdalo en un lugar seguro. Revócalo en cualquier momento.

  5. Mantén el token en una variable de entorno

    Nunca pongas el token en un archivo que subas a git. shellCopiar

    export BOARDMARK_TOKEN="board_pat_…"

  6. Añade el servidor MCP con el encabezado

    Para Claude Code: Claude CodeCopiar

    claude mcp add --transport http boardmark https://mcp.boardmark.ai/mcp --header "Authorization: Bearer $BOARDMARK_TOKEN"

    O añádelo al .mcp.json del proyecto (Claude Code expande ${BOARDMARK_TOKEN} desde el entorno): .mcp.jsonCopiar

    {
  "mcpServers": {
    "boardmark": {
      "type": "http",
      "url": "https://mcp.boardmark.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${BOARDMARK_TOKEN}"
      }
    }
  }
}
  • Claude Code
  • Claude Desktop
  • claude.ai
  • OpenAI Codex CLI
  • ChatGPT
  • Google Antigravity
  • Gemini CLI
  • xAI Grok
  • Goose
  • OpenCode
  • Cursor
  • VS Code (GitHub Copilot)
  • Windsurf
  • Kiro
  • Zed
  • Cline
  • Continue
  • LM Studio
  • Mistral Le Chat
  • Microsoft Copilot Studio

Los clientes que solo pueden ejecutar servidores locales (stdio) se conectan a través de mcp-remote.

Configuración de MCP para cada cliente (connect.md)

Deja que tu agente se configure solo

Pega esto en el agente — lee la guía y sigue los pasos para el cliente en el que se está ejecutando:

Indicación para tu agente

Connect yourself to BoardMark: read https://mcp.boardmark.ai/connect.md and follow the steps for the client you are running in.
  • Cada escritura envía una versión — llama siempre a get_issue antes de update_issue. Si alguien más lo cambió primero, recibirás 409 version_conflict en lugar de una sobrescritura.
  • Leen primero los documentos del proyecto — get_project indica qué documentos leer primero (docs.read_first), o get_docs_context devuelve el resumen, las notas de trabajo y los traspasos abiertos en un solo texto. Las reglas de la empresa y del proyecto tienen prioridad sobre los valores predeterminados de BoardMark (la instrucción del usuario va primero), así un equipo escribe sus reglas una vez y todos los agentes siguen las mismas.
  • Conocen los tres tipos de tablero — Scrum tiene sprints (puede haber varios a la vez), Kanban y el pipeline de entrega no tienen ninguno, y los estados de un pipeline siguen los entornos en project.md.
  • En Scrum, las personas inician los sprints — un agente solo cambia el estado de incidencias en un sprint que una persona haya iniciado (si no, 409 sprint_not_started) y no puede iniciar un sprint por sí mismo; aún puede planificar el backlog, comentar y editar otros campos.
  • Siguen las columnas del tablero — get_project da la categoría, el color, el límite de WIP y el significado de cada columna (las empresas Premium personalizan las columnas en la aplicación web); los agentes siguen el significado y tratan el límite de WIP como una advertencia. 403 plan_required significa que la función necesita el plan Premium — un administrador de la empresa lo actualiza en la aplicación web.
  • Cada escritura queda registrada — el historial de incidencias y documentos muestra qué permisos, qué cliente de IA (por ejemplo, "vía Claude Code"), OAuth o token, qué herramienta MCP y un id de solicitud; en la aplicación, las tarjetas de agente, los comentarios y las subidas llevan una insignia, y las solicitudes que BoardMark rechazó van al registro de auditoría de la empresa.
  • 600 solicitudes/minuto por token — por defecto.
  • Los agentes no ocupan asientos — usan los permisos del usuario que los conectó y no cuestan nada extra.

Proyectos y mi trabajo

HerramientaQué hace
list_projectsProyectos a los que puedes acceder, opcionalmente con una visión general (incidencias abiertas, sprints en curso y su progreso) en una sola llamada
list_my_issuesIncidencias asignadas a ti en todos los proyectos, en una sola llamada
get_projectproject.md: tipo de tablero y plantilla, estados con la categoría, el color, el límite de WIP y el significado de cada columna, definiciones de campos personalizados, filtros guardados, flujo de trabajo, entornos, tu rol y, en Scrum, sprint_control (administradores o miembros: quién puede pulsar Iniciar sprint)

Incidencias

HerramientaQué hace
search_issuesBuscar por estado, asignado, sprint, tipo, prioridad, etiqueta, texto (título, descripción o clave de incidencia, completa o parcial), padre, campos personalizados (fields), indicadores de plantilla (flag, como overdue u off_track) e incidencias vinculadas a una clave (linked_to=KEY-n); ordenar por prioridad o por un campo (paginado)
get_issueLeer una incidencia con su versión actual, valores de campo calculados (computed, como score y progress) y sus objetivos vinculados en vivo (linked: clave, título, estado o el estado de un release + progreso; readable: false cuando no tienes acceso)
create_issueCrear una incidencia (archivo one.md), con los valores de campos personalizados de la plantilla (fields)
update_issueCambiar cualquier número de campos en una sola llamada, incluidos los campos personalizados (fields clave por clave, null borra) — requiere versión
delete_issueEliminar una incidencia — requiere versión
transition_issueMover a otro estado (incluidos los estados de cada entorno en un pipeline) — en Scrum solo para incidencias en un sprint que una persona haya iniciado, si no 409 sprint_not_started
rank_issueOrdenar una incidencia (antes/después de otra)
assign_issueEstablecer el asignado
list_peopleQuién puede abrir el proyecto, con nombres y roles — nombra al reportero o asignado y encuentra ids para @mencionar (via: "company" marca a personas con acceso a toda la empresa)
list_watchersQuién sigue una incidencia, y si tú la sigues
watch_issueSeguir una incidencia para recibir correos sobre cambios de estado y nuevos comentarios
unwatch_issueDejar de seguir una incidencia
link_issuesVincular incidencias (bloquea, relaciona, duplica, clona) — acepta la clave de otro proyecto de la misma empresa y entrega a un release con id KEY/R-n (403 link_target_forbidden, 404 release_not_found)
unlink_issuesEliminar un vínculo

Comentarios y adjuntos

HerramientaQué hace
list_commentsComentarios en una incidencia, con hilos de respuestas
add_commentAñadir un comentario en Markdown o responder a uno — menciona a personas con [@Nombre](mention:usr_…) — ids de list_people (solo los miembros del proyecto reciben correos); después sigues la incidencia
update_commentEditar tu propio comentario — requiere versión
delete_commentEliminar un comentario (deja "Este comentario fue eliminado", las respuestas se mantienen) — requiere versión
request_uploadObtener una URL de subida prefirmada
attach_fileAdjuntar un archivo subido a una incidencia — muestra una imagen en línea con![nombre](path) (sin base64)
list_attachmentsLos adjuntos de una incidencia: nombre, tamaño, fecha y quien lo subió
delete_attachmentEliminar un adjunto definitivamente — solo archivos subidos por este mismo token; los enlaces en la descripción y los comentarios mostrarán "archivo eliminado"
get_download_urlURL de descarga prefirmada para un adjunto

Sprints

HerramientaQué hace
list_sprintsSprints de un proyecto (puede haber varios activos)
create_sprint*Crear un sprint
update_sprint*Renombrar un sprint o cambiar sus fechas u objetivo
move_to_sprintMover incidencias dentro o fuera de un sprint
start_sprint*Iniciar un sprint — solo personas: un token de agente recibe 403, así que pide al usuario que pulse Iniciar sprint en la aplicación
close_sprint*Cerrar un sprint y mover el trabajo no terminado
get_burndownBurndown del sprint (Scrum)

Releases

HerramientaQué hace
list_releasesReleases de un proyecto con su preparación (no listo · listo con riesgos · listo), calculada desde el tablero según reglas fijas
get_releaseUn release: el estado de cada funcionalidad con sus motivos, los números y el resultado de la compuerta — los agentes los informan tal como se devuelven, nunca adivinan
move_to_releasePoner una incidencia (o una épica con sus hijas) en un release o sacarla, con un motivo — crear, compuertar y publicar un release son acciones para personas en la aplicación

El árbol md

HerramientaQué hace
read_fileLeer un archivo .md
write_fileEscribir un archivo .md a través del mismo validador que la interfaz
list_dirListar archivos en el árbol md
get_historyHistorial de commits: quién cambió qué, y a través de qué token de agente
diffDiferencia entre dos versiones

Documentos del proyecto

HerramientaQué hace
list_docsEl resumen del proyecto, las notas de trabajo, los traspasos y el resumen de la empresa, con qué leer primero (read_first)
get_docs_contextTodo lo que hay que leer antes de empezar a trabajar, la plantilla y sus campos explicados, como un solo texto en Markdown
get_docLeer un documento (o una versión anterior) con su versión actual
create_docCrear un resumen, notas de trabajo o un traspaso para equipos o para todo el proyecto
update_docEditar un documento, o cerrar/reabrir un traspaso — requiere versión
delete_docEliminar un documento (restaurable desde su historial) — requiere versión
get_doc_historyCada versión guardada: quién la guardó, a través de qué agente y cuándo
restore_doc_versionRecuperar una versión anterior como una nueva (el historial se conserva)
acknowledge_handoffConfirmar un traspaso dirigido a ti; el autor es notificado

Ayuda del equipo de BoardMark

HerramientaQué hace
list_support_casesLos casos de soporte de tu empresa (todos los miembros los ven), actividad más reciente primero
get_support_summaryCuántos casos te esperan y cuántos están abiertos
open_support_caseAbrir un caso cuando el usuario necesita ayuda o encuentra un problema con BoardMark en sí (no con las incidencias de su proyecto) — solo texto
get_support_caseLeer un caso con todo su hilo, incluidas las respuestas del equipo de BoardMark
reply_support_caseResponder en un caso (solo texto; adjuntos en la web)
close_support_caseCerrar un caso cuando el problema está resuelto
reopen_support_caseReabrir un caso cerrado (dentro de 30 días)
follow_support_caseSeguir un caso para recibir correos cuando el equipo responda
unfollow_support_caseDejar de seguir un caso

Recursos de MCP

  • board://{project_key}/project.md
  • board://{project_key}/issues/{key}
  • board://{project_key}/docs
  • board://{project_key}/docs/{kind}/{slug}
  • project_context (indicación)

* requiere project_admin

¿Qué no puede hacer nunca un agente?

MCP no tiene herramientas de administración ni de facturación en absoluto. Estas permanecen en la aplicación web, para las personas cuyo rol lo permite:

usuariosequiposasientospermisosfacturacióncrear proyectosestablecimientos y entornos de proyectoiniciar sprintsimportar desde Jiraeliminar proyectos o la empresamover proyectos a otra empresaeliminar cuentaswebhooks de proyectoverificación en dos pasos y dispositivos con sesión iniciadafotos de perfil

¿Cómo conecto un agente de IA a BoardMark?

Añade BoardMark como servidor MCP en tu cliente de IA (Claude Code, Codex, Gemini CLI, Cursor, VS Code y más), luego inicia sesión a través de tu navegador y elige la empresa — sin necesidad de copiar ningún token. Para CI o máquinas sin navegador, crea un token de acceso personal en la aplicación y envíalo como encabezado Authorization: Bearer <token>. La configuración para cada cliente está en la página MCP (/mcp), o deja que el agente lea la guía connect.md y se configure solo.

¿Pueden los agentes de IA seguir el flujo de trabajo propio de nuestro equipo?

Sí. BoardMark tiene valores predeterminados para lo que significa cada estado (por ejemplo, En Revisión = QA está probando, Desarrollo Terminado = esperando ser desplegado para QA, Prueba Rechazada = QA lo falló) y para qué parte del flujo mueve cada rol — desarrollador, QA, BA. Si tu equipo trabaja de manera diferente, escribe las reglas de la empresa en el brief de la empresa y las reglas del proyecto en el brief del proyecto o en las notas de trabajo. Los agentes siempre leen esos documentos antes de comenzar y siguen la regla más específica: la instrucción del usuario > los documentos del proyecto > el brief de la empresa > los valores predeterminados. Tu equipo escribe sus reglas una vez, y cada agente — Claude, ChatGPT, Codex, Cursor o cualquier cliente MCP — trabaja dentro del mismo marco acordado, con mayor precisión, en lugar de que se le diga de nuevo en cada chat. Detalles: /docs/boards.

¿Puede un agente editar de forma segura un issue que otra persona está editando?

Sí. Cada escritura envía la versión del archivo que leyó. Si alguien lo cambió primero, el servidor responde 409 version_conflict en lugar de sobrescribir, por lo que los agentes siempre deben llamar a get_issue antes de update_issue.

¿Cómo veo lo que cambió un agente?

Cada cambio que un agente hace a través de MCP se registra en el historial del issue o del documento: qué derechos usó, qué cliente de IA (el nombre que aprobaste al conectarte con inicio de sesión, o el nombre que le diste a un token de acceso personal), OAuth o token, qué herramienta MCP hizo la llamada (por ejemplo, update_issue), y un id de solicitud que vincula todo lo que una llamada cambió. El historial del issue lo muestra como "vía Claude Code"; las tarjetas y adjuntos cambiados o subidos por un agente llevan una insignia, y la página Agente y MCP lista las contribuciones recientes de tus agentes. Los administradores de la empresa pueden filtrar el registro de Auditoría para ver lo que se hizo a través de un agente de IA, y las solicitudes que BoardMark rechazó (sin permiso, o una regla) aparecen como "A un agente de IA se le negó".

¿Hay un límite de velocidad?

Sí — 600 solicitudes por minuto por token de forma predeterminada.

¿Puedo evitar que un agente de IA haga el trabajo de QA?

BoardMark le advierte; no lo bloquea. Cada columna tiene un carril — el rol que trabaja en ese estado (En Revisión = QA, por ejemplo) — y un agente recibe un rol en su token o en la pantalla de aprobación cuando se conecta. Si un agente Desarrollador mueve En Revisión → Terminado, o se salta el paso de QA, el movimiento aún ocurre pero el agente recibe una advertencia para detenerse, informar al usuario y hacer la entrega con un comentario. El historial del issue muestra el rol del agente y una ⚠ en los movimientos fuera de su carril. Las personas nunca reciben advertencias ni son bloqueadas.