# Storelift MCP サーバーを Claude Code に追加する

URL: https://storelift.net/ja/guide/storelift-mcp-claude-code/
Language: ja
Updated: 2026-10-13

Storelift MCP サーバーを Claude Code に接続する手順です。バージョン、要件、エラー応答は、サーバーそのもので計測したものです。

## このガイドの確認方法

NOTE: 確認方法（2026-10-11）。サーバー側は storelift-mcp 1.1.1 で、ハンドシェイク、ツール一覧、読み取りの呼び出し、エラー応答、アクセスの解除を計測しました。Claude Code で確認できたこと：2.1.296 · stdio, API キー: 接続できる, 8 個のツールを一覧表示できる, 削除コマンドで問題なく削除できる; 2.1.296 · Streamable HTTP, ヘッダーに API キー: 接続できる, 8 個のツールを一覧表示できる。Claude Code の中からのツール呼び出しは、まだ試していません。以下の手順は Claude Code 自身のドキュメントに沿っています。

Claude Code のドキュメント：code.claude.com。

## バージョン

このガイドは、現在公開中のサーバーについて説明します。npm の storelift-mcp 1.1.1（2026-09-14）と、ホスト型エンドポイント https://storelift.net/mcp です。どちらも同じ 8 個のツールを備えています：get_ai_visibility, get_charts, get_history, get_keywords, get_reviews, get_rivals, get_store_page, list_apps。

このリリースのツールはすべて読み取り専用で、アカウントの内容を変更するものはありません。ローカルサーバーは stdio 経由でプロトコルバージョン 2024-11-05、ホスト型エンドポイントは Streamable HTTP 経由で 2025-06-18 で応答します。エンドポイントはステートレスで、セッション ID も、サーバーからのストリーム送信もありません。

## 要件

- プラン。MCP へのアクセスには Pro、Studio、または Enterprise プランが必要です。API キーでもサインイン（OAuth）でも同じです。
- キー。Storelift → 設定 → APIキー。キーは sl_live_ で始まります。このリリースのキーにはスコープがありません。1 つのキーで、ワークスペース内のすべてのアプリを読み取れます。キーはクライアントの設定の中だけに置いてください。
- 実行環境。ローカルサーバーには Node.js 18 以降が必要です（npx が初回の実行時にパッケージを取得します）。ホスト型エンドポイントは、何もインストールせずに使えます。
- Claude Code。最近のバージョンであれば使えます。以下のコマンドは、claude mcp add --help と Claude Code の MCP ドキュメントに基づいています。

## セットアップ

API キーを使うローカルサーバー（プロジェクトのディレクトリで実行します。既定のスコープはこのプロジェクトだけです）：

claude mcp add storelift -e STORELIFT_API_KEY=sl_live_... -- npx -y storelift-mcp

または、インストール不要のホスト型エンドポイント。キーはヘッダーで渡します：

claude mcp add --transport http storelift https://storelift.net/mcp --header "Authorization: Bearer sl_live_..."

キーの代わりにサインイン（OAuth）を使う場合は、ヘッダーなしでエンドポイントを追加し、Claude Code の中で /mcp を実行します：

claude mcp add --transport http storelift https://storelift.net/mcp

claude mcp list で接続を確認します。行に ✔ Connected と表示されていれば、接続できています。

## 最初の読み取り

こう尋ねます：「Storelift のアプリを一覧にして、最初のアプリの米国でのキーワード順位を見せて。」アシスタントはまず list_apps を呼び出し、次にあなたが選んだアプリについて get_keywords を呼び出します。list_apps の応答は次のようになります（Storelift のサンプルデータ、2026-09-28。自分のアカウントでは自分のアプリが返ります）：

{
"apps": [
{
"id": "sbx-lumen",
"name": "Lumen — Sleep Sounds",
"countries": [
"us",
"gb",
"de"
],
"keywords": [
"sleep sounds",
"white noise",
"rain sounds"
]
}
]
}

get_keywords は、追跡中のキーワードごとに 1 行を返します：

{
"country": "us",
"platform": "ios",
"keywords": [
{
"term": "sleep sounds",
"measured": true,
"rank": null,
"demand": 73,
"searchDepth": 200
},
{
"term": "white noise",
"measured": true,
"rank": 57,
"demand": 37,
"searchDepth": 200
}
]
}

rank が数値なら、それが順位です。null は、キーワードを計測したもののアプリが結果に含まれていないことを表し、measured: false は計測できなかったことを表します。この 3 つは別々の状態です。計測できなかった日をゼロとして数えると、誤った答えになります。

接続は機能しています。次は最初の 3 つのタスクです。どのキーワードが下がったか、そこで誰が上にいるか、今日の計測がないキーワードについてどう答えるかを、期待される答えと一緒に示します。

## アクセスの解除

1. claude mcp remove storelift を実行します。サインインで接続していた場合、Claude Code は保存していたトークンも削除します。/mcp → Clear authentication を使うと、サーバーを削除せずに同じことができます。
2. Storelift → 設定 → APIキー でキーを削除します。そのキーを使った次のリクエストは拒否されます（ローカルサーバーではツールエラー、ホスト型エンドポイントでは HTTP 401）。開いたままのセッションはないので、待つ必要はありません。
3. サインイン（OAuth）で接続した場合は、設定 → API → 連携中のアプリ で接続を削除します。その接続のトークンは、次のリクエストで 401 を受け取ります。

## トラブルシューティング

| 表示される内容 | 原因 | 対処 |
| --- | --- | --- |
| “No API key was sent…” | ローカルサーバーがキーなしで起動しました。ツールは一覧に表示されますが、どの呼び出しもこのエラーを返します。 | サーバーの設定に STORELIFT_API_KEY を追加し、クライアントを再起動します。 |
| “This API key is not valid…” | キーの入力が間違っているか、キーが削除されています。ホスト型エンドポイントは HTTP 401 を返します。 | 設定 → APIキー で新しいキーを作成し、クライアントの設定にあるキーと置き換えます。 |
| “The Public API is available on the Pro and Studio plans…” | アカウントのプランでは MCP にアクセスできません（HTTP 403）。このリリースでアクセスできるのは Pro、Studio、または Enterprise です。 | storelift.net/pricing でアップグレードします。キーはそのまま残り、プランが対応すればまた使えます。 |
| “fetch failed…” | ローカルサーバーが Storelift に接続できませんでした。ネットワーク、プロキシ、ファイアウォールのいずれかが原因です。 | このマシンから https://storelift.net に接続できるかを確認します。STORELIFT_API は、別のエンドポイントを指定された場合にだけ設定します。 |
| claude mcp list に ✘ Failed to connect と表示される | サーバーが起動しなかった（Node.js がない、または古すぎる）か、エンドポイントが時間内に応答しませんでした。 | node --version を実行します。起動に時間がかかる場合は、起動のタイムアウトを延ばします。例：MCP_TIMEOUT=10000 claude。 |