configure-local-modules

Configurar Módulos Locales Privados

Este skill configura la ruta de módulos MCP privados en ~/.fs-claude.json (el archivo de configuración unificado de fs-claude), y te guía para crear módulos nuevos.

¿Para qué sirve?

Los módulos locales son herramientas MCP que solo tú usas — endpoints privados de tu empresa, integraciones con otros sistemas, o tools específicas de tu instalación de FacturaScripts. Se almacenan en tu máquina y nunca se suben a GitHub.

Cómo funciona

El servidor MCP lee settings.localModulesPath de ~/.fs-claude.json al arrancar. Si la ruta existe, carga automáticamente todos los módulos dentro. No requiere configuración de variables de entorno.

---

Pasos para configurar

1. Detectar la configuración actual

Ejecuta este comando para saber si ya tienes una ruta configurada:

import json
from pathlib import Path

fs_claude = Path.home() / '.fs-claude.json'
if fs_claude.exists():
    config = json.loads(fs_claude.read_text(encoding='utf-8'))
    path = config.get('settings', {}).get('localModulesPath', '')
    print(f"Ruta configurada: {path}" if path else "Sin ruta configurada")
else:
    print("~/.fs-claude.json no existe aún")

2a. Si ya hay una ruta configurada

Usa esa ruta directamente. Confirma al usuario que el servidor MCP la cargará al reiniciar y muestra su contenido actual.

2b. Si NO hay ruta configurada

Pregunta al usuario si quiere:

• Usar una carpeta existente: proporciona la ruta absoluta
• Crear la carpeta por defecto: se crea ~/fs-claude-mcp-private/ automáticamente

Para crear la carpeta por defecto y registrarla:

import json
from pathlib import Path

fs_claude = Path.home() / '.fs-claude.json'
modules_dir = Path.home() / 'fs-claude-mcp-private'

# Crear el directorio si no existe
modules_dir.mkdir(exist_ok=True)
print(f"Carpeta creada: {modules_dir}")

# Actualizar ~/.fs-claude.json
config = json.loads(fs_claude.read_text(encoding='utf-8')) if fs_claude.exists() else {
    "version": "1.0",
    "connections": {"default": "", "connections": {}},
    "settings": {"sortClassMembers": True, "updateCopyright": True}
}
config.setdefault('settings', {})['localModulesPath'] = str(modules_dir)
fs_claude.write_text(json.dumps(config, indent=2, ensure_ascii=False), encoding='utf-8')
print(f"Ruta guardada en: {fs_claude}")