F
licenseNot graded
qualityD
maintenanceProvides live Zoho CRM data access via MCP tools, enabling queries on modules, records, fields, and related lists without syncing data.
-
Genesis-World-MCP
by Gnidreve
cas-genesisworld-mcp
Подключите Claude, Cursor или любого MCP-совместимого AI-агента к вашей CRM CAS genesisWorld. Ищите контакты, управляйте задачами и встречами, читайте и записывайте записи — через естественный язык, без написания ни одного API-вызова.
69 инструментов, включая 7 нативных флоу, которые объединяют многошаговые операции CRM (например, проверку конфликтов расписания перед бронированием встречи или проверку дубликатов перед созданием контакта) в один вызов.
Полный доступ на чтение и запись к задачам, контактам, встречам, документам, спискам рассылки и многому другому — плюс универсальный доступ к любому типу пользовательских объектов, определённых в вашей установке.
Режим только для чтения для безопасного исследовательского использования.
Поставляется в виде готового Docker-образа или npm-пакета.
Быстрый старт
Добавьте это в конфиг вашего MCP-клиента (например, в
claude_desktop_config.json у Claude Desktop):
{
"mcpServers": {
"cas-genesisworld": {
"command": "npx",
"args": ["-y", "cas-genesis-world-mcp"],
"env": {
"GENESISWORLD_BASE_URL": "http://your-genesisworld-server/genesisrest.svc",
"GENESISWORLD_PRODUCT_KEY": "your-product-key",
"GENESISWORLD_USERNAME": "your-username",
"GENESISWORLD_PASSWORD": "your-password"
}
}
}
}Перезапустите клиент — инструменты появятся автоматически. Попросите агента найти контакт, вывести список открытых задач или забронировать встречу — и он сделает всё остальное.
Предпочитаете постоянный, самостоятельно размещённый сервер вместо отдельного процесса на каждый клиент? См. Самостоятельное размещение с Docker ниже.
Related MCP server: Twenty CRM MCP
Что можно у него попросить
После подключения ваш агент сможет обрабатывать запросы вроде:
«Найди контактные данные Джейн Доу и покажи её открытые задачи.»
«Создай задачу на последующие действия для этого лида и привяжи её к записи контакта.»
«Забронируй встречу с отделом продаж на следующий вторник в 10:00 — сначала проверь календари всех на конфликты.»
«Проверь возможные дубликаты перед созданием нового контакта для Acme Corp.»
«Сформируй отчёт по этой возможности.»
На такие запросы отвечают флоу — одиночные вызовы инструментов, которые объединяют многошаговую последовательность API-запросов, которую человеку в противном случае пришлось бы писать вручную.
Инструменты и флоу
Флоу — составные действия, один вызов на каждое
Флоу | Режим | Что делает |
| чтение | Текущий пользователь + его список задач (окно сроков, сохранённое представление или полнотекстовый фильтр) одним вызовом |
| чтение | Запись задачи + ссылки + теги, получаемые параллельно |
| запись | Создать задачу и при необходимости связать её с другим объектом (например, контактом) |
| чтение | Поиск контакта по имени и/или номеру телефона, параллельно |
| чтение | Контакт + досье коллекции + теги + ссылки, получаемые параллельно |
| запись | Сначала проверка дубликатов — создаёт только если кандидатов не найдено |
| запись | Необязательная проверка конфликтов → создание → добавление участников, одним вызовом |
Чтение (39)
Инструмент | Конечная точка |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| серверный локальный статический ориентационный документ |
Запись (23 — скрыты в режиме только для чтения, вместе с флоу записи выше)
Инструмент | Конечная точка |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Полный вышестоящий API, на котором это построено, зафиксирован в swagger.json.
Ресурсы
Помимо инструментов, сервер предоставляет ресурсы MCP для данных, которые редко меняются, чтобы ваш агент не тратил вызовы инструментов на повторное обнаружение их в каждой сессии:
genesisworld://readme— статический ориентирующий документ для самого агента (доменная модель, паттерны навигации, правила эффективности).genesisworld://types— типы объектов данных, доступные пользователю, с правами доступа. Кэшируется 15 мин.genesisworld://metadata/{objectType}— схема полей/связей одного типа, напримерgenesisworld://metadata/ADDRESS. Кэшируется 15 мин.genesisworld://views/{objectType}— сохранённые представления одного типа, напримерgenesisworld://views/TASK. Кэшируется 15 мин.
Самостоятельное развёртывание с Docker
Для постоянного сервера, на который могут указывать несколько клиентов (вместо одного процесса npx на каждого клиента):
docker run -d --name cas-genesisworld-mcp -p 8084:3000 \
-e GENESISWORLD_BASE_URL="http://your-genesisworld-server/genesisrest.svc" \
-e GENESISWORLD_PRODUCT_KEY="your-product-key" \
-e GENESISWORLD_USERNAME="your-username" \
-e GENESISWORLD_PASSWORD="your-password" \
vaatu/cas-genesis-world-mcp
# Read-only mode: append --read-only after the image name
docker run -d --name cas-genesisworld-mcp -p 8084:3000 \
-e GENESISWORLD_BASE_URL="http://your-genesisworld-server/genesisrest.svc" \
-e GENESISWORLD_PRODUCT_KEY="your-product-key" \
-e GENESISWORLD_USERNAME="your-username" \
-e GENESISWORLD_PASSWORD="your-password" \
vaatu/cas-genesis-world-mcp --read-onlyМультитенантный режим: один сервер, много учётных записей genesisWorld
По умолчанию контейнер имеет одну фиксированную учётную запись genesisWorld для всех подключающихся клиентов. С --client-credentials у него нет ни одной — каждый клиент аутентифицируется самостоятельно, поэтому один сервер может безопасно обслуживать несколько человек/команд с разными логинами genesisWorld:
docker run -d --name cas-genesisworld-mcp -p 8084:3000 \
-e GENESISWORLD_BASE_URL="http://your-genesisworld-server/genesisrest.svc" \
vaatu/cas-genesis-world-mcp --client-credentialsЗатем каждый клиент при подключении отправляет свои собственные учётные данные в заголовках:
{
"mcpServers": {
"cas-genesisworld": {
"url": "http://localhost:8084/mcp",
"headers": {
"X-GenesisWorld-Username": "your-username",
"X-GenesisWorld-Password": "your-password"
}
}
}
}Заголовок X-GenesisWorld-Product-Key здесь необязателен — если вы оставите GENESISWORLD_PRODUCT_KEY заданным на сервере, клиенты, которые не указали собственный ключ продукта, используют его как запасной вариант. Только HTTP-транспорт (в stdio нет канала заголовков для отдельных запросов); запрос без обоих заголовков — имени пользователя и пароля — отклоняется сразу (HTTP 401), и отката к общей учётной записи не происходит.
Конечная точка MCP теперь находится по адресу http://localhost:8084/mcp. Направьте на неё своего клиента:
{
"mcpServers": {
"cas-genesisworld": {
"url": "http://localhost:8084/mcp"
}
}
}Конфигурация
Два вида настроек, строго разделённых — ни одна настройка не является одновременно и тем и другим: Переменные окружения настраивают развёртывание (где живёт API, кто подключается); параметры запуска переключают поведение при старте.
Переменные окружения
Переменная | Обязательно | Назначение |
| да | Базовый URL REST-сервиса, например |
| да* | Отправляется как |
| да* | Пользователь Basic Auth |
| да* | Пароль Basic Auth |
| нет |
|
| нет | Адрес привязки для HTTP-режима (по умолчанию |
| нет | Обрезает слишком большие ответы (по умолчанию 60000 символов; |
| нет |
|
* Требуются на практике для успешного выполнения любого реального запроса — за исключением режима --client-credentials (см. ниже), когда у сервера нет собственной учётной записи и ни одна из этих трёх переменных не требуется.
Параметры запуска
Флаг | Обязательно | Назначение |
| нет | Регистрирует только инструменты чтения для этой сессии — изменяющие инструменты не просто блокируются, их не существует |
| нет | Сервер не хранит фиксированную учётную запись genesisWorld; каждый HTTP-клиент аутентифицируется через заголовки запроса (см. «Мультитенантный режим» выше). Только HTTP-транспорт |
Передавайте параметры запуска в командной строке или после имени образа в docker run (как показано выше). Ни один из них не имеет эквивалента среди переменных окружения — так задумано.
Лицензия
Хотите добавить инструмент или понять, как это устроено? См. AGENTS.md — документацию по архитектуре и для контрибьюторов, и ROADMAP.md — план проекта.
This server cannot be deployed
Maintenance
ActivitySlowing
ResponsivenessNo issues
Related MCP Connectors
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
Read-only MCP tools for AI agent discovery, structured resources, and NIULAI information.
Read-only AgentiScript concept search, catalog, authenticity, license, and approved asset discovery.
Read-only MCP access to a documented IT fleet: state, changes, posture. 15 tools.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables MCP clients to read, search, create, update, and manage records in Twenty CRM with a safe, composable 14-tool interface and guarded destructive operations.143MIT
- FlicenseNot gradedqualityCmaintenanceRead-only MCP server for DocuWare that lets you list file cabinets, search documents, view metadata, and download documents.-
- FlicenseNot gradedqualityCmaintenanceProvides read-only MCP tools to find, list, and retrieve sales case studies with hybrid search, returning complete cases and prepared presentations.-