Listable Directory Builder

Listable MCP サーバー

自然な会話を通じて、Claude、Cursor、その他の AI アシスタントに Listable のディレクトリサイトを管理させましょう。

Listable は、レストランガイド、ビジネスディレクトリ、旅行情報の掲載サイト、ニッチなテーマに特化した厳選サイトなど、ディレクトリサイトを構築するためのプラットフォームです。MCP（Model Context Protocol）サーバーは、サイト管理のすべての操作を、AI アシスタントが呼び出せる構造化されたツールとして提供します。

AI に次のように依頼できます。

• 「食べ物のディレクトリに、ブルックリンのイタリアンレストランを20件追加して。」
• 「貼り付けるCSVから、これらの掲載情報をインポートして。」
• 「ホームページのSEOメタタイトルと説明を設定して。」
• 「ヘッダーメニューにカテゴリーのドロップダウンを追加して。」
• 「私たちのミッションと注目の掲載情報一覧を含む「概要」ページを作成して。」

できること

次のグループにまたがる約47個のツールがあります。

グループ	ツール
プロジェクト	一覧表示、取得、スキーマの検出
アイテム（掲載情報）	一覧表示（ページネーション、フィルター対応）、取得、作成、更新、削除、bulk_create（1回につき最大100件）
カテゴリー	CRUD 全般、カテゴリー階層、競合の確認
カスタムフィールド	一覧表示、作成、更新、削除（テキスト、数値、日付、URL、チェックボックス、選択肢、電話番号、住所、画像）
ページ＋ブロック	ページの一覧表示、ページブロックの取得／更新、グローバルブロック領域の管理（ホームページのヒーロー、ホームページのメイン、詳細ページ、カテゴリーのページ）
フォーム	一覧表示、取得、作成、更新、削除、フォームフィールドの管理
設定	メニュー、スクリプト、SEO、URL 構造、テーマ
リダイレクト	CRUD 全般
アップロード	掲載情報やページで使用する画像／ファイルのアップロード

AI には、編集で適切なカスタムフィールドとブロックタイプを使用できるよう、最初に get_schema を呼び出すよう指示されています。削除、ブロックの全置換、URL 構造の変更、スクリプトの上書きなど、破壊的な操作を実行する前には確認を求めます。

接続方法は2つ

	OAuth（推奨）	静的 API キー（このパッケージ）
認証方法	クライアントがブラウザーを開き、Listable にログインして、アクセスを許可するプロジェクトを選択すれば完了です	管理画面でキーを作成し、クライアント設定に貼り付けます
対応クライアント	Claude.ai ウェブ、Claude Code、Cursor、HTTP MCP＋OAuth 検出に対応する任意のクライアント	Claude Desktop（HTTP トランスポート非対応）、または静的トークン接続を使いたい任意の環境
セットアップ	URL を貼り付けます	このパッケージをインストールし、キーを作成して貼り付けます

クライアントが HTTP MCP トランスポートに対応している場合、シムは必要ありません。以下の OAuth のセットアップ をご覧ください。npm パッケージ（listable-mcp）が必要なのは、Claude Desktop のような stdio のみ対応するクライアントだけです。

OAuth のセットアップ（インストール不要）

MCP エンドポイントは次のとおりです。

https://app.get-listable.com/api/v1/external/mcp

クライアントがベアラートークンなしで接続すると、サーバーは 401 とともに、/.well-known/oauth-protected-resource を指す WWW-Authenticate 検出ヒントを返します。クライアントはこのヒントに従い、ログイン画面にリダイレクトして、スコープ（アクセスを許可するプロジェクトを含む）の承認を求め、トークンを自動的に取得します。アクセストークンの有効期限は1時間で、1か月間はサイレントに更新されます。

Claude.ai（ウェブ）

設定 → インテグレーション → カスタムインテグレーションを追加 → 次を貼り付けます。

https://app.get-listable.com/api/v1/external/mcp

Claude.ai は Listable にリダイレクトし、ログインしてインテグレーションがアクセスできるプロジェクトを選択するよう求めます。Listable 管理画面の API キーページから、いつでもアクセスを取り消せます。

Claude Code

claude mcp add --transport http listable https://app.get-listable.com/api/v1/external/mcp

Claude Code は初回使用時にブラウザーで OAuth の認証フローを実行します。セッション内で /mcp を使って確認してください。

Cursor

設定 → MCP で、HTTP サーバーを追加します。

• 名前: listable
• URL: https://app.get-listable.com/api/v1/external/mcp

