Комплексный сервер Model Context Protocol (MCP) для интеграции с EspoCRM. Этот сервер позволяет помощникам ИИ взаимодействовать с вашим экземпляром EspoCRM через стандартизированный интерфейс, предоставляя полные операции CRUD для контактов, учетных записей, возможностей, встреч, пользователей, задач, лидеров и расширенных возможностей управления системой.

Интеграция AI Chatbot теперь включает в себя полный интерфейс чат-бота, который встраивается непосредственно в вашу EspoCRM, обеспечивая доступ к естественному языку для всех 47 инструментов MCP!

Особенности

###Основные возможности

• Complete CRUD Operations - Создание, чтение, обновление и удаление объектов ** Поддержка нескольких организаций** - Контакты, учетные записи, возможности, встречи, пользователи, задачи и лидеры Усовершенствованный поиск и фильтрация - Гибкий поиск с диапазонами дат, патологиями и сложными фильтрами Управление задачами - полный жизненный цикл задач с родительскими отношениями и назначением пользователя Управление свинцом - Полный свинцовый трубопровод от создания до конверсии ** Менеджмент встреч** - полная интеграция с календарем Управление пользователями - Комплексные возможности поиска и поиска пользователей

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