mcpField
M
megaplan-mcp

megaplan-mcp

Local
github.com/theYahiaProductivity2Updated 8w ago

About megaplan-mcp

megaplan-mcp connects AI clients to Megaplan for managing tasks, deals, projects, employees, and comments through API v3. It also includes two prompts for reviewing today's tasks and creating a deal step by step.

Key features

  1. 01Filter and search tasks and deals
  2. 02Create tasks with deadlines
  3. 03Create deals with pipeline and contact
  4. 04Browse projects and employees
  5. 05Read and add comments
  6. 06Use two task and deal prompts

Use cases

  1. 01Review active tasks due today
  2. 02Create a deal with a contact and amount
  3. 03Find employees or projects by filters
  4. 04Add comments to a task, deal, or project

MCP support

Exposes Megaplan API v3 operations as MCP tools for tasks, deals, projects, employees, and comments. It supports stdio and Streamable HTTP transports.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"theyahia-megaplan": {
"command": "npx",
"args": [
"-y",
"@theyahia/megaplan-mcp"
],
"env": {
"MEGAPLAN_DOMAIN": "<MEGAPLAN_DOMAIN>"
}
}
}
}
Run commandnpx -y @theyahia/megaplan-mcp
Environment variables to set
MEGAPLAN_DOMAINSecretAPI key for the service

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@theyahia/megaplan-mcp1.0.0

Tools

3

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
limitintegerNoResults per page
offsetintegerNoOffset for pagination
searchstringNoSearch by task name
filter_statusstringNoFilter by status (e.g. active, completed, delayed)
filter_responsible_idstringNoFilter by responsible employee ID

Details

From the project 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.