@lcapps/mcp-crm

将你的 LCApps CRM 与 Claude 及其他 AI 助手连接。

你需要哪种方式

有两种连接方式，大多数人需要第一种。

从连接器开始。 如果以后需要将发票和报价保存为文件，再回到这里。

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

三个条目可以同时启用。凭据按服务器保存，因此授权一个不会使其他服务器退出登录。

配置文件的位置：

• 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。之后会重用刷新令牌，因此每个服务器只会打开一次浏览器。

你也可以手动启动：

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。