Saltar al contenido principal
Public AI connector guide

Connect your AI assistant to Kernion safely

Use Hermes, Claude Code, or any MCP-compatible client to inspect, draft, QA, and operate Site Studio through scoped connector presets — without handing an agent a platform-admin session.

Agency partners issue from their agency Integrations page. Platform support issues tenant-limited support connectors from the agency cockpit.

Quickstart

Three safe steps, no public secrets

Użyj natywnego zatwierdzania w przeglądarce dla jednej instalacji lub profilu asystenta, a następnie wybierz zakres witryn. Nie potrzebujesz klucza statycznego ani programu pomocniczego do modeli. Lokalna nazwa serwera nie wybiera witryny.

1

Wybierz asystenta

Użyj natywnego zatwierdzania w przeglądarce dla jednej instalacji lub profilu asystenta, a następnie wybierz zakres witryn. Nie potrzebujesz klucza statycznego ani programu pomocniczego do modeli. Lokalna nazwa serwera nie wybiera witryny.

2

Zakres witryn

Autoryzuj instalację asystenta dla witryn i uprawnień podanych poniżej. Dostęp jest sprawdzany przy każdym wywołaniu według bieżącej roli w każdej witrynie. Można go odwołać w dowolnej chwili w połączeniach konta.

3

Sprawdź zarejestrowaną aktywność

Po zatwierdzeniu wróć do Podłączonych asystentów AI. Autoryzacja to coś innego niż zweryfikowane użycie; tylko udane, zarejestrowane działanie narzędzia dowodzi aktywności.

Presets

Use presets instead of hand-picking dangerous checkboxes

Authenticated screens still show advanced capability details. The normal path is preset-first: draft-only by default, explicit publish power only when needed.

Read + QA

Inspect selected sites, schemas, and QA findings without editing drafts.

Risk posture

Safest posture for audits, support triage, and tool discovery.

Capabilities

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

Draft editor

Recommended first

Create and repair Site Studio drafts while keeping visitor-visible publishing off.

Risk posture

Recommended default. Humans still review and publish live changes.

Capabilities

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

Designer

Draft content plus theme, media, and navigation changes for selected sites.

Risk posture

Can reshape the visitor journey. Review carefully before publishing.

Capabilities

  • 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

Draft editing plus explicit permission to publish public Site Studio changes.

Risk posture

Visitor-visible. Use short TTLs, one operator per credential, and audit every key.

Capabilities

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

Agency operator

Agency workspace operations such as client, app, and readiness management.

Risk posture

Can affect client onboarding and readiness workflows. Keep tenant allowlists tight.

Capabilities

  • 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
Publisher rule: Publishing changes what visitors see. Do not grant Publisher unless the operator explicitly owns public launch responsibility for that site.

1. Podłącz narzędzia witryny

Użyj natywnego zatwierdzania w przeglądarce dla jednej instalacji lub profilu asystenta, a następnie wybierz zakres witryn. Nie potrzebujesz klucza statycznego ani programu pomocniczego do modeli. Lokalna nazwa serwera nie wybiera witryny.

Hermes Desktop

„Otwórz w Hermes Desktop” wymaga obsługi łącza hermes://, którą Hermes Desktop rejestruje przy instalacji na tym komputerze. Jeśli nic się nie otworzy — albo otworzy się niewłaściwa aplikacja — zaktualizować Hermes Desktop zwykłym aktualizatorem lub skopiować poniższe instrukcje konfiguracji. Ta witryna nie może wykryć, zainstalować ani zarejestrować tej obsługi.

Ten link zapisuje adres MCP tej witryny w aplikacji Hermes pod lokalną nazwą kernion. Hermes sam prosi o potwierdzenie, a ta witryna nie może po cichu instalować ani otwierać oprogramowania.

Otwórz w Hermes Desktop

Link instalacyjny

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

Uruchom w terminalu na komputerze, na którym zainstalowano tego asystenta.

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

Po zatwierdzeniu sprawdź połączenie

hermes mcp test kernion

Połączenia konta

Użyj natywnego zatwierdzania w przeglądarce dla jednej instalacji lub profilu asystenta, a następnie wybierz zakres witryn. Nie potrzebujesz klucza statycznego ani programu pomocniczego do modeli. Lokalna nazwa serwera nie wybiera witryny.

Zaloguj się, aby połączyć
Zaloguj się, aby połączyć
Inni klienci i konfiguracja ręczna
Wybierz asystenta

Scal ten wpis z konfiguracją użytkownika wybranego klienta, zachowując istniejące wpisy. Następnie uruchom polecenie logowania w tym samym profilu klienta.

Hermes: config.yaml w aktywnym profilu Hermes.

Scal ten wpis z konfiguracją użytkownika wybranego klienta, zachowując istniejące wpisy. Następnie uruchom polecenie logowania w tym samym profilu klienta.

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

Uruchom w terminalu na komputerze, na którym zainstalowano tego asystenta.

hermes mcp add kernion --url 'https://agency.kernion.io/mcp' --auth oauth
hermes mcp login kernion
Zaawansowane: klucze statyczne i konfiguracja ręczna

Client setup

Use the live domain and an environment variable

After issuing a credential, store the bearer value as AGENCY_CONNECTOR_MCP_BEARER. These examples deliberately show only the variable reference.

Add this under mcp_servers. Store the bearer value in the process environment or an env file loaded by Hermes.

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

Security model

  • No keys are issued on this public page. It teaches the flow only.
  • Raw bearer keys are shown only once on authenticated issuance screens.
  • Capabilities are stored with the credential and re-checked against the live role on every call.
  • Draft writes stay private until someone with explicit publish power publishes them.
  • Every tool call is rate-limited, audited, and tied to the credential that made it.

Troubleshooting

Common connector failures are intentional guardrails

Most setup failures are scope, credential, or transport mismatches. Fix the boundary rather than broadening the connector blindly.

401

Invalid, missing, revoked, or expired token

Re-copy the environment variable from your secret store, rotate the connector if the raw key was lost, and confirm the Authorization header uses Bearer plus the variable value.

403

Capability or tenant scope denied

Use a higher preset only when the operator truly needs it, or add the exact tenant site to the credential allowlist.

405

Wrong transport method

The MCP endpoint is Streamable HTTP over POST. GET is intentionally not a server-sent event stream.

Ready to connect an agent?

Po zatwierdzeniu wróć do Podłączonych asystentów AI. Autoryzacja to coś innego niż zweryfikowane użycie; tylko udane, zarejestrowane działanie narzędzia dowodzi aktywności.