Pleasanter MCP Server

An MCP server for interacting with the Pleasanter low-code/no-code business application platform.

Implem.Pleasanter統合のためのModel Context Protocol (MCP)サーバーです。AIアシスタントがPleasanterのプロジェクトや課題を操作できるようになります。

- 課題管理: 課題の作成、読み取り、更新、削除
- 高度な検索: プロジェクト全体での複雑なフィルタリングと検索
- 分析機能: トレンド分析とプロジェクトステータスサマリー
- バルク操作: 複数課題の効率的な一括処理

- サイト: 利用可能なPleasanterプロジェクトへのアクセス
- ユーザー/グループ/部署: 組織構造情報
- 動的リソース: リアルタイムのプロジェクトステータスと課題データ

- プロジェクトステータスレポート: 自動化されたプロジェクト健全性レポート
- 課題分析: トレンド分析とレコメンデーション
- チーム生産性: パフォーマンス分析と洞察
- 優先タスク特定: 緊急タスクの特定とアクションプラン
- 週次スタンドアップ準備: チームミーティングの準備

- 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

# 必須設定 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キーを生成またはコピー
- アカウントでAPIアクセスが有効になっていることを確認

~/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" } } } }

%APPDATA%\Claude\claude_desktop_config.jsonを編集:

{ "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" } } } }

{ "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" } } } }

{ "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" } } } }

~/.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で以下のプロンプトを試して、MCPサーバーが正常に動作していることを確認してください:

期待される結果: サイト一覧が表示されるか、適切なエラーメッセージが表示される

期待される結果: pleasanter://sites、pleasanter://users等のリソース一覧が表示される

期待される結果: pleasanter_create_issue、pleasanter_get_issues等のツール一覧が表示される

- APIキーが正しく設定されているか確認
- PLEASANTER_BASE_URLが正しいか確認
- Claude Desktopを完全に再起動
- MCPサーバーのログを確認（コンソールエラーなど）

- pleasanter_create_issue: 新しい課題を作成
- pleasanter_get_issues: 課題を検索・取得
- pleasanter_update_issue: 既存の課題を更新
- pleasanter_delete_issue: 課題を削除
- pleasanter_bulk_create_issues: 複数の課題を一括作成

- pleasanter_advanced_search: フィルターを使った複雑な検索
- pleasanter_multi_site_search: 複数プロジェクトの横断検索
- pleasanter_trend_analysis: プロジェクトトレンド分析
- pleasanter_status_summary: プロジェクトステータスサマリー

- pleasanter://sites: 利用可能なプロジェクト一覧
- pleasanter://users: ユーザーディレクトリ
- pleasanter://groups: グループ情報
- pleasanter://depts: 部署構造
- pleasanter://sites/{siteId}/issues: プロジェクト固有の課題
- pleasanter://sites/{siteId}/summary: プロジェクトサマリー
- pleasanter://sites/{siteId}/status: プロジェクトステータス

- project_status_report: 包括的なプロジェクトレポートを生成
- issue_analysis: 課題トレンドを分析し、レコメンデーションを提供
- team_productivity_report: チームパフォーマンス分析
- priority_task_identification: 緊急タスクを特定し、アクションプランを作成
- weekly_standup_preparation: 週次スタンドアップ情報を準備

- PLEASANTER_BASE_URLが正しいことを確認
- APIキーの有効性をチェック
- ネットワーク接続を確認

- APIキーが正しいことを確認
- ユーザーのAPIアクセスが有効になっているかチェック
- ユーザーに必要な権限があることを確認

- サーバーはPleasanterのレート制限を遵守します
- リトライには指数バックオフを実装
- 日次のAPI使用量を監視

詳細なログを表示するには、環境変数でLOG_LEVEL=debugを設定してください。

- Windows Subsystem for Linux (WSL)がインストールされているか確認
- wsl --versionでWSLのバージョンを確認

- Windowsのパスはバックスラッシュ\を使用
- JSON内ではエスケープが必要:\\

- Claude DesktopがMCPサーバーにアクセスできない場合
- Windows Defenderファイアウォールでポートを許可する必要がある場合があります

- APIキーは安全に保管してください
- 設定には環境変数を使用してください
- 適切なアクセス制御を実装してください
- API使用量を監視してください
- 定期的にキーをローテーションしてください

# WSL2 Ubuntu環境でのセットアップ sudo apt update sudo apt install nodejs npm # プロジェクトのセットアップ cd /home/ubuntu/github/Implem.Pleasanter/pleasanter-mcp-server npm install npm run build

# WSL2環境でのPleasanter設定 cp .env.example .env # .envファイルを編集 PLEASANTER_BASE_URL=http://10.255.20.80:50001 PLEASANTER_API_KEY=your-api-key-here

- WSL2のファイルシステムは\\wsl.localhost\Ubuntu\からアクセス可能
- Claude DesktopはWindows側で実行するため、WSLコマンドまたはWSL2パスを使用

PleasanterのWebサーバーとMCPサーバーを含む完全な環境を構築できます：

# 1. 環境変数を設定 cp .env.example .env # .envファイルを編集してPleasanter APIキーを設定 # 2. Docker環境を起動 docker-compose up -d # 3. 初回セットアップの確認 docker-compose logs codedefiner # 4. Webアプリケーションにアクセス # http://localhost:8080 でPleasanterにアクセス # 5. MCPサーバーの動作確認 # http://localhost:3000 でMCPサーバーの状態確認

- pleasanter-web: PleasanterのWebアプリケーション (ポート8080)
- db: PostgreSQLデータベース (ポート5432)
- codedefiner: データベース初期化用 (一回のみ実行)
- mcp-server: MCPサーバー (ポート3000)

# 全サービス停止 docker-compose down # データベースも含めて完全削除 docker-compose down -v # 再構築 docker-compose up --build -d

# 全サービスのログ docker-compose logs # 特定サービスのログ docker-compose logs pleasanter-web docker-compose logs mcp-server

Perform queries and entity operations in your Fibery workspace.

Manage assets, maintenance tasks, workspaces, users, and QR codes directly from ChatGPT, Claude, and other MCP clients.

Automated expense management with a Supabase backend and hierarchical category support.

Unified MCP gateway that loads 150+ AI tools into Claude Desktop via a single Docker command on Windows. Routes tool calls across specialized servers (Business Intelligence, API Hub, Content Automation, Intelligence) with centralized logging and governance. Built for teams without dedicated platform engineers.

556-tool MCP server giving AI agents full access to FutureSense's business platform — invoicing, payroll, accounting, CRM, booking, content creation, website builder, and more.

Turn the spreadsheets running your business into secure applications.

MCP Server for Kingdee K3Cloud (金蝶云星空) — one of the most widely used ERP systems in China. Connects AI assistants (Claude Desktop, Cursor, Cline, Cherry Studio, etc.) to Kingdee ERP via natural language.

Integrate Odoo with Large Language Models (LLMs) for enhanced business process automation.

Integrate with Odoo ERP systems to manage business data and operations. Requires external configuration for connection parameters.

A hosted or self-hosted cloud version of Odoo MCP