@dev-bear/mcp

MCP (Model Context Protocol) Server para integrar DevBear con Claude Code y otros asistentes de IA.

Instalacion Rapida

# Agregar a Claude Code (recomendado)
claude mcp add devbear npx @dev-bear/mcp

¡Eso es todo! No necesitas configurar nada mas.

Instalacion Alternativa

Opcion 1: Usar con npx (sin instalar)

npx @dev-bear/mcp

Opcion 2: Instalar globalmente

npm install -g @dev-bear/mcp
devbear-mcp

Opcion 3: Configuracion manual

Edita tu archivo de configuracion de Claude:

Ubicaciones:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/claude/claude_desktop_config.json

{
  "mcpServers": {
    "devbear": {
      "command": "npx",
      "args": ["@dev-bear/mcp"]
    }
  }
}

Primer Uso

Opcion A: Personal Access Token (recomendado para LLMs hosted)

Funciona en cualquier cliente MCP (Claude Desktop, Claude Code, Cursor, ChatGPT desktop, Continue, etc.) sin que tengas que pegar tu contrasena en el chat.

1. Entra a DevBear -> Mi Perfil -> "Tokens de Acceso (MCP)" -> Nuevo token.
2. Copia el token (formato dvb_...). Solo se muestra una vez.
3. Configura el MCP con la variable de entorno DEVBEAR_TOKEN:

{
  "mcpServers": {
    "devbear": {
      "command": "npx",
      "args": ["@dev-bear/mcp"],
      "env": { "DEVBEAR_TOKEN": "dvb_xxxxxxxxxxxxxxxx" }
    }
  }
}

4. Reinicia tu cliente. El MCP intercambia el token por una sesion al arrancar.

Tambien puedes pasar el token desde el chat con devbear_login_token(token="dvb_..."), util para probar antes de configurar la env var.

Para revocar un token: Mi Perfil -> Tokens de Acceso -> icono de papelera. El cliente que lo use dejara de funcionar de inmediato.

Opcion B: Login con email y password

Util para uso local desde Claude Code u otros clientes que pueden capturar contrasenas de forma segura:

Tu: "Lista mis proyectos en DevBear"
Claude: "Necesitas autenticarte. Usa devbear_login con tu email y password"

Tu: devbear_login con email="tu@email.com", password="tu-password"
Claude: "Autenticado como Juan Perez (developer) en Mi Organizacion"

Sesiones siguientes

Tu sesion se guarda automaticamente. No necesitas hacer login cada vez.

Tu: "Lista mis proyectos"
Claude: [Usa tu sesion guardada automaticamente]

3. Ver tu usuario actual

Tu: devbear_whoami
Claude:
- Email: tu@email.com
- Nombre: Juan Perez
- Rol: developer
- Organizacion: Mi Organizacion

4. Cerrar sesion

Tu: devbear_logout
Claude: "Sesion cerrada correctamente"

Herramientas Disponibles

Autenticacion

Proyectos

Tareas

Sprints

Equipo

Documentos

Diagramas

Prompts y Skills

Metricas y Reportes

Ejemplos de Uso

"Muestrame los proyectos activos"
"Dame el contexto del proyecto mi-app"
"Lista las tareas pendientes"
"Crea una tarea: Implementar login con Google"
"Marca la tarea ABC como completada"
"Agrega un comentario a la tarea: Avance del 50%"
"Busca prompts de React y TypeScript"
"Muestrame el diagrama de arquitectura"

Permisos (RBAC)

El MCP respeta los permisos de tu cuenta con dos niveles:

Roles de Organizacion

Roles de Proyecto

Ademas del rol de organizacion, puedes tener un rol especifico en cada proyecto:

Donde se guardan los datos

Importante: Tus datos NUNCA pasan por npm. El MCP es solo codigo que conecta Claude con DevBear.

Solucion de Problemas

"No autenticado"

devbear_login con email="tu@email.com", password="..."

"Acceso denegado"

Tu rol no tiene permisos. Contacta a un admin de tu organizacion.

"Token expirado"

El MCP refresca automaticamente. Si falla:

devbear_logout
devbear_login con email="...", password="..."

Limpiar sesion manualmente

# macOS/Linux
rm ~/.devbear/tokens.json

# Windows
del %USERPROFILE%\.devbear\tokens.json

Requisitos

• Node.js 18+
• Cuenta en DevBear

Self-Hosted (Avanzado)

Si tienes tu propia instancia de DevBear:

SUPABASE_URL=https://tu-instancia.supabase.co \
SUPABASE_ANON_KEY=tu-anon-key \
npx @dev-bear/mcp

Enlaces

• DevBear - Plataforma
• Documentacion - Docs completos
• Reportar problemas

Changelog

v1.9.0

• Feature: Personal Access Tokens (PAT) para autenticacion sin contrasena.
  • Nuevo tool devbear_login_token para login desde el chat con un PAT.
  • Soporte para variable de entorno DEVBEAR_TOKEN (autologin al arrancar).
  • Compatibilidad con LLMs hosted que no pueden capturar contrasenas.
  • Gestion de tokens (crear/listar/revocar) desde Mi Perfil en DevBear.
  • El intercambio PAT -> sesion se hace via edge function mcp-token-exchange.

v1.0.5

• Feature: Herramientas de Sprint (devbear_sprint_list, devbear_sprint_get, devbear_sprint_create, devbear_sprint_update, devbear_sprint_activate)
• Feature: Herramientas de Equipo (devbear_team_list, devbear_team_get, devbear_team_add, devbear_team_remove, devbear_team_update_role)
• Feature: Nuevos reportes (devbear_sprint_report, devbear_team_report)
• Feature: Sistema de permisos RBAC para sprints y equipo

v1.0.4

• Fix: Corregido acceso a proyectos - ahora respeta correctamente RLS
• Fix: getProjectRole() y checkResourceOwnership() usan el token del usuario
• Fix: Operaciones de lectura ya no verifican membresia manualmente
• Mejora: Usuarios con roles validos (owner, maintainer, contributor, viewer) acceden correctamente

v1.0.3

• Fix: Todas las herramientas usan getUserClient() para respetar RLS
• Fix: Removido requiresProjectContext de operaciones de lectura

v1.0.2

• Feature: Sistema de autenticacion con login/logout/whoami
• Feature: Tokens persistentes en ~/.devbear/tokens.json
• Feature: Sistema de permisos RBAC completo

v1.0.0

• Lanzamiento inicial

Licencia

MIT