SOLU Comercial — MCP

Lokales MCP, das den Claude Code jedes Verkäufers mit dem ERP der SOLU (Base44) verbindet. Während der Verkäufer arbeitet (qualifiziert einen Lead, verfasst ein Angebot, schließt einen Vertrag ab), zeichnet Claude Code alles direkt im System auf — Leads, Angebote und Verträge.

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

Verfügbare Werkzeuge (11)

Sicherheit: Das MCP liest, erstellt und aktualisiert nur Leads, Angebote, Verträge und Produkte. Es löscht nichts und berührt den Rest des Systems nicht. Es ist ein von Natur aus sicherer Weg.

Related MCP server: Pipedrive MCP

Installation (einmal pro Mac)

Voraussetzung: Node.js 18+ (node -v). Falls nicht vorhanden: https://nodejs.org

Option A — über npx (empfohlen, KEIN Herunterladen des Ordners nötig) ⭐

Nur ein Befehl. npx lädt das MCP automatisch von GitHub herunter und hält es aktuell. Bitte Daniel um den Vertriebsschlüssel und ersetze ihn 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 macht das MCP in allen deinen Claude-Code-Projekten verfügbar. Wenn Daniel den Code aktualisiert (git push), übernimmt deine nächste Sitzung bereits die neue Version.

Option B — Ordner herunterladen (offline / ohne GitHub)

1. Kopiere den Ordner solu-comercial-mcp auf deinen Mac (z. B. ~/solu-comercial-mcp).

2. Installiere die Abhängigkeiten:

   cd ~/solu-comercial-mcp
   npm install

3. Verbinde mit Claude Code:

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

Test (beliebige Option)

Öffne Claude Code und bitte um "teste die Verbindung von SOLU Comercial". Es sollte ok: true antworten.

Alternative: Konfiguration über Datei

Statt Schritt 3 kannst du ~/.claude.json (oder die .mcp.json des Projekts) bearbeiten:

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

Tägliche Nutzung

Sprich einfach normal mit Claude Code – er entscheidet, wann er die Werkzeuge aufruft. Beispiele:

• "Erstelle einen Lead: João Silva, (61) 99999-0000, Lago Sul, kam über Instagram, Interesse an Automatisierung."

• "Erstelle ein Angebot für Hintergrundmusik für Marina im Sudoeste: 6 Zonen + Subwoofer. Hole die Produktpreise, wende 5% Rabatt an und speichere im System."

• "Aktualisiere den Lead von Gustavo auf 'Angebot gesendet' und erfasse den Wert von R$ 45.000."

• "Erstelle den Vertrag für das genehmigte Angebot von Marina, 50% Anzahlung + 50% bei Lieferung, und markiere ihn als unterschrieben."

Tipp: Lass Claude Code alles automatisch aufzeichnen

Lege im Projekt, das die Verkäufer verwenden, eine CLAUDE.md mit etwa Folgendem an:

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 / Wartung

• Du brauchst weitere Felder oder ein neues Werkzeug? Bearbeite einfach lib.js (Logik) und index.js (Werkzeug).

• Der API-Schlüssel muss dem Vertrieb gewidmet sein (nicht der Admin-Schlüssel). Bitte Daniel darum.