Planfix Mcp

📦 Part of WWmcp — Emerging Markets MCP — 46 MCP servers for non-Western APIs (Brazil/MENA/Gulf/SE Asia/Africa/CIS).

MCP-сервер для Planfix — задачи, проекты и CRM-контакты через ИИ

Если вы искали, как подключить Планфикс к нейросети, ставить задачи и разбирать проекты не открывая интерфейс — это оно. 20 инструментов и 2 навыка: задачи, проекты, контакты, комментарии, сотрудники, файлы. Пишете «поставь задачу Иванову до пятницы» — задача появляется в Planfix.

[npm] [License: MIT]

Часть серии WWmcp (46 серверов) 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

[smithery badge]

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"      }    }  }}

Авторизация

Base URL: https://{PLANFIX_ACCOUNT}.{PLANFIX_HOST}/rest/. Авторизация — заголовок Authorization: Bearer <key>.

Инструменты (20)

Задачи

Контакты

Проекты, комментарии

Сотрудники, справочники, поля, файлы

Навыки (Skills / Prompts) (2)

Статусы задач

Отдельного эндпоинта /taskstatus/list в Planfix нет. Системные статусы — фиксированный набор констант: DRAFT, ACTIVE, ACCEPTED, COMPLETED, DELAYED, REJECTED, DONE, CANCELED. Кастомные наборы статусов настраиваются как справочники — перечислить их можно через list_directories → list_directory_entries.

Примеры

Покажи мои задачи в PlanfixНайди сотрудника Иванов и создай задачу "Подготовить отчёт" в проекте 123 с ним как исполнителемСписок контактовПокажи проектыДобавь комментарий к задаче 456: "Готово"

🚀 Демо-промпты

Сценарий: "Создай задачу 'Звонок клиенту' в Planfix, привяжи к сделке #12345"

🤖 Хорошо сочетается с:

• @theyahia/kaiten-mcp
• @theyahia/megaplan-mcp
• @theyahia/yandex-tracker-mcp

Ограничения

• priority в create_task передаётся как строка «как есть» — точные допустимые значения не верифицированы против live API.
• Прямая загрузка файлов с диска (multipart POST /file/) и эндпоинты time-tracking/actions не реализованы (REST-контракт не подтверждён). Доступна загрузка файла по ссылке (upload_file_from_url).

Разработка

npm installnpm test        # Vitest (32 теста)npm run dev     # tsx watchnpm run build   # TypeScript compile

Planfix — реферальная программа

35% бессрочный recurring от всех платежей приведённых клиентов.

• Без сертификации — просто зарегистрируйтесь в партнёрской программе
• Recurring: получаете 35% каждый месяц, пока клиент платит
• Бессрочно: нет ограничений по времени выплат

Подробнее: planfix.com/partners

Лицензия

MIT

⭐ Поставьте звезду, если строите на Planfix — так сервер найдут другие разработчики.

Часть WWmcp · Telegram: @vhodvai