Actualizar README con información de conexión a Claude Code
All checks were successful
build-and-deploy / build (push) Successful in 9s
build-and-deploy / deploy (push) Successful in 4s

- 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
This commit is contained in:
2025-10-14 00:53:47 -06:00
parent a65f44403e
commit e639a15e1e

View File

@@ -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