@dev-bear/mcp

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

Instalacion Rapida

``bash

Agregar a Claude Code (recomendado)

claude mcp add devbear npx @dev-bear/mcp
`

¡Eso es todo! No necesitas configurar nada mas.

Instalacion Alternativa

$3

`bash
npx @dev-bear/mcp
`

$3

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

$3

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

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

Primer Uso

$3

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"
`

$3

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

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

$3

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

$3

`
Tu: devbear_logout
Claude: "Sesion cerrada correctamente"
`

Herramientas Disponibles

$3

| Herramienta | Descripcion |
|-------------|-------------|
| devbear_login | Iniciar sesion |
| devbear_logout | Cerrar sesion |
| devbear_whoami | Ver usuario actual |

$3

| Herramienta | Descripcion |
|-------------|-------------|
| devbear_project_list | Listar proyectos |
| devbear_project_get | Detalles de proyecto |
| devbear_project_context | Contexto completo para desarrollo |

$3

| Herramienta | Descripcion |
|-------------|-------------|
| devbear_task_list | Listar tareas |
| devbear_task_get | Detalles de tarea |
| devbear_task_create | Crear tarea |
| devbear_task_update | Actualizar tarea |
| devbear_task_start | Marcar en progreso |
| devbear_task_complete | Marcar completada |
| devbear_task_add_comment | Agregar comentario |
| devbear_subtask_list | Listar subtareas |

$3

| Herramienta | Descripcion |
|-------------|-------------|
| devbear_sprint_list | Listar sprints del proyecto |
| devbear_sprint_get | Detalles de sprint con metricas |
| devbear_sprint_create | Crear nuevo sprint |
| devbear_sprint_update | Actualizar sprint |
| devbear_sprint_activate | Activar sprint (desactiva otros) |

$3

| Herramienta | Descripcion |
|-------------|-------------|
| devbear_team_list | Listar miembros del proyecto |
| devbear_team_get | Detalles de miembro con tareas y actividad |
| devbear_team_add | Agregar miembro al proyecto |
| devbear_team_remove | Remover miembro del proyecto |
| devbear_team_update_role | Cambiar rol de un miembro |

$3

| Herramienta | Descripcion |
|-------------|-------------|
| devbear_doc_list | Listar documentos |
| devbear_doc_get | Ver documento |
| devbear_doc_create | Crear documento |
| devbear_doc_update | Actualizar documento |

$3

| Herramienta | Descripcion |
|-------------|-------------|
| devbear_diagram_list | Listar diagramas |
| devbear_diagram_get | Ver diagrama (Mermaid) |
| devbear_diagram_create | Crear diagrama |
| devbear_diagram_update | Actualizar diagrama |

$3

| Herramienta | Descripcion |
|-------------|-------------|
| devbear_prompt_list | Listar prompts |
| devbear_prompt_get | Ver prompt |
| devbear_prompt_create | Guardar prompt |
| devbear_prompt_delete | Eliminar prompt |
| devbear_prompt_search_by_tech | Buscar por tecnologia |

$3

| Herramienta | Descripcion |
|-------------|-------------|
| devbear_metrics_get | Metricas del proyecto |
| devbear_project_report | Reporte completo del proyecto |
| devbear_ai_activity_summary | Resumen de actividad IA |
| devbear_sprint_report | Reporte detallado de un sprint |
| devbear_team_report | Reporte de productividad del equipo |

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:

$3

| Accion | Admin | Leader | Developer | QA | Designer | Viewer |
|--------|-------|--------|-----------|-----|----------|--------|
| Ver proyectos | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Crear proyectos | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| Crear tareas | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| Editar cualquier tarea | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| Editar tus tareas | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| Eliminar proyectos | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |

$3

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

| Rol | Descripcion |
|-----|-------------|
| Owner | Control total del proyecto |
| Maintainer | Editar/eliminar cualquier recurso del proyecto |
| Contributor | Crear y editar sus propios recursos |
| Viewer | Solo lectura |

Donde se guardan los datos

| Dato | Ubicacion | Acceso |
|------|-----------|--------|
| Tu sesion | ~/.devbear/tokens.json (tu PC) | Solo tu |
| Tus proyectos | Servidores de DevBear | Tu + tu equipo |
| Codigo del MCP | npm | Publico |

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

Solucion de Problemas

$3

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

$3

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

$3

El MCP refresca automaticamente. Si falla:
`
devbear_logout
devbear_login con email="...", password="..."
`

$3

`bash

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:

`bash
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

$3

- 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

$3

- 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

$3

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

$3

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

$3

- Lanzamiento inicial

Licencia

MIT