mcp-vtenext

VTENext CRM용 MCP 서버 — Claude 및 기타 MCP 호환 클라이언트를 위한 도구로 WebService API를 노출합니다.

요구 사항

• 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)**에서 확인할 수 있습니다.

읽기 전용 모드

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)

Contatti (연락처/Contacts)

Attività e note (활동 및 메모)

Utilità (유틸리티)

인증

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