# planfix-mcp

Подключает Planfix к ИИ-агенту: задачи, проекты, контакты, комментарии и сотрудники через 20 инструментов. Пишете задачу словами — она появляется в аккаунте.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Автор: theYahia
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/theYahia/planfix-mcp
- Обновлён: 2026-09-06
- HTML: https://affpapa.org/nevibecode/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` по прямой ссылке.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `PLANFIX_TOKEN` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add planfix-mcp -e PLANFIX_TOKEN=<PLANFIX_TOKEN> -- npx -y @theyahia/planfix-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add planfix-mcp --env PLANFIX_TOKEN=<PLANFIX_TOKEN> -- npx -y @theyahia/planfix-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "planfix-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/planfix-mcp"
            ],
            "env": {
                "PLANFIX_TOKEN": "<PLANFIX_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "planfix-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/planfix-mcp"
            ],
            "env": {
                "PLANFIX_TOKEN": "<PLANFIX_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e PLANFIX_TOKEN=<PLANFIX_TOKEN> planfix-mcp npx -y @theyahia/planfix-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- поставить задачу сотруднику, не открывая интерфейс Planfix
- собрать список своих задач на сегодня и просроченных
- найти ID исполнителя по имени перед созданием задачи
- добавить комментарий к задаче по её номеру
- завести контакт или компанию в CRM из разговора с агентом

## Примеры запросов агенту
- Покажи мои задачи в Planfix за сегодня
- Добавь комментарий к задаче 456: «Готово»

## Похожие
- [Reactive Resume](https://affpapa.org/nevibecode/mcp/reactive-resume.md) — MCP-сервер · ★ 44908
- [screenpipe](https://affpapa.org/nevibecode/mcp/screenpipe.md) — MCP-сервер · ★ 22082
- [Inbox Zero](https://affpapa.org/nevibecode/mcp/inbox-zero.md) — MCP-сервер · ★ 12826
- [kaneo](https://affpapa.org/nevibecode/mcp/kaneo.md) — MCP-сервер · ★ 9623
- [Mindwtr](https://affpapa.org/nevibecode/mcp/mindwtr.md) — MCP-сервер · ★ 2330
- [Azure DevOps (ADO)](https://affpapa.org/nevibecode/mcp/azure-devops-ado.md) — MCP-сервер · ★ 2071

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md