PensionPro

PensionPro MCP サーバー

AI アシスタントがPensionPro REST API と連携するためのツールを提供する、ローカルで実行できるオープンソースのMCPサーバーです。

機能

• プランの参照と検索 — 名前、ステータス、種類、またはクライアントでプランを検索します。連絡先、サイクル、料金体系を含む包括的なプラン詳細を取得します。
• プロジェクトとタスクのワークフロー — プロジェクトを検索し、タスクの詳細を表示して、タスクの完了・未完了の切り替え、担当者の変更、テンプレートからのプロジェクト作成を行います。
• クライアントと連絡先の参照 — クライアントと連絡先を検索し、関連するプランを含むクライアントの詳細を表示します。
• ToDo の管理 — プラン、プロジェクト、または連絡先に関連付けられた ToDo を検索、作成、更新します。
• メモ — プラン、プロジェクト、タスク、連絡先にメモを追加して取得します。

前提条件

• Python 3.12+
• PensionPro API キーとユーザー名

インストール

PyPIからインストールします。

pip install pension-pro-mcp

または、uvxを使って直接実行します（インストール不要）。

uvx pension-pro-mcp

設定

次の環境変数を設定します。

export PENSION_PRO_API_KEY=your_api_key
export PENSION_PRO_USERNAME=your_username

Claude Desktop

claude_desktop_config.jsonに追加します。

{
  "mcpServers": {
    "pension-pro": {
      "command": "uvx",
      "args": ["pension-pro-mcp"],
      "env": {
        "PENSION_PRO_API_KEY": "your_api_key",
        "PENSION_PRO_USERNAME": "your_username"
      }
    }
  }
}

Claude Code

プロジェクトの.mcp.jsonに追加します。

{
  "mcpServers": {
    "pension-pro": {
      "command": "uvx",
      "args": ["pension-pro-mcp"],
      "env": {
        "PENSION_PRO_API_KEY": "your_api_key",
        "PENSION_PRO_USERNAME": "your_username"
      }
    }
  }
}

利用可能なツール

ツール	説明
search_plans	名前、ステータス、種類、またはクライアントでプランを検索、絞り込みます
get_plan_details	連絡先、サイクル、サービス、投資、料金を含むプランを取得します
get_plan_projects	タスクの完了状況の概要を含む、プランのプロジェクトを取得します
search_projects	ステータス、種類、またはプランでプロジェクトを検索、絞り込みます
get_project_details	タスクグループ、タスク、参加者、メモ、ファイルを含むプロジェクトを取得します
get_task_details	状態、担当者、メモを含む単一のタスクを取得します
complete_task	タスクを完了としてマークします
uncomplete_task	タスクを未完了に戻します
reassign_task	タスクを別の従業員に再割り当てします
create_project_from_template	テンプレートから新しいプロジェクトを作成します
search_clients	会社名でクライアントを検索、絞り込みます
get_client_details	プランとメモを含むクライアントを取得します
search_contacts	名前またはクライアントで連絡先を検索、絞り込みます
search_todos	ToDo を検索、絞り込みます
get_todo	コメントを含む ToDo を取得します
create_todo	エンティティに関連付けられた新しい ToDo を作成します
update_todo	ToDo の詳細を更新します
add_note	プラン、プロジェクト、タスク、または連絡先にメモを追加します
get_notes	エンティティのメモを取得します
search_api_paths	キーワードで PensionPro API エンドポイントを検索します
get_api_endpoint	特定の API エンドポイントの詳細をすべて取得します
search_api_schemas	キーワードで API データモデル／スキーマを検索します
get_api_schema	API データモデルの定義全体を取得します
search_help_articles	キーワードで PensionPro ヘルプセンターの記事を検索します
get_help_article	ヘルプ記事の全文を取得します
list_help_sections	利用可能なヘルプセクションと記事数の一覧を表示します

開発

git clone https://github.com/douglaslinsmeyer/pension-pro-mcp.git
cd pension-pro-mcp
pip install -e ".[dev]"
pytest

ヘルプ記事の更新

同梱されているヘルプ記事は、PensionPro ナレッジベースから更新できます。

python scripts/scrape_docs.py

ライセンス

MIT