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の 管理 → ユーザー → [ユーザー] → アクセスキー にあります。
読み取り専用モード
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)
ツール | 説明 |
| オプションのフィルター(ステータス、検索、制限)を指定して商談を一覧表示 |
| 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