BugTape

npx add-mcp 'https://app.bugtape.ai/mcp'

Conecte Claude, ChatGPT, Cursor, Codex ou Grok: um comando, ou faça login com a URL.

O BugTape MCP é um servidor HTTP remoto. Ele funciona em todos os planos, incluindo o Free. Nos créditos Free e Pré-pagos, cada leitura de um agente dos eventos capturados de um bug custa 2 créditos (o Free inclui 150 por mês); outras leituras são gratuitas. No Pro, as leituras são gratuitas. Chaves de captura (bt_live_ / bt_test_) são rejeitadas.

Endpoint: https://app.bugtape.ai/mcp

Mais rápido: um comando

npx -y bugtape connect claude   # or: cursor, codex, grok, grok-bot

Ele imprime um link e um código. Abra o link (ou envie-o para quem possui o workspace), verifique o código, clique em Permitir, e o agente é adicionado. Isso funciona em servidores e em agentes na nuvem sem navegador. Em seguida, o mesmo comando com init configura a captura no seu repositório: projeto, chave, etapas de instalação com o release e um relatório de teste. Veja a CLI.

Entrar sem token (OAuth)

Todo cliente que suporta login MCP precisa apenas da URL. Ela abre uma página do BugTape onde você escolhe o workspace e o que o agente pode fazer, e então clica em Permitir. A conexão aparece na página da Equipe, onde você pode removê-la.

Cliente	Adicionar BugTape
Claude Code	claude mcp add --transport http bugtape https://app.bugtape.ai/mcp, depois /mcp e escolha BugTape
Claude (web, desktop, mobile)	Configurações → Conectores → Adicionar conector personalizado → https://app.bugtape.ai/mcp
ChatGPT	Adicione um conector personalizado (modo desenvolvedor) com https://app.bugtape.ai/mcp; o ChatGPT abre a página de login
Cursor	Adicione {"url": "https://app.bugtape.ai/mcp"} em mcpServers.bugtape; o Cursor mostra Needs login
Grok (web)	Conectores → Novo Conector → Personalizado → https://app.bugtape.ai/mcp; complete a autenticação. Administradores da equipe provisionam conectores Business/Enterprise primeiro. Veja plugins para suporte e limites de qualificação

O BugTape publica /.well-known/oauth-protected-resource/mcp e /.well-known/oauth-authorization-server, responde 401 com WWW-Authenticate: Bearer resource_metadata=…, aceita Documentos de Metadados de ID de Cliente, registro dinâmico de clientes e PKCE (S256), e rotaciona tokens de atualização.

Com um token

Prefira o login OAuth nativo do host onde houver suporte. Para um cliente que precisa de um token, crie um token na página da Equipe (Adicionar um agente) ou com npx -y bugtape login, e então cole-o como abaixo. Bots Grok na API xAI podem usar este método; o Grok Build também suporta OAuth nativo para MCP HTTP remoto.

Atualizado: 2026-10-02.

Claude Code

claude mcp add --transport http bugtape https://app.bugtape.ai/mcp \
  --header "Authorization: Bearer bt_pat_YOUR_TOKEN"

Cursor

Salve em .cursor/mcp.json (projeto) ou ~/.cursor/mcp.json (usuário):

{
  "mcpServers": {
    "bugtape": {
      "url": "https://app.bugtape.ai/mcp",
      "headers": {
        "Authorization": "Bearer bt_pat_YOUR_TOKEN"
      }
    }
  }
}

Codex

Defina BUGTAPE_MCP_TOKEN no ambiente que inicia o Codex. Carregue-o do seu gerenciador de senhas ou chaveiro do sistema operacional. Não coloque o PAT no histórico do shell, config.toml, arquivos de origem ou no repositório.

codex mcp add bugtape \
  --url https://app.bugtape.ai/mcp \
  --bearer-token-env-var BUGTAPE_MCP_TOKEN

O Codex armazena a URL e o nome da variável de ambiente na sua configuração TOML, e então lê o token de BUGTAPE_MCP_TOKEN quando se conecta. O Cursor usa o JSON mcpServers acima; não use esse JSON para o Codex.

Grok / HTTP MCP

Aponte o cliente para https://app.bugtape.ai/mcp com o cabeçalho Authorization: Bearer bt_pat_YOUR_TOKEN. Mesma estrutura JSON do Cursor.

O loop do agente

O que o agente pode fazer vem das suas permissões (escopos). Pegar e corrigir dá subscribe, get_repro_context e suggest_fix; Seguir e ler remove suggest_fix; o login adiciona create_bug (arquivar novos problemas) a menos que você desmarque, e setup_capture (criar projetos e chaves de captura) quando você marcar. Permissões não são nomes de ferramentas; não existe ferramenta subscribe.

O loop do agente (nomes de ferramentas como seu agente os vê):

1. subscribe_feed com deliveryFeed: "urgent_critical" e notify: true. Isso elege o feed para o qual o agente é acordado. urgent_critical é recomendado para tokens de agente; all e ui_ux também existem.
2. listen com resourceUri: "bugtape://projects/{projectId}/inbox". Ele espera até que um bug nesse feed chegue, ou até que o BugTape entregue um bug ao agente (notificação automática ou Enviar para agente, evento agent_notify).
3. get_repro_context para esse bug: o que o usuário fez, a solicitação com falha, o console e o stack.
4. ack_bug com action: "working", e depois novamente com prUrl quando o pull request estiver aberto. Sua equipe é avisada no Slack ou por webhook.

Nenhum listener em execução? Comece com list_recommended_critical, depois get_repro_context. Não despeje list_bugs.

Após conectar

Primeira solicitação útil: "Chame subscribe_feed com urgent_critical, depois list_recommended_critical, selecione o problema de maior prioridade e chame get_repro_context para ele. Relate as evidências capturadas e quaisquer lacunas, depois listen na caixa de entrada do projeto para o próximo." Não comece com um despejo de list_bugs.

Cole o trecho AGENTS.md no repositório para que o agente use a caixa de entrada classificada. Contrato completo: Configuração do agente. Lista de ferramentas: Ferramentas MCP.

Listagens de diretórios

Arquivos de máquina para diretórios MCP: mcp.json e smithery.yaml. Submetê-los ao Smithery, PulseMCP, mcp.so, diretório do Cursor, conectores do Claude e Glama é uma etapa manual. A URL pública e o cabeçalho de autenticação acima são a fonte da verdade.

Pacote de plugin

Instale o plugin BugTape para guias de configuração, triagem, relatórios e verificação incluídos no Claude Code, Codex ou Grok Build. A mesma página cobre conexões de aplicativos de chat e o status atual da listagem.