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

Planfix MCP Server

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

MCP-сервер

Средний риск

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

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

  • Создает и изменяет лиды, задачи, контакты и компании в рабочем Планфиксе
  • Токен API дает доступ ко всем данным аккаунта в рамках выданных прав
Все причины и проверки
Российский стек

popstas/planfix-mcp-server

Установка

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

npx skillfoxx add mcp/planfix-mcp-server

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

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

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

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

claude mcp add --transport stdio --env 'PLANFIX_ACCOUNT=<значение PLANFIX_ACCOUNT>' --env 'PLANFIX_TOKEN=<ваш PLANFIX_TOKEN>' --env 'PLANFIX_FIELD_ID_EMAIL=<значение PLANFIX_FIELD_ID_EMAIL>' --env 'PLANFIX_FIELD_ID_PHONE=<значение PLANFIX_FIELD_ID_PHONE>' planfix -- npx -y @popstas/planfix-mcp-server

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

{
  "mcpServers": {
    "planfix": {
      "command": "npx",
      "args": [
        "-y",
        "@popstas/planfix-mcp-server"
      ],
      "env": {
        "PLANFIX_ACCOUNT": "<значение PLANFIX_ACCOUNT>",
        "PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>",
        "PLANFIX_FIELD_ID_EMAIL": "<значение PLANFIX_FIELD_ID_EMAIL>",
        "PLANFIX_FIELD_ID_PHONE": "<значение PLANFIX_FIELD_ID_PHONE>"
      }
    }
  }
}

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

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

PLANFIX_ACCOUNTобязательная
Your Planfix account name (e.g., yourcompany)
PLANFIX_TOKENсекрет, обязательная
Planfix API token with necessary permissions
PLANFIX_FIELD_ID_EMAILобязательная
Custom field ID for email
PLANFIX_FIELD_ID_PHONEобязательная
Custom field ID for phone
PLANFIX_FIELD_ID_TELEGRAMнеобязательная
Set any value to use the system Telegram field
PLANFIX_FIELD_ID_TELEGRAM_CUSTOMнеобязательная
Custom field ID for Telegram when using the custom field
PLANFIX_FIELD_ID_CLIENTнеобязательная
Custom field ID for client
PLANFIX_FIELD_ID_MANAGERнеобязательная
Custom field ID for manager
PLANFIX_FIELD_ID_AGENCYнеобязательная
Custom field ID for agency
PLANFIX_FIELD_ID_TAGSнеобязательная
Custom field ID for task tags
PLANFIX_FIELD_ID_LEAD_IDнеобязательная
Custom field ID for external lead ID
PLANFIX_LEAD_TEMPLATE_IDнеобязательная
ID of the lead task template
PLANFIX_TASK_TITLE_TEMPLATEнеобязательная
Template for the default lead task title (e.g., {name} - client's task)

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

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

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

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

{
  "mcpServers": {
    "planfix": {
      "command": "npx",
      "args": [
        "-y",
        "@popstas/planfix-mcp-server"
      ],
      "env": {
        "PLANFIX_ACCOUNT": "<значение PLANFIX_ACCOUNT>",
        "PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>",
        "PLANFIX_FIELD_ID_EMAIL": "<значение PLANFIX_FIELD_ID_EMAIL>",
        "PLANFIX_FIELD_ID_PHONE": "<значение PLANFIX_FIELD_ID_PHONE>"
      }
    }
  }
}

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

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

PLANFIX_ACCOUNTобязательная
Your Planfix account name (e.g., yourcompany)
PLANFIX_TOKENсекрет, обязательная
Planfix API token with necessary permissions
PLANFIX_FIELD_ID_EMAILобязательная
Custom field ID for email
PLANFIX_FIELD_ID_PHONEобязательная
Custom field ID for phone
PLANFIX_FIELD_ID_TELEGRAMнеобязательная
Set any value to use the system Telegram field
PLANFIX_FIELD_ID_TELEGRAM_CUSTOMнеобязательная
Custom field ID for Telegram when using the custom field
PLANFIX_FIELD_ID_CLIENTнеобязательная
Custom field ID for client
PLANFIX_FIELD_ID_MANAGERнеобязательная
Custom field ID for manager
PLANFIX_FIELD_ID_AGENCYнеобязательная
Custom field ID for agency
PLANFIX_FIELD_ID_TAGSнеобязательная
Custom field ID for task tags
PLANFIX_FIELD_ID_LEAD_IDнеобязательная
Custom field ID for external lead ID
PLANFIX_LEAD_TEMPLATE_IDнеобязательная
ID of the lead task template
PLANFIX_TASK_TITLE_TEMPLATEнеобязательная
Template for the default lead task title (e.g., {name} - client's task)

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

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

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

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

code --add-mcp '{"name":"planfix","type":"stdio","command":"npx","args":["-y","@popstas/planfix-mcp-server"],"env":{"PLANFIX_ACCOUNT":"<значение PLANFIX_ACCOUNT>","PLANFIX_TOKEN":"<ваш PLANFIX_TOKEN>","PLANFIX_FIELD_ID_EMAIL":"<значение PLANFIX_FIELD_ID_EMAIL>","PLANFIX_FIELD_ID_PHONE":"<значение PLANFIX_FIELD_ID_PHONE>"}}'

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

{
  "servers": {
    "planfix": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@popstas/planfix-mcp-server"
      ],
      "env": {
        "PLANFIX_ACCOUNT": "<значение PLANFIX_ACCOUNT>",
        "PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>",
        "PLANFIX_FIELD_ID_EMAIL": "<значение PLANFIX_FIELD_ID_EMAIL>",
        "PLANFIX_FIELD_ID_PHONE": "<значение PLANFIX_FIELD_ID_PHONE>"
      }
    }
  }
}

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

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

