mcpField
M
megaplan-mcp

megaplan-mcp

ローカル
github.com/theYahia生産性28 週間前に更新

megaplan-mcp について

megaplan-mcpは、API v3を介してAIクライアントをMegaplanに接続し、タスク、取引、プロジェクト、従業員、コメントを管理します。今日のタスク確認と取引作成を支援する2つのプロンプトも含みます。

主な機能

  1. 01タスクと取引の検索・絞り込み
  2. 02期限付きタスクの作成
  3. 03パイプラインと連絡先を指定した取引作成
  4. 04プロジェクトと従業員の一覧
  5. 05コメントの取得と追加
  6. 06タスク・取引向けプロンプト2種

活用シーン

  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

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。