LinkBit

linkbit-mcp

LinkBit の MCP サーバーです。Claude、ChatGPT、Cursor、n8n から、リンクの短縮、一括作成、QR コードの生成、クリック分析を行えます。

公開ドキュメント：linkbit.live/docs · linkbit.live/mcp

セットアップ

1. linkbit.live にサインインし、API Keys ページで API キー（slk_...）を作成します。
2. Node.js 18+ が必要です（fetch）。

APP_URL=https://linkbit.live
API_KEY=slk_your_key

REST API の認証には、Authorization: Bearer slk_... または x-api-key: slk_... のいずれかを使用します。このサーバーは Bearer を送信します。

インストール

npx -y linkbit-mcp

Claude Code：

claude mcp add linkbit -e API_KEY=slk_your_key -e APP_URL=https://linkbit.live -- npx -y linkbit-mcp

Claude Desktop / Cursor（mcp.json）：

{
  "mcpServers": {
    "linkbit": {
      "command": "npx",
      "args": ["-y", "linkbit-mcp"],
      "env": {
        "APP_URL": "https://linkbit.live",
        "API_KEY": "slk_your_key"
      }
    }
  }
}

プロンプトの例

• https://example.com/campaign を、スラッグ spring、utm_source newsletter で短縮してください
• リンクの一覧を表示し、最初の ID の 2026-01-01 以降のクリック数を表示してください
• リンク <id> を無効にしてから、印刷用の PNG QR コードを生成してください

ツール

ツール	パラメーター	備考
shorten_url	destination（必須）、slug、note、utm_source、utm_medium、utm_campaign、utm_term、utm_content	URL に既存の utm_* がある場合は上書きされません。#fragment は保持されます
shorten_urls	同じフィールドを持つ urls[]	一括作成
list_links	—	新しい順
update_link	id、任意の destination/slug/note/UTM/disabled	PATCH
disable_link	id、任意の disabled（デフォルトは true）	リダイレクトを停止します。destructiveHint: true
delete_link	id	完全に削除します。destructiveHint: true
get_qr	id、format png|svg、color、logo、print	可能な場合は PNG を画像ブロックとして返します
get_link_stats	id、任意の from、to（YYYY-MM-DD）	国、デバイス、リファラー、日別
get_analytics	—	アカウントの概要

エラー

ツールの失敗（キーがない、401、無効な URL、1 日の上限、安全でないリンク先）は、モデルが説明できるように isError: true を付けた tools/call として返されます。プロトコルエラー（不明なメソッド、不正な JSON）は JSON-RPC エラーのままです。

• 401 — API キーがないか、誤っています（slk_...）。API Keys でキーを作成してください。
• 400 — 無効な URL、使用済みのスラッグ、1 日の作成上限、ブロックされたリンク先、または安全でないリンク先です。
• 404 — 不明なリンク ID です。
• Node のバージョンが 18 より古い場合、起動時にプロセスが失敗します（fetch が必要です）。

n8n、Make、カスタムエージェントからも、同じヘッダーを使って /api/v1 を呼び出せます。

ローカル開発（ShortLinks モノレポ）

npm publish までは、Cursor でこのフォルダーのコピーを実行できます。

1. mcp/cursor.mcp.json.example を .cursor/mcp.json（gitignore 対象）または ~/.cursor/mcp.json にコピーします。
2. slk_… キーを env.API_KEY に貼り付けます。
3. 公開前にこのリポジトリで使用する場合は、"command": "node" と "args": ["mcp/src/index.js"] を指定します。