PLANFIX_ACCOUNTобязательная
Your Planfix account name (e.g., yourcompany)
PLANFIX_TOKENсекрет, обязательная
Planfix API token with necessary permissions
PLANFIX_FIELD_ID_EMAILобязательная
Custom field ID for email
PLANFIX_FIELD_ID_PHONEобязательная
Custom field ID for phone
PLANFIX_FIELD_ID_TELEGRAMнеобязательная
Set any value to use the system Telegram field
PLANFIX_FIELD_ID_TELEGRAM_CUSTOMнеобязательная
Custom field ID for Telegram when using the custom field
PLANFIX_FIELD_ID_CLIENTнеобязательная
Custom field ID for client
PLANFIX_FIELD_ID_MANAGERнеобязательная
Custom field ID for manager
PLANFIX_FIELD_ID_AGENCYнеобязательная
Custom field ID for agency
PLANFIX_FIELD_ID_TAGSнеобязательная
Custom field ID for task tags
PLANFIX_FIELD_ID_LEAD_IDнеобязательная
Custom field ID for external lead ID
PLANFIX_LEAD_TEMPLATE_IDнеобязательная
ID of the lead task template
PLANFIX_TASK_TITLE_TEMPLATEнеобязательная
Template for the default lead task title (e.g., {name} - client's task)

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

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

codex mcp add planfix --env 'PLANFIX_ACCOUNT=<значение PLANFIX_ACCOUNT>' --env 'PLANFIX_TOKEN=<ваш PLANFIX_TOKEN>' --env 'PLANFIX_FIELD_ID_EMAIL=<значение PLANFIX_FIELD_ID_EMAIL>' --env 'PLANFIX_FIELD_ID_PHONE=<значение PLANFIX_FIELD_ID_PHONE>' -- npx -y @popstas/planfix-mcp-server

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

[mcp_servers.planfix]
command = "npx"
args = ["-y", "@popstas/planfix-mcp-server"]
env = { PLANFIX_ACCOUNT = "<значение PLANFIX_ACCOUNT>", PLANFIX_TOKEN = "<ваш PLANFIX_TOKEN>", PLANFIX_FIELD_ID_EMAIL = "<значение PLANFIX_FIELD_ID_EMAIL>", PLANFIX_FIELD_ID_PHONE = "<значение PLANFIX_FIELD_ID_PHONE>" }

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

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

PLANFIX_ACCOUNTобязательная
Your Planfix account name (e.g., yourcompany)
PLANFIX_TOKENсекрет, обязательная
Planfix API token with necessary permissions
PLANFIX_FIELD_ID_EMAILобязательная
Custom field ID for email
PLANFIX_FIELD_ID_PHONEобязательная
Custom field ID for phone
PLANFIX_FIELD_ID_TELEGRAMнеобязательная
Set any value to use the system Telegram field
PLANFIX_FIELD_ID_TELEGRAM_CUSTOMнеобязательная
Custom field ID for Telegram when using the custom field
PLANFIX_FIELD_ID_CLIENTнеобязательная
Custom field ID for client
PLANFIX_FIELD_ID_MANAGERнеобязательная
Custom field ID for manager
PLANFIX_FIELD_ID_AGENCYнеобязательная
Custom field ID for agency
PLANFIX_FIELD_ID_TAGSнеобязательная
Custom field ID for task tags
PLANFIX_FIELD_ID_LEAD_IDнеобязательная
Custom field ID for external lead ID
PLANFIX_LEAD_TEMPLATE_IDнеобязательная
ID of the lead task template
PLANFIX_TASK_TITLE_TEMPLATEнеобязательная
Template for the default lead task title (e.g., {name} - client's task)

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

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

{
  "mcpServers": {
    "planfix": {
      "command": "npx",
      "args": [
        "-y",
        "@popstas/planfix-mcp-server"
      ],
      "env": {
        "PLANFIX_ACCOUNT": "<значение PLANFIX_ACCOUNT>",
        "PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>",
        "PLANFIX_FIELD_ID_EMAIL": "<значение PLANFIX_FIELD_ID_EMAIL>",
        "PLANFIX_FIELD_ID_PHONE": "<значение PLANFIX_FIELD_ID_PHONE>"
      }
    }
  }
}

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

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

PLANFIX_ACCOUNTобязательная
Your Planfix account name (e.g., yourcompany)
PLANFIX_TOKENсекрет, обязательная
Planfix API token with necessary permissions
PLANFIX_FIELD_ID_EMAILобязательная
Custom field ID for email
PLANFIX_FIELD_ID_PHONEобязательная
Custom field ID for phone
PLANFIX_FIELD_ID_TELEGRAMнеобязательная
Set any value to use the system Telegram field
PLANFIX_FIELD_ID_TELEGRAM_CUSTOMнеобязательная
Custom field ID for Telegram when using the custom field
PLANFIX_FIELD_ID_CLIENTнеобязательная
Custom field ID for client
PLANFIX_FIELD_ID_MANAGERнеобязательная
Custom field ID for manager
PLANFIX_FIELD_ID_AGENCYнеобязательная
Custom field ID for agency
PLANFIX_FIELD_ID_TAGSнеобязательная
Custom field ID for task tags
PLANFIX_FIELD_ID_LEAD_IDнеобязательная
Custom field ID for external lead ID
PLANFIX_LEAD_TEMPLATE_IDнеобязательная
ID of the lead task template
PLANFIX_TASK_TITLE_TEMPLATEнеобязательная
Template for the default lead task title (e.g., {name} - client's task)

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

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

{
  "mcpServers": {
    "planfix": {
      "command": "npx",
      "args": [
        "-y",
        "@popstas/planfix-mcp-server"
      ],
      "env": {
        "PLANFIX_ACCOUNT": "<значение PLANFIX_ACCOUNT>",
        "PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>",
        "PLANFIX_FIELD_ID_EMAIL": "<значение PLANFIX_FIELD_ID_EMAIL>",
        "PLANFIX_FIELD_ID_PHONE": "<значение PLANFIX_FIELD_ID_PHONE>"
      }
    }
  }
}

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

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

PLANFIX_ACCOUNTобязательная
Your Planfix account name (e.g., yourcompany)
PLANFIX_TOKENсекрет, обязательная
Planfix API token with necessary permissions
PLANFIX_FIELD_ID_EMAILобязательная
Custom field ID for email
PLANFIX_FIELD_ID_PHONEобязательная
Custom field ID for phone
PLANFIX_FIELD_ID_TELEGRAMнеобязательная
Set any value to use the system Telegram field
PLANFIX_FIELD_ID_TELEGRAM_CUSTOMнеобязательная
Custom field ID for Telegram when using the custom field
PLANFIX_FIELD_ID_CLIENTнеобязательная
Custom field ID for client
PLANFIX_FIELD_ID_MANAGERнеобязательная
Custom field ID for manager
PLANFIX_FIELD_ID_AGENCYнеобязательная
Custom field ID for agency
PLANFIX_FIELD_ID_TAGSнеобязательная
Custom field ID for task tags
PLANFIX_FIELD_ID_LEAD_IDнеобязательная
Custom field ID for external lead ID
PLANFIX_LEAD_TEMPLATE_IDнеобязательная
ID of the lead task template
PLANFIX_TASK_TITLE_TEMPLATEнеобязательная
Template for the default lead task title (e.g., {name} - client's task)

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

Бывший Windsurf.

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

{
  "mcpServers": {
    "planfix": {
      "command": "npx",
      "args": [
        "-y",
        "@popstas/planfix-mcp-server"
      ],
      "env": {
        "PLANFIX_ACCOUNT": "<значение PLANFIX_ACCOUNT>",
        "PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>",
        "PLANFIX_FIELD_ID_EMAIL": "<значение PLANFIX_FIELD_ID_EMAIL>",
        "PLANFIX_FIELD_ID_PHONE": "<значение PLANFIX_FIELD_ID_PHONE>"
      }
    }
  }
}

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

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

PLANFIX_ACCOUNTобязательная
Your Planfix account name (e.g., yourcompany)
PLANFIX_TOKENсекрет, обязательная
Planfix API token with necessary permissions
PLANFIX_FIELD_ID_EMAILобязательная
Custom field ID for email
PLANFIX_FIELD_ID_PHONEобязательная
Custom field ID for phone
PLANFIX_FIELD_ID_TELEGRAMнеобязательная
Set any value to use the system Telegram field
PLANFIX_FIELD_ID_TELEGRAM_CUSTOMнеобязательная
Custom field ID for Telegram when using the custom field
PLANFIX_FIELD_ID_CLIENTнеобязательная
Custom field ID for client
PLANFIX_FIELD_ID_MANAGERнеобязательная
Custom field ID for manager
PLANFIX_FIELD_ID_AGENCYнеобязательная
Custom field ID for agency
PLANFIX_FIELD_ID_TAGSнеобязательная
Custom field ID for task tags
PLANFIX_FIELD_ID_LEAD_IDнеобязательная
Custom field ID for external lead ID
PLANFIX_LEAD_TEMPLATE_IDнеобязательная
ID of the lead task template
PLANFIX_TASK_TITLE_TEMPLATEнеобязательная
Template for the default lead task title (e.g., {name} - client's task)

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

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

{
  "mcpServers": {
    "planfix": {
      "command": "npx",
      "args": [
        "-y",
        "@popstas/planfix-mcp-server"
      ],
      "env": {
        "PLANFIX_ACCOUNT": "<значение PLANFIX_ACCOUNT>",
        "PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>",
        "PLANFIX_FIELD_ID_EMAIL": "<значение PLANFIX_FIELD_ID_EMAIL>",
        "PLANFIX_FIELD_ID_PHONE": "<значение PLANFIX_FIELD_ID_PHONE>"
      }
    }
  }
}

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

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

PLANFIX_ACCOUNTобязательная
Your Planfix account name (e.g., yourcompany)
PLANFIX_TOKENсекрет, обязательная
Planfix API token with necessary permissions
PLANFIX_FIELD_ID_EMAILобязательная
Custom field ID for email
PLANFIX_FIELD_ID_PHONEобязательная
Custom field ID for phone
PLANFIX_FIELD_ID_TELEGRAMнеобязательная
Set any value to use the system Telegram field
PLANFIX_FIELD_ID_TELEGRAM_CUSTOMнеобязательная
Custom field ID for Telegram when using the custom field
PLANFIX_FIELD_ID_CLIENTнеобязательная
Custom field ID for client
PLANFIX_FIELD_ID_MANAGERнеобязательная
Custom field ID for manager
PLANFIX_FIELD_ID_AGENCYнеобязательная
Custom field ID for agency
PLANFIX_FIELD_ID_TAGSнеобязательная
Custom field ID for task tags
PLANFIX_FIELD_ID_LEAD_IDнеобязательная
Custom field ID for external lead ID
PLANFIX_LEAD_TEMPLATE_IDнеобязательная
ID of the lead task template
PLANFIX_TASK_TITLE_TEMPLATEнеобязательная
Template for the default lead task title (e.g., {name} - client's task)

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

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

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

{
  "mcp": {
    "planfix": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@popstas/planfix-mcp-server"
      ],
      "environment": {
        "PLANFIX_ACCOUNT": "<значение PLANFIX_ACCOUNT>",
        "PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>",
        "PLANFIX_FIELD_ID_EMAIL": "<значение PLANFIX_FIELD_ID_EMAIL>",
        "PLANFIX_FIELD_ID_PHONE": "<значение PLANFIX_FIELD_ID_PHONE>"
      }
    }
  }
}

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

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

PLANFIX_ACCOUNTобязательная
Your Planfix account name (e.g., yourcompany)
PLANFIX_TOKENсекрет, обязательная
Planfix API token with necessary permissions
PLANFIX_FIELD_ID_EMAILобязательная
Custom field ID for email
PLANFIX_FIELD_ID_PHONEобязательная
Custom field ID for phone
PLANFIX_FIELD_ID_TELEGRAMнеобязательная
Set any value to use the system Telegram field
PLANFIX_FIELD_ID_TELEGRAM_CUSTOMнеобязательная
Custom field ID for Telegram when using the custom field
PLANFIX_FIELD_ID_CLIENTнеобязательная
Custom field ID for client
PLANFIX_FIELD_ID_MANAGERнеобязательная
Custom field ID for manager
PLANFIX_FIELD_ID_AGENCYнеобязательная
Custom field ID for agency
PLANFIX_FIELD_ID_TAGSнеобязательная
Custom field ID for task tags
PLANFIX_FIELD_ID_LEAD_IDнеобязательная
Custom field ID for external lead ID
PLANFIX_LEAD_TEMPLATE_IDнеобязательная
ID of the lead task template
PLANFIX_TASK_TITLE_TEMPLATEнеобязательная
Template for the default lead task title (e.g., {name} - client's task)

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

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

{
  "context_servers": {
    "planfix": {
      "command": "npx",
      "args": [
        "-y",
        "@popstas/planfix-mcp-server"
      ],
      "env": {
        "PLANFIX_ACCOUNT": "<значение PLANFIX_ACCOUNT>",
        "PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>",
        "PLANFIX_FIELD_ID_EMAIL": "<значение PLANFIX_FIELD_ID_EMAIL>",
        "PLANFIX_FIELD_ID_PHONE": "<значение PLANFIX_FIELD_ID_PHONE>"
      }
    }
  }
}

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

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

PLANFIX_ACCOUNTобязательная
Your Planfix account name (e.g., yourcompany)
PLANFIX_TOKENсекрет, обязательная
Planfix API token with necessary permissions
PLANFIX_FIELD_ID_EMAILобязательная
Custom field ID for email
PLANFIX_FIELD_ID_PHONEобязательная
Custom field ID for phone
PLANFIX_FIELD_ID_TELEGRAMнеобязательная
Set any value to use the system Telegram field
PLANFIX_FIELD_ID_TELEGRAM_CUSTOMнеобязательная
Custom field ID for Telegram when using the custom field
PLANFIX_FIELD_ID_CLIENTнеобязательная
Custom field ID for client
PLANFIX_FIELD_ID_MANAGERнеобязательная
Custom field ID for manager
PLANFIX_FIELD_ID_AGENCYнеобязательная
Custom field ID for agency
PLANFIX_FIELD_ID_TAGSнеобязательная
Custom field ID for task tags
PLANFIX_FIELD_ID_LEAD_IDнеобязательная
Custom field ID for external lead ID
PLANFIX_LEAD_TEMPLATE_IDнеобязательная
ID of the lead task template
PLANFIX_TASK_TITLE_TEMPLATEнеобязательная
Template for the default lead task title (e.g., {name} - client's task)

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

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

{
  "mcpServers": {
    "planfix": {
      "command": "npx",
      "args": [
        "-y",
        "@popstas/planfix-mcp-server"
      ],
      "env": {
        "PLANFIX_ACCOUNT": "<значение PLANFIX_ACCOUNT>",
        "PLANFIX_TOKEN": "<ваш PLANFIX_TOKEN>",
        "PLANFIX_FIELD_ID_EMAIL": "<значение PLANFIX_FIELD_ID_EMAIL>",
        "PLANFIX_FIELD_ID_PHONE": "<значение PLANFIX_FIELD_ID_PHONE>"
      }
    }
  }
}

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

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

PLANFIX_ACCOUNTобязательная
Your Planfix account name (e.g., yourcompany)
PLANFIX_TOKENсекрет, обязательная
Planfix API token with necessary permissions
PLANFIX_FIELD_ID_EMAILобязательная
Custom field ID for email
PLANFIX_FIELD_ID_PHONEобязательная
Custom field ID for phone
PLANFIX_FIELD_ID_TELEGRAMнеобязательная
Set any value to use the system Telegram field
PLANFIX_FIELD_ID_TELEGRAM_CUSTOMнеобязательная
Custom field ID for Telegram when using the custom field
PLANFIX_FIELD_ID_CLIENTнеобязательная
Custom field ID for client
PLANFIX_FIELD_ID_MANAGERнеобязательная
Custom field ID for manager
PLANFIX_FIELD_ID_AGENCYнеобязательная
Custom field ID for agency
PLANFIX_FIELD_ID_TAGSнеобязательная
Custom field ID for task tags
PLANFIX_FIELD_ID_LEAD_IDнеобязательная
Custom field ID for external lead ID
PLANFIX_LEAD_TEMPLATE_IDнеобязательная
ID of the lead task template
PLANFIX_TASK_TITLE_TEMPLATEнеобязательная
Template for the default lead task title (e.g., {name} - client's task)

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

Понадобится: Node.js

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

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

Установи и запусти сервер командой PLANFIX_ACCOUNT=вашаорганизация PLANFIX_TOKEN=токен npx @popstas/planfix-mcp-server, для региональной установки .ru дополнительно задай PLANFIX_BASE_URL.

Другие способы из описания автора
PLANFIX_ACCOUNT=yourcompany PLANFIX_TOKEN=token npx @popstas/planfix-mcp-server

Запуск из README, для .ru аккаунтов добавьте PLANFIX_BASE_URL.

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

Что делает

Сервер дает агенту инструменты для работы с Планфиксом: создание и поиск лидов с конвертацией в задачи, управление контактами и компаниями, создание задач и комментариев, генерацию отчетов и произвольный запрос planfix_request к любому методу REST API v2.0. Кастомные поля Планфикса, вроде email, телефона, Telegram, менеджера или источника лида, настраиваются через переменные окружения или файл config.yml, который можно указать отдельно для нескольких аккаунтов. Есть отдельный SSE-сервер, поддержка HTTP-прокси для всех запросов и опциональная интеграция с Chat API Планфикса для создания задач из переписки.

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

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

  • Нужно создать лид или задачу в Планфиксе из диалога с агентом
  • Нужно сопоставить кастомные поля Планфикса (email, телефон, менеджер) с инструментами агента
  • Нужен один сервер сразу для нескольких аккаунтов Планфикса через config.yml

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

  • У вас региональная установка Планфикса .ru без настройки PLANFIX_BASE_URL: по умолчанию сервер идет на .planfix.com
  • Не хотите разбираться с кастомными полями: без них часть инструментов (создание лида, поиск по email) работает не полностью

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

Создай лид в Планфиксе по этому клиенту и переведи его в задачу с комментарием о первом звонке

Ограничения

Часть функциональности зависит от кастомных полей, которые нужно завести в самом Планфиксе и прописать их ID в конфиге. Системное поле дополнительных email в Планфиксе доступно только на чтение через REST API, поэтому запись новых адресов идет в отдельное пользовательское поле, которое нужно создать самостоятельно. Региональные установки (.ru и другие) требуют явной настройки PLANFIX_BASE_URL, иначе сервер обращается к .planfix.com.

Как отключить. Удалите сервер из конфигурации MCP клиента, например claude mcp remove planfix в Claude Code.

MCP

Транспорт
stdio, sse
Авторизация
API-ключ
Переменные окружения
Переменные окружения
PLANFIX_ACCOUNT
обязательная
Имя аккаунта Планфикса, например yourcompany.
PLANFIX_TOKEN
обязательная, секрет
API-токен Планфикса с нужными правами.
PLANFIX_BASE_URL
Адрес REST API для региональных установок, например .planfix.ru.

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

  • Создает и изменяет лиды, задачи, контакты и компании в рабочем Планфиксе
  • Токен API дает доступ ко всем данным аккаунта в рамках выданных прав

Коротко о README

README на английском описывает интеграцию с Планфиксом через REST API v2.0 и авторизацию по Bearer-токену, дает полный список переменных окружения для кастомных полей с пояснениями по системному и пользовательскому полю дополнительного email, пример config.yml с leadTaskFields, contactFields и userFields, а также блок интеграции с Chat API для создания задач из переписки.

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

Как настроить несколько аккаунтов Планфикса?

Через отдельный файл конфига для каждого: переменная PLANFIX_CONFIG указывает на путь, PLANFIX_ACCOUNT переопределяет аккаунт для этого запуска.

Можно вызвать произвольный метод API?

Да, инструмент planfix_request обращается к любому методу REST API v2.0 Планфикса напрямую.

Официальный

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

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

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

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

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

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

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

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

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