MCP連携

Publee は Model Context Protocol (MCP) に対応しています。Claude Code・Claude Desktop・Cursor などの MCP クライアントから、生成したHTMLを その場で公開 できます。

エンドポイント: https://publee.app/api/mcp(Streamable HTTP)

Claude Code

claude mcp add --transport http publee https://publee.app/api/mcp

これだけで使えます(認証なしの場合は匿名公開・7日で削除)。

アカウントに紐づけるには、Claude Code 内で /mcppubleeAuthenticate を選びます。ブラウザで Publee のログイン画面が開き、ログインすれば完了です(OAuth)。トークンのコピペは不要で、公開したサイトの永続化・非公開設定・publee_list_sites が使えるようになります。

プラグインとして入れる

Claude Code 内で次を実行すると、MCPサーバーと Publee スキル(publish APIの使い方をエージェントに教えるAgent Skill)がまとめて入ります:

/plugin marketplace add publee-dev/skills
/plugin install publee@publee

Claude Desktop / claude.ai

カスタムコネクタとして追加します: 設定 → コネクタ → カスタムコネクタを追加https://publee.app/api/mcp を登録し、「接続」を押すとブラウザでログインを求められます(OAuth)。

Cursor / その他のクライアント

Cursor はボタンひとつで追加できます:

Add to Cursor

または、MCP設定に次を追加します:

{
  "mcpServers": {
    "publee": {
      "type": "http",
      "url": "https://publee.app/api/mcp"
    }
  }
}

OAuth 対応クライアントであれば、接続時にブラウザでログインを求められます。

認証方式

方式 向いている場面
OAuthログイン(推奨) Claude Code / Claude Desktop / Cursor などの対話的クライアント。ブラウザでログインするだけ
APIトークン OAuth 非対応のクライアントや、CI・スクリプトなどのヘッドレス環境
匿名(認証なし) とりあえず試す場合。7日で削除され、公開後の設定変更はできません

APIトークンを使う場合

トークンページpublee_live_ トークンを発行し、Authorization: Bearer ヘッダに設定します。

claude mcp add --transport http publee https://publee.app/api/mcp \
  --header "Authorization: Bearer publee_live_xxxxx"

JSON設定のクライアントでは:

{
  "mcpServers": {
    "publee": {
      "type": "http",
      "url": "https://publee.app/api/mcp",
      "headers": {
        "Authorization": "Bearer publee_live_xxxxx"
      }
    }
  }
}

技術詳細: OAuth 2.1(Dynamic Client Registration 対応)。ディスカバリーメタデータは /.well-known/oauth-authorization-server/.well-known/oauth-protected-resource で公開しています。

使えるツール

publee_publish

HTMLまたはファイルツリーを公開してURLを返します。

「このHTMLをPubleeで公開して」
「今作ったLPをパスワード付きで共有URLにして」
  • html — 単一HTMLをそのまま渡す(一番簡単)
  • files — 複数ファイル(テキストは content、バイナリは contentBase64
  • slug — 公開URLのサブドメインを指定(Pro プラン以上。例: my-pagehttps://my-page.publee.site
  • visibility / password — 公開範囲(デフォルトはパスワード保護)

publee_list_sites

自分のサイト一覧を返します。認証(OAuthログインまたはAPIトークン)が必要です。

curlでの動作確認

curl -X POST https://publee.app/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'