@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 참조.