SOLU Comercial — MCP

Local MCP that connects each salesperson's Claude Code to SOLU's ERP (Base44). While the salesperson works (qualifies a lead, drafts a proposal, closes a contract), Claude Code writes everything straight to the system — Leads, Proposals, and Contracts.

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

Available tools (11)

Security: the MCP only reads, creates, and updates Leads, Proposals, Contracts, and Products. It deletes nothing and doesn't touch the rest of the system. It is a safe-by-design path.

Related MCP server: Pipedrive MCP

Installation (once per Mac)

Prerequisite: Node.js 18+ (node -v). If you don't have it: https://nodejs.org

Option A — via npx (recommended, NO need to download folder) ⭐

A single command. npx downloads the MCP from GitHub on its own and keeps it updated. Ask Daniel for the sales key and replace it in 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 makes the MCP available in all your Claude Code projects. When Daniel updates the code (git push), your next session already picks up the new version.

Option B — downloading the folder (offline / without GitHub)

1. Copy the solu-comercial-mcp folder to your Mac (e.g.: ~/solu-comercial-mcp).

2. Install the dependencies:

   cd ~/solu-comercial-mcp
   npm install

3. Connect to Claude Code:

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

Test (either option)

Open Claude Code and ask "test the SOLU Comercial connection". It should respond ok: true.

Alternative: configure via file

Instead of step 3, you can edit ~/.claude.json (or the project's .mcp.json):

{
  "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"
      }
    }
  }
}

How to use it day to day

Just talk to Claude Code normally — it decides when to call the tools. Examples:

• "Create a lead: João Silva, (61) 99999-0000, Lago Sul, came via Instagram, interest in automation."

• "Put together an ambient sound proposal for Marina in Sudoeste: 6 zones + subwoofer. Pull the product prices, apply a 5% discount, and save it in the system."

• "Update Gustavo's lead to 'proposal sent' and record the amount of R$ 45,000."

• "Generate the contract for Marina's approved proposal, 50% down payment + 50% upon delivery, and mark it as signed."

Tip: let Claude Code record everything on its own

In the project the salespeople use, add a CLAUDE.md with something like this:

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.

Support / maintenance

• Need more fields or a new tool? Just edit lib.js (logic) and index.js (tool).

• The API key should be dedicated to sales (not the admin one). Ask Daniel.