スキル

Showly スキルのインストール

Claude CodeまたはCodexに正式なShowlyスキルを追加します。

Showly スキルは、インテントトリガープロンプトとパブリッシュループ認識拒否モデルで MCP サーバーをラップします。このページでは、Claude Code、Codex、およびその他の MCP 対応エージェントにインストールする手順を説明します。

認可の仕組み

トークンを貼り付けることはできません。 Showly の MCP サーバーは、https://mcp.showly.ai にあるリモート HTTP サーバーであり、標準の MCP 認証ハンドシェイク (OAuth 2.1 + PKCE) を使用します。エージェントが初めて Showly ツールを呼び出すとき:

エージェントは接続し、401 を取得し、Showly の認証サーバーを自動的に検出します。
showly.ai へのブラウザータブが開き、そこでサインインして、要求されたスコープを承認します。
Showly は、スコープ付きの短いトークンをエージェントに直接発行します。決して見たりコピーしたりすることはありません。

したがって、インストーラーの唯一の仕事は、サーバー URL をエージェントに登録することです。初めて使用するときに、ブラウザーでサインインが行われます。

前提条件

Showly ワークスペースと少なくとも 1 つのサイトが接続されています。
エージェントのアクセスを承認する権限。承認ステップでは、少なくとも site:write (所有者、管理者、開発者、またはメンバー) を持つロールが必要です。権限の低いアカウントから承認すると、実際に保持しているスコープに絞り込まれたトークンが生成されます。

Claude Code

正規のインストーラーは @showly/mcp-server パッケージ (bin showly-mcp) です。 claude-code ターゲットで実行します。

npx @showly/mcp-server install --to claude-code

これにより、Showly MCP サーバーブロックが Claude Code 構成に書き込まれます。トークンや個別のログインコマンドは必要ありません。次回 Showly ツールを呼び出すと、エージェントは上記のブラウザーサインインを実行します。

Claude Code 内部から接続をテストします。

Showly、私のサイトをリストしてください。

最初の呼び出しでは、アクセスを承認するためのブラウザータブが開きます。承認すると、mcp__showly__list_sites から提供されたサイトがリストに表示されます。

Codex

codex ターゲットと同じインストーラーを使用します。 Showly サーバーをあなたの ~/.codex/config.toml に書き込みます。

npx @showly/mcp-server install --to codex

Codex を再起動して新しいサーバーを選択し、Showly ツールを呼び出してブラウザーのサインインをトリガーします。

他の MCP ホスト

インストーラーが適用せずに書き込む構成を検査するには、stdout をターゲットにします。

npx @showly/mcp-server install --to stdout

印刷された MCP サーバーブロックをホストの構成にコピーします。標準認証フロー (WWW-Authenticate 検出 → ブラウザ同意) をサポートするすべての MCP クライアントは、手動トークンなしで https://mcp.showly.ai に接続します。エージェントを動かしているマシンにブラウザーがない場合、または承認する人がそのマシンの前にいない場合は、以下のヘッドレスサインインを使用してください。

ヘッドレスサインイン (デバイスフロー)

エージェントのマシンにブラウザーがない場合（サーバー、コンテナー、CI、リモートシェル）、または承認する人がそのマシンではなくスマートフォンを持っている場合は、npx @showly/mcp-server login --to claude-code を実行します。ページの URL と短いコードを表示し、任意のデバイスで承認するまで待機し、承認されるとホスト構成に資格情報を書き込みます。--to codex は ~/.codex/config.toml に書き込みますが、その設定は資格情報をファイルではなく環境変数 SHOWLY_TOKEN から読み取ります。コマンドは対応する export SHOWLY_TOKEN=… の行も表示し、Codex を起動する環境でそれを設定するまで認証できません。--to stdout は何も書き込まずスニペットだけを表示し、--print-token はトークンだけを出力するので、CI はファイルに残さずに取得できます。

ページのコードがターミナルのコードと一致する場合にのみ承認してください。同意画面では明示的なチェックを求めます。クライアントが表示する名前はクライアント自身が付けたものであり、確認できるのはコードだけだからです。コードの有効期限は 15 分で、ページを開くとサインインと承認のためにさらに 10 分が加算されます。期限が切れたらコマンドを再実行してください。

これはクライアントが自力で見つける経路ではありません。MCP クライアントはデバイスフローを開始しないため、login が唯一の入口です。書き込まれる資格情報は 90 日で期限切れになり、Showly はリフレッシュトークンを発行しないので、そのときは login を再実行してください。

トラブルシューティング

tool not found: mcp__showly__list_sites — スキルはインストールされていますが、MCP サーバーはまだ接続されていません。 Claude Code で claude mcp list を実行し、showly エントリを確認します。 Showly ツールを 1 回呼び出して、サインインをトリガーします。

ブラウザーのサインインが表示されない/「未承認」 — エージェントが標準の MCP 認証フローをサポートしていない可能性があります。最新バージョンであることを確認して、再試行してください。エージェントは、401 → WWW-Authenticate ディスカバリに従って同意ページを開くことができる必要があります。

「承認する権限がありません」 — 承認するアカウントには少なくとも site:write が必要です。所有者/管理者/開発者/メンバーのアカウントでサインインするか、その役割を持つチームメイトに承認してもらいます。

「サイトが見つかりません」 - 承認された範囲またはサイトの許可リストは、質問したサイトをカバーしていません。サインインを再実行して必要なスコープを承認するか、エージェント ページ (/app/integrations) からのアクセスを拡大します。

ツール呼び出しがハングする — MCP サーバーが Showly の API に接続できません。ネットワークを確認してください。エンドポイントをオーバーライドした場合は、SHOWLY_MCP_URL (MCP サーバー URL) と SHOWLY_API_URL (API ベース) が古い場所を指していないかを確認してください。

アクセスを取り消します

エージェントのアクセスを取り消すには、私のエージェント ページ (/app/integrations) を開き、エージェントを見つけて切断します。取り消しは直ちに有効になります。エージェントは、次回の通話時に再度サインインするように求められます。手動でローテーションするトークンはありません。エージェントはブラウザフローを通じて新しいトークンを取得します。ブラウザーがない場合は npx @showly/mcp-server login から取得します。ヘッドレスサインインで得た資格情報は 90 日で期限切れになります。