MCP povezava

MCP povezava omogoča, da agent v SimplNormu pripravlja osnutke računov, išče stranke, prikaže predoglede, bere dovoljena poročila in po potrditvi izvede omejena dejanja prek API-ja. Agent ne dostopa neposredno do baze.

Povezava po odjemalcu

Za gostovani MCP najprej ustvarite API žeton v SimplNormu, nato izberite odjemalec in uporabite pripadajočo konfiguracijo.

Codex

Codex uporablja config.toml, običajno v ~/.codex/config.toml.

[mcp_servers.simplnorm]
url = "https://mcp.simplnorm.com/mcp"
bearer_token_env_var = "SIMPLNORM_API_TOKEN"

Nato nastavite okoljsko spremenljivko:

export SIMPLNORM_API_TOKEN="snpat_..."

V Codex TUI lahko stanje preverite z /mcp.

Claude Code

Claude Code lahko HTTP MCP strežnik doda prek CLI:

claude mcp add --transport http simplnorm https://mcp.simplnorm.com/mcp \
  --header "Authorization: Bearer snpat_..."

Alternativa z JSON konfiguracijo:

claude mcp add-json simplnorm \
  '{"type":"http","url":"https://mcp.simplnorm.com/mcp","headers":{"Authorization":"Bearer snpat_..."}}'

V Claude Code lahko stanje preverite z /mcp.

OpenCode

OpenCode uporablja opencode.json:

{
    "$schema": "https://opencode.ai/config.json",
    "mcp": {
        "simplnorm": {
            "type": "remote",
            "url": "https://mcp.simplnorm.com/mcp",
            "enabled": true,
            "headers": {
                "Authorization": "Bearer snpat_..."
            }
        }
    }
}

Cursor

Cursor uporablja mcp.json z mcpServers. Konfiguracijo lahko dodate globalno ali v projekt, odvisno od nastavitev v Cursorju.

{
    "mcpServers": {
        "simplnorm": {
            "url": "https://mcp.simplnorm.com/mcp",
            "headers": {
                "Authorization": "Bearer snpat_..."
            }
        }
    }
}

Po shranjevanju konfiguracije v Cursorju omogočite strežnik in preverite, da so orodja vidna v Agent načinu.

GitHub Copilot

GitHub Copilot uporablja MCP konfiguracijo IDE-ja. V VS Code je to običajno .vscode/mcp.json ali uporabniška MCP konfiguracija.

{
    "servers": {
        "simplnorm": {
            "type": "http",
            "url": "https://mcp.simplnorm.com/mcp",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer snpat_..."
                }
            }
        }
    }
}

V Copilot Chat izberite Agent način in v seznamu orodij preverite, da je simplnorm omogočen.

Hermes Agent

Hermes Agent dodajte kot oddaljen HTTP MCP strežnik. Če uporabljate konfiguracijsko datoteko z mcpServers, uporabite ta format:

{
    "mcpServers": {
        "simplnorm": {
            "url": "https://mcp.simplnorm.com/mcp",
            "headers": {
                "Authorization": "Bearer snpat_..."
            }
        }
    }
}

Če Hermes Agent odjemalec ponudi obrazec namesto JSON datoteke, vnesite isti URL in Authorization header.

API žeton

API žeton ustvarite v aplikaciji pod Nastavitve -> API.

Pri ustvarjanju:

1. vnesite oznako žetona,
2. izberite organizacijo,
3. izberite življenjsko dobo žetona,
4. izberite prednastavitev dostopa ali ročno nastavite dovoljenja,
5. ustvarjeni žeton takoj kopirajte v MCP odjemalca.

Žeton se prikaže samo enkrat. Če ga izgubite, ustvarite novega in starega prekličite.

Žetona ne delite

API žeton omogoča dostop do podatkov v SimplNormu. Če ga ne uporabljate več ali sumite, da je bil razkrit, ga prekličite v nastavitvah.

Dovoljenja

Dostop je omejen z dovoljenji izbranega žetona. V aplikaciji so na voljo prednastavitve:

• Pomočnik za račune za stranke, osnutke, predoglede, izdajo in poročila.
• Samo branje za branje strank, računov, poročil in shranjenih postavk.
• Računovodska poročila za račune in poročila.
• Dovoljenja po meri za ročno izbiro obsegov.

Posamezna dovoljenja vključujejo branje in urejanje strank, iskanje v registru, branje računov, ustvarjanje osnutkov, izdajo računov, branje poročil, shranjene opombe in shranjene postavke.

Izberite samo dovoljenja, ki jih agent dejansko potrebuje.

Varnost pri izdaji računov

Agent ne sme izdati računa samo zato, ker je pripravil osnutek. Najprej mora uporabiti predogled, povzeti stranko, znesek, DDV obravnavo in datume, nato pa počakati na jasno potrditev uporabnika.

MCP orodje za izdajo zahteva confirmed: true, točno ime stranke iz predogleda in točen skupni znesek iz predogleda. Te podatke pri klicu orodja pošlje agent; uporabnik mora samo jasno potrditi, da želi nadaljevati po prikazanem predogledu. Če se podatki ne ujemajo, izdaja ne uspe.

Primer potrditve:

Potrjujem izdajo tega računa.

Enako velja za spremembe plačilnega statusa:

Označi ta račun kot plačan.

Preklic dostopa

Odprite Nastavitve -> API, poiščite aktivni žeton in ga prekličite. To naredite, ko agenta ne uporabljate več, ko menjate odjemalca ali ko žeton ni več zaupanja vreden.