BoardMark

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

Como conecto um agente de IA ao BoardMark?

Adicione o BoardMark como um servidor MCP e faça login pelo seu navegador — sem necessidade de copiar token. Ou use um token de acesso pessoal para CI e máquinas sem navegador. O agente trabalha exatamente com os seus direitos — apenas seus projetos, nunca admin.

paridade de usuário — nunca admin

Envie um link para qualquer assistente de IA

O guia para agentes de IA é um arquivo Markdown: o que é o BoardMark, como usá-lo passo a passo, as regras, preços e o FAQ. Cole o link no ChatGPT, Gemini, Copilot ou qualquer outro assistente e ele poderá ajudá-lo a usar o BoardMark imediatamente, com ou sem MCP. Se o assistente suportar MCP, o guia também mostra como conectar.

Guia para agentes de IA

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

Ou cole esta mensagem

Guia para agentes de IA

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

Abrir o guia (agents.md)

1. Adicione o BoardMark como um servidor MCP

   No Claude Code, execute (Streamable HTTP) — sem necessidade de token: Claude CodeCopiar

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

2. Faça login e escolha a empresa

   O Claude Code abre seu navegador para você entrar no BoardMark e escolher a empresa na qual o agente trabalhará. (Se o navegador não abrir, execute /mcp no Claude Code e selecione este servidor para fazer login.) Cada login é para uma empresa.

3. Veja e revogue a qualquer momento

   Os aplicativos conectados estão listados na página de acesso Agente e MCP do aplicativo web. Encerre a sessão de um e ele perderá o acesso imediatamente. Abrir o aplicativo web

4. Crie um token no aplicativo

   Em Agente e acesso MCP, crie um novo token, dê um nome e escolha 30, 90, 180 ou 365 dias. Os tokens começam com board_pat_ e são exibidos apenas uma vez — guarde-o em um local seguro. Revogue-o a qualquer momento.

5. Mantenha o token em uma variável de ambiente

   Nunca coloque o token em um arquivo que você envie para o git. shellCopiar

   export BOARDMARK_TOKEN="board_pat_…"
   

6. Adicione o servidor MCP com o cabeçalho

   Para Claude Code: Claude CodeCopiar

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

   Ou adicione-o ao .mcp.json do projeto (o Claude Code expande ${BOARDMARK_TOKEN} a partir do ambiente): .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

Clientes que só podem executar servidores locais (stdio) se conectam por meio do mcp-remote.

Configuração MCP para cada cliente (connect.md)

Deixe seu agente se configurar

Cole isto no agente — ele lê o guia e segue os passos para o cliente em que está sendo executado:

Prompt para seu agente

Connect yourself to BoardMark: read https://mcp.boardmark.ai/connect.md and follow the steps for the client you are running in.

• Cada gravação envia uma versão — sempre chame get_issue antes de update_issue. Se alguém alterou antes, você recebe 409 version_conflict em vez de uma sobrescrita.
• Eles leem os documentos do projeto primeiro — get_project informa quais documentos ler primeiro (docs.read_first), ou get_docs_context retorna o briefing, as notas de trabalho e os handoffs abertos em um único texto. As regras da empresa e do projeto ali têm precedência sobre os padrões do BoardMark (a instrução do usuário vem primeiro), então uma equipe escreve suas regras uma vez e todos os agentes seguem as mesmas.
• Eles conhecem os três tipos de quadro — Scrum tem sprints (vários podem estar ativos ao mesmo tempo), Kanban e pipeline de entrega não têm, e os status de um pipeline seguem os ambientes no project.md.
• No Scrum, as pessoas iniciam sprints — um agente altera o status apenas de issues em um sprint que uma pessoa iniciou (caso contrário, 409 sprint_not_started) e não pode iniciar um sprint por conta própria; ele ainda pode planejar o backlog, comentar e editar outros campos.
• Eles seguem as colunas do quadro — get_project fornece a categoria, cor, limite de WIP e significado de cada coluna (empresas Premium personalizam colunas no aplicativo web); os agentes seguem o significado e tratam o limite de WIP como um aviso. 403 plan_required significa que o recurso exige o plano Premium — um administrador da empresa faz o upgrade no aplicativo web.
• Cada gravação é registrada — o histórico de issues e documentos mostra quais direitos, qual cliente de IA (por exemplo, "via Claude Code"), OAuth ou token, qual ferramenta MCP e um id de solicitação; no aplicativo, cartões de agente, comentários e uploads recebem selos, e solicitações que o BoardMark recusou vão para o log de auditoria da empresa.
• 600 solicitações/minuto por token — por padrão.
• Agentes não são assentos — eles usam os direitos do usuário que os conectou e não custam nada extra.

Projetos e meu trabalho

Ferramenta	O que faz
list_projects	Projetos aos quais você tem acesso, opcionalmente com uma visão geral (issues abertas, sprints em andamento e seu progresso) em uma única chamada
list_my_issues	Issues atribuídas a você em todos os projetos, em uma única chamada
get_project	project.md: tipo de quadro e modelo, status com a categoria, cor, limite de WIP e significado de cada coluna, definições de campos personalizados, filtros salvos, fluxo de trabalho, ambientes, seu papel e, no Scrum, sprint_control (administradores ou membros: quem pode pressionar Iniciar sprint)

