# 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)