Aller au contenu 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

Die native Browserfreigabe für eine Assistenteninstallation oder ein Profil verwenden und dabei die Website-Abdeckung wählen. Kein statischer Schlüssel und kein Modell-Hilfsprogramm nötig. Ein lokaler Servername wählt keine Website aus.

1

Assistenten auswählen

Die native Browserfreigabe für eine Assistenteninstallation oder ein Profil verwenden und dabei die Website-Abdeckung wählen. Kein statischer Schlüssel und kein Modell-Hilfsprogramm nötig. Ein lokaler Servername wählt keine Website aus.

2

Website-Abdeckung

Eine Assistenteninstallation für die unten angezeigten Websites und Berechtigungen freigeben. Der Zugriff wird bei jedem Aufruf anhand der aktuellen Rolle je Website geprüft. Ein Widerruf ist jederzeit in den Kontoverbindungen möglich.

3

Erfasste Aktivität prüfen

Kehren Sie nach der Freigabe zu „Verbundene KI-Assistenten“ zurück. Die Autorisierung ist von der verifizierten Nutzung getrennt; nur eine erfolgreich protokollierte Werkzeugaktion belegt Aktivität.

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. Site-Werkzeuge verbinden

Die native Browserfreigabe für eine Assistenteninstallation oder ein Profil verwenden und dabei die Website-Abdeckung wählen. Kein statischer Schlüssel und kein Modell-Hilfsprogramm nötig. Ein lokaler Servername wählt keine Website aus.

Hermes Desktop

„In Hermes Desktop öffnen“ erfordert den hermes://-Link-Handler, den Hermes Desktop bei der Installation auf diesem Computer registriert. Wenn sich nichts öffnet — oder die falsche App — Hermes Desktop mit seinem normalen Updater aktualisieren oder die Einrichtungsanleitung unten kopieren. Diese Website kann diesen Handler weder erkennen noch installieren oder registrieren.

Dieser Link trägt die MCP-Adresse dieser Website unter dem lokalen Namen kernion in die Hermes-App ein. Hermes fragt selbst nach Bestätigung; diese Website kann Software weder still installieren noch öffnen.

In Hermes Desktop öffnen

Installationslink

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

Führen Sie den Befehl in einem Terminal auf dem Computer aus, auf dem dieser Assistent installiert ist.

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

Nach der Anmeldung die Verbindung prüfen

hermes mcp test kernion

Kontoverbindungen

Die native Browserfreigabe für eine Assistenteninstallation oder ein Profil verwenden und dabei die Website-Abdeckung wählen. Kein statischer Schlüssel und kein Modell-Hilfsprogramm nötig. Ein lokaler Servername wählt keine Website aus.

Anmelden zum Verbinden
Anmelden zum Verbinden
Andere Clients und manuelle Einrichtung
Assistenten auswählen

Führen Sie diesen Eintrag mit der Benutzerkonfiguration des ausgewählten Clients zusammen, ohne bestehende Einträge zu entfernen. Führen Sie dann den Anmeldebefehl im selben Client-Profil aus.

Hermes: config.yaml im aktiven Hermes-Profil.

Führen Sie diesen Eintrag mit der Benutzerkonfiguration des ausgewählten Clients zusammen, ohne bestehende Einträge zu entfernen. Führen Sie dann den Anmeldebefehl im selben Client-Profil aus.

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

Führen Sie den Befehl in einem Terminal auf dem Computer aus, auf dem dieser Assistent installiert ist.

hermes mcp add kernion --url 'https://agency.kernion.io/mcp' --auth oauth
hermes mcp login kernion
Erweitert: statische Schlüssel und manuelle Einrichtung

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?

Kehren Sie nach der Freigabe zu „Verbundene KI-Assistenten“ zurück. Die Autorisierung ist von der verifizierten Nutzung getrennt; nur eine erfolgreich protokollierte Werkzeugaktion belegt Aktivität.