artifyde-mcp

artifyde-mcp

エージェントが生成した HTML 成果物の恒久的な保存場所 — MCP 経由で。

エージェントは、ダッシュボード、プロトタイプ、レポート、プレゼンテーションなど、レンダリング済み HTML として実際に使える完成品を生成します。通常、こうした成果物は一時的なものです。消えてしまう localhost のリンク、フォルダー内のファイル、次回の実行で失われるものなどです。この Model Context Protocol サーバーは、それぞれの成果物に Artifyde 上の恒久的な保存場所を提供します。エージェントが MCP ホストを離れることなく、誰でも開いて共有し、マークアップを追加でき、再公開のたびにバージョン管理される安定したリンクです。

Artifyde API をラップしているため、MCP 対応のクライアント（Claude Desktop、Claude Code、Cursor など）から成果物を直接公開・管理できます。

インストール

サーバーは stdio 経由で実行され、npx で起動するため、グローバルにインストールする必要はありません。MCP ホストの設定に追加してください。

Claude Code

claude mcp add artifyde --scope user -e ARTIFYDE_TOKEN=vk_your_login_token -- npx -y artifyde-mcp

すでに artifyde CLI を使っている場合は、トークンを貼り付ける代わりに、保存先から直接取得できます。

claude mcp add artifyde --scope user \
  -e ARTIFYDE_TOKEN="$(jq -r '.servers["https://artifyde.com"].token' ~/.config/artifyde/config.json)" \
  -- npx -y artifyde-mcp

--scope user を指定すると、すべてのプロジェクトで利用できます。省略すると、現在のプロジェクトにのみ追加されます。ツールを表示するには、Claude Code を再起動するか、/mcp を実行してください。

Claude Desktop

ワンクリックバンドルをインストールします。最新リリースから artifyde-mcp.mcpb をダウンロードして開き（Settings → Extensions）、拡張機能の設定にトークンを貼り付けてください。または、以下の JSON ブロックを claude_desktop_config.json に追加してください。

OpenAI Codex

codex mcp add artifyde --env ARTIFYDE_TOKEN=vk_your_login_token -- npx -y artifyde-mcp

または、~/.codex/config.toml に追加します（Codex CLI と IDE 拡張機能で共有されます）。

[mcp_servers.artifyde]
command = "npx"
args = ["-y", "artifyde-mcp"]

[mcp_servers.artifyde.env]
ARTIFYDE_TOKEN = "vk_your_login_token"

Cursor ／その他の MCP ホスト

mcpServers の JSON ブロックを受け付けるホストであれば、どれでも利用できます。

{
  "mcpServers": {
    "artifyde": {
      "command": "npx",
      "args": ["-y", "artifyde-mcp"],
      "env": {
        "ARTIFYDE_TOKEN": "vk_your_login_token"
      }
    }
  }
}

認証

env に次のいずれかの認証情報を設定します。

• ARTIFYDE_TOKEN — ユーザーごとのログイントークン（vk_…）です。CLI（npm i -g artifyde-cli）をインストールし、artifyde login を実行して、~/.config/artifyde/config.json からトークンをコピーしてください。推奨される方法です。この場合、サーバーはあなたとして動作します。
• ARTIFYDE_API_KEY — 管理者用の共有オーナーキーです（セルフホストインスタンス上のプログラムやエージェントの ID に使用します）。両方が設定されている場合は、ベアラートークンが優先されます。

認証情報がなくてもサーバーは起動し、公開ページを読み取れます。公開や非公開ページへのアクセスには認証情報が必要です。

デフォルトでは、サーバーはホスト型インスタンス https://artifyde.com と通信します。ARTIFYDE_URL を設定すると、別のインスタンス（セルフホストまたはプレビュー用など）を指定できます。

ツール

ツール	内容
push_artifact	HTML を公開し、安定した表示 URL を取得します。page_id を指定して再度プッシュすると、バージョンが追加されます。
pull_artifact	バージョンの HTML をバイト単位で正確にダウンロードします。
get_page	ページのメタデータとバージョン履歴を取得します。
list_pages	バージョン数・コメント数とともに、自分のページを一覧表示します（アーカイブ状態またはクエリで絞り込み可能）。
rename_page	ページの表示タイトルを設定します。
archive_page / unarchive_page	ページを非表示にする／元に戻します（アーカイブ中は読み取り専用です）。
get_share	ページの公開範囲と招待済みメールアドレスの一覧を取得します。
set_visibility	ページを public または private に設定します。
share_page / unshare_page	非公開ページにメールアドレスを招待する／招待を取り消します。
list_comments	ページのコメントスレッドを読み取ります。
create_comment	バージョンにコメント（または返信）を投稿します。
list_shelves / create_shelf	ギャラリーのグループ分けを管理します。
add_page_to_shelf / remove_page_from_shelf	ページをシェルフに追加／シェルフから削除して整理します。
whoami	サーバーが認証されている ID を確認します。

各ツールには readOnlyHint／destructiveHint／idempotentHint が注釈されているため、ホスト側で適切に確認を求めることができます。

プライバシー

このサーバーは Artifyde API の薄いクライアントです。送信するデータは、依頼された内容（公開する HTML、ページ ID、コメントテキスト、共有先メールアドレス）のみで、設定した Artifyde サーバー（デフォルトは https://artifyde.com）に HTTPS 経由で送信されます。トークンは環境変数（または Claude Desktop 拡張機能の設定）から読み込まれ、API 呼び出しの認証のみに使用されます。ログに記録されたり、ほかの場所に送信されたりすることはありません。ホスト型サービスにおけるデータの取り扱いについては、Artifyde のプライバシーポリシーをご覧ください。

開発

bun install
bun test              # unit tests (Bun's built-in runner)
bun run typecheck     # tsc --noEmit
bun run start         # run from source over stdio
bun run bundle        # build the Claude Desktop .mcpb bundle

src/core/ 配下の Artifyde API クライアントは、（非公開の）Artifyde モノレポの @artifyde/core パッケージをベンダーとして取り込んだものです。このクライアントがラップする API は、サーバーの安定した /v1 コントラクトです。

リリースとマーケットプレイスへの掲載手順については、PUBLISHING.mdをご覧ください。

サポート

問題や質問は、github.com/kennethkoontz/artifyde-mcp/issuesまでお寄せください。