本文へ移動

k8o

お問い合わせ

255文字以内で入力してください

GitHub Issueからのお問い合わせもお待ちしております。

Blog

公開: 2026年4月7日(火)更新: 2026年11月9日(月)約9分で読めます

ChromaticでStorybookを公開しMCPサーバーにする

ChromaticにStorybookを公開すると、URLの末尾に/mcpを付けるだけでAIエージェント向けのMCPサーバーになり、別のリポジトリのStorybookもCompositionでまとめられます。設定と今の制限を紹介します。

はじめに

ChromaticはStorybookのメンテナーが提供するクラウドサービスで、Storybookの公開やビジュアルテスト、UIレビューなど多くの機能を備えています。@storybook/addon-mcpを入れたStorybookをChromaticにPublishすると、公開したURLの末尾に/mcpを付けたアドレスが、AIエージェントにコンポーネントの情報を渡すMCPサーバーになります。

storybook buildの出力は、どの静的ホスティングに置いてもコンポーネントを見せられます。Storybookの開発サーバーを立てずにAIエージェントからコンポーネントの情報を引きたいときに、ChromaticへのPublishが効いてきます。Chromaticのパーマリンクは、別のリポジトリのStorybookをまとめて表示するStorybook Compositionの参照先にもそのまま使えます。

たとえば、このサイトで使っているデザインシステム@k8ordo/uiのStorybookは公開設定がPublicなので、Claude Codeの.mcp.jsonに次のように書くだけで使えます。

json
{
  "mcpServers": {
    "storybook-mcp": {
      "url": "https://main--687a213c85e2e4589d8db1bb.chromatic.com/mcp",
      "type": "http"
    }
  }
}

エージェントからdocs-listを呼ぶと、ボタンやフォームなどのコンポーネントの一覧が返ります。docs-showにcomponents-buttons-buttonを渡すと、Buttonのストーリーのコードと、sizeやvariantなどのpropsの型が返ります。

この記事では、Chromaticの機能のうちStorybookのPublishに絞り、MCPサーバーとStorybook Compositionで何ができるかを、このサイトの公開しているStorybookを例に紹介します。UI TestsやUI Reviewといったテスト・レビュー機能には触れません。

StorybookをChromaticにPublishする

ChromaticにStorybookをPublishすると、ビルドされたStorybookがChromaticのCDN上にホスティングされます(Publishの方法はこちら)。CI/CDパイプラインからChromaticのCLIを実行するだけで、ビルドのたびに自動的にStorybookが公開されます。

公開されたStorybookには、ブランチやコミットごとにパーマリンクが生成されます。

  • ブランチ: https://<branch>--<appid>.chromatic.com
  • コミット: https://<commithash>--<appid>.chromatic.com

例えばこのサイトで利用しているデザインシステムのStorybookにはhttps://main--687a213c85e2e4589d8db1bb.chromatic.comで常にアクセスでき、誰でもコンポーネントの最新状態を確認できます。

ChromaticにPublishされたStorybookはデフォルトでプライベートです。Chromaticにサインイン済みのコラボレーターのみがアクセスでき、必要に応じて公開設定に変更することも可能です。なお、Linked projectではリポジトリの公開設定と連動するため、パブリックリポジトリの場合はStorybookも自動的に公開されます。

MCPサーバーとしての活用

@storybook/addon-mcpをStorybookに導入すると、StorybookをMCPサーバーとして利用できるようになります。

ローカルでのMCPサーバー

以下のコマンドでアドオンのインストールから標準的なセットアップまで行います。

bash
pnpm exec storybook add @storybook/addon-mcp

インストール後、Storybookの開発サーバーを起動するとhttp://localhost:6006/mcpでMCPサーバーにアクセスできるようになります。

ChromaticにPublishしてリモートMCPサーバーにする

ローカルのMCPサーバーはStorybookの開発サーバーが起動している間しか利用できません。 また、複数のプロジェクトでStorybookを使っている場合はポートの取り合いが発生し、MCPサーバーのURLが定まらないという問題もありました。

ChromaticにPublishすると、リモートのMCPサーバーとして常時利用可能になります。

通常通りChromaticにビルドをPublishするだけで、リモートMCPサーバーのURLが生成されます。 公開するStorybookのURLがhttps://main--687a213c85e2e4589d8db1bb.chromatic.comであれば、MCPサーバーのURLはhttps://main--687a213c85e2e4589d8db1bb.chromatic.com/mcpです。

はじめにの設定のように、利用するエージェントのMCP設定にURLを登録しておけば、ローカルのStorybookを起動していなくてもコンポーネント情報を参照できます。

Storybookの公開設定がPrivateの場合は、認証の設定を追加する必要があります。Claude CodeではoauthのclientIdに、Chromatic共通の値を書きます(Cursorではauth.client_id、Codexではauth.CLIENT_IDに書きます)。

json
{
  "mcpServers": {
    "storybook-mcp": {
      "url": "https://main--687a213c85e2e4589d8db1bb.chromatic.com/mcp",
      "type": "http",
      "oauth": {
        "clientId": "cdf3737dff9d485485968e50b63fd8b4"
      }
    }
  }
}

初回接続時にChromaticの認証が求められ、認証後はコラボレーターとしてMCPサーバーにアクセスできるようになります。

