io.github.theYahia/megaplan-mcp
MCP server for Megaplan — tasks, deals management via API v3.
Open source Open in the app JSON README (API)
About
MCP server for Megaplan — tasks, deals management via API v3.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- theyahia
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.0
- Stars
- 2
- Forks
- 1
- Open pull requests
- 1
- Last push
- 2026-09-03T04:45:41Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:01:31
- Updated
- 2026-08-29 04:01:31
- Origin id
io.github.theYahia/megaplan-mcp
README
# 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-токен
1. В Мегаплане откройте **Настройки → Интеграции → API**
2. Сгенерируйте 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% на регулярной основе**:
- [Партнёрская программа Мегаплана](https://megaplan.ru/partners/)
- Зарегистрируйтесь партнёром и получите реферальную ссылку
- Каждый приведённый клиент — регулярная доля от его платежей
## Разработка
```bash
npm install
npm run build
npm test
npm run dev # режим stdio через tsx
npm run start:http # режим HTTP
```
## Лицензия
MIT
---
Часть [WWmcp](https://github.com/theYahia/WWmcp) · Telegram: [@vhodvai](https://t.me/vhodvai)