mcp-vtenext
mcp-vtenext
VTENext CRM용 MCP 서버 — Claude 및 기타 MCP 호환 클라이언트를 위한 도구로 WebService API를 노출합니다.
요구 사항
Node.js 18 이상
실행 중인 VTENext 인스턴스 (자체 호스팅 또는 Docker — ../docker 참조)
Related MCP server: nimble-crm-mcp
설정
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)**에서 확인할 수 있습니다.
읽기 전용 모드
VTENext에 대한 모든 쓰기 작업을 방지하려면 READ_ONLY=true로 설정하세요. 이 모드가 활성화되면 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à (영업 기회/Potentials)
도구 | 설명 |
| 선택적 필터(상태, 검색, 제한)를 사용하여 영업 기회 목록 조회 |
| ID로 영업 기회의 전체 세부 정보 가져오기 |
| 이름으로 영업 기회 검색 |
| 새 영업 기회 생성 (쓰기 — 읽기 전용 모드에서 차단됨) |
| 기존 영업 기회의 상태, 금액 또는 메모 업데이트 (쓰기 — 읽기 전용 모드에서 차단됨) |
Contatti (연락처/Contacts)
도구 | 설명 |
| 이름, 이메일 또는 회사별로 연락처 검색 |
Attività e note (활동 및 메모)
도구 | 설명 |
| 영업 기회에 댓글/메모 추가 (쓰기 — 읽기 전용 모드에서 차단됨) |
| 영업 기회와 연결된 활동 목록 조회 |
Utilità (유틸리티)
도구 | 설명 |
| 모든 VTENext 모듈에 대해 사용 가능한 필드 표시 |
| 원시 VTQL SELECT 쿼리 실행 |
인증
VTENext는 vtiger WebService 프로토콜을 사용합니다:
GET /webservice.php?operation=getchallenge→ 토큰MD5(토큰 + 액세스 키) → 해시된 키
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
Available Tools
10 toolsadd_nota_opportunitaC
Aggiunge una nota/commento a un'opportunità
Inputs: opportunita_id (required), testo (required).
create_opportunitaC
Crea una nuova opportunità in VTENext
Inputs: nome (required), stato, importo, data_chiusura, +1 more.
describe_moduloC
Mostra i campi disponibili per un modulo VTENext
Inputs: modulo (required).
get_opportunitaC
Recupera i dettagli completi di un'opportunità tramite ID
Inputs: id (required).
list_attivita_opportunitaC
Elenca le attività associate a un'opportunità
Inputs: opportunita_id (required), limit.
list_opportunitaC
Elenca le opportunità con filtri opzionali
Inputs: limit, stato, search.
query_rawC
Esegue una query VTQL grezza su VTENext (solo lettura)
Inputs: query (required).
search_contattiC
Cerca contatti per nome, email o azienda
Inputs: q (required), limit.
search_opportunitaC
Cerca opportunità per nome
Inputs: q (required), limit.
update_opportunitaC
Aggiorna i dati di un'opportunità esistente
Inputs: id (required), stato, importo, descrizione.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a clearly distinct purpose with no ambiguity. For example, list_opportunita retrieves multiple records with filters, get_opportunita fetches a single record by ID, and search_opportunita finds records by name. The tools target different resources (opportunità, contatti, modulo) and actions (create, update, list, search, describe, query).
All tool names follow a consistent verb_noun pattern in snake_case. Verbs like add, create, describe, get, list, query, search, and update are used predictably with corresponding nouns (e.g., add_nota_opportunita, create_opportunita, describe_modulo). There are no deviations in naming conventions.
With 10 tools, the count is well-scoped for managing opportunities and related data in VTENext. Each tool serves a clear purpose, such as CRUD operations for opportunities, searching contacts, listing activities, and raw queries. No tool feels redundant or unnecessary for the server's domain.
The tool set provides complete coverage for the VTENext opportunity management domain. It includes full CRUD (create, get, update, list/search) for opportunities, plus related operations like adding notes, listing activities, searching contacts, describing modules, and raw queries. There are no obvious gaps, and agents can handle typical workflows without dead ends.
Maintenance
Related MCP Connectors
API-first CRM for LLMs - contacts, companies, deals and activities over a native MCP server.
Vtiger MCP server for ChatGPT, Claude and any AI agent: list contacts, convert contact to deal, list deals, update deal stage, list cases, create case, update case and create contact in your own Vtiger account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Vtiger yourself; Cotlet does not store your password and you need no Vtiger API key. About the official Vtiger API: Yes, Vtiger has a REST API, but its limits table lists 0 requests for One Pilot and 24,000 a day (30 a minute) for One Growth, and Vtiger has no official MCP server (checked 22 Oct 2026). Setup and FAQ: https://cotlet.dev/integrations/vtiger-api-mcp-server
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server for Getfly CRM — customers, opportunities, orders, tickets and tasks.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables users to manage CRM leads, opportunities, projects, tasks, and sales records within ERPNext directly through MCP-compatible clients. It supports global searches, timesheet entries, and access to dashboard KPIs using natural language.-
- AlicenseNot gradedqualityDmaintenanceMCP server for the Nimble CRM API, enabling management of contacts, deals, notes, tasks, and tags through natural language.MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for vtiger CRM that enables AI agents to log timesheets and create/update records in any module via natural language.33 npm1MIT
- AlicenseAqualityDmaintenanceMCP server that connects to a sales CRM database, enabling AI agents to search prospects, view pipeline status, manage follow-ups, and update records using natural language commands.5MIT