MCP サーバーと Skill

AI アシスタントから MyAltBox を直接検索できます。製品の代替を探す、オープンソースやセルフホスト可能な選択肢を比較する、新しい製品を登録する、といった操作を Claude や Cursor など MCP 対応のクライアントから行えます。

MyAltBox は 2 つの方法を提供しています。

• MCP サーバー：https://myaltbox.com/api/mcp のリモートサーバーで、AI アシスタントに構造化されたツールを提供します。
• Skill：Claude にいつ、どのように MyAltBox を使うかを伝える短い説明ファイルです。単独でも使えますが、MCP サーバーと組み合わせるとより便利です。

ツール

ツール	内容	トークン
search_services	キーワード検索。カテゴリ、オープンソース、セルフホスト可能で絞り込み	不要
get_service	製品の詳細：説明、ライセンス、料金、プラットフォーム、主な機能、詳細紹介	不要
get_alternatives	コミュニティが推薦する代替製品（投票順）	不要
list_categories	すべてのカテゴリと各カテゴリの製品数	不要
submit_service	名前と公式サイトだけで新しい製品を登録	必要
add_alternative	ある製品を別の製品の代替として登録	必要

すべてのツールで locale（en、zh、ja、ko）を指定でき、説明・カテゴリ・ページへのリンクがその言語で返されます。

MCP から登録した製品は登録ページと同じルールで扱われます。AI が公式サイトを読み取ってカテゴリ・説明・タグを補完し、管理者の承認後に公開されます。管理者以外のアカウントは 1 日あたりの登録数に上限があります。

API トークン

検索系のツールはアカウントなしで使えます。製品の登録や代替の追加には、下で個人用 API トークンを作成し、Authorization: Bearer <トークン> として送信してください。

• トークンは一度だけ表示されます。パスワードと同じように保管してください。
• ここでいつでも取り消せます。取り消すと、そのトークンを使うクライアントはすぐに書き込みできなくなります。

クライアントの設定

Claude Code

# 検索系ツールのみ
claude mcp add --transport http myaltbox https://myaltbox.com/api/mcp

# トークン付きで、すべてのプロジェクトで使う
claude mcp add --transport http myaltbox https://myaltbox.com/api/mcp \
  --scope user --header "Authorization: Bearer mab_あなたのトークン"

Claude Code で /mcp を実行すると接続状態を確認できます。

トークンをリポジトリに含めずにプロジェクトで共有するには、.mcp.json に書き、トークンは環境変数から読み込みます。

{
  "mcpServers": {
    "myaltbox": {
      "type": "http",
      "url": "https://myaltbox.com/api/mcp",
      "headers": { "Authorization": "Bearer ${MYALTBOX_TOKEN}" }
    }
  }
}

Claude Desktop と claude.ai

「設定 → Connectors（コネクタ）」でカスタムコネクタを追加し、https://myaltbox.com/api/mcp を入力します。カスタムコネクタは現在トークンのヘッダーを送れないため、検索系のツールのみ利用できます。

Cursor

~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "myaltbox": {
      "url": "https://myaltbox.com/api/mcp",
      "headers": { "Authorization": "Bearer mab_あなたのトークン" }
    }
  }
}

VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "myaltbox": {
      "type": "http",
      "url": "https://myaltbox.com/api/mcp",
      "headers": { "Authorization": "Bearer mab_あなたのトークン" }
    }
  }
}

その他のクライアント

Streamable HTTP トランスポートに対応したクライアントであれば、URL に https://myaltbox.com/api/mcp を指定して使えます。検索系ツールだけを使う場合は headers を省略してください。

Skill

Skill は、MyAltBox が役立つ場面（「Notion の代わりになるものは？」「セルフホストできるパスワードマネージャー」など）と結果の見せ方を Claude に伝えます。MCP サーバーに接続していればそのツールを、接続していなければ公開検索 API を使います。

Claude Code

mkdir -p ~/.claude/skills/myaltbox
curl -fsSL https://myaltbox.com/skills/myaltbox/SKILL.md -o ~/.claude/skills/myaltbox/SKILL.md

関連する質問のときに Claude が自動で読み込みます。/myaltbox と入力して直接使うこともできます。

Claude Desktop と claude.ai

myaltbox.zip をダウンロードし、「設定 → Capabilities（機能）→ Skills」でアップロードします。

インストール前に Skill の内容を確認できます。

プロンプトの例

• 「セルフホストできる Notion のオープンソース代替を教えて」
• 「MyAltBox で Jellyfin と Plex を比較して」
• 「Linux と Android で使える無料のパスワードマネージャーを探して」
• 「Zed（https://zed.dev）を Visual Studio Code の代替として MyAltBox に追加して」