Linkonda
Create and manage Linkonda short links from an AI assistant, with no per-visitor tracking.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
@veranoapp/linkonda-mcpclaude mcp add linkonda -e 'LINKONDA_API_KEY=<your linkonda_api_key>' -e 'LINKONDA_API_BASE_URL=<LINKONDA_API_BASE_URL>' -- npx -y @veranoapp/linkonda-mcp@0.1.5
{
"mcpServers": {
"linkonda": {
"command": "npx",
"args": [
"-y",
"@veranoapp/linkonda-mcp@0.1.5"
],
"env": {
"LINKONDA_API_KEY": "<your linkonda_api_key>",
"LINKONDA_API_BASE_URL": "<LINKONDA_API_BASE_URL>"
}
}
}
}
متغيرات البيئة
LINKONDA_API_KEYسري Linkonda API key (paid plans). Optional — without it the server still shortens URLs anonymously, but links expire and account tools are unavailable.LINKONDA_API_BASE_URLOverride the API host. Defaults to https://api.linkonda.com.
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
Linkonda MCP server
Create and manage Linkonda short links from Claude, Claude Code, Cursor, or any other MCP client.
Linkonda records a total redirect count per link and nothing else — no IP addresses, geolocation, device data, or referrers. That matters more than usual for an agent, which can generate links in bulk without building a visitor dataset you then have to secure, retain, and answer requests about.
Works without an API key
Most shortener MCP servers refuse to start without credentials. This one shortens URLs immediately on install: anonymous links are capped per network and expire after 30 days. Add a key when you want links that persist and can be managed.
| No key | With LINKONDA_API_KEY | |
|---|---|---|
shorten_link | ✅ 10 links, expire after 30 days | ✅ permanent, saved to your account |
get_link_stats | ✅ | ✅ |
check_quota | ✅ anonymous allowance | ✅ your plan |
shorten_links_bulk, list_links, update_link, delete_link | ✗ | ✅ |
Bearer authentication requires a paid plan — see pricing. Create a key in the dashboard under API keys; it is shown once.
Install
Add to your MCP client config (Claude Desktop: claude_desktop_config.json; Claude Code: .mcp.json):
{
"mcpServers": {
"linkonda": {
"command": "npx",
"args": ["-y", "@veranoapp/linkonda-mcp"]
}
}
}
To use an API key, add it to the same entry:
{
"mcpServers": {
"linkonda": {
"command": "npx",
"args": ["-y", "@veranoapp/linkonda-mcp"],
"env": { "LINKONDA_API_KEY": "lk_your_key_here" }
}
}
}
| Variable | Default | Purpose |
|---|---|---|
LINKONDA_API_KEY | (unset) | Bearer key. Omit to run anonymously. |
LINKONDA_API_BASE_URL | https://api.linkonda.com | Point at another instance. |
Tools
| Tool | What it does | Key required |
|---|---|---|
shorten_link | Shorten one URL | No |
shorten_links_bulk | Shorten up to 100 URLs in one request | Yes |
list_links | List your links with destinations and click counts | Yes |
update_link | Change a destination, or pause/resume a link | Yes |
delete_link | Permanently delete a link | Yes |
get_link_stats | Total redirect count for a link | No |
check_quota | Links live vs. plan allowance | No |
shorten_links_bulk is partial-success: some entries can fail (quota, invalid URL) while others are created, and the tool reports both lists rather than only the successes.
What you cannot get
There is no per-visitor data to return, so there are no tools for geographic, device, or referrer breakdowns — that data is never collected. If your workflow needs click attribution, a tracking shortener is the right tool; see the comparisons.
Development
npm install
npm run build
LINKONDA_API_KEY=lk_... npm start # speaks MCP over stdio
npm run typecheck runs the compiler without emitting.
الأسئلة الشائعة
ما هو Linkonda؟
Create and manage Linkonda short links from an AI assistant, with no per-visitor tracking.
كيف أثبّت Linkonda؟
يعمل على جهازك. في Claude Code: claude mcp add linkonda -e 'LINKONDA_API_KEY=<your linkonda_api_key>' -e 'LINKONDA_API_BASE_URL=<LINKONDA_API_BASE_URL>' -- npx -y @veranoapp/linkonda-mcp@0.1.5. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Linkonda إلى مفتاح API؟
نعم. يتطلب LINKONDA_API_KEY، وتضبطها في إعداداته.
هل Linkonda مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Linkonda؟
ينشره Verano-DE. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.