CRM Copilot MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
CRM Copilot MCP
Connect AI to a legacy system without rewriting it, and without giving up security.
An MCP server that exposes a customer-management API to any AI host (VS Code, Claude Desktop, a LangChain.js agent) with enterprise-style safeguards: JWT + RBAC, scoped service tokens, per-identity rate limiting, and least-privilege tool design.
Why this exists
Most "AI + tools" demos wire a function straight into one chatbot. In real companies the system already exists, many clients need it, and the model cannot be trusted as the security boundary. This project shows the full path: legacy API → secure MCP server → multiple AI clients.
flowchart LR
H[AI host<br/>VS Code · Claude Desktop · LangChain agent] -- MCP stdio --> M[MCP server]
M -- service token<br/>read+write only --> A[Customers API<br/>JWT · RBAC · rate limit]
A --> D[(Memory / MongoDB)]More in docs/architecture.md (sequence diagram, design decisions, threat model).
Related MCP server: Overdrive MCP Server
What's inside
Folder | What |
| Express "legacy" API: JWT login, RBAC, service tokens, rate limiter, Zod validation, memory or MongoDB storage |
| MCP server: 5 tools, 2 resources, 2 prompts |
| LangChain.js agent that discovers tools through |
| 11 automated tests, including end-to-end via a real MCP Client over stdio |
MCP surface
Type | Name | Notes |
Tool |
| read-only |
Tool |
| write |
Tool |
|
|
Resource |
| fields, constraints, scopes |
Resource |
| live counts by status |
Prompt |
| reusable workflows (the latter checks duplicates first) |
Quick start (3 commands, no database needed)
npm install
cp .env.example .env # Windows CMD: copy .env.example .env
npm run api # terminal 1: API on :3000 (in-memory, seeded)Then in a second terminal:
npm run inspect # MCP Inspector: browse tools/resources/prompts
npm test # 11 tests
npm run agent # natural-language agent (needs ANTHROPIC_API_KEY in .env)Example agent session:
you> cadastre a Marina da Initech (marina@initech.com) como lead
you> marque a Marina como ativa
you> apague a Marina
agent> A API recusou: falta o escopo "customers:delete". Peça a um admin.To use MongoDB instead, set MONGODB_URI in .env.
Use it in your editor
VS Code (Copilot agent mode): .vscode/mcp.json is already included. Start the API, then open the MCP tools picker.
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"crm-copilot": {
"command": "node",
"args": ["C:/path/to/crm-copilot-mcp/mcp-server/src/index.js"],
"env": { "API_URL": "http://localhost:3000", "MCP_SERVICE_TOKEN": "dev-mcp-token" }
}
}
}Security model
Identity | How it authenticates | Scopes |
|
| read, write, delete |
| JWT | read |
| service token | read, write |
| service token | read, write, delete |
The MCP server never forwards tokens it receives; it uses its own identity (no token passthrough).
Per-identity rate limit (default 60/min) plus a stricter per-IP limit on login.
429includesRetry-After, which is surfaced to the model.Passwords hashed with scrypt, service tokens kept as SHA-256 digests with constant-time comparison.
Follows the MCP Security Best Practices.
Before real use: the default tokens and passwords in
.env.exampleare for local demo only. Change every secret.
Scripts
Command | Purpose |
| start the Customers API |
| start the MCP server on stdio (used by hosts) |
| open MCP Inspector against the server |
| LangChain.js agent (REPL, or |
| API + MCP end-to-end tests |
Roadmap
Streamable HTTP transport + OAuth 2.1 for remote use
Redis-backed rate limiter
Publish to npm (
binis already configured:npx crm-copilot-mcp)Audit log of tool calls
Built while studying
Pós-graduação em Engenharia de IA Aplicada (UniPDS), disciplina Model Context Protocol.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
API-first CRM for LLMs - contacts, companies, deals and activities over a native MCP server.
The HubSpot MCP Server acts as a bridge that enables AI assistants and Large Language Models to securely interact with HubSpot CRM data through natural conversation, without requiring users to understand complex API structures. It provides read-only access to standard CRM objects (contacts, companies, deals, tickets, products, invoices, and more) and their associations, secured via OAuth 2.0, allowing AI agents to perform tasks like summarizing deals, fetching company updates, and looking up record changes.
Your AI copilot for customer onboarding — projects, KPIs, tasks, and safe writes.
CRM, inbox, meetings, revenue intelligence, analytics and automations for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to interact with a CRM covering companies, people, leads, deals, and more, with role checks, scoped agent keys, approval gates, and a shared audit trail.AGPL 3.0
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to securely access and manage CRM pipeline, relationships, tasks, notes, files, and deal context through authenticated Streamable HTTP/OAuth, inheriting the signed-in user's permissions and business-unit isolation.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to access corporate HR and CRM APIs on behalf of a specific user through OAuth 2.1 token verification, deny-by-default RBAC, token exchange, audit logging, PII masking, and untrusted-output envelopes.MIT
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to access and manage CRM data by creating contacts and companies, retrieving activities and conversations, and performing semantic search over previously retrieved information with built-in vector storage and caching.-