megaplan-mcp について
megaplan-mcpは、API v3を介してAIクライアントをMegaplanに接続し、タスク、取引、プロジェクト、従業員、コメントを管理します。今日のタスク確認と取引作成を支援する2つのプロンプトも含みます。
主な機能
- 01タスクと取引の検索・絞り込み
- 02期限付きタスクの作成
- 03パイプラインと連絡先を指定した取引作成
- 04プロジェクトと従業員の一覧
- 05コメントの取得と追加
- 06タスク・取引向けプロンプト2種
活用シーン
- 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
プロジェクトの 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-токен
- В Мегаплане откройте Настройки → Интеграции → 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 サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。