Pular para o conteúdo
backlog.

Integrações · documentação pública

Documentação.

Três superfícies, uma regra de negócio. API, MCP e WebMCP chamam os mesmos casos de uso; autorização, tenant e concorrência continuam no servidor.

Tenant fixado no token.
O agente nunca escolhe outro workspace.

Comece por aqui · Claude Code e Codex

Instale a skill antes de conectar

Conectar o MCP entrega as ferramentas ao agente, mas é a skill que diz a ele quando usá-las, em qual workspace escrever, como evitar tarefa duplicada e que registrar uma pendência não autoriza executá-la. Sem ela, o agente conectado costuma ignorar o serviço.

No Claude Code, sem clonar nada

No Codex, ou para instalar a partir de um clone do repositório, use o script de instalação descrito no README das skills.

Skills e instalação 
/plugin marketplace add thalesholleben/backlog-syntax-oss
/plugin install backlog-cloud@backlog-syntax

HTTP · contrato estável

API REST

Integrações de servidor, automações e agentes que precisam de um contrato HTTP explícito.

Começo rápido

  1. 1. Crie uma conta de serviço em Configurações → Agentes e tokens.
  2. 2. Guarde o token exibido uma única vez e envie-o como Bearer.
  3. 3. Use If-Match e Idempotency-Key nas mutações.
Referência interativa OpenAPI JSON 
curl "https://backlog-api.syntaxlab.com.br/v1/workspaces/WORKSPACE_ID/tasks?limit=20" \
  -H "Authorization: Bearer $BACKLOG_TOKEN"

Remoto · OAuth

MCP

Clientes de IA acessam tools tipadas, claims com lease e eventos auditáveis no workspace.

Conectar um cliente

Adicione o endpoint remoto abaixo em um cliente MCP compatível com OAuth. O fluxo usa PKCE, mostra os escopos antes do consentimento e não reaproveita a sessão do navegador.

  • contexto e listagem
  • criar e atualizar
  • claim, extensão e release
  • handoff e eventos

Endpoint remoto

https://backlog-api.syntaxlab.com.br/mcp

Para scripts sem cliente MCP, prefira a API REST com token de conta de serviço.

Navegador · progressivo

WebMCP

O agente presente no navegador recebe ferramentas contextuais da página aberta, quando houver suporte.

Como funciona

O app detecta document.modelContext. Se a API experimental existir, registra ferramentas limitadas ao projeto aberto; caso contrário, a interface humana segue normal.

WebMCP é conveniência contextual. O MCP remoto continua sendo a integração principal para agentes.

list_taskscreate_taskupdate_task_statusschedule_task