planfix-mcp

📦 属于 WWmcp — Emerging Markets MCP — 面向非西方 API 的 46 个 MCP 服务（巴西／中东和北非／海湾地区／东南亚／非洲／独联体）。

Planfix MCP 服务 — 通过 AI 管理任务、项目和 CRM 联系人

如果你想知道如何将 Planfix 连接到神经网络，不打开界面就能分配任务和梳理项目，答案就在这里。提供 20 个工具和 2 个技能：任务、项目、联系人、评论、员工、文件。输入“给伊万诺夫安排一个周五前完成的任务”，任务就会出现在 Planfix 中。

属于 WWmcp 系列（46 个服务），作者是 @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 健康检查：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.planfix.com 中的 mycompany）。必填，因为 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、临时 filters）
get_task	按 ID 获取单个任务
create_task	创建任务（可指定项目和执行人 — 参见 list_users）
update_task	更新任务（名称、描述、状态、执行人）

联系人

工具	描述
get_contacts	联系人列表
get_contact	按 ID 获取单个联系人
create_contact	创建联系人或公司
update_contact	更新联系人（姓名、电子邮件、电话）

项目、评论

工具	描述
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: "Готово"

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

Сценарий: "Создай задачу 'Звонок клиенту' в 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 install
npm test        # Vitest (32 теста)
npm run dev     # tsx watch
npm run build   # TypeScript compile

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

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

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

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

Лицензия

MIT

---

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

---

Часть WWmcp · Telegram: @vhodvai