MCP Server

Projects Plus MCP

Model Context Protocol (MCP) を使って、
Claude Desktop、Cursor、Claude CodeなどのAIツールから
Projects+のタスクを直接操作できます。

What is MCP? #

MCP (Model Context Protocol) は、Anthropic が開発した AIツールとアプリケーションを接続するためのオープンプロトコルです。

Projects Plus MCP サーバーを設定すると、以下のことができます:

  • AIツールから直接タスク一覧を確認
  • 自然言語でタスクを作成・更新・完了
  • プロジェクトの進捗をコメントで報告
  • コンテキストを理解した上でのタスク管理支援

Supported AI Tools

Claude Desktop

Anthropicの公式デスクトップアプリ

Cursor

AI搭載コードエディタ

Claude Code

AnthropicのCLIコーディングツール

Continue

オープンソースAIコードアシスタント

Installation #

npxで直接実行できます(インストール不要):

npx -y projects-plus-mcp

または、グローバルインストール:

npm install -g projects-plus-mcp

API Key #

APIキーが必要です

MCPを使用するには、Projects+アプリ内でAPIキーを発行する必要があります。

APIキーの取得手順

  1. Projects+アプリを開く
  2. テーマを選択 → 「AI連携」設定を開く
  3. 「詳細」タブ → 「APIキーを発行・管理」をクリック
  4. 「新しいAPIキーを発行」ボタンをクリック
  5. 発行されたキー(pp_live_...)をコピー

Setup Guides

C Claude Desktop #

Step 1: 設定ファイルを開く

Mac:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Step 2: 以下の内容を追加または更新

{
  "mcpServers": {
    "projects-plus": {
      "command": "npx",
      "args": ["-y", "projects-plus-mcp"],
      "env": {
        "PROJECTS_PLUS_API_KEY": "pp_live_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Step 3: Claude Desktopを再起動

Tip: 設定後、Claude Desktopで「Projects+のタスク一覧を見せて」と話しかけてみてください。

C Cursor #

Step 1: Cursor設定を開く

Cursor → Settings → Features → MCP Servers

Step 2: 「Add MCP Server」をクリック

Step 3: 以下の設定を入力

{
  "name": "projects-plus",
  "command": "npx",
  "args": ["-y", "projects-plus-mcp"],
  "env": {
    "PROJECTS_PLUS_API_KEY": "pp_live_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

Step 4: Cursorを再起動

C Claude Code (CLI) #

Step 1: 設定ファイルを作成または編集

~/.claude/settings.json

Step 2: MCPサーバー設定を追加

{
  "mcpServers": {
    "projects-plus": {
      "command": "npx",
      "args": ["-y", "projects-plus-mcp"],
      "env": {
        "PROJECTS_PLUS_API_KEY": "pp_live_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

または 環境変数を設定:

export PROJECTS_PLUS_API_KEY=pp_live_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

C Continue #

Step 1: Continue設定を開く

~/.continue/config.json

Step 2: MCPサーバー設定を追加

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "projects-plus-mcp"],
          "env": {
            "PROJECTS_PLUS_API_KEY": "pp_live_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
          }
        }
      }
    ]
  }
}

Available Tools #

MCPサーバーは以下のツールを提供します:

ツール名 説明 パラメータ
get_context テーマのコンテキスト(プロジェクト・タスク)を取得 なし
list_tasks タスク一覧を取得 status?, projectId?
get_task タスク詳細を取得 taskId, projectId
create_task 新しいタスクを作成 projectId, title, description?
update_task_status タスクのステータスを更新 taskId, projectId, status
complete_task タスクを完了(アーカイブ) taskId, projectId
add_comment タスクにコメントを追加 taskId, projectId, content
list_projects プロジェクト一覧を取得 status?
create_project 新しいプロジェクトを作成 name, description?, color?
start_session AI作業セッションを開始 ai?
end_session セッションを終了 handoffNote?

Usage Examples #

AIツールで以下のように話しかけるだけで操作できます:

タスク一覧の確認

"Projects+のタスク一覧を見せて"

"アクティブなタスクを教えて"

タスクの作成

"新しいタスク「ログイン機能の実装」を作成して"

"プロジェクトAに「バグ修正」タスクを追加して"

進捗報告

"このタスクに「認証機能を実装しました」とコメントして"

"作業内容をタスクにメモして"

タスクの完了

"このタスクを完了にして"

"タスクXXXをアーカイブして"

Troubleshooting #

MCPサーバーが認識されない

  • 設定ファイルのJSONが正しい形式か確認
  • AIツールを完全に再起動
  • Node.js v18以上がインストールされているか確認

認証エラーが発生する

  • APIキーが正しくコピーされているか確認
  • APIキーが有効か(期限切れでないか)確認
  • 環境変数が正しく設定されているか確認

タスクが見つからない

  • APIキーが正しいテーマのものか確認
  • プロジェクトやタスクがアーカイブされていないか確認

Ready to connect?

Projects+でAPIキーを発行し、お気に入りのAIツールと連携しましょう。