English Français العربية

LinkBit

السجل الرسمي التسويق والمبيعات

Shorten URLs, bulk create, QR, and click analytics for LinkBit.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package linkbit-mcp
Claude Code 
claude mcp add linkbit -e 'API_KEY=<your api_key>' -e 'APP_URL=<APP_URL>' -- npx -y linkbit-mcp@1.0.4
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "linkbit": {
            "command": "npx",
            "args": [
                "-y",
                "linkbit-mcp@1.0.4"
            ],
            "env": {
                "API_KEY": "<your api_key>",
                "APP_URL": "<APP_URL>"
            }
        }
    }
}

متغيرات البيئة

  • API_KEY إلزامي سري LinkBit API key (slk_...)
  • APP_URL API origin, default https://linkbit.live

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. linkbit-mcp
  2. Setup
  3. Install
  4. Example prompts
  5. Tools
  6. Errors
  7. Local development (ShortLinks monorepo)

linkbit-mcp

MCP server for LinkBit: shorten links, bulk create, QR codes, and click analytics from Claude, ChatGPT, Cursor, and n8n.

Public docs: linkbit.live/docs · linkbit.live/mcp

Setup

  1. Sign in at linkbit.live and create an API key (slk_...) on the API Keys page.
  2. Node.js 18+ is required (fetch).
APP_URL=https://linkbit.live
API_KEY=slk_your_key

Auth against the REST API uses either Authorization: Bearer slk_... or x-api-key: slk_.... This server sends Bearer.

Install

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"
      }
    }
  }
}

Example prompts

  • Shorten https://example.com/campaign as slug spring and utm_source newsletter
  • List my links and show clicks for the first id since 2026-01-01
  • Disable link <id> then generate a print PNG QR

Tools

ToolParametersNotes
shorten_urldestination (required), slug, note, utm_source, utm_medium, utm_campaign, utm_term, utm_contentExisting utm_* on the URL are not overwritten; #fragment is kept
shorten_urlsurls[] with the same fieldsBulk create
list_links—Newest first
update_linkid, optional destination/slug/note/UTM/disabledPATCH
disable_linkid, optional disabled (default true)Stops redirects. destructiveHint: true
delete_linkidPermanent. destructiveHint: true
get_qrid, format png\svg, color, logo, printPNG as an image block when possible
get_link_statsid, optional from, to (YYYY-MM-DD)Countries, devices, referrers, daily
get_analytics—Account overview

Errors

Tool failures (missing key, 401, invalid URL, daily limit, unsafe destination) are returned as tools/call with isError: true so the model can explain them. Protocol errors (unknown method, bad JSON) stay JSON-RPC errors.

  • 401 — API key missing or wrong (slk_...). Create a key under API Keys.
  • 400 — invalid URL, slug taken, daily create limit, blocked or unsafe destination.
  • 404 — unknown link id.
  • Process fails at start if Node is older than 18 (fetch is required).

n8n, Make, and custom agents can also call /api/v1 with the same headers.

Until npm publish, Cursor can run the copy in this folder:

  1. Copy mcp/cursor.mcp.json.example to .cursor/mcp.json (gitignored) or ~/.cursor/mcp.json.
  2. Paste the slk_… key into env.API_KEY.
  3. For this repo before publish, use "command": "node" and "args": ["mcp/src/index.js"].

الأسئلة الشائعة

ما هو LinkBit؟

Shorten URLs, bulk create, QR, and click analytics for LinkBit.

كيف أثبّت LinkBit؟

يعمل على جهازك. في Claude Code: claude mcp add linkbit -e 'API_KEY=<your api_key>' -e 'APP_URL=<APP_URL>' -- npx -y linkbit-mcp@1.0.4. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج LinkBit إلى مفتاح API؟

نعم. يتطلب API_KEY، وتضبطها في إعداداته.

هل LinkBit مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون LinkBit؟

ينشره yutotanakastar. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.