io.github.theYahia/megaplan-mcp
MCP server for Megaplan — tasks, deals management via API v3.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
@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>"
}
}
}
}
Variables d'environnement
MEGAPLAN_DOMAINobligatoire secret API key for the service
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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
Questions fréquentes
Qu'est-ce que io.github.theYahia/megaplan-mcp ?
MCP server for Megaplan — tasks, deals management via API v3.
Comment installer io.github.theYahia/megaplan-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add megaplan-mcp -e 'MEGAPLAN_DOMAIN=<your megaplan_domain>' -- npx -y @theyahia/megaplan-mcp@1.0.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.theYahia/megaplan-mcp ?
Oui. Il attend MEGAPLAN_DOMAIN, à renseigner dans sa configuration.
io.github.theYahia/megaplan-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.theYahia/megaplan-mcp ?
Il est publié par theYahia. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.