Issues

Ferramenta	O que faz
search_issues	Pesquisar por status, responsável, sprint, tipo, prioridade, etiqueta, texto (título, descrição ou chave da issue, inteira ou parcial), pai, campos personalizados (fields), sinalizadores de modelo (flag, como overdue ou off_track) e issues vinculadas a uma chave (linked_to=KEY-n); ordenar por prioridade ou um campo (paginado)
get_issue	Ler uma issue com sua versão atual, valores de campos calculados (computed, como score e progress) e seus alvos vinculados em tempo real (linked: chave, título, status ou estado de um release + progresso; readable: false quando você não tem acesso)
create_issue	Criar uma issue (arquivo one.md), com os valores de campos personalizados do modelo (fields)
update_issue	Alterar qualquer número de campos em uma única chamada, incluindo campos personalizados (fields chave por chave, null limpa) — requer version
delete_issue	Excluir uma issue — requer version
transition_issue	Mover para outro status (incluindo os status de cada ambiente em um pipeline) — no Scrum, apenas para issues em um sprint que uma pessoa iniciou, caso contrário 409 sprint_not_started
rank_issue	Ordenar uma issue (antes/depois de outra)
assign_issue	Definir o responsável
list_people	Quem pode abrir o projeto, com nomes e papéis — nomeie o relator ou responsável e encontre ids para @mencionar (via: "company" marca pessoas com acesso em toda a empresa)
list_watchers	Quem observa uma issue e se você observa
watch_issue	Observar uma issue para receber e-mails sobre mudanças de status e novos comentários
unwatch_issue	Parar de observar uma issue
link_issues	Vincular issues (bloqueia, relaciona, duplica, clona) — aceita a chave de outro projeto na mesma empresa e entrega a um release com id KEY/R-n (403 link_target_forbidden, 404 release_not_found)
unlink_issues	Remover um vínculo

Comentários e anexos

Ferramenta	O que faz
list_comments	Comentários em uma issue, com threads de respostas
add_comment	Adicionar um comentário em Markdown ou responder a um — mencione pessoas com [@Nome](mention:usr_…) — ids de list_people (apenas membros do projeto recebem e-mail); você então observa a issue
update_comment	Editar seu próprio comentário — requer version
delete_comment	Excluir um comentário (deixa "Este comentário foi excluído", as respostas permanecem) — requer version
request_upload	Obter uma URL de upload pré-assinada
attach_file	Anexar um arquivo enviado a uma issue — exiba uma imagem inline com (sem base64)
list_attachments	Anexos de uma issue: nome, tamanho, data e quem enviou
delete_attachment	Excluir um anexo permanentemente — apenas arquivos enviados por este mesmo token; links na descrição e comentários mostram então "arquivo excluído"
get_download_url	URL de download pré-assinada para um anexo

Sprints

Ferramenta	O que faz
list_sprints	Sprints de um projeto (vários podem estar ativos)
create_sprint*	Criar um sprint
update_sprint*	Renomear um sprint ou alterar suas datas ou objetivo
move_to_sprint	Mover issues para dentro ou para fora de um sprint
start_sprint*	Iniciar um sprint — apenas pessoas: um token de agente recebe 403, então peça ao usuário para pressionar Iniciar sprint no aplicativo
close_sprint*	Fechar um sprint e mover trabalho não concluído
get_burndown	Burndown do sprint (Scrum)

Releases

Ferramenta	O que faz
list_releases	Releases de um projeto com sua prontidão (não pronto · pronto com riscos · pronto), calculada a partir do quadro por regras fixas
get_release	Um release: o status de cada recurso com seus motivos, os números e o resultado do portão — agentes os relatam como retornados, nunca adivinham
move_to_release	Colocar uma issue (ou uma épica com seus filhos) em um release ou removê-la, com um motivo — criar, aprovar e enviar um release são ações para pessoas no aplicativo

A árvore md

Ferramenta	O que faz
read_file	Ler um arquivo .md
write_file	Gravar um arquivo .md pelo mesmo validador da interface
list_dir	Listar arquivos na árvore md
get_history	Histórico de commits: quem alterou o quê e por meio de qual token de agente
diff	Diff entre duas versões

Documentos do projeto

Ferramenta	O que faz
list_docs	O briefing do projeto, notas de trabalho, handoffs e o briefing da empresa, com o que ler primeiro (read_first)
get_docs_context	Tudo para ler antes de começar o trabalho, o modelo e seus campos explicados, como um único texto em Markdown
get_doc	Ler um documento (ou uma versão mais antiga) com sua versão atual
create_doc	Criar um briefing, notas de trabalho ou um handoff para equipes ou para todo o projeto
update_doc	Editar um documento, ou fechar/reabrir um handoff — requer version
delete_doc	Excluir um documento (restaurável pelo histórico) — requer version
get_doc_history	Cada versão salva: quem salvou, por meio de qual agente e quando
restore_doc_version	Trazer de volta uma versão mais antiga como uma nova (o histórico é mantido)
acknowledge_handoff	Reconhecer um handoff endereçado a você; o autor é notificado