Chromatic以外のホスティング先を利用する場合は、自分でMCPサーバーを立てる必要があります。 @storybook/mcpパッケージを使ってデプロイし、インフラの管理やアクセス制御も自前で行わなければなりません。 ChromaticにPublishするだけでリモートMCPサーバーが手に入るのは大きな利点です。

リモートMCPサーバーで利用できるツール

Storybook MCPサーバーはDocs、Development、Testingの3つのツールセットを提供していますが、ChromaticにPublishしたリモートMCPサーバーで利用できるのはDocsツールセットのみです。DevelopmentやTestingはローカルのStorybook開発サーバーでのみ利用できます。

Docsツールセットには以下のツールが含まれます。

  • docs-list: 利用可能なコンポーネントとドキュメントの一覧を取得する
  • docs-show: 個別のコンポーネントの詳細(Props情報、ストーリー、使用例など)を参照する
  • docs-show-story: 特定のストーリーのコードとドキュメントを取得する

docs-listで利用可能なコンポーネントを探り、docs-showで詳細を確認し、docs-show-storyでユースケースを深掘りする、というように段階的にコンテキストを深めていく形で利用します。

ローカルではこれに加えて、ストーリーの書き方ガイドやプレビューを提供するDevelopmentツールセットや、ストーリーのテスト実行とアクセシビリティチェックを行うTestingツールセットも利用できます。これらがリモートMCPサーバーでも使えるようになると嬉しいのですが、現状はローカル限定なのが残念です。

MCPサーバーから提供する情報の制御

Storybookはマニフェストと呼ばれるJSON形式のメタデータを自動生成します。 CSFファイルの静的分析やコンポーネントのProps型抽出から、コンポーネント名やProps情報、使用例などを含むメタデータが作られます。Docsツールセットは、主にこれをもとにコンポーネント情報を提供します。

デフォルトではすべてのストーリーがマニフェストに含まれますが、!manifestタグを指定することで特定のコンポーネントやストーリーを除外できます。

tsx
export default {
  component: InternalComponent,
  tags: ['!manifest'],
} satisfies Meta<typeof InternalComponent>;

教育目的のみのストーリーや非推奨のコンポーネントなど、AIエージェントに認識させる必要がないものを除外することで、不要なコンテキストを減らし、エージェントの性能低下を避けやすくなります。

Storybook Compositionによる別リポジトリのStorybook統合

Storybook Compositionは、複数のStorybookを1つのStorybookのUIに統合して表示する機能です。

デザインシステムやコンポーネントライブラリが別リポジトリで管理されている場合、そのStorybookをChromaticにPublishしておくと、自分のStorybookから参照して統合表示できます。

.storybook/main.tsにrefsを追加して、外部のStorybookを参照します。このサイトでは、デザインシステムである@k8ordo/uiのStorybookをCompositionで統合しています。実際の設定は以下のようになっています。

ts
import { defineMain } from '@storybook/react-vite/node';

export default defineMain({
  // ...
  refs: {
    'k8ordo-ui': {
      title: '@k8ordo/ui',
      url: 'https://main--687a213c85e2e4589d8db1bb.chromatic.com',
    },
  },
});

Storybookを起動すると、サイドバーに@k8ordo/uiのコンポーネントが並列表示されます。

Storybookのサイドバーに自分のプロジェクトのコンポーネントと@k8ordo/uiのコンポーネントが並列表示されている

ローカルのコンポーネントと外部のコンポーネントを同時にブラウズでき、フレームワークが異なっていても問題ありません。

MCPサーバーとの連携

MCPサーバーは、Storybook Compositionと組み合わせることもできます。外部のStorybookがマニフェストを生成している場合、refsに登録しておくことで、MCPサーバーが外部のコンポーネント情報もまとめて提供します。AIエージェントがdocs-listを実行すると、自分のプロジェクトのコンポーネントだけでなく、Compositionで統合した外部のコンポーネント情報も取得できます。ソースが複数になると、docs-showとdocs-show-storyには、どのStorybookかを表すstorybookId(自分のものはlocal、外部のものはrefsのキー)を渡します。

このサイトのStorybookで試すと、ローカルの開発サーバーのMCPサーバーでも、ChromaticにPublishしたリモートMCPサーバーでも、docs-listは自分のコンポーネントと@k8ordo/uiのコンポーネントをまとめて返します。storybookIdにk8ordo-uiを渡したdocs-showでは、@k8ordo/uiのButtonの詳細が取れます。

なお、ChromaticのドキュメントではMCPサーバーにStorybook 10.3以上とReactが要るとされています。

おわりに

以前からChromaticにStorybookをPublishしていましたが、当初はStorybookを公開すること自体が目的でした。

しかし、MCPサーバーの登場によってAIエージェントにコンポーネント情報を提供できるようになり、Storybook Compositionによって別リポジトリのデザインシステムも統合して扱えるようになりました。Storybookの静的なホスティングにとどまらず、PublishしたStorybookを起点にした動的な機能が使えるようになっているのは嬉しいです。

現状ではDevelopment・Testingツールセットなど、ローカルのStorybook開発サーバーでしか利用できない機能もあります。これらがリモートMCPサーバーでも利用できるようになる日が楽しみです。

Chromaticはビジュアルテストやレビュー機能が注目されがちですが、Publishするだけでもこれだけの価値があります。まだ試していない方はぜひ導入を検討してみてください。