Μετάβαση στο περιεχόμενο
Όλα τα άρθρα

mcpclaude-codeagents

Πώς να προσθέσετε URL shortener στο Claude Code μέσω MCP

Συνδέστε το Claude Code με το Linkdash μέσω MCP για σύντομους συνδέσμους, κατανομή κίνησης, κοινή χρήση αρχείων και στατιστικά κλικ μέσα από το τερματικό.

Igor Kirnosov6 λεπ. ανάγνωσης

Το Claude Code καλεί τον MCP server του Linkdash για να δημιουργήσει τον σύντομο σύνδεσμο lida.sh/pricing

Το Claude Code μπορεί να δημιουργεί και να διαχειρίζεται σύντομους συνδέσμους μόλις το συνδέσετε με έναν URL shortener μέσω MCP. Προσθέστε τον MCP server του Linkdash με μία εντολή, συνδεθείτε μία φορά στον browser σας, και το Claude μπορεί να συντομεύει URLs, να μοιράζει την κίνηση ανάμεσα σε σελίδες, να μοιράζεται αρχεία με λήξη και να διαβάζει στατιστικά κλικ, όλα από την ίδια συνεδρία τερματικού όπου γράφει τον κώδικά σας.

Αυτός ο οδηγός καλύπτει τη ρύθμιση, την κοινή χρήση της με την ομάδα σας, την επιλογή των εργαλείων που μπορεί να εκτελεί το Claude χωρίς να ρωτά, τις ροές εργασίας όπου αξίζει και την εκτέλεση σε CI. Χρησιμοποιείτε Cursor ή Codex; Η τεκμηρίωση MCP έχει τις εντολές ρύθμισής τους.

Τι μπορεί να κάνει το Claude Code με αυτό

Ο MCP server του Linkdash εκθέτει τις ίδιες λειτουργίες με το CLI και το HTTP API, ως εργαλεία που το Claude ανακαλύπτει μόνο του:

Εργαλεία Τι μπορεί να κάνει το Claude
links_create, links_update, links_delete Δημιουργία, αλλαγή, παύση και αφαίρεση συνδέσμων
variants_add, variants_update, variants_remove Κατανομή κίνησης ή δρομολόγηση ανά χώρα, συσκευή ή λειτουργικό
links_list, links_get, links_stats Εύρεση συνδέσμων και ανάγνωση επισκέψεων, χωρών και παραπομπών
files_upload_url Μεταφόρτωση αρχείου και κοινή χρήση του ως σύνδεσμο
links_export, links_import Εισαγωγή και εξαγωγή συνδέσμων σε CSV
domains_*, webhooks_* Διαχείριση προσαρμοσμένων domains και webhooks

Βήμα 1: Προσθέστε τον server

claude mcp add --transport http linkdash \
  https://api.linkdash.dev/mcp

Αυτό προσθέτει το Linkdash για το τρέχον project. Προσθέστε --scope user για να είναι διαθέσιμο σε κάθε project στο μηχάνημά σας.

Βήμα 2: Συνδεθείτε

claude mcp login linkdash

Ο browser σας ανοίγει τη σύνδεση του Linkdash. Αν δεν έχετε ακόμη λογαριασμό, μπορείτε να δημιουργήσετε εκεί έναν στο πρόγραμμα Free. Αφού συνδεθείτε, μια οθόνη συναίνεσης ρωτά αν το Claude Code μπορεί να χρησιμοποιεί τον λογαριασμό σας. Πατήστε Αποδοχή, και το Claude Code αποθηκεύει το access token και το ανανεώνει μόνο του.

Μπορείτε επίσης να συνδεθείτε μέσα από μια συνεδρία: εκτελέστε /mcp, επιλέξτε linkdash και διαλέξτε authenticate. Ελέγξτε τη σύνδεση με:

claude mcp list

Το linkdash πρέπει να εμφανίζεται ως ✔ Connected. Μετά δοκιμάστε:

Συντόμευσε το https://example.com/pricing ως lida.sh/pricing.

Το Claude καλεί το links_create και απαντά με τον νέο σύντομο σύνδεσμο.

Βήμα 3: Μοιραστείτε τη ρύθμιση με την ομάδα σας

Για να έχουν όλοι σε ένα repository τον ίδιο server, προσθέστε ένα αρχείο .mcp.json στη ρίζα του project:

