SOLU Comercial — MCP

各営業担当者の Claude Code を SOLU の ERP（Base44） に接続するローカル MCP。 担当者が作業している間（リードを評価し、提案書を作成し、契約を締結する）、 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 経由（推奨、フォルダをダウンロードする必要はありません）⭐

コマンドは1つだけです。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 と会話するだけです — ツールを呼び出すタイミングは 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 キーは営業専用（admin用ではなく）にしてください。Daniel に依頼してください。