Music Story MCP

Music Storyは、お好みのエージェント（Claude、ChatGPT、Cursor、VS Code など）にすぐに接続できる、プラグアンドプレイのMCPサーバーを提供しています。

お客様ご自身のAPI権限とクォータで、AIアシスタントからMusic Storyのカタログを参照できます。

サーバーURL：https://mcp.music-story.com/mcp（Streamable HTTP）
認証：メタデータモニターのアカウントでサインイン（OAuth）、またはお手持ちのAPIキーを使用
読み取り専用：データを変更するツールはありません

クイックスタート

クライアントにサーバーを追加し、カタログについて質問してください。

Claude.ai / Claude Desktop
ChatGPT
Claude Code
Cursor
VS Code

設定（Settings）› コネクタ（Connectors） を開き、カスタムコネクタを追加（Add custom connector） をクリックします。
名前を Music Story とし、URL https://mcp.music-story.com/mcp を入力します。
接続（Connect） をクリックし、メタデータモニターのアカウントでサインインして、アクセスリクエストを承認します。

設定（Settings）› アプリとコネクタ（Apps & Connectors） を開き、ご利用のプランで必要な場合は（詳細設定（Advanced settings） にある）開発者モード（Developer mode） を有効にします。
作成（Create） をクリックし、名前を Music Story、URL を https://mcp.music-story.com/mcp、認証を OAuth に設定します。
メタデータモニターのアカウントでサインインし、アクセスリクエストを承認します。

claude mcp add --transport http music-story https://mcp.music-story.com/mcp

続いて Claude Code で /mcp を実行し、music-story を選択して、メタデータモニターのアカウントでサインインします。

サインインの代わりにAPIキーを使用する場合：

claude mcp add --transport http music-story https://mcp.music-story.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）にサーバーを追加します：

{
  "mcpServers": {
    "music-story": {
      "url": "https://mcp.music-story.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

ワークスペースの .vscode/mcp.json にサーバーを追加します：

{
  "servers": {
    "music-story": {
      "type": "http",
      "url": "https://mcp.music-story.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

APIキーはメタデータモニターで確認できます。共有ファイルやバージョン管理されたファイルには記載しないでください。

エージェントにセットアップを任せる

次のプロンプトをコピーして、コーディングエージェント（Claude Code、Cursor など）に渡してください：

Music Story の MCP サーバーをセットアップしてください。
- サーバー：https://mcp.music-story.com/mcp（Streamable HTTP トランスポート）
- 認証：このクライアントが OAuth に対応していれば OAuth を使用してください。対応していない
  場合は、私に Music Story の API キーを尋ね、「Authorization: Bearer <キー>」ヘッダーで
  送信してください。キーはバージョン管理されたファイルや共有ファイルに絶対に書き込まないでください。
- 現在動作しているクライアント（Claude Code、Cursor、VS Code など）を判別し、その MCP 設定に
  サーバーを追加してください。
- 接続後、get_account_status ツールを呼び出して動作を確認し、本日の残りクォータを教えてください。
- ドキュメント：https://doc.music-story.com/ja/mcp

できること

普段の言葉で質問するだけで、アシスタントが適切なツールを自動で選びます。

プレイリストや放送ログをカタログと照合し、ISRC と Music Story ID を取得。 「このリストの各曲のISRCを調べて：（リストを貼り付け）」
コードやリンクを特定：ISRC、EAN/UPC、ISWC、ISNI、IPI、または Spotify、Deezer、Apple Music、MusicBrainz のリンク。 「このISRCはどのアルバムに収録されている？（ISRCを貼り付け）」
アーティストのプロフィール：バイオグラフィー、ディスコグラフィー、写真、人気度。 「Daft Punk の簡単なプロフィールを、スタジオアルバムと一緒に教えて。」
権利の内訳：作品や録音の作詞者、作曲者、出版社。 「このプレイリストの曲の作詞・作曲者と出版社は？（リストを貼り付け）」
人気度とチャートを探索：ジャンル、国、年、月ごと。 「現在日本で最も人気のあるロックアーティストのトップ10は？」
レコメンドを取得：曲やアーティストを起点に。 「Daft Punk の『Get Lucky』に似た曲を10曲おすすめして。」

プロンプト

対応クライアント（Claude.ai、Claude Desktop など）でスラッシュコマンドとして表示される、すぐに使えるワークフローです。

プロンプト	入力	結果
`match_tracklist`	1行に1つ「アーティスト - タイトル」	各行の ISRC、Music Story ID、照合の信頼度をまとめた表
`rights_breakdown`	チャートと日付、または曲のリスト	曲全体における各権利者（出版社、作家）のシェア
`artist_profile`	アーティスト名またはID	プロフィール、経歴、スタジオアルバム、人気度
`identify`	ISRC、EAN/UPC、ISWC、ISNI、IPI、またはプラットフォームのリンク	対象の特定と主要データ

アクセス、権利、制限

お客様の権利が適用されます。 すべての呼び出しにお客様のAPIキーが使用されるため、APIと同様に、ご契約の権利と1日あたりのクォータが適用されます。残りのクォータはいつでもアシスタントに尋ねられます。
ご契約外のデータは、回答全体を失敗させるのではなく、不足しているオプション名とともに「利用不可」として報告されます。
リストは10件に制限されます（回答を簡潔にするため）。アシスタントには各リストの実際の件数が伝えられます。
OAuthでサインインすると、メタデータモニターのアカウントに AI assistant (MCP) という名前のAPIキーが作成されます。このキーはすべてのMCP呼び出しで再利用されます。
アクセスを取り消すには、AIクライアントでOAuthの認可を取り消してください。AI assistant (MCP) キーを削除するだけでは不十分です。認可が有効な限り、次の呼び出し時に再作成されます。

ツールリファレンス

全ツール（読み取り専用）

ツール	機能
照合と特定
`match_artist_title`	外部のアーティスト/タイトルの組（プレイリスト、放送ログなど）をカタログと照合
`find_by_identifier`	ISRC、EAN、ISNI、ISWC、IPI、MusicBrainz、Spotify、Deezer、Apple などでエンティティを検索（プラットフォームのURLも可）
検索
`search_artists`、`search_albums`、`search_recordings`、`search_releases`、`search_works`	全文検索
詳細
`get_artist`	アーティスト情報（バイオグラフィー、アルバム、写真、人気度をオプションで追加）
`get_album`	アルバム情報（リリース、クレジット、レビュー、カバーアート、オーディオ記述をオプションで追加）
`get_release`	リリース情報とトラックリスト
`get_recording`	録音情報（IDまたはISRCで指定。リリース、作品、クレジット、オーディオ記述、歌詞、人気度、チャート、クラスターをオプションで追加）
探索
`get_recommendations`	録音またはアーティストを起点としたレコメンド
`get_popularity_ranking`	アーティストまたは録音の人気ランキング（ジャンル、国、年、月ごと）
`browse_charts`	チャート、その日付、内容の閲覧
`get_genre_artists`	ジャンルの主要アーティスト（人気順）
参照データとアカウント
`list_reference_data`	ジャンル、役割、役割カテゴリー、国、番組タイプ
`get_account_status`	本日の残りクォータ
`api_get`	その他のAPI v2エンドポイントへの読み取り呼び出し（番組、CD TOC、高度なページングなど）

クイックスタート​

エージェントにセットアップを任せる​

できること​

プロンプト​

アクセス、権利、制限​