About megaplan-mcp
megaplan-mcp connects AI clients to Megaplan for managing tasks, deals, projects, employees, and comments through API v3. It also includes two prompts for reviewing today's tasks and creating a deal step by step.
Key features
- 01Filter and search tasks and deals
- 02Create tasks with deadlines
- 03Create deals with pipeline and contact
- 04Browse projects and employees
- 05Read and add comments
- 06Use two task and deal prompts
Use cases
- 01Review active tasks due today
- 02Create a deal with a contact and amount
- 03Find employees or projects by filters
- 04Add comments to a task, deal, or project
MCP support
Exposes Megaplan API v3 operations as MCP tools for tasks, deals, projects, employees, and comments. It supports stdio and Streamable HTTP transports.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @theyahia/megaplan-mcpMEGAPLAN_DOMAINSecretAPI key for the serviceLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
3Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | Results per page |
| offset | integer | No | Offset for pagination |
| search | string | No | Search by task name |
| filter_status | string | No | Filter by status (e.g. active, completed, delayed) |
| filter_responsible_id | string | No | Filter by responsible employee ID |
Details
From the project READMEMCP-сервер для Мегаплана — задачи, сделки и проекты через ИИ
Если вы искали, как подключить Мегаплан к нейросети, ставить задачи и вести сделки не открывая интерфейс — это оно. 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
{
"mcpServers": {
"megaplan": {
"command": "npx",
"args": ["-y", "@theyahia/megaplan-mcp"],
"env": {
"MEGAPLAN_DOMAIN": "yourcompany",
"MEGAPLAN_TOKEN": "your-access-token"
}
}
}
}
Либо через логин и пароль:
{
"mcpServers": {
"megaplan": {
"command": "npx",
"args": ["-y", "@theyahia/megaplan-mcp"],
"env": {
"MEGAPLAN_DOMAIN": "yourcompany",
"MEGAPLAN_LOGIN": "[email protected]",
"MEGAPLAN_PASSWORD": "your-password"
}
}
}
}
Транспорт Streamable HTTP
Запуск с флагом --http включает транспорт поверх HTTP (удобно для удалённых и облачных развёртываний):
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% на регулярной основе:
- Партнёрская программа Мегаплана
- Зарегистрируйтесь партнёром и получите реферальную ссылку
- Каждый приведённый клиент — регулярная доля от его платежей
Разработка
npm install
npm run build
npm test
npm run dev # режим stdio через tsx
npm run start:http # режим HTTP
Лицензия
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.