MCP Suitecrm

SuiteCRM MCP服务器

一 MCP（模型上下文协议） 服务器，使AI助手能够完全访问SuiteCRM实例——使用自然语言在27个模块中搜索、创建、更新、关联和转换记录。与Claude、bolt.new和任何启用MCP的客户端兼容。

21个工具·27个模块·每个模块100多个字段

MCP服务器URL

https://suitecrm-mcp-suite-crm.apps.operations.imola-solutions.com/mcp

认证

身份验证完全通过 SuiteCRM OAuth当AI客户端首次连接时，它会被重定向到一个登录页面，用户在该页面上使用现有的SuiteCRM凭据登录。不需要单独的帐户——访问权限是根据用户的SuiteCRM身份授予的，所有操作都尊重该用户的权限。

你能做什么

AI代理可以使用此MCP完成的一些示例：

• *“查找与Ironclad Financial Services相关的所有联系人和机会”*
• *“为Acme Corp的John Smith创建新的潜在客户，来源：网站”*
• *“将潜在客户Jane Doe转换为客户和联系人，并创建25000美元的潜在客户机会”* --在一次工具调用中完成
• *“将测试用户联系到第二季度企业交易机会”*
• *“案例模块中有哪些可用字段？”* --返回所有45个字段及其类型
• *“复制此联系人，但使用不同的电子邮件地址”*
• *“显示CRM中可用的所有模块”* --返回所有27个活动模块

建筑

AI Client (Claude / bolt.new / other)
        │
        │  HTTP  (MCP protocol over StreamableHTTP)
        ▼
┌─────────────────────────────┐
│     SuiteCRM MCP Server     │  (Node.js / Express — deployed on OKD)
│                             │
│  ┌──────────┐ ┌──────────┐  │
│  │  OAuth   │ │  Tools   │  │
│  │ (login)  │ │  (21)    │  │
│  └──────────┘ └──────────┘  │
└─────────────┬───────────────┘
              │  SuiteCRM REST API v8 (JSON:API)
              ▼
     ┌─────────────────┐
     │    SuiteCRM 8   │  (PHP / MariaDB — deployed on OKD)
     └─────────────────┘

可用工具

账户

联系人

潜在客户

机会

病例

任务和注释

一般记录操作

发现和用户

连接AI客户端

新螺栓

1. 打开bolt.new项目设置。
2. 首选 MCP服务器 并添加新服务器。
3. 将URL设置为上面的MCP服务器端点。
4. 将身份验证方法设置为OAuth。
5. 单击连接按钮。
6. bolt.new会将您重定向到SuiteCRM登录页面。使用您的SuiteCRM凭据登录。
7. 一旦通过身份验证，所有21个工具都可以在您的AI助手中使用。

克劳德桌面（通过mcp远程）

mcp-remote 是一个让Claude Desktop连接到远程HTTP MCP服务器的网桥。

1.安装mcp远程：

npm install -g mcp-remote

2.编辑您的Claude Desktop配置文件：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "suitecrm": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://suitecrm-mcp-suite-crm.apps.operations.imola-solutions.com/mcp"
      ]
    }
  }
}

3.重新启动克劳德桌面。

浏览器窗口将打开，要求您使用SuiteCRM凭据登录。登录后，Claude Desktop将可以访问所有CRM工具。

克劳德代码（CLI）

将服务器添加到项目的 .mcp.json:

{
  "mcpServers": {
    "suitecrm": {
      "type": "http",
      "url": "https://suitecrm-mcp-suite-crm.apps.operations.imola-solutions.com/mcp"
    }
  }
}

______________________________________________________________________

在OpenShift/OKD上部署

这 k8s/ 目录包含在OpenShift上部署SuiteCRM和MCP服务器所需的所有清单。

先决条件

• oc CLI已通过OKD集群的身份验证
• 正在运行且可访问的SuiteCRM实例
• 在中配置的OAuth2客户端 SuiteCRM管理员→ OAuth2客户端

所需的环境变量

在部署之前在Kubernetes Secret中配置这些：

构建和部署

# Build and push image from local source
oc start-build suitecrm-mcp --from-dir=mcp-server --follow -n 

# Restart the deployment to pick up the new image
oc rollout restart deployment/suitecrm-mcp -n 

# Verify
oc rollout status deployment/suitecrm-mcp -n 

SuiteCRM RSA密钥

SuiteCRM的OAuth2服务器需要RSA密钥对来对令牌进行签名。这些必须出现在：

/var/www/html/public/legacy/Api/V8/OAuth2/private.key
/var/www/html/public/legacy/Api/V8/OAuth2/public.key

要在pod重启时持久化它们，请将它们作为Kubernetes Secret挂载：

# Generate keys
openssl genrsa -out private.key 2048
openssl rsa -in private.key -pubout -out public.key

# Create secret
oc create secret generic suitecrm-oauth-keys \
  --from-file=private.key=private.key \
  --from-file=public.key=public.key \
  -n 

然后将密钥装载到SuiteCRM部署的上述路径中。

______________________________________________________________________

项目结构

CRM/
├── README.md
├── k8s/                        # OpenShift/Kubernetes manifests
│   ├── 00-imagestream.yaml
│   ├── 01-buildconfig.yaml
│   ├── 02-secret.yaml          # MariaDB credentials
│   ├── 03-mariadb.yaml
│   ├── 04-suitecrm.yaml
│   ├── 05-route.yaml
│   └── 06-mcp-server.yaml      # MCP server deployment
└── mcp-server/                 # MCP server source code
    ├── Dockerfile
    ├── package.json
    ├── tsconfig.json
    └── src/
        ├── index.ts            # Express app entry point
        ├── config.ts           # Environment variable config
        ├── auth/
        │   └── middleware.ts   # Bearer token validation
        ├── oauth/
        │   └── server.ts       # OAuth2 authorization server
        ├── suitecrm/
        │   └── client.ts       # SuiteCRM API client
        └── tools/
            ├── index.ts        # Tool registration
            ├── read.ts         # Read tools
            └── write.ts        # Write tools

技术说明

• 27个模块，21个工具：涵盖从潜在客户捕获到合同关闭的整个CRM生命周期。
• PHP通知处理PHP 8上的SuiteCRM 8发出混合在HTTP响应中的弃用通知。MCP服务器会自动剥离这些数据并提取干净的JSON。
• 无状态：每个MCP请求都会创建一个新的服务器实例——不存储会话状态。
• 令牌验证：通过对SuiteCRM用户API进行实际调用来验证OAuth令牌。如果SuiteCRM拒绝令牌，则MCP请求将被拒绝。
• 权限：MCP服务器不强制执行其自己的权限模型-SuiteRM对每个API调用强制执行真正的权限。