MCP ツール

MCP 概要

Showly が機能を生の REST API ではなく MCP ツールとして公開する理由。

Showly は、Model Context Protocol を通じてコーディングエージェントへ機能を公開します。このページでは採用理由を説明します。利用できる機能の一覧はツールリファレンスを参照してください。

なぜ MCP

裸の REST API では、すべてのエージェントにカスタム認証フロー、カスタム要求形状、カスタム エラー セマンティクスを学習させることになります。 MCP は 3 つすべてを解決します。

  • 型付きツール 各機能は、JSON スキーマ化された入力および出力を備えた tool です。エージェントのホスト (Claude Code、Codex) は、ユーザーのためにツール リストを自動レンダリングします。
  • スコープ付きトークン。 Showly MCP トークンは、ワークスペース、オプションでプロジェクト、OAuth/device フローを通じて作成された場合の承認ユーザー、および一連のツール スコープにバインドされます。トークンは、エージェントが必要とする以上のものを付与することはありません。
  • 第一級の監査。 すべてのツール呼び出しでは、クライアント ID、アクション、パラメーター (秘密の編集を含む)、および結果が記録されます。

エージェントに表示される内容

ユーザーが Showly MCP クライアントをインストールすると、エージェントには機能ごとにグループ化されたツールが表示されます。

  • 読む — list_projects、list_sites、get_site_context、get_site_files、get_preview_status
  • 計画 — create_change_plan
  • 適用 — apply_site_patch
  • ビルド — create_preview、run_checks、retry_deployment
  • 出荷 — request_publish (承認ワークフローを使用して計画に対する人間による承認フローを開きます)。 publish_site と rollback_to_version は、2 段階の会話中確認トークンを介して直接動作します。
  • 検査 — get_deployment_logs、diagnose_deployment、list_deployments、list_site_versions、diff_site_versions
  • 機内 — list_templates、create_site_from_template、create_site_from_html、claim_trial_site
  • 転送 — request_upload_url、request_download_url (モデルのコンテキストを経由しない大きなファイルの署名付き URL)
  • 片付け — delete_preview、delete_site

各ツールのスキーマは、その爆発範囲を明示的に示しています。request_publish では、準備ができたプレビューには deploymentId が必要です。完全にオフにされた 1 つの動詞 MCP はレガシー rollback_deployment です。これは、ステップアップ MFA の背後の Web UI に存在します。運用に影響を与える MCP ツール (publish_site、rollback_to_version、delete_site) は、最初の呼び出しでは決して機能しません。有効期間の短い確認トークンを返します。このトークンは、2 番目の呼び出しでエコーバックする必要があります。

トークンのスコープの設定方法

ワークスペース管理者は、ワークスペース設定 → MCP クライアントから MCP トークンを発行します。各トークンには次のものがあります。

  • クライアント名 (監査ログは「Claude Code (alice@acme)」のようになります)
  • オプションの プロジェクト スコープ (このクライアントがアクセスできるプロジェクト)
  • スコープセット — 階層や暗黙の継承を持たないフラットなスコープ文字列です。既定値は project:read、site:read、preview:read。完全な一覧はスコープとトークンを参照してください。
  • TTL (デフォルトは 90 日、最大 365 日)

トークンは同じパネルから即座に取り消すことができます。

境界

MCP サーフェスは意図的に以下を公開しません:

  • データベースへの直接アクセス。
  • 運用環境変数の値。
  • あらゆる種類のクロステナント読み取り。
  • ワークスペースの課金またはユーザー管理の変更。

エージェントのワークフローにこのリストにないものが必要な場合は、問題を提出してください。答えはほとんどの場合、「API を開く」ではなく、「より範囲が狭いツールを追加する」です。

次のステップ