Slide MCP Server

Slide MCP サーバー

slide-mcp-server は、AI アシスタントを Slide BCDR API に接続します。バックアップの健全性、ファイルの復元、スナップショット、アラート、リカバリー VM、イメージのエクスポート、DR ネットワーク、アカウント管理に対応する、タスク指向のツールを備えた単一の Go バイナリです。

主な 2 つのローカル MCP エコシステムに対応しています。

• Anthropic：ドラッグ＆ドロップで使える Claude Desktop MCP Bundle と Claude Code の登録に対応しています。
• OpenAI：共通の MCP 設定を通じて、Codex デスクトップ、CLI、IDE への登録に対応しています。

このサーバーは stdio JSON-RPC を使用し、実行時の依存関係はありません。また、Slide API トークンをこのリポジトリに書き込むことはありません。

インストール

Claude Desktop：ドラッグ＆ドロップ

1. slide-mcp-server.mcpb をダウンロードします。
2. Claude Desktop → Settings → Extensions にドラッグします。
3. console.slide.tech から取得した Slide API トークンを、My Settings → API Tokens に貼り付けます。

バンドルには、macOS universal、Linux amd64/arm64、Windows amd64 のバイナリが含まれています。macOS バイナリは Developer ID 署名済みで、Apple による公証も受けているため、通常のオンライン Gatekeeper チェックで警告が表示されることはありません。

安定版のダウンロード URL は常に最新の GitHub リリースを指します。廃止された旧 MCPB インストーラーも引き続き動作します。リリースには、従来の macos-x64、macos-arm64、linux-x64、linux-arm64、windows-x64 というアセット名も公開されています。

非公開でサイドロードした Claude Desktop バンドルは、現在、自動更新に対応していません。拡張機能が非公開の間は、安定版の .mcpb を再インストールして更新してください。Anthropic は、公式ディレクトリを通じて配布される拡張機能の自動更新を有効にしています。このマニフェストは、その申請手順に備えています。Anthropic のローカル拡張機能ガイドを参照してください。

OpenAI Codex

クローンしたリポジトリから：

make build
SLIDE_API_KEY=tk_... make install-codex
codex mcp get slide

または、ダウンロードした任意のバイナリを直接登録します。

codex mcp add slide --env SLIDE_API_KEY=tk_... -- /absolute/path/to/slide-mcp-server

Codex のデスクトップ、CLI、IDE の各環境では、共通の MCP 設定が使われます。make install-codex を再実行すると、既存の slide 登録が安全に置き換えられます。

Claude Code

make build
SLIDE_API_KEY=tk_... make install-claude-code
claude mcp list

直接登録することもできます。

claude mcp add slide --env SLIDE_API_KEY=tk_... -- /absolute/path/to/slide-mcp-server

Cursor およびその他の stdio MCP ホスト

ご利用のプラットフォーム向けのバイナリをダウンロードし、次の内容に相当する設定を行います。

{
  "mcpServers": {
    "slide": {
      "command": "/absolute/path/to/slide-mcp-server",
      "env": {
        "SLIDE_API_KEY": "tk_...",
        "SLIDE_TOOLS": "safe"
      }
    }
  }
}

質問例

• 「私の Slide ボックスはすべて正常ですか？」
• 「昨夜、ACME のバックアップは実行されましたか？」
• 「Bob のノート PC で Q4-budget.xlsx を探して、火曜日のバージョンを復元して。」
• 「未解決のアラートはありますか？深刻度の高い順に並べて。」
• 「DC-01 のリカバリー VM を起動して。」
• 「過去 24 時間で何が変わりましたか？」
• 「何から始めればよいかわかりません。何ができますか？」

a_...、d_...、c_... の識別子を覚える必要はありません。ユーザー向けの操作では name_hint を指定できます。サーバー側で決定論的に表示名やホスト名を照合し、名前が曖昧な場合は候補を返します。

MCP の機能

サーバーは、タスク指向のツールを12個と、互換性のためのエイリアスを1個公開します。各メインツールでは、API エンドポイントごとに別のトップレベルツールを作成する代わりに、operation パラメーターを使用します。

ツール	目的
slide_help	オンボーディング、例、用語集、トラブルシューティング、診断機能を内蔵
slide_overview	全体の一覧、健全性、クライアント／デバイスの概要
slide_files	ファイルの検索、閲覧、復元、プッシュ
slide_recovery	リカバリー VM、イメージのエクスポート、DR ネットワーク
slide_audit	アカウント監査ログのクエリ
slide_clients	クライアント管理
slide_admin	ユーザーとアカウントの管理
slide_devices	デバイスの詳細、ネットワーク、アプライアンス操作
slide_agents	保護対象システムの設定、サービス、スケジュール、保持期間
slide_snapshots	復元ポイントと検証結果
slide_backups	バックアップの状態と開始
slide_alerts	アラートの確認、トリアージ、解決
list_all_clients_devices_and_agents	下位互換性を保つインベントリエイリアス

