@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

1. Iniciar sesion

La primera vez que uses el MCP, necesitas autenticarte con tu cuenta de DevBear:

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"

2. 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.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