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