Skip to main content
Glama
deenesjakoruzh
RRS-repositories

crm-mcp

by RRS-repositories
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

crm-mcp

Claude Code를 Rowan Rose CRM에 연결하는 MCP(Model Context Protocol) 서버입니다. Claude의 MCP 도구 호출과 CRM 백엔드의 기존 /api/crm/* REST 엔드포인트 사이에서 가벼운 번역기 역할을 합니다.

아키텍처

Claude Code  ──HTTPS+Bearer──▶  mcp.rowanroseclaims.co.uk  ──HTTPS+x-api-key──▶  crm.rowanroseclaims.co.uk/api/crm/*
                                (this server, EC2)                              (existing CRM, EC2)

3개의 독립적인 인증 경계; 이 서버는 DB나 S3 자격 증명을 보유하지 않습니다.

Related MCP server: MCP ERPNext Plugin

도구 (1단계, 읽기 전용)

도구

목적

crm_lookup_contact

참조, 이메일 또는 이름으로 연락처 조회

crm_get_contact

전체 연락처 + 모든 관련 사례

crm_get_case

전체 사례 상태 (대출 기관, 상태, 날짜, 확장 필드)

crm_list_documents

연락처에 대한 S3 문서 목록 (사례/대출 기관/카테고리별 필터링)

crm_read_document

PDF/DOCX에서 텍스트 추출

crm_search

연락처 및 사례 교차 검색

crm_get_timeline

연락처에 대한 커뮤니케이션/작업 타임라인

crm_list_lenders

알려진 대출 기관 디렉토리 (공식 명칭 + 별칭)

로컬 개발

cp .env.example .env
# fill in CRM_API_KEY (from CRM .env) and MCP_API_KEY (generate)
npm install
npm run build
npm start            # HTTP transport on :5050
npm run start:stdio  # stdio transport (for direct Claude Code stdio use)

상태 확인:

curl http://127.0.0.1:5050/healthz

프로덕션 배포

전용 EC2(CRM 서버와 분리됨)에서 PM2 하에 실행됩니다.

git pull
npm ci
npm run build
pm2 reload ecosystem.config.cjs
pm2 save

Nginx는 mcp.rowanroseclaims.co.uk에 대한 TLS를 종료하고 127.0.0.1:5050으로 프록시합니다.

Claude Code에 등록

claude mcp add --transport http crm \
  https://mcp.rowanroseclaims.co.uk/mcp \
  --header "Authorization: Bearer <MCP_API_KEY>" \
  --scope user

환경 변수

.env.example을 참조하세요. .env는 절대 커밋하지 마십시오.

감사 로그

모든 도구 호출은 pino를 통해 구조화된 로그 라인을 기록합니다. 로그는 /home/ubuntu/crm-mcp/logs/에 저장됩니다. 3단계에서는 이를 Postgres mcp_audit_log 테이블로 이동할 예정입니다.

라이선스

내부용 — Rowan Rose / Fast Action Claims.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • GHL MCP Server

    mnewby20305
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables Claude to manage GoHighLevel CRM contacts, pipelines, and workflows through natural language commands.
    34 npm
    MIT

  • MCP ERPNext Plugin

    glsoltec
    A
    license
    Not graded
    quality
    D
    maintenance
    Integrates Claude with ERPNext v16, enabling CRUD operations, queries, and method calls through a secure MCP interface.
    MIT
  • theLeadRouter MCP by iscale-llc

    theLeadRouter MCPofficial

    iscale-llc
    A
    license
    Not graded
    quality
    D
    maintenance
    Connects Claude Code to the theLeadRouter lead routing platform, enabling lead management, routing, and reporting via API.
    111 npm
    MIT