mcp-vtenext

用于 VTENext CRM 的 MCP 服务器 — 将 WebService API 作为工具暴露给 Claude 和其他兼容 MCP 的客户端。

要求

Node.js 18+
一个正在运行的 VTENext 实例（自托管或 Docker — 参见 ../docker）

设置

cd mcp/vtenext/server
npm install
cp .env.example .env

编辑 .env：

VTENEXT_URL=http://your-vtenext-instance
VTENEXT_USERNAME=admin
VTENEXT_ACCESS_KEY=your_access_key
READ_ONLY=false

访问密钥位于 VTENext 的 管理 (Admin) → 用户 (Users) → [用户] → 访问密钥 (Access Key) 中。

只读模式

设置 READ_ONLY=true 以防止对 VTENext 进行任何写入操作。启用后，工具 create_opportunita、update_opportunita 和 add_nota_opportunita 将返回错误，而不是写入数据。

当服务器被 AI 机器人或自动化代理使用，且仅需读取 CRM 数据时，此功能非常有用。若要与全权限实例同时运行只读实例，请通过 MCP 配置传递该变量：

{
  "mcpServers": {
    "vtenext-bot": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/mcp/vtenext/server/index.js"],
      "env": {
        "VTENEXT_URL": "http://your-vtenext-instance",
        "VTENEXT_USERNAME": "admin",
        "VTENEXT_ACCESS_KEY": "your_access_key",
        "READ_ONLY": "true"
      }
    }
  }
}

Claude Code 集成

添加到项目根目录的 .mcp.json 中：

{
  "mcpServers": {
    "vtenext": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/mcp/vtenext/server/index.js"]
    }
  }
}

工具

Opportunità (商机)

工具	描述
`list_opportunita`	列出商机，支持可选过滤器（状态、搜索、限制）
`get_opportunita`	通过 ID 获取商机的详细信息
`search_opportunita`	按名称搜索商机
`create_opportunita`	创建新商机（写入操作 — 在只读模式下被阻止）
`update_opportunita`	更新现有商机的状态、金额或备注（写入操作 — 在只读模式下被阻止）

Contatti (联系人)

工具	描述
`search_contatti`	按姓名、电子邮件或公司搜索联系人

Attività e note (活动与备注)

工具	描述
`add_nota_opportunita`	向商机添加评论/备注（写入操作 — 在只读模式下被阻止）
`list_attivita_opportunita`	列出与商机关联的活动

Utilità (实用工具)

工具	描述
`describe_modulo`	显示任何 VTENext 模块的可用字段
`query_raw`	运行原始 VTQL SELECT 查询

身份验证

VTENext 使用 vtiger WebService 协议：

GET /webservice.php?operation=getchallenge → token
MD5(token + accessKey) → 哈希密钥
POST /webservice.php 使用 operation=login (表单编码) → sessionName

会话缓存时间为 4 分钟（令牌有效期为 5 分钟）。

测试

# Unit tests (no VTENext required)
npm test

# Integration tests (requires live VTENext at VTENEXT_URL)
npm run test:integration

许可证

MIT

Install Server

A

security – no known vulnerabilities

A

license - permissive license

B

quality - B tier

How are these scores calculated?

Resources

Need Help?

Related Servers

Tools

View all tools

mcp-vtenext

mcp-vtenext

要求

设置

只读模式

Claude Code 集成

工具

Opportunità (商机)

Contatti (联系人)

Attività e note (活动与备注)

Utilità (实用工具)

身份验证

测试

许可证

Resources

Tools

Latest Blog Posts

MCP directory API