SOLU Comercial — MCP

MCP local que conecta el Claude Code de cada vendedor al ERP de SOLU (Base44). Mientras el vendedor trabaja (califica un lead, redacta una propuesta, cierra un contrato), el Claude Code graba todo directamente en el sistema — Leads, Propuestas y Contratos.

Claude Code (vendedor)  →  MCP SOLU Comercial  →  API Base44  →  ERP (Leads / Propostas / Contratos)

Herramientas disponibles (11)

Seguridad: el MCP solo lee, crea y actualiza Leads, Propuestas, Contratos y Productos. No borra nada y no toca el resto del sistema. Es un camino seguro por diseño.

Related MCP server: Pipedrive MCP

Instalación (una vez por Mac)

Requisito previo: Node.js 18+ (node -v). Si no lo tienes: https://nodejs.org

Opción A — vía npx (recomendado, NO necesitas descargar carpeta) ⭐

Solo un comando. El npx descarga el MCP de GitHub automáticamente y lo mantiene actualizado. Pide la clave comercial a Daniel y cámbiala en SUA_CHAVE:

claude mcp add solu-comercial --scope user --env BASE44_API_KEY=SUA_CHAVE -- npx -y https://codeload.github.com/danieldmelo-hub/solu-comercial-mcp/tar.gz/refs/heads/main

--scope user deja el MCP disponible en todos tus proyectos del Claude Code. Cuando Daniel actualice el código (git push), tu próxima sesión ya toma la versión nueva.

Opción B — descargando la carpeta (offline / sin GitHub)

1. Copia la carpeta solu-comercial-mcp a tu Mac (ej.: ~/solu-comercial-mcp).

2. Instala las dependencias:

   cd ~/solu-comercial-mcp
   npm install

3. Conecta al Claude Code:

   claude mcp add solu-comercial --scope user \
     --env BASE44_API_KEY=SUA_CHAVE \
     -- node ~/solu-comercial-mcp/index.js

Prueba (cualquier opción)

Abre el Claude Code y pide "prueba la conexión de SOLU Comercial". Debe responder ok: true.

Alternativa: configurar por archivo

En lugar del paso 3, puedes editar ~/.claude.json (o el .mcp.json del proyecto):

{
  "mcpServers": {
    "solu-comercial": {
      "command": "node",
      "args": ["/Users/SEU_USUARIO_MAC/solu-comercial-mcp/index.js"],
      "env": {
        "BASE44_API_KEY": "SUA_CHAVE",
        "BASE44_APP_ID": "690e523c4894b10373254ffc"
      }
    }
  }
}

Cómo usar en el día a día

Solo habla normalmente con el Claude Code — él decide cuándo llamar a las herramientas. Ejemplos:

• "Crea un lead: João Silva, (61) 99999-0000, Lago Sul, vino por Instagram, interés en automatización."

• "Monta una propuesta de sonido ambiente para Marina en Sudoeste: 6 zonas + subwoofer. Tira los precios de los productos, aplica 5% de descuento y guárdala en el sistema."

• "Actualiza el lead de Gustavo a 'propuesta enviada' y registra el valor de R$ 45.000."

• "Genera el contrato de la propuesta aprobada de Marina, 50% entrada + 50% en la entrega, y márcalo como firmado."

Consejo: deja que el Claude Code registre todo solo

En el proyecto que usan los vendedores, coloca un CLAUDE.md con algo así:

Você é o assistente comercial da SOLU. Use o MCP "solu-comercial" para refletir
TUDO no ERP: ao criar/qualificar um lead, gerar proposta ou fechar contrato,
grave no sistema (criar_lead, criar_proposta, criar_contrato, atualizar_*).
Sempre puxe preços reais com listar_produtos. Ao gerar o texto da proposta/contrato,
salve o markdown no campo document_content. Assine as ações com o nome do vendedor.

Soporte / mantenimiento

• ¿Necesitas más campos o una nueva herramienta? Solo edita lib.js (lógica) y index.js (herramienta).

• La clave de API debe ser dedicada del comercial (no la de admin). Pídela a Daniel.