Productplan Mcp Server

1. 設定ファイルを探します：

   • Mac：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. 任意のテキストエディターで開き、次の内容を追加します（your-token を実際の API トークンに置き換えてください）：

Mac/Linux：

{
  "mcpServers": {
    "productplan": {
      "command": "/usr/local/bin/productplan",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

Windows：

{
  "mcpServers": {
    "productplan": {
      "command": "C:\\Tools\\productplan.exe",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

3. Claude Desktop を再起動します

設定ファイルに追加します：

• Mac/Linux：~/.claude.json
• Windows：%USERPROFILE%\.claude.json

Mac/Linux：

{
  "mcpServers": {
    "productplan": {
      "command": "/usr/local/bin/productplan",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

Windows：

{
  "mcpServers": {
    "productplan": {
      "command": "C:\\Tools\\productplan.exe",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

1. Cursor を開きます
2. Settings → MCP Servers に移動します
3. 次の設定を追加します：

Mac/Linux：

{
  "productplan": {
    "command": "/usr/local/bin/productplan",
    "env": {
      "PRODUCTPLAN_API_TOKEN": "your-token"
    }
  }
}

Windows：

{
  "productplan": {
    "command": "C:\\Tools\\productplan.exe",
    "env": {
      "PRODUCTPLAN_API_TOKEN": "your-token"
    }
  }
}

Windows ユーザー向け：パスには二重のバックスラッシュ（\\）を使用してください。JSON ではバックスラッシュがエスケープ文字として扱われるため、これが必要です。

1. Cline 拡張機能をインストールします
2. VS Code の設定（JSON）を開き、次の内容を追加します：

Mac/Linux：

{
  "cline.mcpServers": {
    "productplan": {
      "command": "/usr/local/bin/productplan",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

Windows：

{
  "cline.mcpServers": {
    "productplan": {
      "command": "C:\\Tools\\productplan.exe",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

1. Continue 拡張機能をインストールします
2. 設定ファイルに追加します：
   • Mac/Linux：~/.continue/config.json
   • Windows：%USERPROFILE%\.continue\config.json

Mac/Linux：

{
  "mcpServers": [
    {
      "name": "productplan",
      "command": "/usr/local/bin/productplan",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  ]
}

Windows：

{
  "mcpServers": [
    {
      "name": "productplan",
      "command": "C:\\Tools\\productplan.exe",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  ]
}

1. n8n インスタンスに環境変数を設定します：

   N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
   

2. ワークフローに MCP Client ノードを追加します
3. 次のように設定します：
   • コマンド：
     • Mac/Linux：/usr/local/bin/productplan
     • Windows：C:\Tools\productplan.exe
   • 環境変数：PRODUCTPLAN_API_TOKEN=your-token
4. AI Agent ノードに接続します

ワークフローの例：Slack Trigger → AI Agent (with MCP Client) → Slack Response

productplan-mcp-server/
├── cmd/productplan/main.go      # Entry point: token check, then MCP server or CLI
├── internal/
│   ├── api/                     # ProductPlan API client
│   │   ├── client.go            # HTTP client: auth, rate limiting, error wrapping
│   │   ├── transport.go         # Tuned HTTP transport
│   │   ├── cache.go             # In-process TTL read cache (singleflight, write invalidation)
│   │   ├── list.go              # Paged collection GETs and Ransack query encoding
│   │   ├── ids.go               # Typed resource IDs (BarID, RoadmapID, ...), each validated into a path segment
│   │   ├── path.go              # Routes and request paths built only from typed IDs
│   │   ├── safeseg.go           # Path-segment validation for user-supplied IDs
│   │   ├── endpoints*.go        # Endpoint methods (roadmaps, bars, ideas, launches, OKRs)
│   │   ├── bars_read.go         # Roadmap bars with lane enrichment and client-side filters
│   │   ├── bar_schema.go        # Roadmap legends/lanes/custom fields for bar writes
│   │   └── formatters.go        # Response projection for AI
│   ├── mcp/                     # MCP wiring over the official go-sdk
│   │   ├── sdk_server.go        # Serves the registry via go-sdk (stdio)
│   │   ├── sdk.go               # Converts local Tool -> SDK tool
│   │   ├── handler.go           # Registry: dispatch and panic recovery
│   │   ├── argkeys.go           # Rejects undeclared argument keys (did-you-mean)
│   │   ├── editdistance.go      # Levenshtein distance for suggestions
│   │   └── types.go             # Tool-authoring types
│   ├── tools/                   # Tool definitions and handlers
│   │   ├── registry.go          # Tool registration (name -> handler)
│   │   ├── definitions*.go      # Tool schemas and descriptions
│   │   ├── helpers.go           # typedHandler, manage-action dispatch
│   │   ├── filters.go           # List-tool filters -> Ransack predicates
│   │   ├── formatter.go         # List/item/action response summaries
│   │   ├── item_type.go         # Item nouns for summaries
│   │   ├── bar_planner.go       # Validates bar writes against the roadmap
│   │   ├── bar_names.go         # Legend/lane/custom field name resolution
│   │   ├── bulk_bars.go         # bulk_update/create/delete_bars
│   │   ├── roadmaps.go, bars.go, ideas.go, objectives.go, launches.go, utility.go  # handlers
│   │   └── types*.go            # Typed argument structs for handlers
│   ├── cli/                     # CLI commands (status, roadmaps, etc.)
│   │   └── cli.go
│   └── logging/                 # slog JSON handler setup (ts/level/msg)
│       └── logger.go
├── pkg/productplan/             # Reusable utilities
│   ├── retry.go                 # Exponential backoff with jitter
│   ├── ratelimit.go             # Adaptive rate limiting
│   ├── batch.go                 # Batched operations
│   ├── health.go                # Health reporting
│   ├── requestid.go             # Request tracing
│   ├── validation.go            # ID validation (Field.RequireID)
│   └── errors.go                # APIError and error suggestions
└── evals/                       # LLM evaluation test suite
    ├── runner.go, types.go
    ├── tool_selection.json
    ├── confusion_pairs.json
    └── argument_correctness.json

Go 1.26 以降が必要です。

git clone https://github.com/olgasafonova/productplan-mcp-server.git
cd productplan-mcp-server
go build -o productplan ./cmd/productplan

すべてのプラットフォーム向けにビルドします：

# macOS Apple Silicon
GOOS=darwin GOARCH=arm64 go build -o dist/productplan-darwin-arm64 ./cmd/productplan

# macOS Intel
GOOS=darwin GOARCH=amd64 go build -o dist/productplan-darwin-amd64 ./cmd/productplan

# Linux
GOOS=linux GOARCH=amd64 go build -o dist/productplan-linux-amd64 ./cmd/productplan

# Windows
GOOS=windows GOARCH=amd64 go build -o dist/productplan-windows-amd64.exe ./cmd/productplan

すべてのテストを実行します：

go test ./...

カバレッジ付きで実行します：

go test ./... -cover

ベンチマークを実行します：

go test ./internal/... -bench=. -benchmem

評価スイートを実行します：

./scripts/run-evals.sh

カバレッジ（2026-09-24 測定、go test ./... -cover）：

本番環境用のすべてのファイルは、CodeScene Code Health で 10.0 のスコアを獲得しています（型のみのファイル 2 つはスコアを算出できません）。

利用可能なツールは合計 50 個です：READ ツール 35 個と WRITE ツール 15 個（アクションベースの manage_* が 12 個、バー用の bulk_* が 3 個）です。

読み取りツール：

• ロードマップ：list_roadmaps、get_roadmap、get_roadmap_bars、get_roadmap_lanes、get_roadmap_milestones、get_roadmap_legends、get_roadmap_comments、get_roadmap_complete
• バー：get_bar、get_bar_children、get_bar_comments、get_bar_connections、get_bar_links
• OKR：list_objectives、get_objective、list_key_results、get_key_result
• ディスカバリー：list_ideas、get_idea、list_all_customers、list_all_tags、list_opportunities、get_opportunity、list_idea_forms、get_idea_form
• ローンチ：list_launches、get_launch、get_launch_sections、get_launch_section、get_launch_tasks、get_launch_task
• 管理：check_status、health_check、list_users、list_teams

書き込みツール：

• ロードマップ：manage_bar、manage_lane、manage_milestone
• バーの関連付け：manage_bar_connection、manage_bar_link
• バーの一括操作：bulk_update_bars、bulk_create_bars、bulk_delete_bars（1 回の呼び出しにつき最大 100 個のバーに対応し、事前検証を行います。dry_run をサポートしています）
• OKR：manage_objective、manage_key_result
• ディスカバリー：manage_idea、manage_opportunity
• ローンチ：manage_launch、manage_launch_section、manage_launch_task

例：

{"tool": "list_roadmaps", "arguments": {}}
{"tool": "manage_bar", "arguments": {"action": "create", "roadmap_id": "123", "lane": "Backend", "name": "New feature", "legend": "Committed"}}
{"tool": "bulk_update_bars", "arguments": {"set": {"legend": "Committed"}, "items": [{"bar_id": "901"}, {"bar_id": "902"}], "dry_run": true}}
{"tool": "manage_idea", "arguments": {"action": "create", "name": "Mobile app improvements"}}

このサーバーは、クリーンなレイヤードアーキテクチャを採用しています：

┌──────────────────────────────────────────────────────────────┐
│                        cmd/productplan                        │
│                     (entry point, DI)                         │
└──────────────────────────────────────────────────────────────┘
                              │
        ┌─────────────────────┼─────────────────────┐
        ▼                     ▼                     ▼
┌───────────────┐    ┌───────────────┐    ┌───────────────┐
│  internal/cli │    │  internal/mcp │    │internal/tools │
│  (CLI cmds)   │    │  (MCP / SDK)  │    │  (handlers)   │
└───────────────┘    └───────────────┘    └───────────────┘
                              │                     │
                              └──────────┬──────────┘
                                         ▼
                              ┌───────────────────┐
                              │   internal/api    │
                              │  (HTTP client)    │
                              └───────────────────┘
                                         │
                                         ▼
                              ┌───────────────────┐
                              │  ProductPlan API  │
                              └───────────────────┘

主要なインターフェース：

// Tool handler interface (internal/mcp)
type Handler interface {
    Handle(ctx context.Context, args map[string]any) (json.RawMessage, error)
}

// Logging (internal/logging): a *slog.Logger with a JSON handler on stderr
logger := logging.New(slog.LevelInfo)

ログ形式：

{"ts":"2026-09-24T10:30:00.123456789Z","level":"debug","msg":"API response","endpoint":"/roadmaps/5","status_code":200,"dur_ms":245}