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キーの取得手順
- Projects+アプリを開く
- テーマを選択 → 「AI連携」設定を開く
- 「詳細」タブ → 「APIキーを発行・管理」をクリック
- 「新しいAPIキーを発行」ボタンをクリック
- 発行されたキー(
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ツールと連携しましょう。