SOLU Comercial — MCP

Локальный MCP, который подключает Claude Code каждого продавца к ERP SOLU (Base44). Пока продавец работает (квалифицирует лид, составляет предложение, заключает контракт), Claude Code записывает всё прямо в систему — Лиды, Предложения и Контракты.

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

Доступные инструменты (11)

Безопасность: MCP только читает, создаёт и обновляет лиды, предложения, контракты и продукты. Ничего не удаляет и не затрагивает остальную часть системы. Это безопасный путь по дизайну.

Related MCP server: Pipedrive MCP

Установка (один раз на Mac)

Предварительное требование: Node.js 18+ (node -v). Если нет: https://nodejs.org

Вариант A — через npx (рекомендуется, НЕ нужно скачивать папку) ⭐

Всего одна команда. npx сам скачивает MCP с GitHub и поддерживает его в актуальном состоянии. Попросите у Даниэля ключ коммерческого отдела и замените 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 делает MCP доступным во всех ваших проектах Claude Code. Когда Даниэль обновит код (git push), ваша следующая сессия уже получит новую версию.

Вариант B — скачивание папки (офлайн / без GitHub)

1. Скопируйте папку solu-comercial-mcp на свой Mac (напр.: ~/solu-comercial-mcp).

2. Установите зависимости:

   cd ~/solu-comercial-mcp
   npm install

3. Подключите к Claude Code:

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

Тест (любой вариант)

Откройте Claude Code и попросите «проверь подключение SOLU Comercial». Должен ответить ok: true.

Альтернатива: настройка через файл

Вместо шага 3 можно отредактировать ~/.claude.json (или .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"
      }
    }
  }
}

Как использовать в повседневной работе

Просто общайтесь с Claude Code как обычно — он сам решает, когда вызывать инструменты. Примеры:

• «Создай лид: Жуан Силва, (61) 99999-0000, Лагу-Сул, пришёл из Instagram, интерес к автоматизации.»

• «Составь предложение по фоновому звуку для Марины в Судоэсте: 6 зон + сабвуфер. Подтяни цены на продукты, примени скидку 5% и сохрани в системе.»

• «Обнови лид Густаво на „предложение отправлено“ и зафиксируй сумму R$ 45.000.»

• «Создай контракт по одобренному предложению Марины, 50% предоплата + 50% при доставке, и отметь как подписанный.»

Совет: позвольте Claude Code записывать всё самостоятельно

В проекте, который используют продавцы, поместите CLAUDE.md примерно с таким содержимым:

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.

Поддержка / обслуживание

• Нужны дополнительные поля или новый инструмент? Просто отредактируйте lib.js (логика) и index.js (инструмент).

• Ключ API должен быть выделенным для коммерческого отдела (не админский). Попросите у Даниэля.