Vývojářský přístup

Ovládejte Seneku z terminálu nebo z AI agenta

Dvě cesty k programovému ovládání Seneky. CLI sncb běží v jakémkoli shellu nebo CI pipeline. MCP server se připojí přímo do Claude Desktopu, Claude Code, Cursoru, Codexu a dalších klientů, kteří mluví protokolem Model Context Protocol. Stejná data, stejný OAuth, stejné EU hosting.

Rychlý start CLI

Tři kroky k prvnímu příkazu

  1. 1

    Instalace

    Běží na Bunu. Jedna řádka, žádný build, ve vašem PATH.

    bun install -g @senecabot/sncb
  2. 2

    Přihlášení

    Použijte API token z konzole. Uloží se do ~/.config/sncb s právy 0600.

    sncb auth login
  3. 3

    Použijte

    Vytvořte stránku z Markdown souboru, publikujte a hotovo.

    sncb page create --website my-site \
      --title "Reklamace" --slug reklamace -f reklamace.md

Rychlý start MCP

Tři kroky a agent dostane klíče

MCP server je hostovaný HTTP endpoint. AI klient si při prvním spojení sám projde OAuth - žádné ruční tokeny, žádné konfigurační soubory, které byste museli synchronizovat.

  1. 1

    Přidejte server

    Nasměrujte klienta na MCP endpoint Seneky. Transport Streamable HTTP, lokální proxy není potřeba.

    # Claude Code
    claude mcp add seneca https://app.senecabot.com/api/mcp
    
    # Cursor / Claude Desktop (mcp.json)
    {
      "mcpServers": {
        "seneca": { "url": "https://app.senecabot.com/api/mcp" }
      }
    }
  2. 2

    Autorizace

    První volání otevře prohlížeč s přihlášením k Senekovi. Schvalte mcp:read a mcp:write pro organizaci, ke které má agent přístup.

    # Scopes, které budete schvalovat
    mcp:read   # výpis a načtení
    mcp:write  # vytvoření, úprava, publikace, smazání
  3. 3

    Mluvte s agentem

    Ptejte se obyčejnou řečí. Agent si vybere správný nástroj, vám zůstává auditní stopa.

    > Přesuň stránku "Reklamace" ze složky Koncepty
    > do složky Podpora a publikuj ji.

Co umí

Všechno z konzole, skriptovatelné i agentem

CLI i MCP vystavují stejnou plochu - cokoli lze kliknout v konzoli Seneky. Zálohy, hromadné importy, migrace, časované publikace, přepisy obsahu řízené AI - ze shellu, z CI pipeline, nebo z chatu s agentem.

Stránky ze souborů

Vytvářejte a upravujte stránky z Markdown nebo HTML souborů (i ze stdin). Verze se ukládají automaticky, návrat je jeden příkaz.

Složky a struktura

Sestavte strom centra nápovědy ze skriptu. Přesouvejte stránky mezi složkami, měňte pořadí, publikujte i stahujte hromadně.

Agenti a design

Aktualizujte systémový prompt i jazyk agenta. Měňte design schéma a brandové barvy bez otevírání dashboardu.

Historie a návrat verzí

Vypište všechny uložené verze stránky a vraťte se k libovolné z nich. Pro obsah bezpečnější než git revert.

Připojte AI agenta

Dvě cesty, jak agentovi předat klíče

CLI zvolte tam, kde agent už žije v terminálu (Claude Code, Codex, shell skripty v CI). MCP server zvolte, když agent běží v Claude Desktopu, Cursoru nebo v jiném chatu, který umí registrovat MCP nástroje. Obě cesty jdou přes stejný OAuth, stejné scopes a stejný auditní log.

Příklad promptu pro agenta

Přidej stránku "Reklamace" do složky Podpora ve webu acme-help, publikuj ji a vrať mi novou URL.

# Cesta přes CLI
$ sncb page create --website acme-help \
    --title "Reklamace" --slug reklamace \
    --parent podpora -f reklamace.md -o json
$ sncb page publish <id> -o json

# Cesta přes MCP - agent volá nástroje přímo
create_page(website_id, title, slug, parent_id, content)
publish_page(page_id)

Veřejné REST API

Postavené na tomtéž API

Každý příkaz sncb i každý MCP nástroj je volání veřejného REST API. Stejný token, stejné scopes, stejné struktury. Pro vlastní integraci mimo CLI nebo MCP si přečtěte specifikaci.

Otevřít dokumentaci API

Dva řádky a jedete

sncb je open source na npm; MCP server je hostovaný, autorizovaný přes OAuth a připravený, kdykoli ho zavoláte.

$ bun install -g @senecabot/sncb
https://app.senecabot.com/api/mcp

Zdroje