From b57ac8de839c21693090ecf4e4416b675e58b846 Mon Sep 17 00:00:00 2001
From: josedario87 <jodarioel87@gmail.com>
Date: Mon, 27 Oct 2025 15:41:07 -0600
Subject: [PATCH] =?UTF-8?q?Reorganizar=20instalaci=C3=B3n=20MCPs=20al=20in?=
 =?UTF-8?q?icio=20del=20README?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Movida sección de instalación al principio del documento
- Corregido comando chrome-devtools: usar -- para args
- Consolidada información de scopes y verificación
- Eliminadas secciones duplicadas
- Mejorada estructura para acceso rápido
---
 README.md | 112 +++++++++++++++++++++++++-----------------------------
 1 file changed, 51 insertions(+), 61 deletions(-)

diff --git a/README.md b/README.md
index 754d240..72f5442 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,55 @@
 
 Sistema de documentación para el ecosistema Nucleo basado en Nuxt 4 con autenticación mediante Authentik Proxy Outpost.
 
+## Instalación de Servidores MCP
+
+Para conectar los servidores MCP a Claude Code, ejecuta los siguientes comandos:
+
+### MCP Docker Server
+```bash
+claude mcp add --transport http nucleodocs-docker https://docker.nucleoriofrio.com/mcp
+```
+
+### MCP Gitea Server
+```bash
+claude mcp add --transport http nucleodocs-gitea https://gitea.nucleoriofrio.com/mcp
+```
+
+### MCP Chrome DevTools
+```bash
+claude mcp add chrome-devtools npx -- chrome-devtools-mcp@latest --isolated=true
+```
+
+### Scopes Disponibles
+
+**Para compartir con el equipo** (crea .mcp.json en el proyecto):
+```bash
+claude mcp add --transport http nucleodocs-docker --scope project https://docker.nucleoriofrio.com/mcp
+claude mcp add --transport http nucleodocs-gitea --scope project https://gitea.nucleoriofrio.com/mcp
+claude mcp add chrome-devtools --scope project npx -- chrome-devtools-mcp@latest --isolated=true
+```
+
+**Para uso personal en todos los proyectos**:
+```bash
+claude mcp add --transport http nucleodocs-docker --scope user https://docker.nucleoriofrio.com/mcp
+claude mcp add --transport http nucleodocs-gitea --scope user https://gitea.nucleoriofrio.com/mcp
+claude mcp add chrome-devtools --scope user npx -- chrome-devtools-mcp@latest --isolated=true
+```
+
+### Verificación
+```bash
+# Listar todos los servidores configurados
+claude mcp list
+
+# Ver detalles de un servidor específico
+claude mcp get nucleodocs-docker
+claude mcp get nucleodocs-gitea
+claude mcp get chrome-devtools
+
+# Dentro de Claude Code, verificar el estado
+/mcp
+```
+
 ## Propósito
 
 Este repositorio contiene la documentación del funcionamiento del sistema Nucleo, incluyendo:
@@ -66,48 +115,9 @@ Servidor MCP personalizado construido con TypeScript que expone la API de Gitea
   - `POST /mcp` - Protocolo MCP para operaciones Gitea
   - `GET /health` - Health check del servicio
 
-## Conexión a Claude Code
+## Ejemplos de Uso
 
-Para conectar los servidores MCP a Claude Code, utiliza los siguientes comandos:
-
-### 1. MCP Docker Server
-
-```bash
-claude mcp add --transport http nucleodocs-docker https://docker.nucleoriofrio.com/mcp
-```
-
-### 2. MCP Gitea Server
-
-```bash
-claude mcp add --transport http nucleodocs-gitea https://gitea.nucleoriofrio.com/mcp
-```
-
-### 3. MCP Chrome DevTools
-
-```bash
-claude mcp add chrome-devtools npx chrome-devtools-mcp@latest --isolated=true
-```
-
-### Verificación
-
-Después de agregar los servidores, puedes verificar que estén configurados correctamente:
-
-```bash
-# Listar todos los servidores configurados
-claude mcp list
-
-# Ver detalles de un servidor específico
-claude mcp get nucleodocs-docker
-claude mcp get nucleodocs-gitea
-claude mcp get chrome-devtools
-
-# Dentro de Claude Code, verificar el estado
-/mcp
-```
-
-### Uso
-
-Una vez agregados, podrás usar las herramientas directamente en Claude Code:
+Una vez agregados los servidores MCP, podrás usar las herramientas directamente en Claude Code:
 
 **Para Docker:**
 ```
@@ -130,26 +140,6 @@ Una vez agregados, podrás usar las herramientas directamente en Claude Code:
 > Toma una captura de pantalla de la página actual
 ```
 
-### Scopes disponibles
-
-Si quieres compartir estos servidores con todo el equipo, puedes agregarlos con scope `project`:
-
-```bash
-# Para compartir con el equipo (crea .mcp.json en el proyecto)
-claude mcp add --transport http nucleodocs-docker --scope project https://docker.nucleoriofrio.com/mcp
-claude mcp add --transport http nucleodocs-gitea --scope project https://gitea.nucleoriofrio.com/mcp
-claude mcp add chrome-devtools --scope project npx chrome-devtools-mcp@latest --isolated=true
-```
-
-O si los quieres disponibles en todos tus proyectos personales:
-
-```bash
-# Para uso personal en todos los proyectos
-claude mcp add --transport http nucleodocs-docker --scope user https://docker.nucleoriofrio.com/mcp
-claude mcp add --transport http nucleodocs-gitea --scope user https://gitea.nucleoriofrio.com/mcp
-claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest --isolated=true
-```
-
 ## Desarrollo Local
 
 ```bash