io.github.theYahia/megaplan-mcp
MCP server for Megaplan — tasks, deals management via API v3.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@theyahia/megaplan-mcpclaude mcp add megaplan-mcp -e 'MEGAPLAN_DOMAIN=<your megaplan_domain>' -- npx -y @theyahia/megaplan-mcp@1.0.0
{
"mcpServers": {
"megaplan-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/megaplan-mcp@1.0.0"
],
"env": {
"MEGAPLAN_DOMAIN": "<your megaplan_domain>"
}
}
}
}
Environment variables
MEGAPLAN_DOMAINrequired secret API key for the service
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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
{
"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": "user@example.com",
"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
Frequently asked questions
What is io.github.theYahia/megaplan-mcp?
MCP server for Megaplan — tasks, deals management via API v3.
How do I install io.github.theYahia/megaplan-mcp?
It runs on your machine. In Claude Code: claude mcp add megaplan-mcp -e 'MEGAPLAN_DOMAIN=<your megaplan_domain>' -- npx -y @theyahia/megaplan-mcp@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.theYahia/megaplan-mcp need an API key?
Yes. It expects MEGAPLAN_DOMAIN, which you set in its configuration.
Is io.github.theYahia/megaplan-mcp open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.theYahia/megaplan-mcp?
It is published by theYahia. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.