English Français العربية

io.github.theYahia/megaplan-mcp

السجل الرسمي أخرى

MCP server for Megaplan — tasks, deals management via API v3.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @theyahia/megaplan-mcp
Claude Code 
claude mcp add megaplan-mcp -e 'MEGAPLAN_DOMAIN=<your megaplan_domain>' -- npx -y @theyahia/megaplan-mcp@1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "megaplan-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/megaplan-mcp@1.0.0"
            ],
            "env": {
                "MEGAPLAN_DOMAIN": "<your megaplan_domain>"
            }
        }
    }
}

متغيرات البيئة

  • MEGAPLAN_DOMAIN إلزامي سري API key for the service

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. MCP-сервер для Мегаплана — задачи, сделки и проекты через ИИ
  2. Инструменты (8)
  3. Навыки (Skills / Prompts)
  4. Настройка
  5. Подключение к Claude Desktop
  6. Транспорт Streamable HTTP
  7. Переменные окружения
  8. Партнёрская программа
  9. Разработка
  10. Лицензия

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

Часть WWmcp · Telegram: @vhodvai

الأسئلة الشائعة

ما هو io.github.theYahia/megaplan-mcp؟

MCP server for Megaplan — tasks, deals management via API v3.

كيف أثبّت io.github.theYahia/megaplan-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add megaplan-mcp -e 'MEGAPLAN_DOMAIN=<your megaplan_domain>' -- npx -y @theyahia/megaplan-mcp@1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.theYahia/megaplan-mcp إلى مفتاح API؟

نعم. يتطلب MEGAPLAN_DOMAIN، وتضبطها في إعداداته.

هل io.github.theYahia/megaplan-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.theYahia/megaplan-mcp؟

ينشره theYahia. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.