包括的なモデルコンテキストプロトコル(MCP)サーバーで、EsmoCRMとのシームレスな統合を実現します。 このサーバーは、AIアシスタントが、標準化されたインターフェースを使用して、EsmoCRMインスタンスとやり取りし、連絡先、アカウント、機会、会議、ユーザー、タスク、リード、および高度なシステム管理機能の完全なCRUD操作を提供します。

** NEW: AIチャットボットインテグレーション** - 今すぐあなたのEssoCRMに直接埋め込まれた完全なチャットボットインターフェイスが搭載され、すべての47 MCPツールに自然言語アクセスを提供します!

##特徴

コア機能

• 完全なCRUD操作 - 作成、読み取り、更新、および削除
• 多国籍サポート - 連絡先、アカウント、機会、会議、ユーザー、タスク、およびリード
• 高度な検索とフィルタリング - 日付範囲、パジネーション、および複雑なフィルタの柔軟な検索
• タスク管理 - 親関係とユーザーアサインでタスクのライフサイクルを完了
• リード管理 - 作成から変換までのフルリードパイプライン
• 会議管理 - 出席者管理との完全なカレンダー統合 -ユーザー管理 - 包括的なユーザー検索と検索機能

EspoCRM MCP Server

A comprehensive Model Context Protocol (MCP) server for seamless integration with EspoCRM. This server enables AI assistants to interact with your EspoCRM instance through a standardized interface, providing complete CRUD operations for Contacts, Accounts, Opportunities, Meetings, Users, Tasks, Leads, and advanced system management capabilities.

** NEW: AI Chatbot Integration** - Now includes a complete chatbot interface that embeds directly into your EspoCRM, providing natural language access to all 47 MCP tools!

Features

Core Capabilities

• Complete CRUD Operations - Create, read, update, and delete entities
• Multi-Entity Support - Contacts, Accounts, Opportunities, Meetings, Users, Tasks, and Leads
• Advanced Search & Filtering - Flexible search with date ranges, pagination, and complex filters
• Task Management - Complete task lifecycle with parent relationships and user assignment
• Lead Management - Full lead pipeline from creation to conversion
• Meeting Management - Full calendar integration with attendee management
• User Management - Comprehensive user search and lookup capabilities
• Real-time Validation - Zod-based schema validation for all operations
• Comprehensive Logging - Winston-powered logging with multiple levels

Authentication & Security

• Multiple Auth Methods - API Key and HMAC authentication support
• Secure Configuration - Environment-based configuration management
• Rate Limiting - Built-in rate limiting for API protection
• Error Handling - Robust error handling with detailed logging

Calendar Integration

• Meeting Operations - Create, search, update, and manage meetings
• Attendee Management - Link contacts and users to meetings
• Date/Time Filtering - Advanced date range search capabilities
• Google Calendar Sync Compatibility - Designed for calendar synchronization workflows

AI Chatbot Integration

• Floating Chat Widget - Beautiful, non-intrusive chat bubble interface
• Natural Language Processing - Chat in plain English to perform CRM operations
• Real-time Communication - WebSocket-powered instant responses
• 47 MCP Tools Access - Complete CRM functionality via chat
• EspoCRM Embedding - Integrates directly into your EspoCRM interface
• Mobile Responsive - Works seamlessly on all devices

Developer Experience

• TypeScript - Full TypeScript support with strict typing
• Docker Support - Containerized deployment ready
• Comprehensive Testing - Multiple test scripts and validation tools
• MCP 2024/2025 Compliant - Latest MCP specification support

Quick Start

Prerequisites

• Node.js 18+
• npm or yarn
• EspoCRM instance with API access
• Valid API credentials

Installation

1. Clone the repository

git clone https://github.com/zaphod-black/EspoMCP.git
cd EspoMCP

2. Install dependencies

npm install