Компактный MCP-сервер для Планфикса
Planfix MCP Server
Легкий TypeScript MCP-сервер для задач Планфикса: карточка, список с фильтрами, создание, обновление, комментарии и файлы
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Создает и изменяет задачи, комментарии и файлы в рабочем Планфиксе
- Токен REST API дает доступ ко всем данным аккаунта в рамках выданных прав
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/kitsukata-planfix-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Собрано автоматически, проверьте перед установкой.
Выполните в терминале
claude mcp add --transport stdio --env 'PLANFIX_BASE_URL=<значение PLANFIX_BASE_URL>' --env 'PLANFIX_TOKEN=<ваш PLANFIX_TOKEN>' planfix -- npx tsx src/index.tsИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"planfix": {
"command": "npx",
"args": [
"tsx",
"src/index.ts"
],
"env": {
"PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
"PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
PLANFIX_BASE_URLобязательная- URL аккаунта Planfix, например https://your-account.planfix.ru
PLANFIX_TOKENсекрет, обязательная- Токен REST API Planfix
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"planfix": {
"command": "npx",
"args": [
"tsx",
"src/index.ts"
],
"env": {
"PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
"PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
PLANFIX_BASE_URLобязательная- URL аккаунта Planfix, например https://your-account.planfix.ru
PLANFIX_TOKENсекрет, обязательная- Токен REST API Planfix
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"planfix","type":"stdio","command":"npx","args":["tsx","src/index.ts"],"env":{"PLANFIX_BASE_URL":"<значение PLANFIX_BASE_URL>","PLANFIX_TOKEN":"<ваш PLANFIX_TOKEN>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"planfix": {
"type": "stdio",
"command": "npx",
"args": [
"tsx",
"src/index.ts"
],
"env": {
"PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
"PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
PLANFIX_BASE_URLобязательная- URL аккаунта Planfix, например https://your-account.planfix.ru
PLANFIX_TOKENсекрет, обязательная- Токен REST API Planfix
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add planfix --env 'PLANFIX_BASE_URL=<значение PLANFIX_BASE_URL>' --env 'PLANFIX_TOKEN=<ваш PLANFIX_TOKEN>' -- npx tsx src/index.tsИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.planfix]
command = "npx"
args = ["tsx", "src/index.ts"]
env = { PLANFIX_BASE_URL = "<значение PLANFIX_BASE_URL>", PLANFIX_TOKEN = "<ваш PLANFIX_TOKEN>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
PLANFIX_BASE_URLобязательная- URL аккаунта Planfix, например https://your-account.planfix.ru
PLANFIX_TOKENсекрет, обязательная- Токен REST API Planfix
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
gemini mcp add -s user -e 'PLANFIX_BASE_URL=<значение PLANFIX_BASE_URL>' -e 'PLANFIX_TOKEN=<ваш PLANFIX_TOKEN>' planfix npx tsx src/index.tsИли добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"planfix": {
"command": "npx",
"args": [
"tsx",
"src/index.ts"
],
"env": {
"PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
"PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
PLANFIX_BASE_URLобязательная- URL аккаунта Planfix, например https://your-account.planfix.ru
PLANFIX_TOKENсекрет, обязательная- Токен REST API Planfix
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"planfix": {
"command": "npx",
"args": [
"tsx",
"src/index.ts"
],
"env": {
"PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
"PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
PLANFIX_BASE_URLобязательная- URL аккаунта Planfix, например https://your-account.planfix.ru
PLANFIX_TOKENсекрет, обязательная- Токен REST API Planfix
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"planfix": {
"command": "npx",
"args": [
"tsx",
"src/index.ts"
],
"env": {
"PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
"PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
PLANFIX_BASE_URLобязательная- URL аккаунта Planfix, например https://your-account.planfix.ru
PLANFIX_TOKENсекрет, обязательная- Токен REST API Planfix
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"planfix": {
"command": "npx",
"args": [
"tsx",
"src/index.ts"
],
"env": {
"PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
"PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
PLANFIX_BASE_URLобязательная- URL аккаунта Planfix, например https://your-account.planfix.ru
PLANFIX_TOKENсекрет, обязательная- Токен REST API Planfix
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"planfix": {
"type": "local",
"command": [
"npx",
"tsx",
"src/index.ts"
],
"environment": {
"PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
"PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
PLANFIX_BASE_URLобязательная- URL аккаунта Planfix, например https://your-account.planfix.ru
PLANFIX_TOKENсекрет, обязательная- Токен REST API Planfix
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"planfix": {
"command": "npx",
"args": [
"tsx",
"src/index.ts"
],
"env": {
"PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
"PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
PLANFIX_BASE_URLобязательная- URL аккаунта Planfix, например https://your-account.planfix.ru
PLANFIX_TOKENсекрет, обязательная- Токен REST API Planfix
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"planfix": {
"command": "npx",
"args": [
"tsx",
"src/index.ts"
],
"env": {
"PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
"PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
PLANFIX_BASE_URLобязательная- URL аккаунта Planfix, например https://your-account.planfix.ru
PLANFIX_TOKENсекрет, обязательная- Токен REST API Planfix
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Склонируй репозиторий, выполни npm install, задай PLANFIX_BASE_URL и PLANFIX_TOKEN в .env и запусти сервер командой npm run start.
Другие способы из описания автора
npm install && npm run startУстановка и запуск из исходников после настройки .env.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает десять инструментов для работы с задачами Планфикса через REST API: проверку доступности, получение задачи по номеру, список задач с фильтрами и пагинацией, создание и обновление задач, список фильтров и шаблонов задач, комментарии и файлы задачи, а также список процессов. Проект компактный, без лидов, контактов и отчетов, только задачи.
Для кого. Для небольших команд, которым от Планфикса нужны только операции с задачами и легкий сервер без лишнего.
Подходит, если
- Нужен простой сервер только для задач Планфикса без лидов и контактов
- Нужен TypeScript-проект с понятной сборкой через npm
- Нужны фильтры, шаблоны и файлы задач
Не подходит, если
- Нужны лиды, контакты или отчеты: сервер их не поддерживает
- Нужен уже опубликованный npm-пакет: собирается из исходников
Пример запроса к агенту
Найди в Планфиксе задачу номер 1245 и добавь к ней комментарий о статусе оплатыОграничения
Проект небольшой, без релизов и без публикации в npm, ставится и собирается из исходников. Нужен платный или premium аккаунт Планфикса с доступом к REST API. Лиды, контакты и отчеты не реализованы, только задачи и связанные с ними сущности.
Как отключить. Остановите процесс сервера и удалите его из конфигурации MCP клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| PLANFIX_BASE_URL обязательная | URL аккаунта Планфикса, например https://company.planfix.ru. |
| PLANFIX_TOKEN обязательная, секрет | Токен REST API Планфикса. |
Проверка безопасности
- Создает и изменяет задачи, комментарии и файлы в рабочем Планфиксе
- Токен REST API дает доступ ко всем данным аккаунта в рамках выданных прав
Коротко о README
README на русском кратко перечисляет требования: Node.js 18.20+, платный аккаунт Планфикса с REST API и токен из раздела Управление аккаунтом. Дальше идет таблица из десяти инструментов задач с коротким описанием каждого и стандартные команды установки, запуска и сборки.
Частые вопросы
Нужен ли платный аккаунт Планфикса?
Да, README указывает, что REST API доступен на платном или premium тарифе.
Поддерживаются ли лиды?
Нет, только задачи, их фильтры, шаблоны, комментарии, файлы и процессы.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма