@lcapps/mcp-crm

Conecta tu CRM de LCApps con Claude y otros asistentes de IA.

Cuál de las dos formas necesitas

Hay dos maneras de conectar, y la mayoría de la gente quiere la primera.

Empieza por el conector. Si más adelante necesitas que las facturas y presupuestos se guarden como fichero, vuelve aquí.

Related MCP server: capsulemcp

Conectar sin instalar nada

Necesitas la dirección de tu CRM. Es la de siempre, cambiando el principio por mcp:

Los pasos:

1. Abre Claude y entra en sus ajustes.

2. Busca el apartado de conectores y elige añadir uno personalizado.

3. Pega la dirección de la tabla y guarda.

4. Claude abrirá tu CRM en el navegador para que inicies sesión y autorices. Es tu sesión de siempre, con tu usuario.

5. Revisa lo que te pide y acepta.

Ya está. Pregúntale por tus clientes, tus facturas o tus gastos.

Si algo no va

Verás solo lo que tu usuario puede ver en el CRM. Conectar no da permisos nuevos.

Guardar los documentos en tu ordenador

Para esto sí hace falta este paquete. Un conector normal no puede escribir en tu disco, así que un PDF llega dentro de la respuesta y se queda ahí.

Este programa se ejecuta en tu ordenador, reenvía la conversación al servidor y guarda los ficheros que lleguen, dejándole a Claude la ruta donde quedaron.

Necesitas Node.js instalado. Después, en la configuración de tu cliente:

{
  "mcpServers": {
    "lcrm-int": {
      "command": "npx",
      "args": ["-y", "@lcapps/mcp-crm"],
      "env": { "LCRM_MCP_URL": "https://mcp-int.lcrm.es/mcp" }
    },
    "lcrm-test": {
      "command": "npx",
      "args": ["-y", "@lcapps/mcp-crm"],
      "env": { "LCRM_MCP_URL": "https://mcp-test.lcrm.es/mcp" }
    },
    "lcrm": {
      "command": "npx",
      "args": ["-y", "@lcapps/mcp-crm"],
      "env": { "LCRM_MCP_URL": "https://mcp.lcrm.es/mcp" }
    }
  }
}

Las tres entradas pueden estar activas a la vez. Las credenciales se guardan por servidor, así que autorizar una no cierra la sesión de las otras.

Dónde está el fichero de configuración:

• Claude Desktop en macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Claude Desktop en Windows: %APPDATA%\Claude\claude_desktop_config.json

• Cursor: en sus ajustes de MCP

--url https://…/mcp sirve como alternativa a la variable de entorno.

Autorización

La primera vez se abre el navegador para que autorices el acceso. El paquete se registra como cliente OAuth, espera la respuesta en http://localhost:33420/callback y guarda las credenciales en ~/.lcrm/credentials/<servidor>.json con permisos 0600. Después reutiliza el token de refresco, así que el navegador solo aparece una vez por servidor.

También puedes lanzarlo a mano:

LCRM_MCP_URL=https://mcp.lcrm.es/mcp npx -y @lcapps/mcp-crm login
LCRM_MCP_URL=https://mcp.lcrm.es/mcp npx -y @lcapps/mcp-crm logout

Dónde acaban los ficheros

Los documentos que devuelve el CRM se guardan en ~/Downloads/lcrm-mcp/ y el asistente recibe la ruta. El nombre viene del propio CRM —budget_26_010.pdf y similares— reducido a un único segmento seguro: el servidor no decide dónde se escribe. Nunca se sobrescribe un fichero existente; se añade un sufijo -1, -2.

Variables de entorno

Cambiar el puerto cambia la dirección de retorno, así que habrá que autorizar de nuevo.

Desarrollo

npm install
npm run typecheck
npm test
npm run build

Licencia

MIT — ver LICENSE.