io.github.theYahia/megaplan-mcp MCP Server

MCP server for Megaplan that manages tasks, deals, and projects via API v3. It exposes tools for working with tasks, deals, projects, employees, and comments, plus two skills related to today’s tasks and creating a deal.

🛠️ Key Features

Uses API v3 for Megaplan integration
8 tools covering: tasks, deals, projects, employees, and comments
Skills: “my tasks for today” and a deal-creation skill

🚀 Use Cases

Create a deal in Megaplan based on a natural-language request (example mentions a deal amount and contact)
Assign and retrieve tasks without opening the Megaplan interface
Manage projects and related records through an AI-driven workflow

⚡ Developer Benefits

Model Context Protocol (MCP) server for Claude integration
TypeScript-oriented project (topics include TypeScript)
Developer-friendly access to Megaplan entities via API v3

⚠️ Limitations

Scope is limited to Megaplan tasks, deals, projects, employees, and comments via API v3
The provided readme excerpt only lists tools/skills at a high level without further implementation details

MCP-сервер для Мегаплана — задачи, сделки и проекты через ИИ

Если вы искали, как подключить Мегаплан к нейросети, ставить задачи и вести сделки не открывая интерфейс — это оно. 8 инструментов поверх API v3: задачи, сделки, проекты, сотрудники и комментарии, плюс 2 навыка — «мои задачи на сегодня» и мастер создания сделки. Пишете «создай сделку на 300 тысяч по этому контакту» — сделка появляется в Мегаплане.

MCP-сервер для системы управления проектами Мегаплан. Задачи, сделки, проекты, сотрудники и комментарии через API v3.

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

Инструмент	Описание
`get_tasks`	Список задач с фильтрами по статусу, ответственному и поиском
`create_task`	Создать задачу с названием, описанием и дедлайном
`get_deals`	Список сделок с фильтрами
`create_deal`	Создать сделку с воронкой, суммой и контактом
`get_projects`	Список проектов с фильтрами
`get_employees`	Список сотрудников с поиском и фильтром по отделу
`get_comments`	Комментарии к задаче, сделке или проекту
`create_comment`	Добавить комментарий к задаче, сделке или проекту

Навыки (Skills / Prompts)

Навык	Описание
`my-tasks-today`	«Мои задачи на сегодня» — активные задачи по срочности
`create-deal-wizard`	«Создай сделку» — пошаговое создание сделки

Настройка

Вариант A: access-токен

В Мегаплане откройте Настройки → Интеграции → API
Сгенерируйте access-токен

Вариант B: логин и пароль

Используйте свои учётные данные Мегаплана (e-mail + пароль).

Подключение к Claude Desktop

json

{
  "mcpServers": {
    "megaplan": {
      "command": "npx",
      "args": ["-y", "@theyahia/megaplan-mcp"],
      "env": {
        "MEGAPLAN_DOMAIN": "yourcompany",
        "MEGAPLAN_TOKEN": "your-access-token"
      }
    }
  }
}

Либо через логин и пароль:

json

{
  "mcpServers": {
    "megaplan": {
      "command": "npx",
      "args": ["-y", "@theyahia/megaplan-mcp"],
      "env": {
        "MEGAPLAN_DOMAIN": "yourcompany",
        "MEGAPLAN_LOGIN": "user@example.com",
        "MEGAPLAN_PASSWORD": "your-password"
      }
    }
  }
}

Транспорт Streamable HTTP

Запуск с флагом --http включает транспорт поверх HTTP (удобно для удалённых и облачных развёртываний):

bash

MEGAPLAN_DOMAIN=yourcompany MEGAPLAN_TOKEN=xxx npx @theyahia/megaplan-mcp --http
# Слушает http://localhost:3000/mcp

Свой порт задаётся переменной окружения PORT.

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

Переменная	Обяз.	Описание
`MEGAPLAN_DOMAIN`	да	Поддомен Мегаплана (например, `yourcompany`)
`MEGAPLAN_TOKEN`	одно из	Bearer access-токен
`MEGAPLAN_LOGIN`	одно из	E-mail для входа (если нет токена)
`MEGAPLAN_PASSWORD`	одно из	Пароль (если нет токена)
`PORT`	нет	HTTP-порт для режима `--http` (по умолчанию 3000)

Партнёрская программа

Реферальное вознаграждение за приведённых клиентов Мегаплана — 20-50% на регулярной основе:

Партнёрская программа Мегаплана
Зарегистрируйтесь партнёром и получите реферальную ссылку
Каждый приведённый клиент — регулярная доля от его платежей

Разработка