Vgradili smo WebMCP strežnik: AI agenti zdaj komunicirajo z racunalnicar.eu

Spletno stran racunalnicar.eu smo opremili z WebMCP strežnikom — vmesnikom, prek katerega lahko AI agenti (npr. Claude ali drugi odjemalci z MCP podporo) neposredno komunicirajo s stranjo: preberejo storitve in produkte, pridobijo kontaktne podatke in celo oddajo povpraševanje — vse strukturirano, brez ugibanja iz HTML-ja.

Kaj je MCP in WebMCP

MCP (Model Context Protocol) je odprt standard, ki AI agentom omogoča, da kličejo orodja in berejo podatke prek enotnega protokola. WebMCP to prenese v brskalnik: spletna stran agentu ponudi nabor orodij prek navigator.modelContext, agent pa jih kliče kot funkcije — namesto da bi grebel po vsebini strani.

Kako deluje pri nas

Vgradnja ima dve plasti:

1. Oddaljeni MCP strežnik teče na Cloudflare Workerju na naslovu racunalnicar.eu/mcp, svojo prisotnost pa naznanja na racunalnicar.eu/.well-known/mcp (standard RFC 8615). Govori JSON-RPC 2.0.
2. Brskalniški most (/webmcp.js) se naloži na vsaki strani. Ko stran obišče agent z WebMCP podporo, most pri strežniku vpraša po seznamu orodij (tools/list) in jih registrira prek navigator.modelContext.registerTool (s povratnimi možnostmi provideContext in tools[] za različne odjemalce). Klici orodij se posredujejo nazaj na /mcp.

Za običajnega obiskovalca brez agenta most ne naredi ničesar — stran deluje povsem enako in brez vpliva na hitrost nalaganja.

Javna orodja (brez prijave)

Ta orodja so dostopna vsakemu agentu prek WebMCP-ja:

• list_services / get_service — storitve in tehnološki sklad
• list_products — aktivni produkti s povezavami
• get_contact — kontaktni in poslovni podatki
• submit_inquiry — oddaja povpraševanja (le z izrecno privolitvijo uporabnika)

Anatomija submit_brief — consent gate brez Turnstile-a

submit_brief smo dodali kot strukturirano varianto submit_inquiry — z kind parametrom (web, ai, app) za usmerjanje v pravi projektni flow. Razrez, ker je to najbolj delikatno orodje (write + email send + DB insert).

Vmesnik je prompt. tools/list vrne JSON Schema, ki agentu pove, kaj orodje sprejme. Description ni doc-comment — je prompt:

{
  "name": "submit_brief",
  "description": "Odda projektni brief za SPLETNO STRAN (kind=web), AI INTEGRACIJO (kind=ai) ali SPLETNO APLIKACIJO (kind=app). Uporabi le z izrecno privolitvijo uporabnika (consent=true).",
  "inputSchema": {
    "properties": {
      "kind": { "enum": ["web", "ai", "app"] },
      "name": { "type": "string" },
      "email": { "type": "string" },
      "description": { "type": "string" },
      "consent": { "type": "boolean" }
    },
    "required": ["kind", "name", "email", "description", "consent"]
  }
}

Če v description-u ne piše „kdaj uporabiti", agent ne ve. Eno besedo ven — en bug noter.

Brez Turnstile-a, z consent gate-om. Turnstile je captcha. Agent ga ne prebere. MCP submit_brief ga obide, ker je agent sam trust boundary — če Claude v dialogu z uporabnikom kliče orodje, mu uporabnik pravkar reče „da". Zato consent=true ne sme biti privzeto: model mora eksplicitno postaviti polje na true, kar pomeni eksplicitno privolitev uporabnika.

Risk surface: zlonameren MCP klient mimo Claude UI-ja. Risk je realen, ampak nizek — endpoint je public, brez nagrade za napad. Najslabši primer: spam brief, ki ga zavrnemo ročno.

Vstop v D1. Insert je identičen web-form briefu — isti table, ista kind dimenzija. Razlikuje le ip='mcp' marker, ki v admin panelu loči agentske leade od web leade. Kvaliteta vsakega kanala se trakira ločeno.

Številke. MCP plast: ~230 vrstic v bandur-api/src/index.ts. Javnih orodij: 5. Average response: ~120 ms.

Zaščitena admin orodja (bearer token)

Poleg javnega obstaja ločen, avtenticiran strežnik na racunalnicar.eu/mcp/admin. Dostop je mogoč samo z bearer tokenom (deny-by-default) in je namenjen upravljanju vsebine z lastnim AI agentom:

• create_project / update_project / delete_project / list_projects / get_project
• create_news / update_news / delete_news / list_news / get_news
• get_theme / set_theme — barve in videz strani
• list_contacts — pregled prejetih povpraševanj
• publish — sprožitev ponovne objave strani

Javna in admin orodja sta namenoma ločena: write dostop in zasebni podatki nikoli niso na javni poti.

Zakaj to počnemo

AI agenti vse pogosteje obiskujejo splet namesto ljudi. Stran, ki agentu ponudi strukturirana orodja, je berljiva, takojšnja in zanesljiva — agent ne ugiba, ampak kliče. To imenujemo AI-ready strani.

Enako vgradnjo ponujamo strankam: WebMCP strežnik na njihovi spletni strani, da lahko AI asistenti rezervirajo, povprašujejo ali berejo katalog — varno in pod nadzorom.

Več o standardu MCP ↗