📦 Part of WWmcp — Emerging Markets MCP — 114 MCP servers for non-Western APIs (Brazil/MENA/Gulf/SE Asia/Africa/CIS).

@theyahia/planfix-mcp

MCP-сервер для Planfix API — задачи, проекты, контакты, комментарии, сотрудники, файлы. 20 инструментов, 2 навыка.

Часть серии Russian API MCP (50 серверов) by @theYahia.

Установка

Claude Desktop

{
  "mcpServers": {
    "planfix": {
      "command": "npx",
      "args": ["-y", "@theyahia/planfix-mcp"],
      "env": {
        "PLANFIX_API_KEY": "your-api-key",
        "PLANFIX_ACCOUNT": "your-subdomain"
      }
    }
  }
}

Claude Code

claude mcp add planfix \
  -e PLANFIX_API_KEY=your-api-key \
  -e PLANFIX_ACCOUNT=your-subdomain \
  -- npx -y @theyahia/planfix-mcp

Streamable HTTP (удалённый сервер)

PLANFIX_API_KEY=your-key PLANFIX_ACCOUNT=your-sub npx @theyahia/planfix-mcp --http 8080

Эндпоинт: http://localhost:8080/mcp Health check: http://localhost:8080/health

Smithery

npx -y @smithery/cli install @theyahia/planfix-mcp --client claude

VS Code / Cursor

{
  "servers": {
    "planfix": {
      "command": "npx",
      "args": ["-y", "@theyahia/planfix-mcp"],
      "env": {
        "PLANFIX_API_KEY": "your-api-key",
        "PLANFIX_ACCOUNT": "your-subdomain"
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "planfix": {
      "command": "npx",
      "args": ["-y", "@theyahia/planfix-mcp"],
      "env": {
        "PLANFIX_API_KEY": "your-api-key",
        "PLANFIX_ACCOUNT": "your-subdomain"
      }
    }
  }
}

Авторизация

Переменная	Обязательная	Описание
PLANFIX_API_KEY	Да	API-ключ. Создаётся в Управлении аккаунтом → Доступ к API → REST API
PLANFIX_ACCOUNT	Да	Субдомен (например mycompany из mycompany.planfix.com). Обязателен — общего хоста у REST API нет
PLANFIX_HOST	Нет	Хост для региональных инсталляций (по умолчанию planfix.com; например planfix.ru)
PLANFIX_TOKEN	Нет	Устаревший вариант, используйте PLANFIX_API_KEY

Base URL: https://{PLANFIX_ACCOUNT}.{PLANFIX_HOST}/rest/. Авторизация — заголовок Authorization: Bearer <key>.

Инструменты (20)

Задачи

Инструмент	Описание
get_tasks	Список задач (пагинация, fields, filterId, ad-hoc filters)
get_task	Одна задача по ID
create_task	Создание задачи (можно указать проект, исполнителя — см. list_users)
update_task	Обновление задачи (название, описание, статус, исполнитель)

Контакты

Инструмент	Описание
get_contacts	Список контактов
get_contact	Один контакт по ID
create_contact	Создать контакт или компанию
update_contact	Обновить контакт (имя, email, телефон)

Проекты, комментарии

Инструмент	Описание
get_projects	Список проектов
get_project	Один проект по ID
get_comments	Комментарии к задаче
add_comment	Добавить комментарий к задаче

Сотрудники, справочники, поля, файлы

Инструмент	Описание
list_users	Список сотрудников — используйте для поиска ID исполнителя по имени
get_user	Один сотрудник по ID
list_directories	Справочники (наборы статусов задач хранятся как справочники)
list_directory_entries	Записи справочника по его ID (например, варианты статусов)
list_custom_fields	Ка

... View full README on GitHub