mcpField
M
megaplan-mcp

megaplan-mcp

本地服务
github.com/theYahia生产力28 周前更新

关于 megaplan-mcp

megaplan-mcp 通过 API v3 将 AI 客户端连接到 Megaplan,以管理任务、交易、项目、员工和评论。它还提供两个提示词,用于查看今日任务和分步创建交易。

主要功能

  1. 01筛选和搜索任务与交易
  2. 02创建带截止日期的任务
  3. 03创建含销售漏斗和联系人的交易
  4. 04浏览项目和员工
  5. 05读取并添加评论
  6. 06使用两个任务与交易提示词

适用场景

  1. 01查看今日到期的活动任务
  2. 02为联系人创建指定金额的交易
  3. 03按条件查找员工或项目
  4. 04为任务、交易或项目添加评论

MCP 相关

将 Megaplan API v3 操作作为 MCP 工具提供,用于任务、交易、项目、员工和评论管理。支持 stdio 和 Streamable HTTP 传输。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"theyahia-megaplan": {
"command": "npx",
"args": [
"-y",
"@theyahia/megaplan-mcp"
],
"env": {
"MEGAPLAN_DOMAIN": "<MEGAPLAN_DOMAIN>"
}
}
}
}
启动命令npx -y @theyahia/megaplan-mcp
需要配置的环境变量
MEGAPLAN_DOMAIN密钥API key for the service

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@theyahia/megaplan-mcp1.0.0

工具

3

收录的工具列表 · 更新于 2 周前

参数类型必填说明
limitinteger否每页结果数
offsetinteger否分页偏移量
searchstring否按任务名称搜索
filter_statusstring否按状态筛选(例如,进行中、已完成、已延迟)
filter_responsible_idstring否按负责人 ID 筛选

README 原文English

来自项目 README

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

{
  "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


Часть WWmcp · Telegram: @vhodvai

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。