Preskoči na glavni sadržaj
Javni vodič za AI konektore

Sigurno povežite AI asistenta s Kernionom

Koristite Hermes, Claude Code ili bilo koji MCP-kompatibilni klijent za pregled, nacrte, QA i operacije u Site Studiju kroz ograničene presete — bez davanja administratorske sesije agentu.

Agencijski partneri izdaju konektore na stranici Integracije u svom agencijskom prostoru. Platformska podrška izdaje konektore ograničene na zakupca iz agencijskog kokpita.

Brzi početak

Tri sigurna koraka, bez javnih tajni

Za jednu instalaciju ili profil asistenta koristi se izvorno odobrenje u pregledniku, a zatim se odabire obuhvat stranica. Nisu potrebni statički ključ ni pomoćni program za modele. Lokalni naziv poslužitelja ne odabire stranicu.

1

Odabir asistenta

Za jednu instalaciju ili profil asistenta koristi se izvorno odobrenje u pregledniku, a zatim se odabire obuhvat stranica. Nisu potrebni statički ključ ni pomoćni program za modele. Lokalni naziv poslužitelja ne odabire stranicu.

2

Obuhvat stranica

Odobrava se instalacija asistenta za niže prikazane stranice i ovlasti. Pristup se pri svakom pozivu provjerava prema trenutačnoj ulozi na svakoj stranici. Opoziv je uvijek dostupan u vezama računa.

3

Provjera zabilježene aktivnosti

Nakon odobrenja status je dostupan u odjeljku Povezani AI asistenti. Odobrenje nije isto što i potvrđena uporaba; aktivnost dokazuje samo uspješno zabilježena radnja alata.

Preseti

Koristite presete umjesto ručnog biranja opasnih checkboxova

Autentificirani ekrani i dalje prikazuju napredne detalje o mogućnostima. Normalan put je preset-first: draft-only kao zadano, a eksplicitna mogućnost objave samo kad je potrebna.

Čitanje + QA

Pregled odabranih stranica, shema i QA nalaza bez uređivanja nacrta.

Rizik

Najsigurniji pristup za audite, support triage i otkrivanje alata.

Mogućnosti

  • studio.read
  • studio.schema.read
  • studio.qa.run

Uređivač nacrta

Preporučeno prvo

Izrada i popravak Site Studio nacrta bez uključivanja objave vidljive posjetiteljima.

Rizik

Preporučeno zadano. Ljudi i dalje pregledavaju i objavljuju live promjene.

Mogućnosti

  • studio.read
  • studio.schema.read
  • studio.draft.blocks.write
  • studio.draft.content.write
  • studio.qa.run

Dizajner

Nacrti sadržaja plus promjene teme, medija i navigacije za odabrane stranice.

Rizik

Može promijeniti putanju posjetitelja. Pažljivo pregledajte prije objave.

Mogućnosti

  • studio.read
  • studio.schema.read
  • studio.draft.blocks.write
  • studio.draft.content.write
  • studio.qa.run
  • studio.theme.write
  • studio.media.write
  • studio.navigation.write

Publisher

Uređivanje nacrta plus eksplicitna dozvola za objavu javnih Site Studio promjena.

Rizik

Vidljivo posjetiteljima. Koristite kratke TTL-ove, jednog operatora po vjerodajnici i audit svake tipke.

Mogućnosti

  • studio.read
  • studio.schema.read
  • studio.draft.blocks.write
  • studio.draft.content.write
  • studio.qa.run
  • studio.publish

Agencijski operator

Operacije agencijskog prostora kao što su klijenti, aplikacije i readiness upravljanje.

Rizik

Može utjecati na onboarding klijenata i readiness tokove. Držite tenant allowlist uskim.

Mogućnosti

  • studio.read
  • studio.schema.read
  • studio.draft.blocks.write
  • studio.draft.content.write
  • studio.qa.run
  • apps.read
  • apps.manage
  • readiness.read
  • readiness.manage
  • clients.view
  • clients.manage
Pravilo za Publisher: Objava mijenja ono što posjetitelji vide. Ne dodjeljujte Publisher osim ako operator izričito preuzima odgovornost za javno lansiranje te stranice.

1. Povezivanje alata web-mjesta

Za jednu instalaciju ili profil asistenta koristi se izvorno odobrenje u pregledniku, a zatim se odabire obuhvat stranica. Nisu potrebni statički ključ ni pomoćni program za modele. Lokalni naziv poslužitelja ne odabire stranicu.

Hermes Desktop