{
  "mcpServers": {
    "linkdash": {
      "type": "http",
      "url": "https://api.linkdash.dev/mcp"
    }
  }
}

Το αρχείο δεν περιέχει τίποτα μυστικό, οπότε μπορείτε να το κάνετε commit με ασφάλεια. Την πρώτη φορά που ένας συνάδελφος ανοίγει το project, το Claude Code του ζητά να εγκρίνει τον server, και ο καθένας συνδέεται με τον δικό του λογαριασμό Linkdash, ώστε κάθε σύνδεσμος να καταλήγει στον λογαριασμό εκείνου που τον ζήτησε.

Βήμα 4: Αποφασίστε τι εκτελείται χωρίς ερώτηση

Από προεπιλογή, το Claude Code ρωτά πριν καλέσει ένα εργαλείο MCP. Η ανάγνωση στατιστικών είναι ακίνδυνη, οπότε αξίζει να επιτραπεί· η διαγραφή συνδέσμων αξίζει να μπλοκαριστεί εντελώς. Προσθέστε κανόνες δικαιωμάτων στο .claude/settings.json:

{
  "permissions": {
    "allow": [
      "mcp__linkdash__links_list",
      "mcp__linkdash__links_get",
      "mcp__linkdash__links_stats"
    ],
    "deny": [
      "mcp__linkdash__links_delete",
      "mcp__linkdash__variants_remove"
    ]
  }
}

Τα εργαλεία MCP ονομάζονται mcp__<server>__<tool>, οπότε αυτοί οι κανόνες προϋποθέτουν ότι ονομάσατε τον server linkdash στο βήμα 1. Η δημιουργία και η ενημέρωση συνδέσμων εξακολουθούν να ρωτούν κάθε φορά, ώστε να έχετε τον έλεγχο σε ό,τι αλλάζει το πού οδηγεί ένας σύνδεσμος.

Ροές εργασίας που αξίζουν στο τερματικό

Συντομεύστε κάθε σύνδεσμο μιας έκδοσης

Δημιούργησε σύντομους συνδέσμους για κάθε URL στο CHANGELOG.md κάτω από το 2.4.0, βάλε τους την ετικέτα release-2.4 και αντικατάστησε τα URLs στο αρχείο.

Το Claude διαβάζει το αρχείο, καλεί το links_create μία φορά ανά URL με την ετικέτα και επεξεργάζεται το changelog. Η ετικέτα κρατά μαζί τους συνδέσμους της έκδοσης στον πίνακα ελέγχου και σε μεταγενέστερες ερωτήσεις για στατιστικά.

Μοιράστε την κίνηση σε μια σελίδα που μόλις φτιάξατε

Δημιούργησε το lida.sh/pricing που μοιράζει τους επισκέπτες 50/50 ανάμεσα στο /pricing και στο /pricing-v2, με utm_content ίσο με το όνομα κάθε παραλλαγής.

Το Claude δημιουργεί έναν σύνδεσμο με δύο παραλλαγές, την καθεμία σημασμένη ώστε το εργαλείο αναλυτικών σας να ξεχωρίζει τις ομάδες. Ο οδηγός για το A/B test ενός συνδέσμου εξηγεί πόσο να τρέξει η δοκιμή και πώς να διαβάσετε το αποτέλεσμα.

Μοιραστείτε ένα build που λήγει

Μοιράσου το dist/app-1.4.2.dmg ως σύνδεσμο που λήγει σε 3 ημέρες και σταματά μετά από 5 ανοίγματα.

Επειδή το Claude Code έχει shell, μπορεί να χειριστεί αρχεία: καλεί το files_upload_url, ανεβάζει το αρχείο στο URL που επιστρέφεται με curl και μετά καλεί το links_create με το αρχείο που ανέβηκε, expires: "3d" και maxOpenings: 5. Το αρχείο δεν περνά ποτέ μέσα από την ίδια τη συνομιλία.

Δείτε πώς πάνε οι σύνδεσμοι

Ποιοι σύνδεσμοι με την ετικέτα release-2.4 είχαν τις περισσότερες επισκέψεις τις τελευταίες 7 ημέρες και από πού ήρθαν οι επισκέψεις;

Το Claude απαριθμεί τους συνδέσμους με την ετικέτα και μετά καλεί το links_stats για τον καθένα με last: "7d". Κάθε αποτέλεσμα περιλαμβάνει επισκέψεις, χώρες και παραπομπές. Με τους κανόνες δικαιωμάτων του βήματος 4, αυτές οι αναγνώσεις εκτελούνται χωρίς ερώτηση.

