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の 管理 → ユーザー → [ユーザー] → アクセスキー にあります。

読み取り専用モード

VTENextへの書き込み操作を禁止するには READ_ONLY=true を設定します。有効にすると、ツール create_opportunita、update_opportunita、add_nota_opportunita はデータを書き込まずにエラーを返します。

これは、CRMデータの読み取りのみを行うAIボットや自動エージェントがサーバーを使用する場合に便利です。フルアクセス可能なインスタンスと並行して読み取り専用インスタンスを実行するには、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