Skip to main content

MCP Server

Conectează PayLinks la Claude Desktop, Cursor și alte tool-uri AI compatibile MCP.

Ce este MCP?​

Model Context Protocol (MCP) este un standard pentru conectarea asistenților AI la tool-uri externe și surse de date. Serverul MCP PayLinks îți permite să gestionezi plățile prin Claude Desktop și alți clienți MCP.

Instalare​

npx mcp-paylinks

Nu este nevoie de instalare globală — npx îl rulează direct.

Configurare​

Variabile de mediu​

VariabilăObligatoriuDescriere
PAYLINKS_API_TOKENDaJWT bearer token-ul tău
PAYLINKS_API_BASE_URLNuURL-ul de bază al API (implicit: https://api.paylinks.ro/api/v1)

Claude Desktop​

Adaugă în configurația Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json pe macOS):

{
  "mcpServers": {
    "paylinks": {
      "command": "npx",
      "args": ["mcp-paylinks"],
      "env": {
        "PAYLINKS_API_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

Restartează Claude Desktop după salvare.

Cursor​

Adaugă în .cursor/mcp.json din proiectul tău:

{
  "mcpServers": {
    "paylinks": {
      "command": "npx",
      "args": ["mcp-paylinks"],
      "env": {
        "PAYLINKS_API_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

Transport SSE​

Pentru conexiuni la distanță, serverul MCP suportă transport SSE (Server-Sent Events):

PAYLINKS_API_TOKEN=your-token npx mcp-paylinks --sse --port 3100

Apoi conectează clientul MCP la http://localhost:3100/sse.

Tool-uri disponibile​

Serverul MCP expune 41 de tool-uri:

Linkuri de plată (7)​

  • list_paylinks — Listează toate linkurile de plată
  • get_paylink — Obține paylink după ID
  • create_paylink — Creează un link de plată
  • update_paylink — Actualizează un paylink
  • delete_paylink — Șterge un paylink
  • duplicate_paylink — Duplică un paylink
  • ai_draft_paylink — Generare cu AI din prompt

Tranzacții (2)​

  • list_transactions — Listează tranzacțiile
  • refund_transaction — Rambursează o tranzacție

Clienți (1)​

  • list_customers — Listează clienții pe segment

Analitice (5)​

  • get_analytics_summary — Sumar dashboard
  • get_revenue_data — Venituri în timp
  • get_mrr_data — Venit lunar recurent
  • get_payment_methods — Distribuția metodelor de plată
  • trigger_reconciliation — Reconciliere cu Stripe

Stripe (6)​

  • get_stripe_balance — Soldul contului
  • list_stripe_payouts — Listează plățile către cont
  • create_stripe_payout — Creează o plată către cont
  • get_stripe_account — Cont conectat
  • get_stripe_requirements — Cerințe de verificare
  • create_stripe_account_link — Link de onboarding

Dispute (3)​

  • list_disputes — Listează disputele
  • get_dispute — Obține dispută
  • submit_dispute_evidence — Trimite dovezi

Setări (2)​

  • get_settings — Obține setările
  • update_settings — Actualizează setările

Abonamente (1)​

  • list_subscriptions — Listează abonamentele

Achiziții (3)​

  • list_purchases — Listează achizițiile
  • download_purchase — Obține URL-ul de descărcare
  • cancel_subscription — Anulează abonament

Email (6)​

  • list_broadcasts — Listează broadcast-urile
  • create_broadcast — Creează broadcast
  • send_broadcast — Trimite broadcast
  • ai_draft_broadcast — Generează broadcast cu AI
  • list_subscribers — Listează abonații
  • add_subscriber — Adaugă abonat

Profil (2)​

  • get_profile — Obține utilizatorul curent
  • update_profile — Actualizează profilul

Upload-uri (1)​

  • presign_upload — Obține URL presemnat pentru upload

Public (2)​

  • list_public_paylinks — Listează paylink-urile publice
  • get_public_paylink — Obține paylink public

Exemple de conversații​

Cu Claude Desktop:

"Arată-mi sumarul dashboard-ului PayLinks"

Claude apelează get_analytics_summary și prezintă veniturile, tranzacțiile și numărul de clienți.

"Creează un link de plată pentru consultanță la 500 RON pe oră"

Claude apelează create_paylink cu parametrii corespunzători.

"Scrie și trimite un email către toți abonații despre reducerile de Black Friday"

Claude apelează ai_draft_broadcast, arată draft-ul, iar la aprobare apelează send_broadcast.

Obținerea token-ului​

  1. Mergi pe paylinks.ro și autentifică-te
  2. Deschide DevTools din browser (F12)
  3. Navighează la Application > Local Storage > https://paylinks.ro
  4. Copiază valoarea token

Sau folosește fluxul magic link programatic (vezi Autentificare).

MCP Server pe scurt​

Serverul MCP PayLinks expune 41 de tool-uri în 12 module: Linkuri de plată (7), Tranzacții (2), Clienți (1), Analitice (5), Stripe (6), Dispute (3), Setări (2), Abonamente (1), Achiziții (3), Email (6), Profil (2), Upload-uri (1) și Public (2). Suportă atât protocolul de transport stdio cât și SSE și rulează prin npx mcp-paylinks fără instalare.

Întrebări frecvente​

Cum instalez serverul MCP?​

Nu este nevoie de instalare. Rulează npx mcp-paylinks și se descarcă și execută automat. Pentru Claude Desktop, adaugă serverul în claude_desktop_config.json. Pentru Cursor, adaugă-l în .cursor/mcp.json.

Ce clienți MCP sunt suportați?​

Serverul MCP PayLinks funcționează cu orice client compatibil MCP inclusiv Claude Desktop, Cursor, Claude Code și alte tool-uri care suportă Model Context Protocol. Sunt suportate ambele protocoale de transport stdio (local) și SSE (remote).

Pot rula serverul MCP de la distanță?​

Da. Folosește npx mcp-paylinks --sse --port 3100 pentru a porni serverul cu transport SSE. Apoi conectează clientul MCP la http://localhost:3100/sse. Aceasta permite conexiuni la distanță și instanțe de server partajate.