Εκτέλεση του Claude Code σε CI

Η σύνδεση χρειάζεται έναν άνθρωπο μπροστά σε browser, οπότε οι headless εκτελέσεις, όπως το claude -p σε ένα CI job, χρησιμοποιούν κλειδί API. Δημιουργήστε ένα στα Κλειδιά API (τα κλειδιά ξεκινούν με ldash_), αποθηκεύστε το ως CI secret με όνομα LINKDASH_API_KEY και περάστε το ως header:

{
  "mcpServers": {
    "linkdash": {
      "type": "http",
      "url": "https://api.linkdash.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${LINKDASH_API_KEY}"
      }
    }
  }
}

Το Claude Code συμπληρώνει το ${LINKDASH_API_KEY} από το περιβάλλον, οπότε το ίδιο το κλειδί δεν γίνεται ποτέ commit. Τα εργαλεία και οι κανόνες δικαιωμάτων λειτουργούν με τον ίδιο τρόπο και στις δύο περιπτώσεις.

MCP ή CLI;

Το Claude Code μπορεί επίσης να εκτελεί το CLI linkdash μέσω του shell του, και τα δύο φτάνουν στον ίδιο λογαριασμό:

  • Το MCP δεν χρειάζεται εγκατάσταση. Το Claude βλέπει εργαλεία με τύπους και τις παραμέτρους τους, κάτι που το κάνει την ευκολότερη επιλογή όταν θέλετε απλώς το Claude να διαχειρίζεται συνδέσμους.
  • Το CLI (npm i -g linkdash-cli) εμφανίζει JSON, που ταιριάζει σε scripts που γράφει το Claude για εσάς. Για να μάθει το Claude το CLI, εγκαταστήστε το skill του Linkdash για agents με npx skills add https://linkdash.dev/skills/linkdash/SKILL.md.

Αντιμετώπιση προβλημάτων

  • Το linkdash εμφανίζει ! Needs authentication. Εκτελέστε claude mcp login linkdash και συνδεθείτε ξανά. Αυτό συμβαίνει επίσης αφού αποσυνδέσετε το Claude Code από τον πίνακα ελέγχου.
  • Ένας server από το .mcp.json μένει σε αναμονή. Ξεκινήστε το claude στο project και εγκρίνετέ τον. Το claude mcp reset-project-choices καθαρίζει τις προηγούμενες επιλογές.
  • Τα εργαλεία αποτυγχάνουν με σφάλμα 401 σε CI. Το LINKDASH_API_KEY λείπει ή είναι λάθος σε εκείνο το περιβάλλον, ή το κλειδί διαγράφηκε.

Συχνές ερωτήσεις

Βλέπει το Claude τον κωδικό μου ή κάποιο κλειδί;

Όχι. Συνδέεστε στο linkdash.dev από τον browser σας, και το Claude Code λαμβάνει ένα token που κρατά στη δική του διαμόρφωση. Ούτε ο κωδικός σας ούτε το token χρειάζεται να εμφανιστούν στη συνομιλία.

Πώς αποσυνδέω το Claude Code;

Στον πίνακα ελέγχου του Linkdash, ανοίξτε τα Κλειδιά API και πατήστε Αποσύνδεση δίπλα στο Claude Code, στις Συνδεδεμένες εφαρμογές. Η πρόσβασή του σταματά αμέσως. Η εντολή claude mcp logout linkdash αφαιρεί επίσης το αποθηκευμένο token από το μηχάνημά σας.

Μπορεί το Claude να διαγράψει τους συνδέσμους μου;

Μόνο αν το αφήσετε. Οι κανόνες deny του βήματος 4 μπλοκάρουν τα links_delete και variants_remove ακόμη κι αν το Claude προσπαθήσει.

Είναι δωρεάν;

Ναι, στο πρόγραμμα Free, που περιλαμβάνει 5.000 συμβάντα τον μήνα. Δείτε τις τιμές για μεγαλύτερα όρια.

Μπορώ να συνδέσω και Cursor, Codex ή ChatGPT;

Ναι. Ο ίδιος server λειτουργεί με όλα, και τα περισσότερα χρειάζονται μόνο το URL και μια σύνδεση. Η τεκμηρίωση MCP έχει τα βήματα για το καθένα.