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

PlanfixMCP

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

  • 0 ★ репозитория
  • Последний коммит
MCP-сервер

Расширенный доступ

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

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

alexd73/planfixmcp

Установка

Сервисы

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

npx skillfoxx add mcp/planfixmcp

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

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

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

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

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

Что делает

Сервер строит набор 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

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

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

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

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

Ограничения

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

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

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

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

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

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

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

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

MCP-сервер для Планфикса на REST API v2.0: лиды, задачи, контакты, компании, отчеты и кастомные поля через конфиг

MCP-серверРасширенный доступ11Звезды репозитория
Российский стек

MCP-сервер для Планфикса на Node.js и FastMCP: задачи, проекты, контакты, комментарии и HTTP-транспорт

MCP-серверРасширенный доступ1Звезды репозитория
Российский стек

Неофициальный MCP-сервер для Планфикса с 93 операциями чтения через веб-интерфейс: задачи, комментарии, вебхуки, интеграции

MCP-серверШирокий доступ3Звезды репозитория
Российский стек

Легкий TypeScript MCP-сервер для задач Планфикса: карточка, список с фильтрами, создание, обновление, комментарии и файлы

MCP-серверРасширенный доступ
Российский стек

MCP-сервер Планфикса: задачи, проекты, контакты, комментарии и сотрудники через REST API

MCP-серверШирокий доступ5Звезды репозитория
Российский стек

MCP-сервер для Planfix по STDIO: 58 инструментов для задач, комментариев, чеклистов, проектов и справочников через REST API

MCP-серверРасширенный доступ

Коротко о README

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

Бейдж для README

Сообщить о проблеме