MCP serveris

Prijunk savo P9.lt paskyrą prie Claude ar bet kurio kito AI agento. AI galės kurti QR kodus, keisti dinamines nuorodas ir skaityti skenavimo statistiką tavo vardu, laikydamasis tavo plano limitų.

Kas yra MCP?

MCP (Model Context Protocol) yra atviras standartas, leidžiantis AI agentams saugiai naudotis išorinėmis paslaugomis. P9.lt MCP serveris veikia adresu https://p9.lt/mcp ir visus veiksmus atlieka per tą pačią REST API su tavo paskyros teisėmis.

Autorizacija

Du būdai. Pasirink pagal savo klientą:

API raktas
Kiekvienas registruotas naudotojas API raktą gauna nemokamai. Jį rasi skiltyje Paskyra → API. Perduok jį kaip Authorization: Bearer antraštę.
OAuth prisijungimas
Klientams be rakto lauko (claude.ai, Claude Desktop). Įvedęs serverio adresą, būsi nukreiptas į įprastą P9.lt prisijungimą ir patvirtinimo langą, jokio rakto kopijuoti nereikia. Prieigą atšauksi pakeitęs paskyros slaptažodį: tada atjungiami visi prijungti AI agentai. Jei naudoji API raktą, prieigą nutrauksi sugeneravęs naują raktą skiltyje Paskyra → API.

Kaip prijungti

claude.ai / Claude Desktop
  1. Atidaryk Settings → Connectors → Add custom connector.
  2. Įvesk adresą https://p9.lt/mcp.
  3. Paspaudęs „Connect“, prisijunk prie P9.lt ir patvirtink prieigą.
Claude Code (terminalas)
claude mcp add --transport http p9 https://p9.lt/mcp --header "Authorization: Bearer {api_key}"
Kiti MCP klientai

Tinka bet kuris Streamable HTTP MCP klientas: adresas https://p9.lt/mcp, autorizacija: Authorization: Bearer <API raktas> antraštė arba OAuth 2.1 (aptinkama automatiškai per /.well-known/oauth-protected-resource).

Įrankiai

AI agentas matys šiuos įrankius:

Įrankis Aprašymas
account_info Account information
list_links List dynamic links
get_link Get dynamic link
create_link Create dynamic link
update_link Update dynamic link
delete_link Delete dynamic link
list_qr_codes List QR codes
get_qr_code Get QR code
create_qr_code Create QR code
delete_qr_code Delete QR code
link_statistics Link scan statistics
list_projects List projects
create_project Create project
update_project Update project
delete_project Delete project
list_domains List custom domains

Limitai ir saugumas

  • Visi veiksmai atliekami per REST API, tad galioja tavo plano limitai ir 60 užklausų/min. greičio ribojimas.
  • OAuth prieigos raktai galioja 7 dienas ir atsinaujina automatiškai (atnaujinimo raktas galioja 90 dienų ir keičiamas kiekvieną kartą).
  • AI agentas gali atlikti ir negrįžtamus veiksmus (pvz., ištrinti nuorodą), todėl įrankiai pažymėti taip, kad agentas prieš tai atsiklaustų.
  • Prieiga naudoja tavo paskyros teises: agentas nemato kitų naudotojų duomenų.

QR kodo atsisiuntimas PNG formatu

QR kodai saugomi SVG formatu. Kai kurie AI agentai SVG nerodo pokalbio lange. Tokiu atveju paprašyk agento panaudoti įrankį get_qr_code_png: jis grąžina QR kodą kaip PNG paveikslėlį tiesiai į pokalbį. Nurodyk qr_code_id (jį gauni iš create_qr_code arba list_qr_codes) ir pasirinktinai dydį pikseliais (100–2000, numatyta 1000).

Pavyzdinis prašymas agentui: „Atsiųsk QR kodą 2150 kaip PNG, 800 pikselių.“

Jei serveryje įdiegtas Imagick, gausi tikslią išsaugoto dizaino kopiją. Jei ne, QR kodas bus sugeneruotas iš naujo pagal tą patį turinį (nuskaitomas identiškai), tačiau be logotipo ir be specialių taškų stilių. Tokiu atveju agentas apie tai praneša.

Pavyzdys

Paprašyk savo AI agento: „Sukurk dinaminę nuorodą į mano-svetaine.lt/akcija, pridėk jai QR kodą ir po savaitės pasakyk, kiek žmonių nuskenavo.“. Visa tai įmanoma vien per MCP įrankius.