Как подключить Freshsales к Claude через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Freshsales, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Freshsales + Claude

Freshsales (Freshworks CRM) из любого AI-агента: поиск и фильтрация контактов, аккаунтов и сделок, перевод сделок по этапам воронки, заметки, задачи и встречи, учёт активностей продаж и маркетинговые списки. Работает с личным API-ключом пользователя и bundle URL вашего аккаунта.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

FRESHSALES_BUNDLE_URL, FRESHSALES_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужен аккаунт Freshsales (Freshworks CRM).

1. В Freshsales нажмите на фото профиля, затем Profile Settings, и откройте вкладку API Settings.
2. Скопируйте Your API key в FRESHSALES_API_KEY. Коннектор отправляет его как Authorization: Token token=<key>, поэтому вставляйте только сам ключ.
3. На той же вкладке скопируйте bundle alias (адрес вашего аккаунта) в FRESHSALES_BUNDLE_URL, например https://acme.myfreshworks.com/crm/sales. Аккаунты, созданные до появления пакета Freshworks, используют https://acme.freshsales.io. Не добавляйте /api и косую черту в конце.
4. Установите коннектор и запустите freshsales_list_owners: он покажет пользователей портала и подтвердит ключ и адрес.

Каждый вызов выполняется с правами пользователя, чей ключ указан: записи вне его области не видны. Берите ключ пользователя, который видит нужные команде данные.

С чего начать: freshsales_list_owners возвращает id пользователей для owner_id. freshsales_list_selector читает справочник (территории, воронки и этапы, валюты, типы и причины сделок, источники лидов, отрасли и типы компаний, кампании, статусы контактов, этапы жизненного цикла, типы и результаты активностей продаж) и возвращает id для записи. freshsales_list_pipeline_stages выдаёт этапы одной воронки. freshsales_list_fields перечисляет поля контактов, аккаунтов, сделок или активностей продаж, включая пользовательские: их внутренние имена начинаются с cf_ и передаются в custom_field.

Поиск записей:

• freshsales_search: текстовый поиск по имени или email среди контактов, аккаунтов, сделок и пользователей. include принимает имена в единственном числе: contact, sales_account, deal и user; во множественном ничего не вернётся.
• freshsales_lookup: точное совпадение по одному полю, например контакты по email или контакты, аккаунты и сделки по имени или значению пользовательского поля.
• freshsales_filtered_search: правила по полям (точные значения, диапазоны, списки), возвращает полные записи.
• Списки всегда идут через сохранённое представление: freshsales_list_views даёт id представлений (например, "All Contacts" или "My Deals"), затем freshsales_list_contacts, freshsales_list_accounts или freshsales_list_deals читают его с сортировкой.

Контакты, аккаунты и сделки: freshsales_get_contact, freshsales_get_account и freshsales_get_deal читают одну запись и встраивают связанные записи через include (например, sales_accounts,deals,notes). freshsales_list_contact_activities показывает ленту контакта (письма, звонки, заметки, изменения полей, посещения сайта). Для записи ИИ использует freshsales_create_contact (нужен хотя бы email или фамилия), freshsales_update_contact, freshsales_upsert_contact (создать или обновить по email или другому уникальному полю), freshsales_create_account (уникальное name), freshsales_update_account, freshsales_create_deal (обязательны name и amount) и freshsales_update_deal. Сделка переходит дальше, когда deal_stage_id указывает на этап её воронки; выигрыш и проигрыш тоже этапы, а у проигранной сделки может быть deal_reason_id. При обновлении меняются только переданные поля.

Заметки, задачи, встречи и активности привязываются к записи через targetable_type (Contact, SalesAccount или Deal) и targetable_id:

• Заметки: freshsales_create_note, freshsales_update_note.
• Задачи: freshsales_list_tasks (один фильтр за вызов: open, due_today, due_tomorrow, overdue или completed), freshsales_get_task, freshsales_create_task, freshsales_update_task, freshsales_complete_task.
• Встречи: freshsales_list_appointments (open для предстоящих, past для прошедших; старые порталы используют upcoming), freshsales_get_appointment, freshsales_create_appointment, freshsales_update_appointment. Участники: пользователи (FdMultitenant::User) или контакты (Contact).
• Активности продаж, например записанные звонки и визиты: freshsales_list_sales_activities, freshsales_get_sales_activity, freshsales_create_sales_activity.

Маркетинговые списки: freshsales_list_marketing_lists, freshsales_list_marketing_list_contacts, freshsales_add_contacts_to_list и freshsales_remove_contacts_from_list (сами контакты сохраняются).

Лиды: в современных аккаунтах Freshsales потенциальные клиенты хранятся как контакты с этапом жизненного цикла; отдельного модуля лидов нет. ИИ фильтрует контакты по этапу жизненного цикла через представление или freshsales_filtered_search.

Отключено при установке: ничего. У коннектора нет инструментов удаления, поэтому он не может удалить контакты, аккаунты, сделки, заметки, задачи или встречи. Создание и изменение записей сразу меняет вашу рабочую CRM, поэтому попросите ИИ показать поля перед сохранением.

Форматы данных: метки времени приходят в UTC или со смещением (2026-02-13T23:27:49Z). Даты на входе принимаются как YYYY-MM-DD или ISO 8601; без зоны подразумевается UTC. Суммы указаны в валюте сделки; base_currency_amount пересчитан в валюту портала. Пустые поля равны null. Записи, встроенные через include, приходят в отдельных массивах верхнего уровня (users, sales_accounts, deals) рядом с записью и связаны по id.

Постраничный вывод: списки принимают page (с 1) и per_page (по умолчанию 25, максимум 100) и возвращают meta.total_pages и meta.total. freshsales_search по умолчанию возвращает 10 результатов, максимум 100.

Лимиты и частые ошибки: 1000 запросов в час на аккаунт; сверх этого Freshsales отвечает 429. 401 означает неверный или отсутствующий ключ, 403 что у пользователя нет права или функции нет в тарифе, 404 неверный id или неверный bundle URL. Ошибки валидации приходят как 400 с errors.message.

Коннектор не удаляет записи, не отправляет письма и не меняет настройки портала, поля или воронки.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Claude

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Рекомендуемый путь: работает в claude.ai web без редактирования конфигурационных файлов.

1. Открой в Claude Customize → Connectors.
2. Нажми +, затем Add custom connector.
3. Введи название, например Freshsales, и URL удалённого MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Add.
4. Нажми Connect и войди в AnythingMCP (OAuth), чтобы разрешить доступ.

Все инструменты ниже появятся в чате: начинайте писать промпты.

Доступные инструменты

Примеры запросов

• «Найди контакт [email protected] и покажи её открытые сделки и последние заметки в карточке.»
• «Покажи мои открытые сделки с ожидаемым закрытием в этом месяце, с суммой и этапом.»
• «Переведи сделку Продление Acme на этап Переговоры и добавь заметку, что коммерческое предложение отправлено.»
• «Какие из моих задач просрочены? Сгруппируй их по связанному аккаунту.»
• «Запиши на сегодня 30-минутный звонок с Tom Becker и создай задачу на повторный контакт в следующий вторник в 10:00.»

FAQ

Работает ли с Claude Code так же как с Claude Desktop? Да, оба указывайте на https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Следующие шаги

• Страница коннектора
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot