本文へスキップ
hdknr blog
戻る

Spec Workflow MCP とは? ダッシュボードで仕様を承認しながら進める MCP サーバーの使い方と注意点

Spec Workflow MCP は、AI コーディングエージェントに仕様駆動開発(SDD)の進め方を持ち込む MCP サーバー です。要件 → 設計 → タスクの順に仕様を作ります。特徴は、その一つひとつを Web ダッシュボードや VS Code 拡張から人間が承認する 仕組みです。

ほかの SDD ツールがスラッシュコマンドやスキルとして入るのに対し、Spec Workflow MCP は MCP サーバーとして動きます。そのため、MCP に対応したエージェント(Claude Code、Cursor、Codex など)なら、ほぼ同じ書き方の設定で使えます。

なお、2026 年 11 月時点でメンテナンスが休止しており、npm で入る版には最新の脆弱性修正が入っていません。詳しくは後半の「使う前に知っておきたい注意点」を読んでから導入を判断してください。

この記事では、リポジトリ(Pimzino/spec-workflow-mcp)とドキュメントをもとに、導入方法、仕様の作り方と承認の流れ、ダッシュボード、使う前に知っておきたい注意点を整理します。内容は 2026 年 11 月 13 日時点のものです。

あわせて読みたい関連記事です。

Spec Workflow MCP の概要

項目内容
作者Pimzino 氏(GitHub)
ライセンスGPL-3.0
公開2025 年 8 月
npm パッケージ@pimzino/spec-workflow-mcp(npm の最新は 2.2.5、2026 年 3 月 2 日)
形態MCP サーバー + Web ダッシュボード + VS Code 拡張
ダッシュボードの言語日本語・英語を含む 11 言語

ライセンスが MIT ではなく GPL-3.0 である点は、ほかの SDD ツールとの違いです。ツールとして使うだけなら影響は小さいですが、改変して配布する場合は条件を確かめてください。

導入方法

Claude Code

プロジェクトのパスを指定して、MCP サーバーとして登録します。

claude mcp add spec-workflow npx @pimzino/spec-workflow-mcp@latest -- /path/to/your/project

/path/to/your/project は、自分のプロジェクトの絶対パスに置き換えます(以下の設定例も同じです)。

そのほかのエージェント

Claude Desktop・Cursor・Cline などは、MCP の設定ファイルに次の形で追加します。

{
  "mcpServers": {
    "spec-workflow": {
      "command": "npx",
      "args": ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]
    }
  }
}

Codex では ~/.codex/config.toml に次のように書きます。

[mcp_servers.spec-workflow]
command = "npx"
args = ["-y", "@pimzino/spec-workflow-mcp@latest", "/path/to/your/project"]

ダッシュボードを起動する

ダッシュボードは MCP サーバーとは別に起動します(Configuration)。

npx -y @pimzino/spec-workflow-mcp@latest --dashboard

ポートは --port で指定できます。README は http://localhost:5000 の例ですが、ドキュメントには「指定しなければ空いているポートを自動で選ぶ」という記述もあり、食い違っています。決まったポートで開きたいなら、--port 5000 のように明示してください。

ダッシュボードは 1 つだけ起動すれば、複数のプロジェクトをまとめて表示できます。

Spec Workflow MCP で仕様を作り承認する流れ

チャットで頼む

エージェントのチャットで、自然な言葉で頼みます(README の例)。

Create a spec for user authentication
List my specs
Execute task 1.2 in spec user-auth

エージェントは、MCP サーバーが提供する手順の説明に従って、要件(requirements)→ 設計(design)→ タスク(tasks)の順に文書を作ります。

承認の流れ

文書を作ると、承認の依頼が自動で出ます。人間はダッシュボードか VS Code 拡張で文書を読み、次のどれかを選びます(User Guide)。

操作(画面の表示)日本語意味
Approve承認そのまま受け入れる
Request Changes修正依頼コメントを付けて修正を求める
Reject却下要件からやり直す

修正を求めると、エージェントが文書を直して再び承認を依頼します。承認された文書をもとに、次の段階へ進みます。チャットの中で「OK」と返すのではなく、専用の画面で承認の記録が残る のが、このツールのいちばんの特徴です。

提供する MCP ツール

現在のソースで登録されている MCP ツールは次の 5 つです。

ツール役割
spec-workflow-guide仕様の作り方の手順を説明する
steering-guidesteering 文書の作り方を説明する
spec-status仕様の状態を返す
approvals承認の依頼と状態を扱う
log-implementationタスクの実装記録を残す

ドキュメントのツール一覧(TOOLS-REFERENCE.md)には、これより多くのツールが載っていますが、現在のソースとは合っていません。ドキュメントの更新が追いついていない可能性があります。

作られるファイル

仕様はプロジェクトの .spec-workflow/ の下に作られます。

置き場所内容
.spec-workflow/specs/<仕様名>/requirements.md、design.md、tasks.md
.spec-workflow/steering/プロジェクト全体の知識(product.md、tech.md、structure.md)
.spec-workflow/templates/文書のテンプレート(独自のものに差し替えられる)
.spec-workflow/archive/完了した仕様の保管先

steering 文書は「Create steering documents for my project」のように頼むと作られます。仕様の文書構成(requirements・design・tasks と steering の 3 ファイル)は Kiro とよく似ています。

ダッシュボードと VS Code 拡張

Web ダッシュボード

Web ダッシュボードでは、次の情報の確認と操作ができます。

画面は WebSocket でリアルタイムに更新されます。既定では 127.0.0.1 で待ち受け、外部からは接続できません。

VS Code 拡張

VS Code の拡張「Spec Workflow MCP」を入れると、Web ダッシュボードとほぼ同等の画面をサイドバーで使えます。承認・却下・修正依頼のほか、仕様のアーカイブといった、Web ダッシュボードにはない機能もあります。

code --install-extension Pimzino.spec-workflow-mcp

使う前に知っておきたい注意点

導入する前に、次の点を確かめておくことをおすすめします。

承認を画面で記録できる仕組みは魅力ですが、業務で使うなら、上の点を踏まえてリスクを判断してください。

Kiro・cc-sdd・Spec Kit・OpenSpec との違い

項目Spec Workflow MCPKirocc-sddSpec KitOpenSpec
形態MCP サーバー専用の AI 開発環境エージェントのスキルCLI + スラッシュコマンドエージェントのスキル
ライセンスGPL-3.0商用製品MITMITMIT

承認の記録を画面で残したい、MCP に対応したエージェントならどれでも同じように使いたい、という場合に Spec Workflow MCP が合います。ただし、前の節の注意点を踏まえて判断してください。ほかのツールは、それぞれの紹介記事を参照してください。

まとめ



前の記事
Astro のアーカイブページが遅い原因は View Transition の <style> が 1,121 個だった
次の記事
仕様駆動開発(SDD)とは? 3 つのアプローチ・EARS 記法・Kiro / Spec Kit・TDD との違い