@lcapps/mcp-crm

LCAppsのCRMをClaudeや他のAIアシスタントと接続します。

必要なのはどちらの方法ですか

接続方法は2つあり、ほとんどの方は最初の方法をお求めです。

まずはコネクタから始めてください。 後で請求書や見積もりをファイルとして保存する必要が出てきたら、こちらに戻ってきてください。

Related MCP server: capsulemcp

何もインストールせずに接続する

CRMのアドレスが必要です。いつものアドレスの先頭を mcp に変えたものです：

手順：

1. Claudeを開き、設定に入ります。

2. コネクタのセクションを探し、カスタムコネクタを追加します。

3. 表のアドレスを貼り付けて保存します。

4. ClaudeがブラウザでCRMを開き、ログインして承認するよう促します。いつものセッション、いつものユーザーです。

5. 表示される内容を確認し、承認します。

これで完了です。顧客、請求書、経費について質問してみてください。

うまくいかない場合

CRMであなたのユーザーが見えるものだけが表示されます。接続しても新しい権限は付与されません。

ドキュメントをコンピュータに保存する

このためにはこのパッケージが必要です。通常のコネクタはディスクに書き込めないため、PDFは応答内に留まります。

このプログラムはあなたのコンピュータ上で実行され、会話をサーバーに転送し、到着したファイルを保存し、Claudeに保存先のパスを伝えます。

Node.js がインストールされている必要があります。その後、クライアントの設定で：

{
  "mcpServers": {
    "lcrm-int": {
      "command": "npx",
      "args": ["-y", "@lcapps/mcp-crm"],
      "env": { "LCRM_MCP_URL": "https://mcp-int.lcrm.es/mcp" }
    },
    "lcrm-test": {
      "command": "npx",
      "args": ["-y", "@lcapps/mcp-crm"],
      "env": { "LCRM_MCP_URL": "https://mcp-test.lcrm.es/mcp" }
    },
    "lcrm": {
      "command": "npx",
      "args": ["-y", "@lcapps/mcp-crm"],
      "env": { "LCRM_MCP_URL": "https://mcp.lcrm.es/mcp" }
    }
  }
}

3つのエントリはすべて同時に有効にできます。認証情報はサーバーごとに保存されるため、1つを承認しても他のセッションは閉じられません。

設定ファイルの場所：

• macOSのClaude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json

• WindowsのClaude Desktop: %APPDATA%\Claude\claude_desktop_config.json

• Cursor: MCP設定内

--url https://…/mcp は環境変数の代わりとして使用できます。

認証

初回はブラウザが開き、アクセスを承認します。パッケージはOAuthクライアントとして登録し、http://localhost:33420/callback で応答を待ち、認証情報を ~/.lcrm/credentials/<サーバー>.json にパーミッション 0600 で保存します。その後はリフレッシュトークンを再利用するため、ブラウザはサーバーごとに1度だけ表示されます。

手動で起動することもできます：

LCRM_MCP_URL=https://mcp.lcrm.es/mcp npx -y @lcapps/mcp-crm login
LCRM_MCP_URL=https://mcp.lcrm.es/mcp npx -y @lcapps/mcp-crm logout

ファイルの保存先

CRMが返すドキュメントは ~/Downloads/lcrm-mcp/ に保存され、アシスタントはそのパスを受け取ります。ファイル名はCRMから提供されたもの（budget_26_010.pdf など）を安全な単一セグメントに短縮したものです。サーバーが書き込み先を決定することはありません。既存のファイルは上書きされず、-1、-2 のようなサフィックスが追加されます。

環境変数

ポートを変更するとコールバックアドレスが変わるため、再度認証する必要があります。

開発

npm install
npm run typecheck
npm test
npm run build

ライセンス

MIT — LICENSE を参照。