MCP-сервер для Планфикса из OpenAPI-спеки

PlanfixMCP

MCP-сервер для Планфикса на FastMCP: инструменты генерируются из OpenAPI-спеки, есть режим только для чтения и экспорт данных

MCP-сервер

Средний риск

Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.

Почему такой уровень

  • Без включения PLANFIX_READ_ONLY сервер может создавать и изменять задачи, контакты и проекты
  • Токен API дает доступ ко всем данным аккаунта в рамках выданных прав
Все причины и проверки
Российский стек

alexd73/planfixmcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/planfixmcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Собрано автоматически, проверьте перед установкой.

Выполните в терминале

claude mcp add --transport stdio --env 'PLANFIX_BASE_URL=<значение PLANFIX_BASE_URL>' --env 'PLANFIX_API_TOKEN=<ваш PLANFIX_API_TOKEN>' planfix -- uvx run planfix-mcp --env-file .env

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "planfix": {
      "command": "uvx",
      "args": [
        "run",
        "planfix-mcp",
        "--env-file",
        ".env"
      ],
      "env": {
        "PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
        "PLANFIX_API_TOKEN": "<ваш PLANFIX_API_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

PLANFIX_BASE_URLобязательная
Базовый URL REST API ПланФикс
PLANFIX_API_TOKENсекрет, обязательная
Bearer-токен авторизации
PLANFIX_EXCLUDE_TECHNICAL_COMMENTSнеобязательная
Если true, скрывает технические события в ленте комментариев
PLANFIX_READ_ONLYнеобязательная
Если true, включает режим только для чтения
PLANFIX_TAGSнеобязательная
Список тегов OpenAPI для фильтрации инструментов
PLANFIX_EXPORT_DIRнеобязательная
Базовый каталог для выгрузки задач в файлы
PLANFIX_EXPORT_ACCOUNTнеобязательная
Имя аккаунта для имён файлов и frontmatter
PLANFIX_EXPORT_COMMENTS_PER_FILEнеобязательная
Сколько комментариев в одном файле Markdown

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "planfix": {
      "command": "uvx",
      "args": [
        "run",
        "planfix-mcp",
        "--env-file",
        ".env"
      ],
      "env": {
        "PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
        "PLANFIX_API_TOKEN": "<ваш PLANFIX_API_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

PLANFIX_BASE_URLобязательная
Базовый URL REST API ПланФикс
PLANFIX_API_TOKENсекрет, обязательная
Bearer-токен авторизации
PLANFIX_EXCLUDE_TECHNICAL_COMMENTSнеобязательная
Если true, скрывает технические события в ленте комментариев
PLANFIX_READ_ONLYнеобязательная
Если true, включает режим только для чтения
PLANFIX_TAGSнеобязательная
Список тегов OpenAPI для фильтрации инструментов
PLANFIX_EXPORT_DIRнеобязательная
Базовый каталог для выгрузки задач в файлы
PLANFIX_EXPORT_ACCOUNTнеобязательная
Имя аккаунта для имён файлов и frontmatter
PLANFIX_EXPORT_COMMENTS_PER_FILEнеобязательная
Сколько комментариев в одном файле Markdown

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"planfix","type":"stdio","command":"uvx","args":["run","planfix-mcp","--env-file",".env"],"env":{"PLANFIX_BASE_URL":"<значение PLANFIX_BASE_URL>","PLANFIX_API_TOKEN":"<ваш PLANFIX_API_TOKEN>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "planfix": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "run",
        "planfix-mcp",
        "--env-file",
        ".env"
      ],
      "env": {
        "PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
        "PLANFIX_API_TOKEN": "<ваш PLANFIX_API_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

PLANFIX_BASE_URLобязательная
Базовый URL REST API ПланФикс
PLANFIX_API_TOKENсекрет, обязательная
Bearer-токен авторизации
PLANFIX_EXCLUDE_TECHNICAL_COMMENTSнеобязательная
Если true, скрывает технические события в ленте комментариев
PLANFIX_READ_ONLYнеобязательная
Если true, включает режим только для чтения
PLANFIX_TAGSнеобязательная
Список тегов OpenAPI для фильтрации инструментов
PLANFIX_EXPORT_DIRнеобязательная
Базовый каталог для выгрузки задач в файлы
PLANFIX_EXPORT_ACCOUNTнеобязательная
Имя аккаунта для имён файлов и frontmatter
PLANFIX_EXPORT_COMMENTS_PER_FILEнеобязательная
Сколько комментариев в одном файле Markdown

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add planfix --env 'PLANFIX_BASE_URL=<значение PLANFIX_BASE_URL>' --env 'PLANFIX_API_TOKEN=<ваш PLANFIX_API_TOKEN>' -- uvx run planfix-mcp --env-file .env

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.planfix]
command = "uvx"
args = ["run", "planfix-mcp", "--env-file", ".env"]
env = { PLANFIX_BASE_URL = "<значение PLANFIX_BASE_URL>", PLANFIX_API_TOKEN = "<ваш PLANFIX_API_TOKEN>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

PLANFIX_BASE_URLобязательная
Базовый URL REST API ПланФикс
PLANFIX_API_TOKENсекрет, обязательная
Bearer-токен авторизации
PLANFIX_EXCLUDE_TECHNICAL_COMMENTSнеобязательная
Если true, скрывает технические события в ленте комментариев
PLANFIX_READ_ONLYнеобязательная
Если true, включает режим только для чтения
PLANFIX_TAGSнеобязательная
Список тегов OpenAPI для фильтрации инструментов
PLANFIX_EXPORT_DIRнеобязательная
Базовый каталог для выгрузки задач в файлы
PLANFIX_EXPORT_ACCOUNTнеобязательная
Имя аккаунта для имён файлов и frontmatter
PLANFIX_EXPORT_COMMENTS_PER_FILEнеобязательная
Сколько комментариев в одном файле Markdown

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "planfix": {
      "command": "uvx",
      "args": [
        "run",
        "planfix-mcp",
        "--env-file",
        ".env"
      ],
      "env": {
        "PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
        "PLANFIX_API_TOKEN": "<ваш PLANFIX_API_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

PLANFIX_BASE_URLобязательная
Базовый URL REST API ПланФикс
PLANFIX_API_TOKENсекрет, обязательная
Bearer-токен авторизации
PLANFIX_EXCLUDE_TECHNICAL_COMMENTSнеобязательная
Если true, скрывает технические события в ленте комментариев
PLANFIX_READ_ONLYнеобязательная
Если true, включает режим только для чтения
PLANFIX_TAGSнеобязательная
Список тегов OpenAPI для фильтрации инструментов
PLANFIX_EXPORT_DIRнеобязательная
Базовый каталог для выгрузки задач в файлы
PLANFIX_EXPORT_ACCOUNTнеобязательная
Имя аккаунта для имён файлов и frontmatter
PLANFIX_EXPORT_COMMENTS_PER_FILEнеобязательная
Сколько комментариев в одном файле Markdown

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "planfix": {
      "command": "uvx",
      "args": [
        "run",
        "planfix-mcp",
        "--env-file",
        ".env"
      ],
      "env": {
        "PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
        "PLANFIX_API_TOKEN": "<ваш PLANFIX_API_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

PLANFIX_BASE_URLобязательная
Базовый URL REST API ПланФикс
PLANFIX_API_TOKENсекрет, обязательная
Bearer-токен авторизации
PLANFIX_EXCLUDE_TECHNICAL_COMMENTSнеобязательная
Если true, скрывает технические события в ленте комментариев
PLANFIX_READ_ONLYнеобязательная
Если true, включает режим только для чтения
PLANFIX_TAGSнеобязательная
Список тегов OpenAPI для фильтрации инструментов
PLANFIX_EXPORT_DIRнеобязательная
Базовый каталог для выгрузки задач в файлы
PLANFIX_EXPORT_ACCOUNTнеобязательная
Имя аккаунта для имён файлов и frontmatter
PLANFIX_EXPORT_COMMENTS_PER_FILEнеобязательная
Сколько комментариев в одном файле Markdown

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "planfix": {
      "command": "uvx",
      "args": [
        "run",
        "planfix-mcp",
        "--env-file",
        ".env"
      ],
      "env": {
        "PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
        "PLANFIX_API_TOKEN": "<ваш PLANFIX_API_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

PLANFIX_BASE_URLобязательная
Базовый URL REST API ПланФикс
PLANFIX_API_TOKENсекрет, обязательная
Bearer-токен авторизации
PLANFIX_EXCLUDE_TECHNICAL_COMMENTSнеобязательная
Если true, скрывает технические события в ленте комментариев
PLANFIX_READ_ONLYнеобязательная
Если true, включает режим только для чтения
PLANFIX_TAGSнеобязательная
Список тегов OpenAPI для фильтрации инструментов
PLANFIX_EXPORT_DIRнеобязательная
Базовый каталог для выгрузки задач в файлы
PLANFIX_EXPORT_ACCOUNTнеобязательная
Имя аккаунта для имён файлов и frontmatter
PLANFIX_EXPORT_COMMENTS_PER_FILEнеобязательная
Сколько комментариев в одном файле Markdown

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "planfix": {
      "command": "uvx",
      "args": [
        "run",
        "planfix-mcp",
        "--env-file",
        ".env"
      ],
      "env": {
        "PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
        "PLANFIX_API_TOKEN": "<ваш PLANFIX_API_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

PLANFIX_BASE_URLобязательная
Базовый URL REST API ПланФикс
PLANFIX_API_TOKENсекрет, обязательная
Bearer-токен авторизации
PLANFIX_EXCLUDE_TECHNICAL_COMMENTSнеобязательная
Если true, скрывает технические события в ленте комментариев
PLANFIX_READ_ONLYнеобязательная
Если true, включает режим только для чтения
PLANFIX_TAGSнеобязательная
Список тегов OpenAPI для фильтрации инструментов
PLANFIX_EXPORT_DIRнеобязательная
Базовый каталог для выгрузки задач в файлы
PLANFIX_EXPORT_ACCOUNTнеобязательная
Имя аккаунта для имён файлов и frontmatter
PLANFIX_EXPORT_COMMENTS_PER_FILEнеобязательная
Сколько комментариев в одном файле Markdown

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "planfix": {
      "type": "local",
      "command": [
        "uvx",
        "run",
        "planfix-mcp",
        "--env-file",
        ".env"
      ],
      "environment": {
        "PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
        "PLANFIX_API_TOKEN": "<ваш PLANFIX_API_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

PLANFIX_BASE_URLобязательная
Базовый URL REST API ПланФикс
PLANFIX_API_TOKENсекрет, обязательная
Bearer-токен авторизации
PLANFIX_EXCLUDE_TECHNICAL_COMMENTSнеобязательная
Если true, скрывает технические события в ленте комментариев
PLANFIX_READ_ONLYнеобязательная
Если true, включает режим только для чтения
PLANFIX_TAGSнеобязательная
Список тегов OpenAPI для фильтрации инструментов
PLANFIX_EXPORT_DIRнеобязательная
Базовый каталог для выгрузки задач в файлы
PLANFIX_EXPORT_ACCOUNTнеобязательная
Имя аккаунта для имён файлов и frontmatter
PLANFIX_EXPORT_COMMENTS_PER_FILEнеобязательная
Сколько комментариев в одном файле Markdown

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "planfix": {
      "command": "uvx",
      "args": [
        "run",
        "planfix-mcp",
        "--env-file",
        ".env"
      ],
      "env": {
        "PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
        "PLANFIX_API_TOKEN": "<ваш PLANFIX_API_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

PLANFIX_BASE_URLобязательная
Базовый URL REST API ПланФикс
PLANFIX_API_TOKENсекрет, обязательная
Bearer-токен авторизации
PLANFIX_EXCLUDE_TECHNICAL_COMMENTSнеобязательная
Если true, скрывает технические события в ленте комментариев
PLANFIX_READ_ONLYнеобязательная
Если true, включает режим только для чтения
PLANFIX_TAGSнеобязательная
Список тегов OpenAPI для фильтрации инструментов
PLANFIX_EXPORT_DIRнеобязательная
Базовый каталог для выгрузки задач в файлы
PLANFIX_EXPORT_ACCOUNTнеобязательная
Имя аккаунта для имён файлов и frontmatter
PLANFIX_EXPORT_COMMENTS_PER_FILEнеобязательная
Сколько комментариев в одном файле Markdown

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "planfix": {
      "command": "uvx",
      "args": [
        "run",
        "planfix-mcp",
        "--env-file",
        ".env"
      ],
      "env": {
        "PLANFIX_BASE_URL": "<значение PLANFIX_BASE_URL>",
        "PLANFIX_API_TOKEN": "<ваш PLANFIX_API_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

PLANFIX_BASE_URLобязательная
Базовый URL REST API ПланФикс
PLANFIX_API_TOKENсекрет, обязательная
Bearer-токен авторизации
PLANFIX_EXCLUDE_TECHNICAL_COMMENTSнеобязательная
Если true, скрывает технические события в ленте комментариев
PLANFIX_READ_ONLYнеобязательная
Если true, включает режим только для чтения
PLANFIX_TAGSнеобязательная
Список тегов OpenAPI для фильтрации инструментов
PLANFIX_EXPORT_DIRнеобязательная
Базовый каталог для выгрузки задач в файлы
PLANFIX_EXPORT_ACCOUNTнеобязательная
Имя аккаунта для имён файлов и frontmatter
PLANFIX_EXPORT_COMMENTS_PER_FILEнеобязательная
Сколько комментариев в одном файле Markdown

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 26 сент. 2026, коммит 61b1754.

Текст для агента

Установи uv, склонируй репозиторий, выполни uv sync, задай PLANFIX_BASE_URL и PLANFIX_API_TOKEN в .env по README и запусти сервер командой planfix-mcp.

Другие способы из описания автора
git clone <url> && cd PlanfixMCP && uv sync

Установка из README после настройки .env с PLANFIX_BASE_URL и PLANFIX_API_TOKEN.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер строит набор MCP-инструментов для задач, контактов, проектов и комментариев Планфикса, генерируя их из OpenAPI-спеки библиотекой FastMCP.from_openapi, а не описывая вручную. Доступ к REST API настраивается через базовый URL и Bearer-токен, права выбираются в самом Планфиксе через раздел REST API. Отдельно можно включить режим PLANFIX_READ_ONLY, ограничить набор операций через переменные include или exclude и настроить экспорт комментариев в файлы.

Для кого. Для разработчиков, которые хотят держать набор инструментов синхронным со спекой Планфикса и иметь безопасный режим только для чтения.

Подходит, если

  • Нужен MCP-сервер, инструменты которого генерируются из официальной OpenAPI-спеки Планфикса
  • Нужен безопасный режим только для чтения через PLANFIX_READ_ONLY
  • Нужно ограничить набор операций по id через include или exclude

Не подходит, если

  • Нужны готовые MCP-ресурсы и промпты: здесь только инструменты
  • Нужен опубликованный npm или PyPI пакет: устанавливается из исходников через uv

Пример запроса к агенту

Найди все открытые задачи по проекту «Запуск сайта» в Планфиксе и покажи их статусы

Ограничения

Проект без релизов и без публикации пакета, ставится из исходников через uv sync. Так как инструменты генерируются из OpenAPI, их состав и описания зависят от актуальности спеки Планфикса на момент генерации. Требуется REST API токен Планфикса с настроенными правами доступа.

Как отключить. Остановите процесс сервера и удалите его из конфигурации MCP клиента.

MCP

Транспорт
stdio
Авторизация
API-ключ
Переменные окружения
Переменные окружения
PLANFIX_BASE_URL
обязательная
Базовый URL REST API аккаунта, например https://аккаунт.planfix.com/rest.
PLANFIX_API_TOKEN
обязательная, секрет
Bearer-токен REST API Планфикса.
PLANFIX_READ_ONLY
Включает режим только для чтения, отключает мутирующие операции.

Проверка безопасности

  • Без включения PLANFIX_READ_ONLY сервер может создавать и изменять задачи, контакты и проекты
  • Токен API дает доступ ко всем данным аккаунта в рамках выданных прав

Коротко о README

README на русском описывает установку через uv sync, получение Bearer-токена в разделе REST API Планфикса и рекомендуемые права доступа с упором на режим только для чтения. Отдельно описана настройка через .env: базовый URL, токен, ограничение операций и параметры экспорта комментариев в файлы.

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

Как получить токен для сервера?

В Планфиксе: Управление аккаунтом, Интеграции, REST API. Там же выбираются права доступа, рекомендуемый минимум только для чтения.

Можно ли ограничить набор операций?

Да, переменными PLANFIX_INCLUDE_OPERATION_IDS и PLANFIX_EXCLUDE_OPERATION_IDS, либо включив PLANFIX_READ_ONLY.

Официальный

Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента

MCP-серверВысокий риск483Звезды репозитория
Официальный

Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex

ПлагинВысокий рискРоссийский стекБез VPN28Звезды репозитория
Выбор редакции

Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию

MCP-серверВысокий рискРоссийский стекБез VPN
Официальный

Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма

MCP-серверВысокий рискРоссийский стекБез VPN
Foxx AIMCP-сервер для Планфикса из OpenAPI-спеки

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.