BugTape

Errores de producción con reproducción, red, consola y pila, clasificados para que tu agente de codificación los corrija a través de MCP remoto (OAuth).

Servidor MCP alojado

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

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

Documentación

Conecta Claude, ChatGPT, Cursor, Codex o Grok: un solo comando, o inicia sesión con la URL.

BugTape MCP es un servidor HTTP remoto. Funciona en todos los planes, incluido el gratuito. En créditos gratuitos y prepagados, cada lectura de un agente de los eventos capturados de un bug cuesta 2 créditos (el plan gratuito incluye 150 al mes); otras lecturas son gratuitas. En Pro, las lecturas son gratuitas. Las claves de captura (bt_live_ / bt_test_) son rechazadas.

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

Más rápido: un solo comando

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

Imprime un enlace y un código. Abre el enlace (o envíalo a quien sea dueño del espacio de trabajo), verifica el código, haz clic en Permitir y el agente se añadirá. Esto funciona en servidores y en agentes en la nube sin navegador. Luego, el mismo comando con init configura la captura en tu repositorio: proyecto, clave, pasos de instalación con la versión y un informe de prueba. Consulta la CLI.

Inicia sesión sin token (OAuth)

Todo cliente que admita el inicio de sesión de MCP solo necesita la URL. Abre una página de BugTape donde eliges el espacio de trabajo y lo que el agente puede hacer, luego haz clic en Permitir. La conexión aparece en la página del Equipo, donde puedes eliminarla.

ClienteAñadir BugTape
Claude Codeclaude mcp add --transport http bugtape https://app.bugtape.ai/mcp, luego /mcp y elige BugTape
Claude (web, escritorio, móvil)Configuración → Conectores → Añadir conector personalizado → https://app.bugtape.ai/mcp
ChatGPTAñade un conector personalizado (modo desarrollador) con https://app.bugtape.ai/mcp; ChatGPT abre la página de inicio de sesión
CursorAñade {"url": "https://app.bugtape.ai/mcp"} en mcpServers.bugtape; Cursor muestra Necesita inicio de sesión
Grok (web)Conectores → Nuevo conector → Personalizado → https://app.bugtape.ai/mcp; completa la autenticación. Los administradores del equipo aprovisionan conectores Business/Enterprise primero. Consulta plugins para soporte y límites de calificación

BugTape publica /.well-known/oauth-protected-resource/mcp y /.well-known/oauth-authorization-server, responde 401 con WWW-Authenticate: Bearer resource_metadata=…, acepta documentos de metadatos de ID de cliente, registro dinámico de clientes y PKCE (S256), y rota los tokens de actualización.

Con un token

Prefiere el inicio de sesión OAuth nativo del host donde sea compatible. Para un cliente que necesita un token, crea un token en la página del Equipo (Añadir un agente) o con npx -y bugtape login, luego pégalo como se indica a continuación. Los bots de Grok en la API de xAI pueden usar este método; Grok Build también admite OAuth nativo para MCP HTTP remoto.

Actualizado: 2026-10-02.

Claude Code

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

Cursor

Guarda en .cursor/mcp.json (proyecto) o ~/.cursor/mcp.json (usuario):

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

Codex

Establece BUGTAPE_MCP_TOKEN en el entorno que lanza Codex. Cárgalo desde tu gestor de contraseñas o llavero del sistema operativo. No pongas el PAT en el historial del shell, config.toml, archivos fuente o el repositorio.

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

Codex almacena la URL y el nombre de la variable de entorno en su configuración TOML, luego lee el token desde BUGTAPE_MCP_TOKEN cuando se conecta. Cursor usa el JSON mcpServers anterior; no uses ese JSON para Codex.

Grok / HTTP MCP

Apunta el cliente a https://app.bugtape.ai/mcp con el encabezado Authorization: Bearer bt_pat_YOUR_TOKEN. Misma forma JSON que Cursor.

El bucle del agente

Lo que el agente puede hacer proviene de sus permisos (ámbitos). Recoger y arreglar otorga subscribe, get_repro_context y suggest_fix; Seguir y leer elimina suggest_fix; el inicio de sesión añade create_bug (archivar nuevos problemas) a menos que lo desmarques, y setup_capture (crear proyectos y claves de captura) cuando lo marques. Los permisos no son nombres de herramientas; no existe la herramienta subscribe.

El bucle del agente (nombres de herramientas como los ve tu agente):

  1. subscribe_feed con deliveryFeed: "urgent_critical" y notify: true. Esto elige el feed para el que se despierta al agente. urgent_critical se recomienda para tokens de agente; all y ui_ux también existen.
  2. listen con resourceUri: "bugtape://projects/{projectId}/inbox". Espera hasta que llegue un bug en ese feed, o hasta que BugTape entregue un bug al agente (notificación automática o Enviar al agente, evento agent_notify).
  3. get_repro_context para ese bug: lo que hizo el usuario, la solicitud fallida, la consola y el stack.
  4. ack_bug con action: "working", luego nuevamente con prUrl cuando la solicitud de extracción esté abierta. Tu equipo es notificado en Slack o por webhook.

¿Sin listener en ejecución? Comienza con list_recommended_critical, luego get_repro_context. No vuelques list_bugs.

Después de conectar

Primera solicitud útil: "Llama a subscribe_feed con urgent_critical, luego list_recommended_critical, selecciona el problema de mayor prioridad y llama a get_repro_context para él. Informa la evidencia capturada y cualquier brecha, luego listen en la bandeja de entrada del proyecto para el siguiente." No comiences con un volcado de list_bugs.

Pega el fragmento AGENTS.md en el repositorio para que el agente use la bandeja de entrada clasificada. Contrato completo: Configuración del agente. Lista de herramientas: Herramientas MCP.

Listados de directorios

Archivos de máquina para directorios MCP: mcp.json y smithery.yaml. Enviarlos a Smithery, PulseMCP, mcp.so, directorio de Cursor, conectores de Claude y Glama es un paso manual. La URL pública y el encabezado de autenticación anteriores son la fuente de verdad.

Paquete de plugin

Instala el plugin de BugTape para guías integradas de configuración, triaje, informes y verificación en Claude Code, Codex o Grok Build. La misma página cubre conexiones de aplicaciones de chat y el estado actual de listados.