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ăți, analitice, dispute, operațiuni cu clienți și instrumente business gratuite direct din clientul AI.

Instalare​

npx mcp-paylinks

Nu este nevoie de instalare globală. npx descarcă și rulează serverul direct.

Configurare​

Variabile de mediu​

VariabilăObligatoriuDescriere
PAYLINKS_API_TOKENDaJWT bearer token-ul tău
PAYLINKS_API_BASE_URLNuURL de bază API (implicit: https://paylinks.ro)
PAYLINKS_API_TIMEOUT_MSNuTimeout request în ms (implicit: 15000)

Claude Desktop​

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

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

Restartează Claude Desktop după salvare.

Cursor​

Adaugă în .cursor/mcp.json din proiect:

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

Transport SSE​

Pentru conexiuni remote, serverul MCP suportă 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 61 de tool-uri publice în 16 module:

  • list_paylinks
  • get_paylink
  • create_paylink
  • update_paylink
  • delete_paylink
  • duplicate_paylink
  • toggle_paylink
  • ai_draft_paylink

Tranzacții (1)​

  • get_transactions

Analitice (5)​

  • get_analytics_summary
  • get_revenue
  • get_mrr
  • get_payment_methods
  • reconcile_analytics

Stripe (6)​

  • get_balance
  • get_payouts
  • create_payout
  • get_stripe_account
  • create_account_link
  • get_account_requirements

Clienți (1)​

  • get_customers

Abonamente (1)​

  • list_subscriptions

Dispute (3)​

  • list_disputes
  • get_dispute
  • submit_dispute_evidence

Email (7)​

  • list_broadcasts
  • create_broadcast
  • get_broadcast
  • send_broadcast
  • ai_draft_broadcast
  • list_subscribers
  • add_subscriber

Achiziții (3)​

  • list_purchases
  • presign_download
  • cancel_purchase_subscription

Profil (3)​

  • get_me
  • update_me
  • complete_onboarding

Setări (2)​

  • get_settings
  • update_settings

Auth (2)​

  • request_magic_link
  • verify_magic_link

Upload-uri (1)​

  • presign_upload

Crypto (3)​

  • crypto_list_wallets
  • crypto_get_balance
  • crypto_create_payment_link

Public (3)​

  • list_public_paylinks
  • get_public_paylink
  • claim_free_paylink

Free Tools (12)​

  • free_generate_proforma_totals
  • free_convert_bank_statement_rows
  • free_verify_cui
  • free_generate_qr_payload
  • free_calculate_pfa_taxes
  • free_calculate_vat
  • free_calculate_net_income
  • free_compare_payment_commissions
  • free_calculate_hourly_rate
  • free_get_fiscal_calendar_events
  • free_quiz_pfa_vs_srl
  • free_split_bill

Resurse disponibile​

Serverul MCP expune și 3 resurse:

  • paylinks://dashboard/stats
  • paylinks://activity/recent
  • paylinks://account/overview

Tool-uri Privilegiate​

Operatiunile MCP privilegiate nu sunt listate in catalogul public si sunt inregistrate doar cand token-ul API furnizat are permisiuni elevate.

Exemple de conversații​

"Creează un link de plată pentru consultanță la 500 RON, apoi arată-mi veniturile și MRR-ul pe luna curentă."

Asistentul poate apela create_paylink, get_revenue și get_mrr.

"Scrie și trimite o campanie email de Black Friday către toți abonații."

Asistentul poate apela ai_draft_broadcast, create_broadcast și send_broadcast.

"Rulează quiz PFA vs SRL și compară comisioanele procesatorilor pentru 10.000 RON/lună."

Asistentul poate apela free_quiz_pfa_vs_srl și free_compare_payment_commissions.

Cum obții token-ul​

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

Sau folosește fluxul programatic din Autentificare.

MCP Server pe scurt​

Serverul MCP PayLinks expune 61 de tool-uri publice in 16 module, plus 3 resurse. Suporta transport stdio si SSE si ruleaza prin npx mcp-paylinks fara instalare. Operatiunile privilegiate sunt disponibile doar pentru token-uri cu permisiuni elevate.

Întrebări frecvente​

Cum instalez serverul MCP?​

Nu este nevoie de instalare. Rulează npx mcp-paylinks și se descarcă + rulează automat.

Ce clienți MCP sunt suportați?​

Serverul MCP PayLinks funcționează cu orice client compatibil MCP, inclusiv Claude Desktop, Cursor, Claude Code și alți clienți Model Context Protocol.

Pot rula serverul MCP remote?​

Da. Rulează npx mcp-paylinks --sse --port 3100 și conectează clientul MCP la http://localhost:3100/sse.