Skip to main content
Glama

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)

도구

설명

list_opportunita

선택적 필터(상태, 검색, 제한)를 사용하여 영업 기회 목록 조회

get_opportunita

ID로 영업 기회의 전체 세부 정보 가져오기

search_opportunita

이름으로 영업 기회 검색

create_opportunita

새 영업 기회 생성 (쓰기 — 읽기 전용 모드에서 차단됨)

update_opportunita

기존 영업 기회의 상태, 금액 또는 메모 업데이트 (쓰기 — 읽기 전용 모드에서 차단됨)

Contatti (연락처/Contacts)

도구

설명

search_contatti

이름, 이메일 또는 회사별로 연락처 검색

Attività e note (활동 및 메모)

도구

설명

add_nota_opportunita

영업 기회에 댓글/메모 추가 (쓰기 — 읽기 전용 모드에서 차단됨)

list_attivita_opportunita

영업 기회와 연결된 활동 목록 조회

Utilità (유틸리티)

도구

설명

describe_modulo

모든 VTENext 모듈에 대해 사용 가능한 필드 표시

query_raw

원시 VTQL SELECT 쿼리 실행

인증

VTENext는 vtiger WebService 프로토콜을 사용합니다:

  1. GET /webservice.php?operation=getchallenge → 토큰

  2. MD5(토큰 + 액세스 키) → 해시된 키

  3. 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 tools
add_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

    B3.4/5.0

    Scored across 10 tools

    Disambiguation5/5

    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).

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables 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.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for the Nimble CRM API, enabling management of contacts, deals, notes, tasks, and tags through natural language.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for vtiger CRM that enables AI agents to log timesheets and create/update records in any module via natural language.
      33 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      5
      MIT