garmonia-crm-mcp

Servidor MCP para probar el CRM «Garmonia Hotel» a través de su API interna. Inicia sesión con contraseña (cookie de sesión), ofrece herramientas para pedidos, clientes, marcas, calendario y acceso universal a todo lo demás CRUD.

Instalación rápida (un comando, sin clonar)

Solo necesitas Node 18+. No hace falta instalar ni clonar el repositorio — npx ejecutará el servidor directamente desde GitHub.

1. Crea un archivo local con las credenciales, por ejemplo ~/garmonia-crm.json:

   {
     "baseUrl": "https://адрес-crm",
     "login": "твой-логин",
     "password": "твой-пароль"
   }

2. Añade el MCP con un comando (sustituye tu ruta al archivo):

   claude mcp add garmonia-crm \
     -e CRM_CONFIG="$HOME/garmonia-crm.json" \
     -- npx -y github:AlekseiKastsiuk/garmonia-crm-mcp

3. Reinicia Claude Code.

Las credenciales están solo en tu archivo local y no se envían a ningún sitio — npx descarga de GitHub únicamente el código del servidor.

Related MCP server: MCP CRUD Tools

Instalación desde el código fuente (alternativa)

git clone https://github.com/AlekseiKastsiuk/garmonia-crm-mcp
cd garmonia-crm-mcp
npm install
cp crm-config.example.json crm-config.json
# открой crm-config.json и впиши baseUrl, логин и пароль своей CRM

crm-config.json es la dirección del CRM y el usuario/contraseña, no lo subas a git (ya está en .gitignore).

Conexión a Claude Code

En ~/.claude.json (o mediante claude mcp add) añade el servidor:

{
  "mcpServers": {
    "garmonia-crm": {
      "command": "node",
      "args": ["/полный/путь/к/garmonia-crm-mcp/server.mjs"]
    }
  }
}

Si el config no está junto al servidor — indica la ruta en env:

"env": { "CRM_CONFIG": "/полный/путь/к/crm-config.json" }

Después de editar — reinicia Claude Code.

Herramientas

Seguridad

• La contraseña y la dirección del CRM se guardan en crm-config.json, que está en .gitignore — no llega al repositorio.

• En crm-config.example.json solo hay placeholders, sin datos reales.

• Antes del primer push conviene comprobar: git ls-files no debe contener crm-config.json, y git grep -i password — solo el nombre del campo en el código.

Notas

• Los pedidos se crean con el endpoint público POST /api/form-lead — no requiere autorización.

• La eliminación de un pedido no es REST, sino una server action de Next.js (el mismo botón «Eliminar» en la pestaña de cerrados). crm_order_delete la invoca por sí mismo. El id de la acción está vinculado a la compilación del front; si tras un despliegue del CRM la eliminación falla — actualiza bulkDeleteActionId en crm-config.json (búscalo en el bundle JS por bulkDelete).

• Los productos/categorías devuelven listados mediante renderizado del servidor, no a través de una API GET — para crearlos/editarlos/eliminarlos usa crm_request (POST/PATCH/DELETE).