Cursor は初回接続時に OAuth フローを開始します。

Stdio フォールバック（この npm パッケージ）

Claude Desktop（HTTP MCP にまだ対応していません）または stdio 専用クライアントでは、この方法を使用してください。まず API キーを作成する必要があります。

1. Listable の管理画面で API Keys を開きます：https://app.get-listable.com/my-account/api-keys
2. Create a new API key をクリックして名前（例：「Claude Desktop」）を付け、必要に応じて特定のプロジェクトにスコープを設定します
3. キーをコピーします。このキーが表示されるのは一度だけです

Claude Desktop

Settings → Developer → Edit Config（claude_desktop_config.json）を開いて、次を追加します：

{
  "mcpServers": {
    "listable": {
      "command": "npx",
      "args": ["-y", "listable-mcp"],
      "env": {
        "LISTABLE_API_TOKEN": "lst_..."
      }
    }
  }
}

Claude Desktop を完全に終了して再起動します。Listable のツールが Search and tools メニューに表示されます。

その他の stdio クライアント

サブプロセスを起動する MCP クライアントであれば、npx -y listable-mcp を実行し、環境変数に LISTABLE_API_TOKEN を渡すことができます。

グローバルインストール（任意）

起動のたびに npx の解決に依存したくない場合は、次のようにします：

npm install -g listable-mcp

その後、クライアントの実行先を npx -y listable-mcp ではなく、listable-mcp バイナリに直接指定します。

設定

環境変数	必須	デフォルト	用途
LISTABLE_API_TOKEN	はい	—	https://app.get-listable.com/my-account/api-keys の API キー
LISTABLE_MCP_URL	いいえ	https://app.get-listable.com/api/v1/external/mcp	上流エンドポイントを上書きします（セルフホスト版の Listable またはステージング環境）

レート制限

• Growth プラン：1 分あたり 60 リクエスト、月あたり 750 回のツール呼び出し
• Pro プラン：1 分あたり 300 リクエスト、月あたりの呼び出し回数は無制限

いずれかの上限に達すると、retry_after（1 分あたりの上限）または quota_reset_at（月あたりの上限）を含む 429 が返されます。一括処理では、多数の個別作成よりも bulk_create_items（1 回の呼び出しで最大 100 件のリスティング）を AI が優先します。

安全性

ツールの説明では、AI に次のことを指示しています：

• 最初に調査する — 編集前に get_schema を呼び出し、適切なカスタムフィールドとブロックタイプを使って変更する
• 破壊的な操作を確認する — 削除、ページ全体のブロック置換、URL 構造の変更、スクリプトの上書きでは、明示的な確認を求める
• 編集前にバックアップする — 問題が発生した場合に復元できるよう、以前の状態をコンテキストに保持する
• 置き換えずに追記する — スクリプト（分析、トラッキング）は既存のコンテンツに追記する

すべてのツール呼び出しは、対象となったプロジェクトに記録されます。Listable の管理画面で Project → API を開くと、タイムラインを確認できます。ソース（MCP と REST）で絞り込め、30 日間保持されます。

アクセスの取り消し

• OAuth の許可：手動で作成したキーとともに API Keys ページに表示されます。そこで取り消してください。
• 静的 API キー：同じ API Keys ページから取り消してください。AI クライアントは次回の呼び出しで 401 エラーを受け取ります。

トラブルシューティング

「Unauthenticated」エラー（stdio シム） — クライアントを起動する同じシェルまたは設定ブロックで LISTABLE_API_TOKEN が設定されていることを確認してください。Claude Desktop では、JSON 設定の env マップにキーを含める必要があります。

OAuth ループ／ブラウザーが戻り先にリダイレクトしない — クライアントのリダイレクト URL に到達できることを確認してください。一部のクライアントは localhost コールバックを使用するため、Cookie やポップアップブロッカーがフローを妨げる場合があります。

「Tool not available」 — クライアントを再起動してください（Claude Desktop では完全に終了して再度開く必要があります）。Claude Code では /mcp を実行して Listable が接続されていることを確認してください。

特定のプロジェクトで 403 が発生する — トークンのスコープが設定されています。OAuth の場合は、承認手続きを再実行して、より多くのプロジェクトを選択してください。静的キーの場合は、プロジェクトのスコープを設定せずに新しいキーを作成してください。

リンク

• Listable：https://get-listable.com
• API と MCP のドキュメント：https://app.get-listable.com/my-account/api-docs
• Model Context Protocol：https://modelcontextprotocol.io

ライセンス

MIT — LICENSE を参照してください。