planfix-mcp — MCP-сервер для Planfix: задачи и контакты
Подключает Planfix к ИИ-агенту: задачи, проекты, контакты, комментарии и сотрудники через 20 инструментов. Пишете задачу словами — она появляется в аккаунте.
claude mcp add planfix-mcp -e PLANFIX_TOKEN=<PLANFIX_TOKEN> -- npx -y @theyahia/planfix-mcpЧто делает planfix-mcp
Сервер работает поверх REST API Planfix. Внутри 20 инструментов: get_tasks и create_task для задач, get_contacts и create_contact для CRM, плюс проекты, комментарии, сотрудники, справочники и кастомные поля. Отдельно идут два навыка: skill-my-tasks собирает задачи с дедлайном на сегодня и просроченные, skill-create-task ведёт по шагам при создании задачи с выбором проекта.
Запускается через npx -y @theyahia/planfix-mcp. Нужны две переменные: PLANFIX_API_KEY (ключ создаётся в Управлении аккаунтом → Доступ к API → REST API) и PLANFIX_ACCOUNT — субдомен вида mycompany из mycompany.planfix.com. Без субдомена не заработает: общего хоста у REST API нет. Для региональных инсталляций есть необязательный PLANFIX_HOST, по умолчанию planfix.com.
Есть режим Streamable HTTP: --http 8080 поднимает эндпоинт http://localhost:8080/mcp и health check http://localhost:8080/health. Ограничения стоит знать заранее. priority в create_task уходит строкой как есть, допустимые значения против живого API не проверены. Загрузки файла с диска и учёта времени нет — только upload_file_from_url по прямой ссылке.
Какие задачи решает
- поставить задачу сотруднику, не открывая интерфейс Planfix
- собрать список своих задач на сегодня и просроченных
- найти ID исполнителя по имени перед созданием задачи
- добавить комментарий к задаче по её номеру
- завести контакт или компанию в CRM из разговора с агентом
Примеры запросов агенту
- Покажи мои задачи в Planfix за сегодня
- Добавь комментарий к задаче 456: «Готово»
Как установить planfix-mcp
Командой платформы
claude mcp add planfix-mcp -e PLANFIX_TOKEN=<PLANFIX_TOKEN> -- npx -y @theyahia/planfix-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add planfix-mcp --env PLANFIX_TOKEN=<PLANFIX_TOKEN> -- npx -y @theyahia/planfix-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"planfix-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/planfix-mcp"
],
"env": {
"PLANFIX_TOKEN": "<PLANFIX_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"planfix-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@theyahia/planfix-mcp"
],
"env": {
"PLANFIX_TOKEN": "<PLANFIX_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e PLANFIX_TOKEN=<PLANFIX_TOKEN> planfix-mcp npx -y @theyahia/planfix-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о planfix-mcp
Как установить planfix-mcp в Claude Code?
Выполните claude mcp add planfix-mcp -e PLANFIX_TOKEN=<PLANFIX_TOKEN> -- npx -y @theyahia/planfix-mcp. Второй вариант — с явным указанием транспорта: claude mcp add --env PLANFIX_TOKEN=<PLANFIX_TOKEN> --transport stdio planfix-mcp -- npx -y @theyahia/planfix-mcp.
Что делает planfix-mcp?
Даёт агенту доступ к задачам, проектам, контактам, комментариям и сотрудникам Planfix через 20 инструментов. Плюс два навыка для списка задач на сегодня и пошагового создания задачи.
Какие переменные нужны для работы?
PLANFIX_API_KEY с ключом из Управления аккаунтом → Доступ к API → REST API и PLANFIX_ACCOUNT — субдомен аккаунта. Для региональной инсталляции добавляется PLANFIX_HOST.
