Pleasanter MCP サーバー
Implem.Pleasanter統合のためのModel Context Protocol (MCP)サーバーです。AIアシスタントがPleasanterのプロジェクトや課題を操作できるようになります。
機能
ツール
- 課題管理: 課題の作成、読み取り、更新、削除
- 高度な検索: プロジェクト全体での複雑なフィルタリングと検索
- 分析機能: トレンド分析とプロジェクトステータスサマリー
- バルク操作: 複数課題の効率的な一括処理
リソース
- サイト: 利用可能なPleasanterプロジェクトへのアクセス
- ユーザー/グループ/部署: 組織構造情報
- 動的リソース: リアルタイムのプロジェクトステータスと課題データ
プロンプト
- プロジェクトステータスレポート: 自動化されたプロジェクト健全性レポート
- 課題分析: トレンド分析とレコメンデーション
- チーム生産性: パフォーマンス分析と洞察
- 優先タスク特定: 緊急タスクの特定とアクションプラン
- 週次スタンドアップ準備: チームミーティングの準備
インストール
-
サーバーコードのクローンまたはダウンロード
cd pleasanter-mcp-server
-
依存関係のインストール
npm install
-
サーバーのビルド
npm run build
前提条件
- Node.js 18.0.0 以上（推奨: 24.x LTS）
- npm または yarn
- Pleasanter サーバーへのアクセス権限とAPIキー
動作確認済み環境
以下の環境でビルドと動作確認が完了しています：
- OS: Ubuntu 24.04.2 LTS (WSL2)
- Node.js: v24.2.0
- npm: v11.3.0
- TypeScript: v5.8.3
- プラットフォーム: WSL2 on Windows
設定
-
環境ファイルの作成
cp .env.example .env
-
設定の編集
# 必須設定
PLEASANTER_BASE_URL=http://10.255.20.80:50001 # ローカルネットワーク内のPleasanterサーバー
PLEASANTER_API_KEY=your-api-key-here # PleasanterのAPIキー
# オプション設定
PLEASANTER_TIMEOUT=30000
PLEASANTER_RETRIES=3
LOG_LEVEL=info
注意:
- 本番環境ではHTTPSを使用してください
- APIキーは安全に管理し、定期的にローテーションしてください
-
Pleasanter APIキーの取得
- Pleasanterシステムにログイン
- ユーザー設定に移動
- APIキーを生成またはコピー
- アカウントでAPIアクセスが有効になっていることを確認
Claude Desktopでの使用方法
macOS環境
-
Claude Desktop設定に追加
~/Library/Application Support/Claude/claude_desktop_config.json を編集:
{
"mcpServers": {
"pleasanter": {
"command": "node",
"args": ["/path/to/pleasanter-mcp-server/dist/index.js"],
"env": {
"PLEASANTER_BASE_URL": "https://your-pleasanter-server.com",
"PLEASANTER_API_KEY": "your-api-key-here"
}
}
}
}
Windows環境
-
Claude Desktop設定に追加
%APPDATA%\Claude\claude_desktop_config.json を編集:
オプション1: WSLコマンドを使用（推奨）
{
"mcpServers": {
"pleasanter": {
"command": "wsl",
"args": [
"node",
"/home/ubuntu/github/Implem.Pleasanter/pleasanter-mcp-server/dist/index.js"
],
"env": {
"PLEASANTER_BASE_URL": "http://10.255.20.80:50001",
"PLEASANTER_API_KEY": "your-api-key-here",
"PLEASANTER_TIMEOUT": "30000",
"PLEASANTER_RETRIES": "3",
"LOG_LEVEL": "info"
}
}
}
}
オプション2: WSL2パスを直接指定
{
"mcpServers": {
"pleasanter": {
"command": "node",
"args": [
"\\\\wsl.localhost\\Ubuntu\\home\\ubuntu\\github\\Implem.Pleasanter\\pleasanter-mcp-server\\dist\\index.js"
],
"env": {
"PLEASANTER_BASE_URL": "http://10.255.20.80:50001",
"PLEASANTER_API_KEY": "your-api-key-here"
}
}
}
}
オプション3: Windows側にプロジェクトをコピーした場合
{
"mcpServers": {
"pleasanter": {
"command": "node",
"args": ["C:\\path\\to\\pleasanter-mcp-server\\dist\\index.js"],
"env": {
"PLEASANTER_BASE_URL": "http://10.255.20.80:50001",
"PLEASANTER_API_KEY": "your-api-key-here"
}
}
}
}
Linux環境
-
Claude Desktop設定に追加
~/.config/Claude/claude_desktop_config.json を編集:
{
"mcpServers": {
"pleasanter": {
"command": "node",
"args": ["/path/to/pleasanter-mcp-server/dist/index.js"],
"env": {
"PLEASANTER_BASE_URL": "https://your-pleasanter-server.com",
"PLEASANTER_API_KEY": "your-api-key-here"
}
}
}
}
-
Claude Desktopを再起動
-
接続を確認
Claude D
... View full README on GitHub
