Planfix MCP: как подключить Планфикс к Claude, Cursor и Codex

theYahia/planfix-mcp· Проверено 12.11.2026· 5на GitHub

Подключает агента к Планфиксу через REST API: искать и ставить задачи, добавлять комментарии, вести контакты и проекты, превращать лиды в задачи и запускать отчёты.

2 реализации:

Общий набор из 20 инструментов: задачи, проекты, контакты, комментарии, сотрудники, справочники и файлы по ссылке.

Как подключить

Что сделать до подключения

Node.js с командой npx

API-ключ REST API и субдомен аккаунта Планфикса

PLANFIX_API_KEY

Управление аккаунтом → Доступ к API → REST API → создать ключ

PLANFIX_ACCOUNT

Субдомен: mycompany из mycompany.planfix.com; для planfix.ru задайте ещё PLANFIX_HOST=planfix.ru

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'PLANFIX_API_KEY=<API-ключ Планфикса>' --env 'PLANFIX_ACCOUNT=<субдомен аккаунта>' --transport stdio planfiks \
  -- npx -y @theyahia/planfix-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.planfiks]
command = "npx"
args = ["-y", "@theyahia/planfix-mcp"]

[mcp_servers.planfiks.env]
PLANFIX_API_KEY = "<API-ключ Планфикса>"
PLANFIX_ACCOUNT = "<субдомен аккаунта>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "planfiks": {
      "command": "npx",
      "args": ["-y", "@theyahia/planfix-mcp"],
      "env": {
        "PLANFIX_API_KEY": "<API-ключ Планфикса>",
        "PLANFIX_ACCOUNT": "<субдомен аккаунта>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "planfiks": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@theyahia/planfix-mcp"],
      "env": {
        "PLANFIX_API_KEY": "<API-ключ Планфикса>",
        "PLANFIX_ACCOUNT": "<субдомен аккаунта>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "planfiks": {
      "command": "npx",
      "args": ["-y", "@theyahia/planfix-mcp"],
      "env": {
        "PLANFIX_API_KEY": "<API-ключ Планфикса>",
        "PLANFIX_ACCOUNT": "<субдомен аккаунта>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "planfiks": {
      "command": "npx",
      "args": ["-y", "@theyahia/planfix-mcp"],
      "env": {
        "PLANFIX_API_KEY": "<API-ключ Планфикса>",
        "PLANFIX_ACCOUNT": "<субдомен аккаунта>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "planfiks": {
        "type": "local",
        "command": ["npx", "-y", "@theyahia/planfix-mcp"],
        "environment": {
          "PLANFIX_API_KEY": "<API-ключ Планфикса>",
          "PLANFIX_ACCOUNT": "<субдомен аккаунта>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "planfiks": {
      "command": "npx",
      "args": ["-y", "@theyahia/planfix-mcp"],
      "env": {
        "PLANFIX_API_KEY": "<API-ключ Планфикса>",
        "PLANFIX_ACCOUNT": "<субдомен аккаунта>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "planfiks": {
      "command": "npx",
      "args": ["-y", "@theyahia/planfix-mcp"],
      "env": {
        "PLANFIX_API_KEY": "<API-ключ Планфикса>",
        "PLANFIX_ACCOUNT": "<субдомен аккаунта>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

get_tasksвыводит задачи с фильтрами

get_taskчитает задачу по ID

create_taskставит задачу

update_taskменяет статус, срок, исполнителя

get_contactsвыводит контакты

create_contactсоздаёт контакт или компанию

update_contactобновляет контакт

get_projectsвыводит проекты

get_commentsчитает комментарии к задаче

add_commentдобавляет комментарий

list_usersищет сотрудника по имени

list_directoriesвыводит справочники

list_directory_entriesчитает записи справочника

list_custom_fieldsвыводит кастомные поля

upload_file_from_urlзагружает файл по ссылке

Показано 15 из 20.

Заточен под продажи: лиды, сделки и контакты с поиском по email, телефону и Telegram; сопоставление полей задаётся ID кастомных полей или config.yml.

Как подключить

Что сделать до подключения

Node.js с командой npx

API-токен Планфикса с нужными правами; для работы с лидами — ID кастомных полей (email, телефон, Telegram, клиент, менеджер) и шаблона задачи лида

PLANFIX_TOKEN

API-токен Планфикса с правами на нужные объекты

PLANFIX_ACCOUNT

Имя аккаунта, например yourcompany; для planfix.ru задайте PLANFIX_BASE_URL=https://yourcompany.planfix.ru/rest/

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'PLANFIX_ACCOUNT=<имя аккаунта>' --env 'PLANFIX_TOKEN=<API-токен Планфикса>' --transport stdio planfix-mcp-server \
  -- npx -y @popstas/planfix-mcp-server

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.planfix-mcp-server]
command = "npx"
args = ["-y", "@popstas/planfix-mcp-server"]

[mcp_servers.planfix-mcp-server.env]
PLANFIX_ACCOUNT = "<имя аккаунта>"
PLANFIX_TOKEN = "<API-токен Планфикса>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "planfix-mcp-server": {
      "command": "npx",
      "args": ["-y", "@popstas/planfix-mcp-server"],
      "env": {
        "PLANFIX_ACCOUNT": "<имя аккаунта>",
        "PLANFIX_TOKEN": "<API-токен Планфикса>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "planfix-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@popstas/planfix-mcp-server"],
      "env": {
        "PLANFIX_ACCOUNT": "<имя аккаунта>",
        "PLANFIX_TOKEN": "<API-токен Планфикса>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "planfix-mcp-server": {
      "command": "npx",
      "args": ["-y", "@popstas/planfix-mcp-server"],
      "env": {
        "PLANFIX_ACCOUNT": "<имя аккаунта>",
        "PLANFIX_TOKEN": "<API-токен Планфикса>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "planfix-mcp-server": {
      "command": "npx",
      "args": ["-y", "@popstas/planfix-mcp-server"],
      "env": {
        "PLANFIX_ACCOUNT": "<имя аккаунта>",
        "PLANFIX_TOKEN": "<API-токен Планфикса>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "planfix-mcp-server": {
        "type": "local",
        "command": ["npx", "-y", "@popstas/planfix-mcp-server"],
        "environment": {
          "PLANFIX_ACCOUNT": "<имя аккаунта>",
          "PLANFIX_TOKEN": "<API-токен Планфикса>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "planfix-mcp-server": {
      "command": "npx",
      "args": ["-y", "@popstas/planfix-mcp-server"],
      "env": {
        "PLANFIX_ACCOUNT": "<имя аккаунта>",
        "PLANFIX_TOKEN": "<API-токен Планфикса>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "planfix-mcp-server": {
      "command": "npx",
      "args": ["-y", "@popstas/planfix-mcp-server"],
      "env": {
        "PLANFIX_ACCOUNT": "<имя аккаунта>",
        "PLANFIX_TOKEN": "<API-токен Планфикса>"
      }
    }
  }
}

Инструменты сервера

planfix_search_contactищет контакт по имени, телефону, email

planfix_create_contactсоздаёт контакт

planfix_update_contactобновляет контакт

planfix_search_companyищет компанию

planfix_search_lead_taskищет задачу лида

planfix_create_lead_taskсоздаёт задачу лида

planfix_add_to_lead_taskдополняет лид и контакт

planfix_create_sell_taskсоздаёт задачу продажи

planfix_search_taskищет задачи

planfix_create_taskставит задачу

planfix_create_commentдобавляет комментарий

planfix_get_child_tasksвыводит подзадачи

planfix_search_managerищет менеджера по email

planfix_reports_listвыводит отчёты

planfix_run_reportстроит отчёт

planfix_requestвызывает любой метод REST API

Показано 16 из 22.

Что попросить агента

«Покажи мои задачи в Планфиксе на сегодня»Агент вызовет get_tasks с фильтром по сроку; есть готовый навык skill-my-tasks

«Найди сотрудника Иванов и создай задачу «Подготовить отчёт» в проекте <номер> с ним как исполнителем»Агент найдёт ID через list_users и поставит задачу через create_task

«Добавь комментарий к задаче <номер>: «Готово»»Агент вызовет add_comment

«Заведи лид: <имя>, телефон <телефон>, Telegram <ник>, хочет <товар>»popstas найдёт или создаст контакт через planfix_search_contact и planfix_create_contact и соберёт лид через planfix_add_to_lead_task

Для каких задач

Показать задачи на сегодня и просроченные

Найти сотрудника и поставить ему задачу в проекте

Добавить комментарий к задаче или прочитать обсуждение

Найти клиента по email, телефону или Telegram и завести по нему лид

Создать задачу продажи с привязкой к клиенту и агентству

Запустить отчёт Планфикса и получить результат

Ограничения

Оба сервера сторонние и маленькие: 5 и 11 звёзд на GitHub

В сервере theYahia нет загрузки файлов с диска и учёта времени; priority в create_task передаётся строкой без проверки допустимых значений

Отдельного списка статусов в API нет: системные статусы — фиксированный набор, свои наборы статусов читаются через справочники

У popstas лиды и контакты работают по ID ваших кастомных полей: без них поиск по телефону и Telegram и заполнение лидов не сработают

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Planfix MCP (theYahia)	theYahia	5	локально	токен	20	6 сентября 2026
Planfix MCP Server (popstas)	popstas	11	локально	токен	22	16 июля 2026

Частые вопросы

Какой сервер выбрать?

Для задач, проектов и комментариев — сервер theYahia: подключается двумя переменными. Если вы ведёте в Планфиксе продажи и лиды, popstas умеет искать клиента по email, телефону и Telegram и собирать лид-задачу, но требует ID кастомных полей.

Как подключить аккаунт на planfix.ru?

У theYahia задайте PLANFIX_HOST=planfix.ru рядом с PLANFIX_ACCOUNT. У popstas задайте PLANFIX_BASE_URL=https://<аккаунт>.planfix.ru/rest/.

Как агент меняет статус задачи?

Через update_task. Системные статусы — DRAFT, ACTIVE, ACCEPTED, COMPLETED, DELAYED, REJECTED, DONE, CANCELED; свои наборы статусов агент находит через list_directories и list_directory_entries.

Можно ли вызвать метод, для которого нет инструмента?

Да, у popstas есть planfix_request: он отправляет запрос к любому методу REST API Планфикса.

Работает ли сервер из России?

Серверы работают на вашем компьютере и ходят в REST API вашего аккаунта Планфикса, в том числе на planfix.ru.

Planfix MCP: как подключить Планфикс к Claude, Cursor и Codex

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Какую реализацию выбрать

Частые вопросы

Похожие серверы