stelaspace-mcp

stelaspace-mcp

ローカルファイルを扱うコーディングエージェント（Claude Code と Codex）から、HTML ファイルを StelaSpace に公開するためのローカル MCP サーバーです。

お使いのマシン上で動作するため、HTML ファイルをパスで指定してディスクから直接読み込み、 StelaSpace API 経由でバイトデータをアップロードします。これにより、大容量（1 MB 以上）の レポートやダッシュボードも公開できます。ファイルの内容をツールの引数として渡す方法では、 モデルの出力サイズ上限に制限されます。

Claude Desktop（チャット）は公開に対応していません。サンドボックスからローカル MCP サーバーに ファイルを共有できないため、ローカルのレポートをアップロードできません。エージェントが レポートをディスクに生成して直接公開する Claude Code または Codex を使用してください。

ツール

• publish_file — { path, spaceSlug, title?, slug?, tags?, visibility? } → ファイルを読み込み、 永続 URL を返します。同じ slug を再利用すると、新しいバージョンが公開されます。
• list_spaces — チーム内のスペースを一覧表示します。
• list_documents — { spaceSlug, query? } — スペース内のドキュメントを一覧表示します。

セットアップ

StelaSpace → Settings → API Keys から API キーを取得します（ss_sk_ で始まります）。

Claude Code

claude mcp add stelaspace --scope user \
  --env STELASPACE_API_KEY=ss_sk_your_key \
  -- npx -y stelaspace-mcp

Codex

~/.codex/config.toml:

[mcp_servers.stelaspace]
command = "npx"
args = ["-y", "stelaspace-mcp"]
env = { STELASPACE_API_KEY = "ss_sk_your_key" }

次に、エージェントにレポートを作成して公開するよう依頼します。例： 「売上ダッシュボードを生成して、HTML を公開設定で自分のレポート用スペースに公開してください。」

環境

• STELASPACE_API_KEY（必須）— ss_sk_ キーです。
• STELASPACE_API_URL（任意）— API エンドポイントを上書きします。デフォルトは https://stelaspace.com です。ほとんどのユーザーは設定する必要がありません。