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) — 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). Įvedus 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. Paspaudus „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 — galioja tavo plano limitai ir 60 užklausų/min. greičio ribojimas.
  • OAuth prieigos raktai galioja 7 dienas ir atsinaujina automatiškai (atnaujinimo raktas — 90 dienų, keičiamas kiekvieną kartą).
  • AI agentas gali atlikti ir negrįžtamus veiksmus (pvz., ištrinti nuorodą) — į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.