📦 Part of WWmcp — Emerging Markets MCP — 114 MCP servers for non-Western APIs (Brazil/MENA/Gulf/SE Asia/Africa/CIS).
@theyahia/planfix-mcp
MCP-сервер для Planfix API — задачи, проекты, контакты, комментарии, сотрудники, файлы. 20 инструментов, 2 навыка.
Часть серии Russian API MCP (50 серверов) by @theYahia.
Установка
Claude Desktop
{
"mcpServers": {
"planfix": {
"command": "npx",
"args": ["-y", "@theyahia/planfix-mcp"],
"env": {
"PLANFIX_API_KEY": "your-api-key",
"PLANFIX_ACCOUNT": "your-subdomain"
}
}
}
}
Claude Code
claude mcp add planfix \
-e PLANFIX_API_KEY=your-api-key \
-e PLANFIX_ACCOUNT=your-subdomain \
-- npx -y @theyahia/planfix-mcp
Streamable HTTP (удалённый сервер)
PLANFIX_API_KEY=your-key PLANFIX_ACCOUNT=your-sub npx @theyahia/planfix-mcp --http 8080
Эндпоинт: http://localhost:8080/mcp
Health check: http://localhost:8080/health
Smithery
npx -y @smithery/cli install @theyahia/planfix-mcp --client claude
VS Code / Cursor
{
"servers": {
"planfix": {
"command": "npx",
"args": ["-y", "@theyahia/planfix-mcp"],
"env": {
"PLANFIX_API_KEY": "your-api-key",
"PLANFIX_ACCOUNT": "your-subdomain"
}
}
}
}
Windsurf
{
"mcpServers": {
"planfix": {
"command": "npx",
"args": ["-y", "@theyahia/planfix-mcp"],
"env": {
"PLANFIX_API_KEY": "your-api-key",
"PLANFIX_ACCOUNT": "your-subdomain"
}
}
}
}
Авторизация
| Переменная | Обязательная | Описание |
|---|---|---|
PLANFIX_API_KEY | Да | API-ключ. Создаётся в Управлении аккаунтом → Доступ к API → REST API |
PLANFIX_ACCOUNT | Да | Субдомен (например mycompany из mycompany.planfix.com). Обязателен — общего хоста у REST API нет |
PLANFIX_HOST | Нет | Хост для региональных инсталляций (по умолчанию planfix.com; например planfix.ru) |
PLANFIX_TOKEN | Нет | Устаревший вариант, используйте PLANFIX_API_KEY |
Base URL: https://{PLANFIX_ACCOUNT}.{PLANFIX_HOST}/rest/. Авторизация — заголовок Authorization: Bearer <key>.
Инструменты (20)
Задачи
| Инструмент | Описание |
|---|---|
get_tasks | Список задач (пагинация, fields, filterId, ad-hoc filters) |
get_task | Одна задача по ID |
create_task | Создание задачи (можно указать проект, исполнителя — см. list_users) |
update_task | Обновление задачи (название, описание, статус, исполнитель) |
Контакты
| Инструмент | Описание |
|---|---|
get_contacts | Список контактов |
get_contact | Один контакт по ID |
create_contact | Создать контакт или компанию |
update_contact | Обновить контакт (имя, email, телефон) |
Проекты, комментарии
| Инструмент | Описание |
|---|---|
get_projects | Список проектов |
get_project | Один проект по ID |
get_comments | Комментарии к задаче |
add_comment | Добавить комментарий к задаче |
Сотрудники, справочники, поля, файлы
| Инструмент | Описание |
|---|---|
list_users | Список сотрудников — используйте для поиска ID исполнителя по имени |
get_user | Один сотрудник по ID |
list_directories | Справочники (наборы статусов задач хранятся как справочники) |
list_directory_entries | Записи справочника по его ID (например, варианты статусов) |
list_custom_fields | Кастомные поля по типу объекта (task/contact/project/user/main) |
list_datatags | Дата-теги |
upload_file_from_url | Загрузить файл по прямой ссылке |
get_file | Метаданные файла по ID |
Навыки (Skills / Prompts) (2)
| Навык | Описание |
|---|---|
skill-my-tasks | "Мои задачи на сегодня" — показывает задачи с дедлайном сегодня или просроченные |
skill-create-task | "Создай задачу в проекте" — пошаговый помощник для создания задачи с выбором проекта |
Статусы задач
Отдельного эндпоинта /taskstatus/list в Planfix нет. Системные статусы — фиксированный
набор констант: DRAFT, ACTIVE, ACCEPTED, COMPLETED, DELAYED, REJECTED, DONE, CANCELED.
Кастомные наборы статусов настраиваются как справочники — перечислить их можно через
list_directories → list_directory_entries.
Примеры
Покажи мои задачи в Planfix
Найди сотрудника Иванов и создай задачу "Подготовить отчёт" в проекте 123 с ним как исполнителем
Список контактов
Покажи проекты
Добавь комментарий к задаче 456: "Готово"
🚀 Demo prompts
Use case (RU): "Создай задачу 'Звонок клиенту' в Planfix, привяжи к сделке #12345"
🤖 Pairs well with:
Ограничения
priorityвcreate_taskпередаётся как строка «как есть» — точные допустимые значения не верифицированы против live API.- Прямая загрузка файлов с диска (multipart
POST /file/) и эндпоинты time-tracking/actions не реализованы (REST-контракт не подтверждён). Доступна загрузка файла по ссылке (upload_file_from_url).
Разработка
npm install
npm test # Vitest (32 теста)
npm run dev # tsx watch
npm run build # TypeScript compile
Planfix — реферальная программа
35% бессрочный recurring от всех платежей приведённых клиентов.
- Без сертификации — просто зарегистрируйтесь в партнёрской программе
- Recurring: получаете 35% каждый месяц, пока клиент платит
- Бессрочно: нет ограничений по времени выплат
Подробнее: planfix.com/partners
Лицензия
MIT
⭐ Star if you build with Planfix — helps other devs find this server.