关于 megaplan-mcp
megaplan-mcp 通过 API v3 将 AI 客户端连接到 Megaplan,以管理任务、交易、项目、员工和评论。它还提供两个提示词,用于查看今日任务和分步创建交易。
主要功能
- 01筛选和搜索任务与交易
- 02创建带截止日期的任务
- 03创建含销售漏斗和联系人的交易
- 04浏览项目和员工
- 05读取并添加评论
- 06使用两个任务与交易提示词
适用场景
- 01查看今日到期的活动任务
- 02为联系人创建指定金额的交易
- 03按条件查找员工或项目
- 04为任务、交易或项目添加评论
MCP 相关
将 Megaplan API v3 操作作为 MCP 工具提供,用于任务、交易、项目、员工和评论管理。支持 stdio 和 Streamable HTTP 传输。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
3收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 每页结果数 |
| offset | integer | 否 | 分页偏移量 |
| search | string | 否 | 按任务名称搜索 |
| filter_status | string | 否 | 按状态筛选(例如,进行中、已完成、已延迟) |
| filter_responsible_id | string | 否 | 按负责人 ID 筛选 |
README 原文English
来自项目 READMEREADME 暂无中文译文,以下为英文原文;中文介绍见上方。
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": "[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
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。