MCP-сервер для Планфикса из OpenAPI-спеки
PlanfixMCP
MCP-сервер для Планфикса на FastMCP: инструменты генерируются из OpenAPI-спеки, есть режим только для чтения и экспорт данных
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Без включения PLANFIX_READ_ONLY сервер может создавать и изменять задачи, контакты и проекты
- Токен API дает доступ ко всем данным аккаунта в рамках выданных прав
Установка
В терминале, через 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/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
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
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, склонируй репозиторий, выполни 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 из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма