Claude Media
Claude Code ArtifactsのMCP連携で公開後もライブデータを更新する

Claude Code ArtifactsのMCP連携で公開後もライブデータを更新する

Claude Code ArtifactsはMCPコネクタを宣言でき、公開後も開くたびに最新データを取得します。仕組み・作り方・共有範囲の制約を解説します。

Claude Code Artifactsは、セッションの作業結果をclaude.ai上の非公開Webページとして公開する機能です。v2.1.209以降ではページにMCPコネクタの呼び出しを宣言でき、誰かがページを開くたびに接続先から最新データを取り直します。セッションを閉じた後もダッシュボードやステータスボードが動き続ける、という新しい使い方が生まれました。

Claude Code ArtifactsのMCP連携とは

Claude Code ArtifactsのMCP連携とは、公開済みのページが表示のたびにMCPコネクタを呼び出し、セッションが終わった後も最新データを反映し続ける仕組みです。通常のArtifactはセッションが取得した時点の内容を固めた静的ページですが、コネクタ呼び出しを宣言したページだけは、開かれるたびに外部から値を取り直します。

対象はPro・Max・Team・Enterpriseの各プランで、Claude Code CLI v2.1.209以降が必要です。それより前のバージョンでは、セッションが集めたデータをそのまま埋め込んだページとして公開され、ライブ更新はされません。なお、Artifacts機能自体はもう少し前のバージョンから使えており、コネクタ呼び出しによるライブ更新だけがv2.1.209以降の追加機能という位置づけになります。

要件内容
プラン内容Pro / Max / Team / Enterprise
Claude Codeバージョン内容v2.1.209以降(Artifactsの公開自体はCLI v2.1.183以降、デスクトップアプリはv1.13576.0以降)
ログイン方式内容/loginでのclaude.aiアカウント認証(APIキー・ゲートウェイトークンでのセッションは公開不可)
モデルプロバイダ内容Anthropic API(Bedrock・Google Cloud's Agent Platform・Microsoft Foundry経由は非対応)

組織側でCMEK・HIPAA・ゼロデータ保持のいずれかを有効にしている場合、Artifacts自体が使えません。この制約はコネクタ連携の有無に関わらずかかります。

Claude.aiのArtifactsとは何が違うのか

同じ「Artifacts」という名前でも、claude.aiの会話内で生成されるClaude ProjectsのArtifactsとClaude Code Artifactsは別物です。前者はチャットの応答としてその場に描画されるコード・文書のプレビューで、公開URLを持つとは限りません。後者はClaude CodeのCLIセッションからHTMLまたはMarkdownファイルとして書き出され、claude.aiの専用URLに公開される独立したWebページです。

紛らわしいのは、コネクタ呼び出しのオン・オフを切り替える管理者トグルが両方に共通という点です。claude.aiの会話内で作られたArtifactsとClaude Code Artifactsは、組織設定では同じ「Enable artifact connectors」トグルで扱われます。片方だけ止める設定はありません。

ライブデータ対応のArtifactを作る手順

ページに宣言させたいコネクタと、取得したいデータをプロンプトで具体的に名指しします。

GitHubコネクタ経由でオープンなプルリクエスト一覧を取得し、ページを開くたびに最新化されるダッシュボードArtifactを作って

手順は次の流れです。

  1. コネクタとデータを名指しする: 「〇〇コネクタ経由で」「ページを開くたびに」のように、取得元と更新タイミングを明示します。名指ししないと、Claudeはセッション内で集めた値をそのまま固定ページに埋め込みます。
  2. Claudeがコネクタの宣言を含めて公開する: 公開はセッションの権限モードに従います。Auto modeでは分類器が確認するためプロンプトは出ません。Manual・Accept editsモードでは「connector calls」のような実行時能力を宣言する公開に対して確認が入ります。
  3. 閲覧者が最初のコネクタ呼び出し時に許可を求められる: 呼び出しはページを開いた本人のclaude.aiアカウントを経由します。ページ自身は誰の認証情報も保持しません。
  4. ページはロード時に取得し、任意の間隔や手動更新ボタンで再取得する: 応答は閲覧者のブラウザーにキャッシュされるため、再度開いたときはまずキャッシュから表示し、その後最新の結果に更新されます。

ローカルの.mcp.jsonに登録したMCPサーバーは、Claudeがページを作る過程でのデータ取得には使えますが、公開後のページからは呼び出せません。ライブ更新の対象になるのは、claude.aiアカウント側に登録したコネクタだけです。

公開したページは、ターミナルでCtrl+]を押すといつでも再度開けます。別セッションから改修したいときは、URLをClaudeに渡すか、/artifactsで一覧から呼び出して同じページに紐づけます。呼び出す接続先やコネクタの構成を変えたいときも、この方法で既存のページに追記する形になり、URLを渡さずに新しく依頼すると別のArtifactが生まれてしまいます。

https://claude.ai/code/artifact/5fbea6f3-... のダッシュボードに、GitLabコネクタのIssue件数も追加して

閲覧者ごとにデータが変わる仕組み

