SOLU Comercial — MCP

로컬 MCP로 각 판매자의 Claude Code를 **SOLU ERP(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가 GitHub에서 MCP를 자동으로 다운로드하고 최신 상태로 유지합니다. Daniel에게 영업용 키를 요청하고 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의 모든 프로젝트에서 사용할 수 있게 합니다. Daniel이 코드를 업데이트하면(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와 평소처럼 대화하기만 하면 됩니다 — 도구를 호출할 시기를 스스로 결정합니다. 예:

• "리드를 생성하세요: João Silva, (61) 99999-0000, Lago Sul, Instagram에서 유입, 자동화 관심."

• "Sudoeste의 Marina를 위한 배경 음악 제안을 작성하세요: 6개 구역 + 서브우퍼. 제품 가격을 가져와 5% 할인을 적용하고 시스템에 저장하세요."

• "Gustavo의 리드를 '제안 전송'으로 업데이트하고 R$ 45.000 값을 기록하세요."

• "Marina의 승인된 제안에 대한 계약을 생성하고, 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 키는 영업 전용이어야 합니다(관리자용 아님). Daniel에게 요청하세요.