また、slide.welcome、slide.daily-status、slide.restore-fileを含む6個の MCP プロンプトと、静的／動的なslide://リソースを提供します。

安全性と信頼性

デフォルトのsafe権限ティアでは運用上のリカバリー作業が許可されますが、削除、電源オフ、再起動はブロックされます。利用可能なモードは次のとおりです。

モード	許可される操作
read-only	一覧表示、取得、検索、閲覧、診断操作
safe	読み取り操作に加え、復元、バックアップ、取り消し可能な設定
full	削除や電源のオン／オフ操作を含むすべて

既存の設定でも引き続き起動できるよう、従来の名前reporting、restores、full-safeも引き続き受け付けます。

信頼性を高めるため、次の保護機能を備えています。

• MCP の初期化ハンドシェイクを決してブロックしない起動時検証。
• 45秒の操作期限と、上流レスポンス本文のサイズ制限。
• 冪等な読み取りに限った再試行／バックオフにより、変更操作の重複を回避。
• アカウント全体のインベントリと健全性情報に対する、完全かつループ安全なページネーション。
• 実行可能な修正方法を示す、トークンを秘匿した型付き API エラー。
• 入力と構造化出力に対する、サーバー側の JSON Schema 検証。
• --doctorおよびシークレットをマスクする--debug診断機能。

設定

CLI フラグは環境変数より優先されます。

フラグ	環境変数	デフォルト
--api-key	SLIDE_API_KEY	通常の操作には必須
--base-url	SLIDE_BASE_URL	https://api.slide.tech
--tools	SLIDE_TOOLS	safe
--disabled-tools	SLIDE_DISABLED_TOOLS	なし
--doctor	—	チェックを実行して終了
--debug	—	マスク済みの診断情報を出力して終了
--skip-startup-validation	—	バックグラウンドのアカウント確認をスキップ
--tool / --args	—	MCP ホストなしで単一のツール呼び出しを実行
--version	—	バージョンを出力して終了

ループバック以外の API ベース URL では HTTPS が必要です。プレーンな HTTP は localhost のテストサーバーでのみ使用できます。

テストハーネス

このリポジトリには、次の3つのテストレイヤーがあります。

# Deterministic offline suite: API failure injection, permissions, schemas,
# MCP protocol profiles, distribution contracts, and a real stdio subprocess.
make test

# Live, read-only demo/account smoke. Loads ignored .env when present and
# always rebuilds the repository binary before testing.
./smoke_test.sh

# Cross-platform binaries, MCPB structure, checksums, compatibility aliases.
make release

CI では、競合検出を有効にした Go テスト、go vet、クロスコンパイル、ShellCheck、リリースアセットの検証、Anthropic 公式 MCPB マニフェストバリデーターを実行します。プロトコルプロファイルでは、Claude Desktop の既定の2025-06-18パスと、Codex／現行 MCP の2025-11-25パスをカバーします。

対話形式で確認するには、次を実行します。

SLIDE_API_KEY=tk_... npx @modelcontextprotocol/inspector ./build/slide-mcp-server

開発

git clone https://github.com/amcchord/slideMCP.git
cd slideMCP
make setup-dev
make test
make build

API クライアントは Slide API v1.27.0 に対応しています。キャッシュ済みの OpenAPI ドキュメントはdocs/openapi.jsonです。ワークフローを MCP プロンプトまたはリソースとして表現したほうが適切な場合を除き、新しいエンドポイントの動作は、最も近い既存のメタツールの操作として追加してください。

便利な診断機能：

SLIDE_API_KEY=tk_... build/slide-mcp-server --doctor
build/slide-mcp-server --debug | jq .

リリース

署名パイプラインに手を加える前に、docs/SIGNING.md をお読みください。本番リリースは、すでにコミット済みのクリーンな main ブランチから意図的に作成します。

./scripts/setup-signing.sh       # first machine only
make doctor-signing
./scripts/release-all-in-one.sh vX.Y.Z

リリースパイプラインでは、次の処理を行います。

1. Makefile、config.go、dxt/manifest.json のバージョンが一致していることを確認します。
2. race テストと go vet を実行します。
3. クリーンな build/ ディレクトリからすべてのターゲットをビルドします。
4. universal macOS 実行ファイルに Developer ID 署名を行い、公証を受けます。
5. .mcpb をパッケージ化して検証します。
6. 現行およびレガシーのインストーラーアセット名と SHA-256 チェックサムを作成します。
7. タグ付けの前に、署名と公証の要件を再度確認します。
8. main をプッシュし、タグを作成して、GitHub リリースを公開します。

Apple は raw Mach-O 実行ファイルにチケットをステープルできません。stapled: no は想定どおりです。codesign --test-requirement="=notarized" により、正しいオンライン公証チェックを実行できます。

ライセンス

MIT