コネクタ呼び出しの主体は、ページを公開した本人ではなくそのとき見ている人のアカウントです。3つの挙動を押さえておくと運用で迷いません。

  • 同じダッシュボードを2人が開いても、それぞれの接続先の権限次第で見える中身が変わります。ページ自体は誰の認証情報も見ません。claude.aiが本人に代わって呼び出しを実行します
  • 最初のコネクタ呼び出しの前に、claude.aiが閲覧者へ許可を求めます。拒否した場合や、そのコネクタを未接続の場合でも、ライブ部分が空欄になるだけでページ自体は表示されます
  • コメント投稿やIssue更新のような副作用を伴う操作をページに置いた場合、その操作も操作した人のアカウントで実行されます

社内に配るときは、コネクタが必要なセクションに「〇〇コネクタが必要です」というフォールバック表示を入れるよう指示しておくと、未接続の閲覧者が空白に戸惑わずに済みます。

コネクタ呼び出し自体のネットワーク通信はclaude.ai側が代行するため、ページを公開したセッションの利用枠が閲覧のたびに消費されるわけではありません。何人が開いても、通信の主体は各閲覧者のアカウントに分散します。

公開範囲の制約とよくある原因

ページを開いてもライブ部分が空のままのときは、次の3つを順に確認します。

原因見分け方対処
閲覧者がコネクタを未接続見分け方フォールバック表示が出ている対処Settings > Connectorsで接続してから再読み込み
直前に許可を拒否した見分け方そのページを開いている間だけ空欄が続く対処ページを再読み込みすると許可を聞き直す
組織側でコネクタ呼び出しを無効化見分け方全員のライブ部分が一律で空対処管理者がSettings > Capabilitiesの「Enable artifact connectors」を確認

使い分けの目安は次のとおりです。

用途向いている種類理由
一度きりのPR説明・レポート向いている種類通常のArtifact(スナップショット)理由再取得が要らず、公開リンクにする自由度も高い
開くたびに数字が変わってほしいダッシュボード向いている種類コネクタ連携のArtifact理由表示のたびに接続先を呼び直す
社外の不特定多数と共有したい資料向いている種類通常のArtifact理由コネクタ連携版はどのプランでも公開リンクにできない
社内メンバーに常に最新の状態を見せたい向いている種類コネクタ連携のArtifact(Team・Enterprise)理由組織内共有とライブ更新を両立できる
組織管理者向けの設定

Team・EnterpriseのOwnerは、claude.ai admin settingsの「Settings > Claude Code > Capabilities」でArtifacts自体のオン・オフを切り替えられます。Enterpriseでロールベースのアクセス制御を使っている場合は、ロールごとにArtifacts権限を絞ることも可能です。公開範囲・保持期間はそれぞれ「External sharing」トグルと「Data & privacy controls」で設定し、private状態のものと共有済みのもので保持期間を分けて指定できます。作成・共有・削除の操作はすべてclaude_artifact_*イベントとして監査ログに残り、Compliance APIからも一覧・取得・削除ができます。

よくある質問

claude.aiの会話内で作ったArtifactsもMCP連携できますか

はい。組織のコネクタ呼び出しトグルは、Claude Code Artifactsとclaude.aiの会話内で作られたArtifactsの両方に共通で適用されます。

コネクタを一切使わない普通のArtifactにコネクタ呼び出しの制約は付きますか

付きません。コネクタ呼び出しを宣言していないArtifactは従来どおりスナップショットのページとして扱われ、公開リンクの作成にも制約はかかりません。

閲覧者がコネクタを持っていないとエラーになりますか

エラーにはなりません。該当のライブセクションが空欄で表示されるだけで、ページの他の部分は通常どおり見られます。

ローカルのMCPサーバーのデータを公開後もライブ表示できますか

できません。.mcp.jsonなどでClaude Codeに登録したローカルサーバーは、ページを作る作業中の取得には使えますが、公開後のページ自身が呼び出せるのはclaude.aiアカウント側のコネクタだけです。

公開したArtifactはいつまで残りますか

Team・Enterpriseでは、Owner側の管理設定で保持期間を決められます。非公開のまま自分だけが見ているものと、共有済みのもので別々の期間を設定できるため、社内配布用のダッシュボードだけ長めに残す、といった運用が可能です。

まとめ

Claude Code ArtifactsのMCP連携は、公開したページを「取得済みの記録」から「開くたびに問い合わせる窓口」に変える機能です。ダッシュボードやステータスボードのように更新が続く資料を作るチームに向いていて、閲覧者ごとに見える中身が変わる代わりに、社外への公開リンクは作れません。まずは通常のArtifactで公開の流れに慣れてから、更新が続く資料だけをコネクタ連携に切り替えるのが無理のない進め方です。判断の目安は単純で、「毎回開き直して最新の値を見たいか」がその1点に尽きます。

社内のMCP活用を広げたいならClaude Code SkillsとMCPの違いで機構ごとの役割を、コネクタ呼び出しの要件バージョンであるClaude Code v2.1.209のリリースノートも参照してください。

この記事を共有:XはてブLinkedIn