Что ИИ-агент делает в Планфиксе
Серверы сообщества сильно различаются охватом. Одни работают только с задачами, другие добавляют лиды, отчеты, чеклисты и вебхуки.
- Ведет воронку продаж. MCP-сервер для Планфикса создает и ищет лиды, переводит их в задачи и отправляет произвольный запрос planfix_request к любому методу REST API v2.0. Кастомные поля вроде телефона или источника лида прописываются в config.yml.
- Назначает исполнителя по имени. В Планфикс MCP есть поиск сотрудников и 2 готовых промпта: задачи на сегодня и пошаговое создание задачи в проекте.
- Собирает еженедельный отчет. Сервер с промптами и ресурсами на Python 3.8 и новее отдает отчеты по времени, финансам и задачам, а шаблоны помогают разобрать проект и спланировать спринт.
- Работает с чеклистами и справочниками. Kotelkin Planfix MCP дает 58 инструментов, включая чеклисты, DataTags, шаблоны проектов и процессы.
- Принимает вебхуки. Пакет MCP-сервера с вебхуками с 15 инструментами ставится из PyPI через uvx. В комплекте пример Flask-сервера, который складывает уведомления Планфикса в SQLite.
- Разбирает технические логи. Read-only сервер открывает 93 операции чтения по 15 разделам через веб-интерфейс, в том числе логи и вебхуки, которых нет в REST API.
Где взять токен REST API Планфикса
Токен создают в управлении аккаунтом, в разделе доступа к API, на вкладке REST API. При создании отметьте только те уровни доступа (scope), которые нужны агенту. Описание всех методов лежит в спецификации на help.planfix.com/restapidocs.
Каждый токен привязан к сотруднику, и запросы идут от его имени. Если агент должен менять все контакты компании, документация Планфикса советует выпустить токен для робота.
Сервер из OpenAPI-спеки встает в агента после npx skillfoxx add mcp/planfixmcp. Остальные серверы ставятся так же, командой из своей карточки. Для аккаунта на planfix.ru адрес нужно указать явно. У сервера popstas это переменная PLANFIX_BASE_URL. Без нее запросы уйдут на домен planfix.com.
Какой сервер подойдет вашей команде
Официального сервера от Планфикса в каталоге нет. Все серверы написали независимые разработчики, и VPN ни одному не нужен. Большинство получили расширенный уровень доступа: они создают и меняют задачи, контакты и проекты в пределах прав токена. Широкий доступ у Планфикс MCP и у read-only сервера, которому нужны логин и пароль в открытом файле .env с единственной защитой chmod 600.
- Для знакомства и аудита возьмите сервер из OpenAPI-спеки с переменной PLANFIX_READ_ONLY. Агент читает задачи и комментарии и ничего не меняет.
- Для отдела продаж подойдет сервер popstas: лиды и Chat API Планфикса есть только в его описании.
- Если нужны одни задачи, хватит компактного сервера на TypeScript с 10 инструментами.
- Для подключения по HTTP вместо локального процесса есть сервер на FastMCP, который поднимается как HTTP Stream.
- Для процессов и кастомных полей выбирайте Kotelkin. Токен у него можно хранить в OS keyring вместо переменных окружения.
- Если сомневаетесь между двумя серверами, опишите задачу в Подборе с Foxx AI. CRM и таск-трекеры других вендоров лежат в российском стеке.
Ограничения и безопасность
Удаления в Планфикс MCP нет. Но смену статуса или исполнителя в рабочем аккаунте команда увидит сразу, и откатывать ее придется вручную через интерфейс или повторным вызовом того же инструмента. Автор Kotelkin Planfix MCP советует проверять инструменты на аккаунте, где не страшно создать тестовые записи. Это правило годится для любого сервера из списка.
Read-only сервер ходит в Планфикс через веб-клиент, поэтому может сломаться после обновления сервиса. Автор ограничил его 1 запросом в секунду и предупреждает, что чтение способно поставить отметку о прочтении. Для разовой выгрузки надежнее режим PLANFIX_READ_ONLY.