„Otvori u Hermes Desktopu” zahtijeva obradu veze hermes:// koju Hermes Desktop registrira pri instalaciji na ovom računalu. Ako se ništa ne otvori — ili se otvori pogrešna aplikacija — ažurirati Hermes Desktop njegovim uobičajenim programom za ažuriranje ili kopirati upute za postavljanje u nastavku. Ovo web-mjesto ne može otkriti, instalirati ni registrirati tu obradu.

Ova poveznica u aplikaciju Hermes upisuje MCP adresu ovog web-mjesta pod lokalnim nazivom kernion. Hermes traži vlastitu potvrdu, a ovo web-mjesto ne može tiho instalirati ni otvoriti program.

Otvori u Hermes Desktopu

Poveznica za ugradnju

hermes://mcp/install?name=kernion&config=eyJ1cmwiOiJodHRwczovL2FnZW5jeS5rZXJuaW9uLmlvL21jcCIsImF1dGgiOiJvYXV0aCJ9

Naredba se pokreće u terminalu na računalu na kojem je asistent instaliran.

hermes mcp add kernion --url 'https://agency.kernion.io/mcp' --auth oauth
hermes mcp login kernion

Nakon prijave provjeriti vezu

hermes mcp test kernion

Veze računa

Za jednu instalaciju ili profil asistenta koristi se izvorno odobrenje u pregledniku, a zatim se odabire obuhvat stranica. Nisu potrebni statički ključ ni pomoćni program za modele. Lokalni naziv poslužitelja ne odabire stranicu.

Prijava za povezivanje
Prijava za povezivanje
Ostali klijenti i ručno postavljanje
Odabir asistenta

Ovaj unos dodaje se u korisničku konfiguraciju odabranog klijenta uz očuvanje postojećih unosa. Zatim se naredba za prijavu pokreće u istom profilu klijenta.

Hermes: config.yaml u aktivnom profilu Hermes.

Ovaj unos dodaje se u korisničku konfiguraciju odabranog klijenta uz očuvanje postojećih unosa. Zatim se naredba za prijavu pokreće u istom profilu klijenta.

mcp_servers:
  kernion:
    url: "https://agency.kernion.io/mcp"
    auth: oauth

Naredba se pokreće u terminalu na računalu na kojem je asistent instaliran.

hermes mcp add kernion --url 'https://agency.kernion.io/mcp' --auth oauth
hermes mcp login kernion
Napredno: statički ključevi i ručno postavljanje

Postavljanje klijenta

Koristite live domenu i varijablu okruženja

Nakon izdavanja vjerodajnice, spremite bearer vrijednost kao AGENCY_CONNECTOR_MCP_BEARER. Ovi primjeri namjerno prikazuju samo referencu na varijablu.

Dodajte ovo pod mcp_servers. Bearer vrijednost spremite u procesno okruženje ili env datoteku koju Hermes učitava.

# ~/.hermes/config.yaml
mcp_servers:
  kernion_site:
    transport: http
    url: https://agency.kernion.io/mcp
    headers:
      Authorization: "Bearer ${AGENCY_CONNECTOR_MCP_BEARER}"

Sigurnosni model

  • Na ovoj javnoj stranici ne izdaju se ključevi. Ona samo objašnjava tok.
  • Sirovi bearer ključevi prikazuju se samo jednom na autentificiranim ekranima izdavanja.
  • Mogućnosti se spremaju uz vjerodajnicu i ponovno provjeravaju protiv žive uloge pri svakom pozivu.
  • Upisi u nacrt ostaju privatni dok ih netko s eksplicitnom ovlasti objave ne objavi.
  • Svaki poziv alata ima rate limit, audit zapis i vezan je uz vjerodajnicu koja ga je napravila.

Rješavanje problema

Uobičajeni kvarovi konektora namjerne su zaštitne ograde

Većina problema pri postavljanju dolazi iz neusklađenog opsega, vjerodajnice ili transporta. Popravite granicu umjesto slijepog proširenja konektora.

401

Nevažeći, nedostajući, opozvan ili istekao token

Ponovno kopirajte varijablu okruženja iz spremnika tajni, rotirajte konektor ako je sirovi ključ izgubljen i potvrdite da Authorization header koristi Bearer plus vrijednost varijable.

403

Mogućnost ili tenant opseg odbijen

Koristite viši preset samo kad operator to zaista treba ili dodajte točnu tenant stranicu u allowlist vjerodajnice.

405

Pogrešna transportna metoda

MCP endpoint je Streamable HTTP preko POST-a. GET namjerno nije server-sent event stream.

Spremni za povezivanje agenta?

Nakon odobrenja status je dostupan u odjeljku Povezani AI asistenti. Odobrenje nije isto što i potvrđena uporaba; aktivnost dokazuje samo uspješno zabilježena radnja alata.