Ajuda da equipe do BoardMark

Ferramenta	O que faz
list_support_cases	Os casos de suporte da sua empresa (todos os membros veem), atividade mais recente primeiro
get_support_summary	Quantos casos aguardam você e quantos estão abertos
open_support_case	Abrir um caso quando o usuário precisar de ajuda ou encontrar um problema com o próprio BoardMark (não com as issues do projeto) — apenas texto
get_support_case	Ler um caso com toda a sua thread, incluindo as respostas da equipe do BoardMark
reply_support_case	Responder em um caso (apenas texto; anexos na web)
close_support_case	Fechar um caso quando o problema for resolvido
reopen_support_case	Reabrir um caso fechado (dentro de 30 dias)
follow_support_case	Seguir um caso para receber e-mails quando a equipe responder
unfollow_support_case	Parar de seguir um caso

Recursos MCP

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

* requer project_admin

O que um agente nunca pode fazer?

O MCP não tem ferramentas de administração ou cobrança. Elas permanecem no aplicativo web, para as pessoas cujo papel permite:

usuáriosequipesassentospermissõescobrançacriação de projetosconfigurações do projeto e ambientesinício de sprintsimportação do Jiraexclusão de projetos ou da empresamover projetos para outra empresaexclusão de contaswebhooks de projetoverificação em duas etapas e dispositivos conectadosfotos de perfil

Como conecto um agente de IA ao BoardMark?

Adicione o BoardMark como um servidor MCP no seu cliente de IA (Claude Code, Codex, Gemini CLI, Cursor, VS Code e outros), faça login pelo navegador e escolha a empresa — sem necessidade de copiar token. Para CI ou máquinas sem navegador, crie um token de acesso pessoal no aplicativo e envie-o como cabeçalho Authorization: Bearer <token>. A configuração para cada cliente está na página MCP (/mcp), ou deixe o agente ler o guia connect.md e se configurar sozinho.

Os agentes de IA podem seguir o fluxo de trabalho da nossa equipe?

Sim. O BoardMark tem padrões para o que cada status significa (por exemplo, Em Revisão = QA está testando, Dev Concluído = aguardando deploy para QA, Teste Rejeitado = QA reprovou) e para qual parte do fluxo cada função — desenvolvedor, QA, BA — atua. Se o seu time trabalha de forma diferente, escreva as regras da empresa no brief da empresa e as regras do projeto no brief do projeto ou nas notas de trabalho. Os agentes sempre leem esses documentos antes de começar e seguem a regra mais específica: a instrução do usuário > os documentos do projeto > o brief da empresa > os padrões. Seu time escreve as regras uma vez, e todo agente — Claude, ChatGPT, Codex, Cursor ou qualquer cliente MCP — trabalha dentro do mesmo quadro acordado, com mais precisão, em vez de receber instruções novamente em cada chat. Detalhes: /docs/boards.

Um agente pode editar com segurança uma issue que outra pessoa está editando?

Sim. Cada escrita envia a versão do arquivo que ele leu. Se alguém o alterou primeiro, o servidor responde com 409 version_conflict em vez de sobrescrever, então os agentes devem sempre chamar get_issue antes de update_issue.

Como vejo o que um agente alterou?

Cada alteração que um agente faz via MCP é registrada no histórico da issue ou do documento: quais direitos ele usou, qual cliente de IA (o nome que você aprovou ao conectar com login, ou o nome que você deu a um token de acesso pessoal), OAuth ou token, qual ferramenta MCP fez a chamada (por exemplo, update_issue) e um ID de solicitação que agrupa tudo o que uma chamada alterou. O histórico da issue mostra isso como "via Claude Code"; cartões e anexos alterados ou enviados por um agente carregam um selo, e a página Agente e MCP lista os commits recentes dos seus agentes. Administradores da empresa podem filtrar o log de auditoria para o que foi feito por um agente de IA, e solicitações que o BoardMark recusou (sem permissão ou por uma regra) aparecem como "Um agente de IA foi recusado".

Existe um limite de taxa?

Sim — 600 solicitações por minuto por token por padrão.

Posso impedir um agente de IA de fazer o trabalho do QA?

O BoardMark avisa; ele não bloqueia. Cada coluna tem uma faixa — a função que trabalha naquele status (Em Revisão = QA, por exemplo) — e um agente recebe uma função no token dele ou na tela de aprovação ao conectar. Se um agente Desenvolvedor move Em Revisão → Concluído, ou pula a etapa de QA, a movimentação ainda acontece, mas o agente recebe um aviso para parar, informar o usuário e fazer a entrega com um comentário. O histórico da issue mostra a função do agente e um ⚠ em movimentações fora da faixa dele. Pessoas nunca são avisadas ou bloqueadas.