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