From e639a15e1eaee2ae5001fc066c8f3429e93542bd Mon Sep 17 00:00:00 2001
From: josedario87 <jodarioel87@gmail.com>
Date: Tue, 14 Oct 2025 00:53:47 -0600
Subject: [PATCH] =?UTF-8?q?Actualizar=20README=20con=20informaci=C3=B3n=20?=
 =?UTF-8?q?de=20conexi=C3=B3n=20a=20Claude=20Code?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Agregada sección de Conexión a Claude Code con comandos
- Documentado MCP Gitea Server completo
- Actualizada URL de MCP Docker Server a docker.nucleoriofrio.com
- Agregados ejemplos de uso y scopes disponibles
---
 README.md | 91 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 89 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 6df3af7..444ad1c 100644
--- a/README.md
+++ b/README.md
@@ -28,6 +28,7 @@ Este repositorio contiene la documentación del funcionamiento del sistema Nucle
 - ✅ Traefik para proxy reverso y SSL
 - ✅ Claude Code hooks para monitoreo de Actions
 - ✅ MCP Server Docker para gestión de contenedores
+- ✅ MCP Server Gitea para API de Gitea
 
 ## Servicios
 
@@ -40,11 +41,97 @@ Servidor MCP personalizado construido con TypeScript que expone operaciones Dock
 - Usa el puerto 3000 para comunicación HTTP
 - Tiene acceso al socket de Docker del host (solo lectura)
 - Se ejecuta en las redes `principal` y `traefik-network`
-- **Expuesto públicamente en `APP_DOMAIN/mcp` SIN autenticación Authentik**
+- **Expuesto públicamente en `docker.nucleoriofrio.com/mcp` SIN autenticación Authentik**
 - Prioridad 200 en Traefik para evitar conflictos con otros routers
 - Endpoints disponibles:
   - `POST /mcp` - Protocolo MCP para operaciones Docker
-  - `GET /mcp/health` - Health check del servicio
+  - `GET /health` - Health check del servicio
+
+### MCP Gitea Server (`mcp-gitea`)
+Servidor MCP personalizado construido con TypeScript que expone la API de Gitea a través del protocolo MCP sobre HTTP. Este servicio:
+- Implementa 5 herramientas optimizadas para Gitea API v1
+- Usa el puerto 3000 para comunicación HTTP
+- Se conecta a Gitea mediante URL interna (http://gitea:3000)
+- Se ejecuta en las redes `principal` y `traefik-network`
+- **Expuesto públicamente en `gitea.nucleoriofrio.com/mcp` SIN autenticación Authentik**
+- Prioridad 200 en Traefik para evitar conflictos con otros routers
+- Herramientas disponibles:
+  - `gitea_repos` - Gestión de repositorios
+  - `gitea_commits` - Operaciones con commits
+  - `gitea_issues` - Manejo de issues
+  - `gitea_secrets` - Gestión de secrets para Actions
+  - `gitea_variables` - Gestión de variables para Actions
+- Endpoints disponibles:
+  - `POST /mcp` - Protocolo MCP para operaciones Gitea
+  - `GET /health` - Health check del servicio
+
+## Conexión a Claude Code
+
+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
+```
+
+### 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
+
+# Dentro de Claude Code, verificar el estado
+/mcp
+```
+
+### Uso
+
+Una vez agregados, podrás usar las herramientas directamente en Claude Code:
+
+**Para Docker:**
+```
+> Lista todos los contenedores en ejecución
+> Muestra los logs del contenedor nucleodocs-mcp-gitea
+> Inspecciona el contenedor de traefik
+```
+
+**Para Gitea:**
+```
+> Lista mis repositorios de Gitea
+> Muestra los últimos commits del repo nucleoDocs
+> Busca issues abiertos en el repositorio analiticaNucleo
+```
+
+### 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
+```
+
+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
+```
 
 ## Desarrollo Local