---
url: https://docs.ogmabox.com/cs/reference/mcp-tools.md
description: >-
  Úplná referenční dokumentace Ogma MCP s účelem a vstupy nástrojů, zdroji,
  zadáními, oprávněními, stránkováním a zpracováním výsledků.
---

# Zdroje a nástroje MCP {#mcp-resources-and-tools}

Server Ogma MCP je určen pro externí klienty MCP, například Codex, Claude Code, Cursor a další hostitele protokolu Model Context Protocol. Je oddělený od AI asistenta v aplikaci.

MCP poskytuje čtyři rozhraní pro objevování dostupných funkcí:

* **Zdroje**: pojmenované cíle čtení, které může klient MCP otevřít.
* **Šablony zdrojů**: parametrizované cíle čtení pro konkrétní záznam, nález, pracovní postup, běh, export nebo objekt funkce Opakované odesílání (Replay).
* **Nástroje**: volatelné akce. Některé jsou pouze pro čtení. Některé vyžadují přepínače při spuštění serveru.
* **Zadání**: opakovaně použitelné pokyny, které agentovi pomáhají naplánovat prohlídku, opakované testování nebo zprávu. Získání zadání nespouští jeho nástroje.

Koncové body připojení a konfiguraci klientů popisuje [Nastavení MCP](../mcp-setup.md). Úplnou sekvenci interakcí popisuje [Automatizace prohlížeče pomocí MCP](../guide/mcp-browser.md).

Tato referenční dokumentace pokrývá současnou implementaci: **255 nástrojů**, 17 zdrojů, 9 šablon zdrojů a 12 zadání. Všechny nástroje se zveřejňují; při volání se nadále vynucují oprávnění. Starší nainstalovaná vydání mohou poskytovat méně nástrojů. Před výběrem nástroje zjistěte katalog z běžícího serveru.

## Metody protokolu {#protocol-methods}

Jde o názvy metod JSON-RPC, nikoli o samostatné cesty URL. Klient MCP spravuje životní cyklus připojení přes [HTTP nebo stdio](../mcp-setup.md#connection-addresses).

| Metoda | Účel |
| --- | --- |
| `initialize` | Vyjedná verzi protokolu a funkce serveru a klienta. |
| `notifications/initialized` | Oznámí serveru dokončení inicializace; toto oznámení nemá ID požadavku. |
| `tools/list` | Zjistí nástroje a schémata jejich argumentů se sledováním `nextCursor`. |
| `tools/call` | Spustí nástroj pomocí `name` a `arguments`. |
| `resources/list` | Vypíše pojmenované zdroje pouze pro čtení. |
| `resources/templates/list` | Vypíše šablony URI pro čtení jednotlivých objektů. |
| `resources/read` | Přečte zdroj pomocí jeho úplného `uri`. |
| `prompts/list` | Zjistí opakovaně použitelná zadání a jejich argumenty. |
| `prompts/get` | Načte zprávy zadání pomocí `name` a volitelných řetězcových argumentů. |

## Vyhledávání a volání nástrojů {#discover-and-call-tools}

Názvy jako `ogma_search_http_history` jsou identifikátory nástrojů MCP, nikoli jednotlivé trasy HTTP. Volejte je pomocí `tools/call` na svém připojení MCP.

1. Inicializujte připojení pomocí klienta MCP.
2. Zavolejte `tools/list`. Ogma vrací až **40 nástrojů na stránku**. Každý vrácený `nextCursor` předávejte zpět jako `params.cursor`, dokud nepřestane být přítomen; jinak bude klientovi chybět většina nástrojů prohlížeče.
3. Přečtěte si `inputSchema` každého nástroje, kde najdete typy polí, hodnoty výčtů, výchozí hodnoty, limity a formáty vnořených objektů. Nevymýšlejte argumenty podle názvu nástroje.
4. Před prováděním akcí přečtěte `ogma://mcp/permissions` a `ogma://mcp/tool-guide`.
5. Zavolejte vybraný nástroj s objektem JSON v `arguments`.

Příklad požadavku JSON-RPC na inicializovaném připojení:

```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "ogma_search_http_history",
    "arguments": {
      "q": "req.host.eq:\"example.com\"",
      "limit": 20,
      "offset": 0
    }
  }
}
```

Používejte ID vrácená nástroji výpisu či vyhledávání místo jejich odhadování. Vyhledávání historie a nálezů používá `limit`/`offset`; nástroje přírůstků prohlížeče používají `since_entry_id`. Ani jedno není neprůhledný kurzor používaný metodou `tools/list`.

## Čtení výsledků {#reading-results}

Upřednostňujte `result.structuredContent`. Textový blok obsahu obsahuje stejnou JSON obálku pro klienty podporující pouze textové výsledky. Výjimka: výchozí výsledek `ogma_browser_snapshot` nemá strukturovaný obsah a jeho textový obsah tvoří čitelný strom; pro strukturované prvky použijte `result_detail: "full"`. V místním přemostění REST místo toho zpracujte řetězec JSON v `result`; toto přemostění není transport MCP.

Při selhání nástroje v přemostění REST je zpracovaná hodnota `{ "error": "..." }` a uvnitř tohoto řetězce je serializovaná chybová obálka nástroje. Samotný úspěšný stav HTTP z přemostění neznamená, že nástroj uspěl.

| Pole obálky | Význam |
| --- | --- |
| `ok` | Zda operace nástroje uspěla. Kontrolujte také `isError` výsledku MCP. |
| `workflow_stage`, `summary` | Kontext operace a krátké vysvětlení. |
| `evidence`, `hypotheses` | Pozorované důkazy a oddělené, nepotvrzené interpretace. |
| `next_actions`, `use_next_tools` | Navržená navazující práce a směrování na nástroje. |
| `artifacts` | Odkazy na vygenerované důkazy či soubory, jsou-li dostupné. |
| `raw` | Data specifická pro nástroj. Jsou přítomna ve strukturovaných variantách výstupu; kompaktní nástroje je zahrnují pouze s `result_detail: "full"`. Mohou být objektem, polem nebo textem; nepředpokládejte jedinou univerzální strukturu. |

Nástroje snímků obrazovky vracejí také nativní obrazový blok MCP. Čtěte tento blok místo očekávání obrazových dat base64 v metadatech JSON. Snímek prohlížeče ve výchozím stavu vrací kompaktní textový strom; pro jeho strukturované prvky v `raw.elements` předejte `result_detail: "full"`. Přírůstky síťových událostí a konzole prohlížeče obsahují strukturované záznamy.

Úspěšné validační volání může ve svých datech stále vracet `valid: false`. Selhání provádění nástroje používá `isError: true`; neplatné požadavky protokolu používají chyby JSON-RPC. Před opakováním si přečtěte diagnostiku. Chyby backendu mohou obsahovat stav HTTP, koncový bod a diagnostický text omezené délky; `[truncated]` znamená zkrácení diagnostiky, nikoli úspěch operace.

Tyto konvence výsledků používají [formát výsledků nástrojů](https://modelcontextprotocol.io/specification/2025-11-25/server/tools#tool-result) MCP.

## Zdroje {#resources}

| Zdroj | Co vrací |
| --- | --- |
| `ogma://status` | Aktuální kondici a stav backendu. |
| `ogma://projects` | Všechny projekty Ogma. |
| `ogma://project/current` | Aktuálně aktivní projekt. |
| `ogma://instances` | Instance naslouchajících proxy. |
| `ogma://http-history/recent` | 20 nejnovějších záznamů HTTP bez obsahu těla. |
| `ogma://ws-history/recent` | 20 nejnovějších připojení WebSocket. |
| `ogma://findings` | Až 50 nálezů. |
| `ogma://workflows` | Nakonfigurované pracovní postupy. |
| `ogma://workflow-runs/recent` | 20 nejnovějších záznamů běhů pracovních postupů. |
| `ogma://migration/workflows` | Zprávu o kompatibilitě migrace pracovních postupů. |
| `ogma://exports/recent` | 10 nejnovějších exportních úloh. |
| `ogma://capabilities` | Souhrn funkcí serveru MCP. |
| `ogma://mcp/permissions` | Aktuální přepínače oprávnění MCP. |
| `ogma://mcp/tool-guide` | Směrování agenta na nástroje, konvence výstupů a doporučené sekvence pro prohlížeč a testování. |
| `ogma://mcp/report-guide` | Sekvenci sestavení zprávy, požadavky na důkazy a kontroly kvality. |
| `ogma://mcp/resume` | Trvale uložený kontext obnovení aktivního projektu: uložené kontrolní body a nedávnou aktivitu nástrojů. |
| `ogma://replay/sessions/recent` | 20 nejnovějších relací opakovaného odesílání. |

## Šablony zdrojů {#resource-templates}

| Šablona | Co vrací |
| --- | --- |
| `ogma://http-history/{entry_id}` | Jeden záznam historie HTTP. |
| `ogma://ws-history/{connection_id}` | Jedno připojení WebSocket. |
| `ogma://findings/{finding_id}` | Jeden nález. |
| `ogma://workflows/{workflow_id}` | Jeden pracovní postup. |
| `ogma://workflow-runs/{run_id}` | Jeden běh pracovního postupu. |
| `ogma://exports/{export_id}` | Jednu exportní úlohu. |
| `ogma://replay/sessions/{session_id}` | Jednu relaci opakovaného odesílání. |
| `ogma://replay/attempts/{session_id}/{attempt_id}` | Jeden pokus opakovaného odesílání. |
| `ogma://workflow-safety/{workflow_id}` | Klasifikaci bezpečnosti pracovního postupu a požadovaná oprávnění. |

Tyto URI čtěte pomocí `resources/read`, nikoli požadavkem HTTP GET na `ogma://`. Před čtením dosaďte ID do šablony zdroje. Zdroje vracejí text v `contents`; nepoužívají výše uvedenou obálku výsledku nástroje.

## Zadání {#prompts}

Zjistěte je pomocí `prompts/list` a pak použijte `prompts/get` s `name` a objektem `arguments`. Hodnoty argumentů zadání jsou řetězce. Povinné argumenty jsou níže tučně.

| Zadání | Argumenty | Co připravuje |
| --- | --- | --- |
| `analyze_http_entry` | **`entry_id`** | Prozkoumání jedné zachycené výměny HTTP z hlediska bezpečnostních problémů podložených důkazy. |
| `summarize_project_security_state` | Žádné | Souhrn nálezů a priorit nápravy pro aktivní projekt. |
| `triage_findings` | `severity` | Stanovení priorit nálezů, volitelně v rámci jedné závažnosti. |
| `investigate_suspicious_host` | **`host`** | Kontrolu zachyceného provozu pro název hostitele nebo IP. |
| `review_workflow_migration_report` | Žádné | Vysvětlení problémů kompatibility pracovních postupů a kroků migrace. |
| `generate_retest_plan` | **`finding_id`** | Kroky reprodukce a kritéria úspěchu či neúspěchu pro nález. |
| `create_finding_from_http_evidence` | **`entry_id`** | Analýzu důkazů a vedení při vytváření nálezu, pokud je povoleno. |
| `prepare_evidence_export` | **`export_kind`** | Plán exportu `http_history`, `findings` nebo `automate_results`. |
| `retest_http_entry_with_replay` | **`entry_id`** | Pokyny pro sekvenci náhledu a potvrzení opakovaného odesílání. |
| `run_workflow_safely` | **`workflow_id`** | Kontrolu vedlejších účinků pracovního postupu, náhled a spuštění, pokud je povoleno. |
| `pentest_web_target` | **`target_url`**, `objective` | Plán postupného posouzení oprávněně testovaného cíle vedeného důkazy. |
| `solve_web_challenge` | **`challenge_url`**, `goal` | Plán zkoumání webové výzvy a shromažďování důkazů. |

## Oprávnění nástrojů {#tool-permissions}

Většina nástrojů pro prohlížení je vždy dostupná. Akce měnící data nebo odesílající provoz řídí přepínače při spuštění `ogma-mcp`:

| Přepínač oprávnění | Co povoluje |
| --- | --- |
| `--allow-write-findings` | Zápis nálezů a generování zpráv; také sdílené úpravy projektu, například změny proměnných prostředí a pravidel funkce Vyhledat a nahradit (Match & Replace). |
| `--allow-export-data` | Vytváření exportních úloh. Čtení metadat existujících exportů a informací pro stažení tento přepínač nevyžaduje. |
| `--allow-read-secrets` | Nemaskované hodnoty proměnných prostředí. Jde o samostatné oprávnění oddělené od oprávnění měnit proměnné. |
| `--allow-send-requests` | Odesílání pomocí funkcí Opakované odesílání a Automatizace (Automate), přímé a hromadné požadavky, interakce s prohlížečem, vyhledávání obsahu, procházení webu, přihlašovací postupy, aktivní sondy, WebSocket a přepínání projektů. |
| `--allow-run-workflows` | Nástroje náhledu, spouštění a rušení pracovních postupů. Spouštění funkce Automatizace místo toho používá oprávnění k odesílání. |
| `--allow-intercept-control` | Čtení stavu a fronty funkce Zachytávání (Intercept), úpravy fronty a ovládání stavu zadržování. |

Oprávnění se kontrolují při volání nástroje; uvedení nástroje v seznamu neznamená, že jsou jeho akce povoleny. Pozorovací nástroje prohlížeče mohou prohlížet již běžící prohlížeč, ale jeho ovládání a správa kontextů vyžaduje `allow_send_requests`. Přihlašovací postupy toto oprávnění také vyžadují, včetně volání výpisu a ověření. Poznámky a úkoly místní pro relaci nevyžadují oprávnění k zápisu do projektu.

Neexistují kvóty aktivity na minutu ani na relaci. Jednotlivé nástroje nadále vynucují vlastní velikosti vstupů, velikosti dávek, časové limity a kontroly rozsahu. Spouštění pracovních postupů může podle jejich operací vyžadovat další oprávnění k odesílání nebo zápisu nálezů. Viz [nastavení a oprávnění](../mcp-setup.md#permissions).

Všechny nástroje se zveřejňují bez ohledu na oprávnění. Starší přepínače profilů již seznam nástrojů nefiltrují. Viz [Vyhledávání a směrování nástrojů](#tool-discovery-and-dispatch).

## Katalog nástrojů {#tool-catalog}

### Obnovení po ztrátě kontextu {#recovering-after-context-loss}

Po opětovném připojení nebo ztrátě kontextu konverzace zavolejte `ogma_resume_session`, než zahájíte další posouzení. Zkontrolujte aktivní projekt, poslední kontrolní bod a nedávné výsledky nástrojů. Pro omezené kontroly uložených identifikátorů pouze pro čtení použijte `check_live: true`; neopakuje akce. Před opětovným použitím odkazů na prvky obnovte snímky prohlížeče.

Před předáním práce nebo dlouhou pauzou uložte kontrolní bod. Aktivita nástrojů zaznamenává, co se spustilo; nedokáže odvodit váš zamýšlený další test. Cíl, závěry, nejistoty a další kroky uvádějte výslovně a na důkazy odkazujte pomocí ID místo kopírování velkých těl odpovědí do kontrolního bodu.

```json
{
  "name": "ogma_save_checkpoint",
  "arguments": {
    "assessment_id": "authorization-review",
    "objective": "Compare access to invoices across two test identities",
    "progress": "Captured the owner request; the second identity has not been tested yet",
    "next_steps": ["Resume the saved context", "Verify the active project and both identities before replaying"],
    "uncertainties": ["Whether the server checks invoice ownership"]
  }
}
```

```json
{
  "name": "ogma_resume_session",
  "arguments": {
    "assessment_id": "authorization-review",
    "check_live": true
  }
}
```

Před předáním práce nebo kompakcí kontextu uložte kontrolní bod. Výslovně zaznamenejte cíl, dokončenou práci, nejistoty, ID důkazů a další kroky: automatický protokol aktivity ukládá identifikátory a výsledky, nikoli payloady požadavků nebo váš záměr. Volání, které začalo, ale nemá dokončený výsledek, má neznámý výsledek; před opakováním odeslání prozkoumejte aktuální stav.

Záznamy pro obnovení se ukládají trvale a jsou omezené na projekt. S `assessment_id` je čtení omezené na dané posouzení; při čtení pro obnovení jej vynechte, pokud chcete prohlížet aktivitu celého projektu. Existující poznámky a úkoly místní pro relaci slouží jinému účelu a neměly by být zaměňovány za trvale uložené předání práce.

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_save_checkpoint` | Připojí trvale uložený záznam předání. `next_steps` je pole výslovných akcí; `references` mapuje názvy na uložená ID. Plán neprovádí. | **`objective`**, **`progress`**, **`next_steps`**, `uncertainties`, `references` |
| `ogma_resume_session` | Přečte aktivní projekt, nejnovější kontrolní bod, nedávnou aktivitu a pokyny k obnovení. Volitelné živé kontroly prohlížejí uložené identifikátory bez opakování akcí. | `check_live` |
| `ogma_get_session_activity` | Přečte kontrolní body a aktivitu nástrojů od nejnovějších. Časy jsou unixové milisekundy UTC. Pro stránkování předejte z vráceného kurzoru jak `before_ms`, tak `before_id`. | `kind`, `id`, `since_ms`, `until_ms`, `before_ms`, `before_id`, `search`, `limit` |

Každý řádek vysvětluje nástroj a uvádí jeho vstupy nejvyšší úrovně. **Tučně vyznačené vstupy jsou povinné podle schématu**; ostatní jsou volitelné. Některé nástroje vyžadují volbu mezi vstupy (například zdrojem pro opakované odesílání nebo cílem kliknutí); jejich popisy a validace při běhu vysvětlují tyto kombinace. Vnořená pole a přesné typy najdete v `inputSchema` běžícího nástroje.

Každý nástroj také přijímá volitelný `assessment_id` (neprázdný řetězec, nejvýše 200 znaků). Používejte jej opakovaně, aby kontext obnovení jednoho posouzení zůstal pohromadě. Nemění aktivní projekt ani neuděluje oprávnění. Tento společný vstup se v níže uvedených tabulkách neopakuje.

### Vyhledávání a směrování nástrojů {#tool-discovery-and-dispatch}

Server zveřejňuje každý registrovaný nástroj. Před voláním použijte nástroje pro zjištění funkcí a kontraktů, abyste našli operaci a prozkoumali její vstupy; k jejímu zpřístupnění nemusíte měnit profil. Viz [Nastavení MCP](../mcp-setup.md#tool-discovery).

Pro akce vestavěného prohlížeče (`snapshot`, `fill_input`, `fill_form`, `console_delta`, `network_delta` a ostatní nástroje této skupiny) použijte `ogma_browser` a pro oblasti vyhledávání jako `http_history`, `findings` a `ws_history` použijte `ogma_search`. Odpovídající specializované nástroje zůstávají dostupné.

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_find_tools` | Prohledává celý katalog podle klíčových slov úkolu. Dotaz na přesný název nástroje vrátí jeho úplný kontrakt; `include_schema` vyžádá kontrakty také pro shody klíčových slov. Musí se shodovat všechna hledaná slova a zkrácený či prázdný výsledek nedokazuje nepřítomnost funkce. Výchozí limit je 5, maximum 10. | **`query`**, `limit`, `include_schema` |
| `ogma_call_tool` | Spustí registrovaný nástroj Ogma podle názvu. Vstupy kromě `tool` se předají pojmenovanému nástroji; jeho oprávnění nadále platí. | **`tool`** |
| `ogma_browser` | Ovládá vestavěný prohlížeč podle názvu akce. Jakýkoli jiný nástroj `ogma_browser_*` je dostupný pomocí přípony svého názvu, například `action: "snapshot"` pro `ogma_browser_snapshot`. | **`action`**, `selector`, `tab_id`, `url`, `js`, `text`, `value`, `key`, `cookie`, `timeout_ms` |
| `ogma_search` | Prohledává oblasti dat Ogma přes jeden vstupní bod. Jakýkoli jiný nástroj `ogma_search_*` je dostupný pomocí přípony svého názvu. | **`domain`**, `q`, `limit`, `offset` |

### Historie HTTP a dotazování {#http-history-and-querying}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_search_http_history` | Prohledává historii HTTP pomocí HTTPQL a vrací metadata požadavků a odpovědí. | `q`, `limit`, `offset`, `result_detail` |
| `ogma_get_http_entry` | Získá jeden záznam HTTP podle ID, volitelně s náhledy těla. | **`entry_id`**, `include_body_preview`, `result_detail` |
| `ogma_get_http_entry_body` | Získá úplné tělo požadavku a/nebo odpovědi pro záznam HTTP. | **`entry_id`**, **`part`**, `search_pattern`, `result_detail` |
| `ogma_validate_httpql` | Ověří výraz HTTPQL. | **`query`** |
| `ogma_analyze_http_entry_security` | Zkontroluje jeden záznam HTTP z hlediska bezpečnostně relevantního chování a důkazů. | **`entry_id`** |
| `ogma_search_by_vulnerability_pattern` | Prohledává zachycený provoz podle vzorů zaměřených na zranitelnosti. | **`pattern_type`**, `limit` |

### WebSocket a SSE {#websocket-and-sse}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_search_ws_history` | Prohledává historii připojení WebSocket pomocí StreamQL. | `q`, `limit`, `offset` |
| `ogma_get_ws_messages` | Získá uložené zprávy jednoho připojení WebSocket. | **`connection_id`**, `limit`, `offset` |
| `ogma_get_ws_message` | Přečte jednu úplnou zprávu bez zkrácení náhledu v seznamu; text je UTF-8, binární a řídicí payloady jsou base64. | **`message_id`** |
| `ogma_validate_streamql` | Ověří výraz StreamQL. | **`query`** |
| `ogma_get_ws_messages_live` | Získá živé zprávy WebSocket zachycené instrumentací prohlížeče. | `host`, `limit` |
| `ogma_create_ws_replay_session` | Vytvoří relaci funkce Opakované odesílání WS (WebSocket Replay). | **`ws_connection_id`** |
| `ogma_connect_ws_replay` | Připojí relaci opakovaného odesílání WS. | **`ws_session_id`** |
| `ogma_send_ws_replay_message` | Odešle zprávu přes relaci opakovaného odesílání WS. | **`ws_session_id`**, **`payload`**, `message_type` |
| `ogma_list_ws_replay_sessions` | Vypíše relace opakovaného odesílání WS. | `result_detail` |
| `ogma_get_ws_replay_messages` | Přečte přepis relace opakovaného odesílání WS, nikoli zachycenou historii. Na začátku vynechte `cursor`; pak předávejte vrácený `next_cursor` a načítejte další stránky, dokud platí `has_more`. | **`ws_session_id`**, `cursor`, `limit`, `result_detail` |
| `ogma_get_ws_replay_message` | Přečte jednu zprávu opakovaného odesílání WS bez zkrácení náhledu payloadu; `payload_base64` označuje bajty kódované v base64. | **`message_id`**, `result_detail` |
| `ogma_disconnect_ws_replay` | Odpojí relaci opakovaného odesílání WS při zachování relace i přepisu; také zruší čekající připojení. | **`ws_session_id`** |
| `ogma_browser_get_ws_frames` | Přečte rámce WebSocket zachycené vestavěným prohlížečem. | `limit`, `connection_url`, `direction` |
| `ogma_browser_start_ws_capture` | Spustí zachytávání rámců WebSocket na straně prohlížeče. | Žádné. |
| `ogma_browser_send_ws_message` | Odešle zprávu WebSocket z kontextu prohlížeče. | **`payload`**, `connection_url` |

### Nálezy a důkazy {#findings-and-evidence}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_search_findings` | Vyhledává nálezy podle závažnosti, původce, textu, limitu a posunu. | `severity`, `reporter`, `q`, `limit`, `offset` |
| `ogma_get_finding` | Získá jeden nález podle ID. | **`finding_id`** |
| `ogma_preview_finding_from_evidence` | Zobrazí náhled návrhu nálezu ze záznamu HTTP bez jeho vytvoření. | **`entry_id`**, `reporter` |
| `ogma_create_finding` | Vytvoří nález s metadaty, štítky, mírou jistoty, nápravou a volitelnými odkazy na důkazy. | **`title`**, `severity`, `status`, `description`, `reporter`, `tags`, `dedupe_key`, `entry_id`, `replay_attempt_id`, `automate_result_id`, `ws_message_id`, `confidence`, `remediation`, `skip_dedup_check` |
| `ogma_update_finding` | Aktualizuje existující nález. | **`finding_id`**, **`title`**, `severity`, `status`, `description`, `reporter`, `tags`, `dedupe_key`, `confidence`, `remediation` |
| `ogma_add_finding_tag` | Přidá štítky k nálezu bez nahrazení existujících štítků. | **`finding_id`**, **`tags`** |
| `ogma_link_finding_evidence` | Přidá k nálezu důkazy HTTP, opakovaného odesílání, automatizace, zachyceného WebSocket nebo zprávy opakovaného odesílání WS. Podpůrné odkazy nenahrazují jeho primární důkaz. | **`finding_id`**, `entry_id`, `replay_attempt_id`, `automate_result_id`, `ws_message_id`, `ws_replay_message_id` |
| `ogma_delete_finding` | Smaže nález. | **`finding_id`** |
| `ogma_create_finding_from_entry` | Vytvoří nález ze zachyceného záznamu HTTP. Vloží hlavičky a těla požadavku a odpovědi jako důkazy HTTP v Markdownu, přičemž tělo odpovědi zkrátí na 3000 znaků. Přidá skóre CVSS z dodaného rozpisu, CWE, kód PoC a odkazy. | **`entry_id`**, **`title`**, **`severity`**, **`vulnerability_type`**, **`description`**, **`impact`**, **`remediation`**, `confidence`, `reporter`, `tags`, `affected_parameter`, `proof_of_concept`, `cvss_breakdown`, `cwe`, `poc_code`, `references`, `skip_dedup_check` |
| `ogma_get_finding_evidence_summary` | Shrne propojené důkazy nálezu. | **`finding_id`** |
| `ogma_record_finding_verification` | Zaznamená nezávislý verdikt opakovaného testu nálezu: `verified`, `refuted` nebo `inconclusive`. Platí nejnovější verdikt, takže pozdější vyvrácení nahradí dřívější potvrzení; nástroj vrátí uložený řádek. | **`finding_id`**, **`state`**, **`method`**, **`reason`**, `evidence_entry_id`, `control_entry_id`, `canary_id` |
| `ogma_check_canary` | Vytvoří token pomocí `label` a `purpose` nebo znovu zkontroluje existující token pomocí `canary_id` bez vytvoření dalšího. Prohledává zachycený provoz a hledá odpovídající záznamy. Shoda v těle odpovědi je důkazem zpětného přečtení; shoda v těle požadavku pouze ukazuje, že byl token odeslán. | **`canary_id`** nebo **`label`** a **`purpose`**, `finding_id`, `hosted_path`, `limit` |
| `ogma_export_findings_report` | Vytvoří export zprávy o nálezech. | **`format`**, `title`, `summary`, `scope`, `tester`, `include_evidence` |

### Exporty {#exports}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_preview_export_plan` | Zobrazí náhled obsahu a formátu exportu bez vytvoření úlohy. | **`kind`**, **`format`**, `limit`, `q`, `severity`, `reporter` |
| `ogma_create_export_job` | Vytvoří exportní úlohu pro historii, výsledky vyhledávání, nálezy nebo výsledky funkce Automatizace. | **`name`**, **`kind`**, **`format`**, `limit`, `offset`, `scope`, `q`, `severity`, `reporter`, `run_id` |
| `ogma_get_export_job` | Získá jednu exportní úlohu podle ID. | **`export_id`** |
| `ogma_list_export_jobs` | Vypíše exportní úlohy. | `limit`, `offset` |
| `ogma_get_export_download_info` | Získá metadata pro stažení dokončeného exportu. | **`export_id`** |

### Opakované odesílání a odesílání požadavků {#replay-and-request-sending}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_preview_replay_send` | Zobrazí náhled opakovaného odeslání a vrátí potvrzovací token. | `http_entry_id`, `replay_session_id`, `method`, `path`, `query`, `body`, `result_detail` |
| `ogma_send_replay_request` | Odešle požadavek pomocí funkce Opakované odesílání s potvrzovacím tokenem. | **`confirmation_token`**, **`request_hash`**, `result_detail` |
| `ogma_create_replay_session_from_history` | Vytvoří relaci opakovaného odesílání ze zachyceného záznamu HTTP. | **`entry_id`**, `name`, `result_detail` |
| `ogma_create_replay_session_raw` | Vytvoří relaci opakovaného odesílání ze surové definice požadavku. | `name`, **`host`**, **`port`**, `tls`, `method`, `path`, `headers`, `body` |
| `ogma_get_replay_session` | Získá metadata relace opakovaného odesílání a stránkovaný seznam pokusů. | **`session_id`**, `attempts_limit`, `attempts_offset`, `result_detail` |
| `ogma_get_replay_attempt` | Získá jeden pokus opakovaného odesílání. | **`session_id`**, **`attempt_id`**, `result_detail` |
| `ogma_list_replay_sessions` | Vypíše relace opakovaného odesílání. | `limit`, `offset`, `result_detail` |
| `ogma_create_replay_sequence` | Vytvoří vícekrokovou sekvenci opakovaného odesílání z existujících relací v pořadí provádění kroků; `collection_id` při běhu doplní a případně přepíše proměnné hodnotami z dané kolekce. | **`name`**, **`session_ids`**, `collection_id` |
| `ogma_run_replay_sequence` | Spustí uloženou sekvenci opakovaného odesílání, která odesílá skutečný odchozí provoz. `plan` uvádí indexy kroků v pořadí provádění; položky mohou kroky opakovat, vynechávat nebo měnit jejich pořadí. Při vynechání `plan` se každý uložený krok provede jednou v původním pořadí. Prázdný `plan` je odmítnut. | **`sequence_id`**, `plan` |
| `ogma_repeat_request` | Zopakuje existující požadavek s volitelnými změnami. | **`request_id`**, `params`, `headers`, `body`, `cookies`, `url`, `method`, `method_override`, `path`, `path_override`, `entry_id`, `headers_add`, `headers_remove`, `body_text`, `body_json`, `body_b64`, `body_base64`, `raw_request_base64`, `result_detail` |
| `ogma_replay_with_modifications` | Zopakuje zachycený požadavek HTTP s přepsáním jednotlivých polí a vrátí odpověď i souhrn rozdílů. | **`entry_id`**, `method_override`, `path_override`, `headers_add`, `headers_remove`, `body`, `body_text`, `body_json`, `body_b64`, `body_base64`, `raw_request_base64`, `request_id`, `method`, `path`, `headers`, `follow_redirects`, `timeout_secs`, `result_detail` |
| `ogma_http_request` | Odešle přímý požadavek HTTP prostřednictvím nástroje MCP. S `raw_request_base64` načte `max_responses` několik rámců odpovědi ze stejného připojení místo zastavení u prvního a `followup_raw_request_base64` po přečtení první odpovědi zapíše požadavek na toto připojení; odpověď, kterou odeslané bajty nevyžadovaly, umožňuje desynchronizaci požadavků potvrdit místo pouhého odhadu. Oba vstupy platí pouze pro surový režim. | **`host`**, `port`, `tls`, `method`, `path`, `headers`, `body_b64`, `method_override`, `path_override`, `headers_add`, `headers_remove`, `body`, `body_text`, `body_json`, `body_base64`, `raw_request_base64`, `max_responses`, `followup_raw_request_base64`, `result_detail` |
| `ogma_bulk_send_requests` | Odešle dávku požadavků. | **`base_session_id`**, **`payloads`**, **`placeholder`**, `max_requests` |
| `ogma_fetch_url` | Načte URL a vrátí stav odpovědi, hlavičky a náhled těla. | **`url`**, `method`, `headers`, `body_b64`, `max_bytes` |
| `ogma_follow_redirect` | Načte URL, sleduje řetězec přesměrování a uvede každý krok. | **`url`**, `method`, `headers`, `body_b64`, `max_hops`, `timeout_secs` |
| `ogma_fuzz_parameter` | Nahradí zástupný výraz `{{FUZZ}}` hodnotami ze seznamu slov a seskupí odpovědi podle stavu a velikosti. | **`url`**, `method`, `headers`, `body_template`, **`wordlist`**, `timeout_secs`, `stop_on_match` |
| `ogma_multipart_upload` | Odešle požadavky multipart form-data s textovými a souborovými poli pro testování nahrávání. | **`url`**, **`fields`**, `headers`, `timeout_secs` |
| `ogma_test_login` | Otestuje přihlašovací koncový bod dodanými nebo výchozími dvojicemi přihlašovacích údajů a uvede důkazy. | **`url`**, `credentials`, `username_field`, `password_field`, `submit_selector`, `success_pattern`, `failure_pattern`, `max_attempts` |

### Pracovní postupy a Automatizace {#workflows-and-automate}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_search_workflows` | Vypíše a filtruje pracovní postupy. | `workflow_type`, `enabled`, `limit`, `offset` |
| `ogma_get_workflow` | Získá jeden pracovní postup podle ID. | **`workflow_id`** |
| `ogma_get_workflow_run` | Získá jeden záznam běhu pracovního postupu. | **`run_id`** |
| `ogma_validate_workflow_import` | Ověří kompatibilitu balíku pracovních postupů pro import. | **`bundle_json`** |
| `ogma_get_workflow_safety` | Získá klasifikaci bezpečnosti a oprávnění pracovního postupu. | **`workflow_id`** |
| `ogma_preview_workflow_run` | Zobrazí náhled běhu pracovního postupu před spuštěním. | **`workflow_id`**, `input`, `trigger_entry_id` |
| `ogma_run_workflow` | Spustí pracovní postup. | **`confirmation_token`**, **`definition_hash`**, `input_hash`, `input` |
| `ogma_cancel_workflow_run` | Zruší běh pracovního postupu. | **`run_id`** |
| `ogma_list_automate_sessions` | Vypíše relace funkce Automatizace. | `limit`, `offset` |
| `ogma_get_automate_session` | Získá jednu relaci funkce Automatizace. | **`session_id`** |
| `ogma_create_automate_session` | Vytvoří relaci funkce Automatizace s jedním bodem vkládání. `inject_into` jej vybírá jako `query:<name>`, `header:<name>` nebo `body`; ve výchozím stavu se použije první parametr dotazu, a pokud není dostupný, tělo. | **`entry_id`**, `name`, **`payloads`**, `inject_into`, `placeholder_start`, `placeholder_end`, `worker_count`, `delay_ms` |
| `ogma_run_automate_session` | Spustí relaci funkce Automatizace. | **`session_id`** |
| `ogma_list_automate_runs` | Vypíše běhy funkce Automatizace. | **`session_id`**, `limit`, `offset` |
| `ogma_get_automate_run` | Získá jeden běh funkce Automatizace. | **`run_id`** |
| `ogma_cancel_automate_run` | Zruší běh funkce Automatizace. | **`run_id`** |
| `ogma_list_automate_results` | Vypíše výsledky funkce Automatizace. | **`run_id`**, `limit`, `offset`, `min_status`, `max_status` |
| `ogma_get_automate_result` | Získá jeden výsledek funkce Automatizace. | **`run_id`**, **`seq`** |
| `ogma_load_skill` | Načte vestavěné pokyny dovedností MCP do kontextu asistenta. | **`skills`** |

### Skener {#scanner}

Spuštění pasivního nebo aktivního skenování vyžaduje oprávnění k zápisu nálezů, protože skenování může vytvářet nálezy. Výpis pravidel skeneru a kategorií aktivních kontrol je nevyžaduje.

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_run_passive_scan` | Spustí kontroly pasivního skeneru pro jeden záznam HTTP. | **`entry_id`** |
| `ogma_run_passive_scan_all` | Spustí kontroly pasivního skeneru napříč zachycenou historií. | Žádné. |
| `ogma_list_scanner_rules` | Vypíše detekční pravidla skeneru. | Žádné. |
| `ogma_list_active_checks` | Vypíše kategorie kontrol aktivního skeneru s ID a popisy a uvede, kolik z nich vytváří nálezy. Zástupné kategorie jsou uvedeny, ale nikdy nález nevytvoří. | Žádné. |
| `ogma_scan_active` | Spustí aktivní skener, který odesílá průkazné payloady a vytváří nálezy pouze pro třídy, které potvrdí z odpovědi. Pro skenování jednoho záznamu předejte `entry_id`, nebo jej vynechte pro průchod nedávnou historií. Jde o dlouhotrvající operaci, proto je zpřístupněna jako úloha; synchronní cesta sleduje úlohu dotazováním až do konečného stavu a vrací `job_id`, čítače průběhu a `findings_created`. Vyžaduje oprávnění k zápisu nálezů. | `entry_id`, `checks`, `concurrency`, `delay_ms`, `scan_headers` |

### Zachytávání {#intercept}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_get_intercept_status` | Získá aktuální stav zadržování. | Žádné. |
| `ogma_set_intercept_enabled` | Povolí nebo zakáže zadržování. | `request_enabled`, `response_enabled`, `websocket_enabled` |
| `ogma_list_intercept_queue` | Vypíše zadržené položky ve frontě. | Žádné. |
| `ogma_get_intercept_item` | Získá jednu zadrženou položku ve frontě. | **`id`** |
| `ogma_forward_intercept_item` | Předá zadrženou položku, volitelně upravenou. | **`id`**, `method`, `path`, `headers`, `body`, `status_override` |
| `ogma_drop_intercept_item` | Zahodí zadrženou položku. | **`id`** |
| `ogma_intercept_and_modify` | Počká na živý zadržený požadavek či odpověď, použije úpravy pomocí JSON Patch, náhrady regulárními výrazy nebo úplné nahrazení těla a pak položku předá. | **`direction`**, `host_pattern`, `path_pattern`, `wait_secs`, `json_patches`, `regex_replacements`, `body_b64`, `status_override`, `forward_unmatched` |

### Proxy, rozsah testování a síť {#proxy-scope-and-network}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_list_proxy_listeners` | Vypíše naslouchající proxy. | Žádné. |
| `ogma_start_proxy_listener` | Spustí naslouchající proxy. | **`listener_id`** |
| `ogma_stop_proxy_listener` | Zastaví naslouchající proxy. | **`listener_id`** |
| `ogma_list_scope_presets` | Vypíše předvolby rozsahu. | Žádné. |
| `ogma_create_scope_preset` | Uloží předvolbu rozsahu bez její aktivace. Vyžaduje oprávnění k odesílání. Každé pravidlo vyžaduje `pattern` a `include`; volitelný `rule_type` vybírá shodu podle hostitele, CIDR, cesty nebo regulárního výrazu. Pravidla cest používají `pattern` pro hostitele a `path_pattern` pro cestu. Vrácenou předvolbu aktivujte zvlášť pomocí `ogma_set_active_scope`. | **`name`**, **`rules`**, `httpql_expression` |
| `ogma_get_active_scope` | Získá aktivní rozsah. | Žádné. |
| `ogma_set_active_scope` | Nastaví aktivní rozsah. | `preset_id` |
| `ogma_local_ips` | Vypíše místní IP adresy užitečné pro naslouchající služby a zpětná volání. | Žádné. |
| `ogma_get_tls_info` | Získá informace TLS pro cíl nebo zachycené připojení. | **`host`**, `port` |

### Mapa webu, koncové body a OAST {#sitemap-endpoints-and-oast}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_get_sitemap` | Získá mapu webu (Sitemap) sestavenou ze zachyceného provozu. | `host`, `show_api_only` |
| `ogma_get_sitemap_parameters` | Získá parametry objevené pro jednu cestu v mapě webu. | **`host`**, **`port`**, **`path`** |
| `ogma_list_extracted_endpoints` | Vypíše koncové body extrahované z provozu a obsahu frontendu. | `limit`, `offset` |
| `ogma_discovery_start` | Spustí na pozadí úlohu vyhledávání obsahu proti hostiteli a portu v rozsahu; vrátí ID úlohy. | **`host`**, **`port`**, `tls`, `base_path`, `config` |
| `ogma_discovery_list` | Vypíše úlohy vyhledávání obsahu a jejich průběh v aktivním projektu. | Žádné. |
| `ogma_discovery_get` | Získá stav úlohy vyhledávání obsahu a objevené výsledky. | **`job_id`** |
| `ogma_discovery_cancel` | Požádá o zrušení běžící úlohy vyhledávání obsahu. | **`job_id`** |
| `ogma_import_openapi_spec` | Importuje specifikaci OpenAPI pro počáteční vytvoření koncových bodů a struktur požadavků. | **`spec_content`**, `base_url`, `collection_name` |
| `ogma_get_oast_config` | Získá konfiguraci naslouchající služby OAST. | Žádné. |
| `ogma_get_oast_reachability` | Uvede, zda je nakonfigurovaný hostitel zpětných volání OAST dosažitelný z cíle, včetně důvodů nedosažitelnosti a kroků k nápravě. Zkontrolujte jej před spoléháním na slepý payload: nedosažitelné zpětné volání vede k falešně negativnímu výsledku, který se jeví jako nepřítomnost zranitelnosti. | Žádné. |
| `ogma_list_oast_interactions` | Vypíše interakce OAST. Backend používá každý filtr ještě před vymezením stránky, takže celkový počet zahrnuje všechny shody místo délky stránky a omezení na jeden štítek tokenu či jednu zdrojovou adresu nikdy neskryje odpovídající zpětné volání dále ve výpisu. `token_label` je bod vkládání, který nesl token: název parametru dotazu, název hlavičky nebo `body`. Štítky se uchovávají v paměti spolu s tokeny, takže štítek, jehož token byl kvůli stáří odstraněn z paměti, nenajde žádnou shodu místo vrácení zastaralých řádků. | `limit`, `offset`, `token_id`, `token_label`, `protocol`, `source_ip`, `since` |

### Anotace historie {#history-annotation}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_set_entry_color` | Nastaví barevné označení záznamu historie. | **`entry_id`**, **`color`** |
| `ogma_add_entry_tag` | Přidá štítek k záznamu historie. | **`entry_id`**, **`tag`** |
| `ogma_remove_entry_tag` | Odebere štítek ze záznamu historie. | **`entry_id`**, **`tag`** |

### Ovládání prohlížeče {#browser-control}

Výběr mezi snímky, selektory a snímky obrazovky popisuje [průvodce prohlížečem](../guide/mcp-browser.md). Nepředpokládejte, že každý nástroj prohlížeče přijímá `tab_id` nebo `element_ref`; používejte pouze vstupy uvedené pro daný nástroj.

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_browser_launch` | Spustí prohlížeč Ogma. | `proxy_port` |
| `ogma_browser_navigate` | Přejde v prohlížeči na URL. | **`url`**, `tab_id`, `wait_for_load`, `timeout_ms`, `result_detail` |
| `ogma_browser_get_dom` | Přejde na stránku a vrátí vykreslený DOM i volitelné výsledky selektorů po provedení JavaScriptu. | **`url`**, `wait_secs`, `selectors`, `js_eval`, `include_full_html` |
| `ogma_browser_screenshot` | Zachytí stav stránky prohlížeče. | `tab_id`, `result_detail` |
| `ogma_browser_execute_js` | Provede JavaScript v prohlížeči. | **`script`**, `tab_id` |
| `ogma_browser_get_source` | Získá zdrojový kód DOM aktuální stránky. | `tab_id`, `format`, `max_chars` |
| `ogma_browser_get_cookies` | Získá cookies prohlížeče. | `tab_id` |
| `ogma_browser_set_cookie` | Nastaví cookie prohlížeče. | **`name`**, **`value`**, `domain`, `path`, `http_only`, `secure` |
| `ogma_browser_new_tab` | Otevře novou kartu prohlížeče. | `url` |
| `ogma_browser_close_tab` | Zavře kartu prohlížeče. | `tab_id` |
| `ogma_browser_get_tabs` | Vypíše karty prohlížeče. | `result_detail` |
| `ogma_browser_click` | Klikne na `element_ref` ze snímku nebo na výslovné souřadnice `x` a `y`. | `element_ref`, `snapshot_id`, `x`, `y`, `button`, `click_count`, `modifiers`, `offset_x`, `offset_y`, `force`, `timeout_ms`, `tab_id`, `expect`, `observation`, `result_detail` |
| `ogma_browser_type_text` | Napíše text do prohlížeče. | **`text`**, `tab_id`, `snapshot_id` |
| `ogma_browser_fill_input` | Nastaví vstupní pole pomocí právě jednoho selektoru CSS `selector` nebo odkazu `element_ref` ze snímku; prázdná hodnota pole vymaže. Neodesílá formulář. | **`selector`**, `value`, `tab_id`, **`element_ref`**, `snapshot_id`, `expect`, `observation`, `result_detail` |
| `ogma_browser_fill_form` | Jedním voláním nahradí text v několika vstupních polích, textových oblastech nebo prvcích contenteditable v dodaném pořadí; každé pole používá právě jeden `element_ref` nebo `selector` a hodnotu `value`. Zastaví se při prvním selhání a neodesílá formulář. | **`fields`**, `snapshot_id`, `tab_id`, `expect`, `observation`, `result_detail` |
| `ogma_browser_click_selector` | Klikne na prvek podle selektoru. | **`selector`**, `tab_id`, `expect`, `observation`, `result_detail` |
| `ogma_browser_submit_form` | Odešle formulář. | `selector`, `tab_id`, `expect`, `observation`, `result_detail` |
| `ogma_browser_get_page_links` | Extrahuje odkazy z aktuální stránky. | `tab_id` |
| `ogma_browser_get_page_forms` | Extrahuje formuláře z aktuální stránky. Nastavte `include_templates` na `true` (výchozí hodnota `false`), aby se přidala absolutní cílová URL každého formuláře, metoda, skutečně použitý typ obsahu, odesílané ovládací prvky s aktuálními hodnotami, odesílací prvky a `token_candidates` podobné CSRF. Formuláře multipart odkazují na `ogma_multipart_upload` místo sestaveného těla. Vyžaduje oprávnění `send_requests`. | `tab_id`, `include_templates` |
| `ogma_browser_form_to_replay` | Vytvoří relaci opakovaného odesílání z formuláře na aktuální stránce; přečte aktuální hodnoty polí a aktuální cookies prohlížeče v daném okamžiku a odvodí hlavičky Origin a Referer ze stránky. Požadavek neodesílá. | **`form_selector`**, `tab_id`, `name` |
| `ogma_browser_scroll` | Posune aktuální stránku. | `selector`, `x`, `y`, `tab_id` |
| `ogma_browser_wait_for_selector` | Počká na prvek odpovídající selektoru. | **`selector`**, `timeout_ms`, `tab_id`, `snapshot_id` |
| `ogma_browser_get_network_log` | Získá síťové události prohlížeče. | `host`, `since_ms`, `limit` |
| `ogma_browser_go_back` | Přejde zpět v historii prohlížeče. | `tab_id`, `snapshot_id` |
| `ogma_browser_go_forward` | Přejde vpřed v historii prohlížeče. | `tab_id`, `snapshot_id` |
| `ogma_browser_reload` | Znovu načte stránku. | `tab_id`, `snapshot_id` |
| `ogma_browser_find_text` | Najde text na aktuální stránce. | **`text`**, `tab_id`, `snapshot_id` |
| `ogma_browser_clear_data` | Vymaže data prohlížeče. | `types` |
| `ogma_crawl_site` | Prochází cílový web přes vestavěný prohlížeč v aktivním rozsahu a vrací data o pokrytí. | **`start_url`**, `max_pages`, `max_depth`, `wait_ms`, `tab_id` |

### Prvky prohlížeče a čekání {#browser-elements-and-waits}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_browser_snapshot` | Přečte kompaktní sémantický strom stránky s odkazy na prvky a jejich stavem; `result_detail: "full"` místo toho vrací strukturovanou obálku s prvky v `raw.elements`. Lze vyžádat přírůstek oproti předchozímu snímku. | `tab_id`, `previous_snapshot_id`, `changes_only`, `focus_ref`, `text`, `max_elements`, `max_text_length`, `include_hidden`, `max_depth`, `result_detail` |
| `ogma_browser_hover` | Přesune ukazatel nad odkazovaný prvek a uvede nově viditelné nabídky nebo popisky. | **`element_ref`**, `snapshot_id`, `offset_x`, `offset_y`, `modifiers`, `timeout_ms`, `tab_id` |
| `ogma_browser_select_option` | Vybere možnosti rozbalovacího seznamu podle hodnoty, popisku nebo indexu a uvede vybrané hodnoty. | **`element_ref`**, `snapshot_id`, **`values`**, `match_mode`, `allow_first_match`, `timeout_ms`, `tab_id` |
| `ogma_browser_check` | Výslovně nastaví stav zaškrtávacího políčka nebo přepínače místo slepého přepnutí. | **`element_ref`**, `snapshot_id`, `checked`, `timeout_ms`, `tab_id` |
| `ogma_browser_press_key` | Odešle klávesu nebo kombinaci kláves na aktivní stránku či odkazovaný prvek. | **`key`**, `element_ref`, `snapshot_id`, `modifiers`, `repeat`, `delay_ms`, `tab_id` |
| `ogma_browser_focus` | Zaměří odkazovaný prvek a uvede jeho možnosti vstupu. | **`element_ref`**, `snapshot_id`, `tab_id` |
| `ogma_browser_blur` | Odebere zaměření aktuálně zaměřenému prvku. | `tab_id`, `snapshot_id` |
| `ogma_browser_drag_and_drop` | Přetáhne jeden odkazovaný prvek na jiný. | **`source_ref`**, **`target_ref`**, `snapshot_id`, `steps`, `tab_id` |
| `ogma_browser_scroll_to` | Posune zobrazení k prvku, na pozici stránky nebo uvnitř odkazovaného posuvného kontejneru. | `target`, `element_ref`, `snapshot_id`, `container_ref`, `direction`, `amount`, `behavior`, `timeout_ms`, `tab_id` |
| `ogma_browser_wait_for` | Počká na podmínku prvku, textu, URL, navigace či dialogu nebo na stabilitu stránky; v případě potřeby podporuje výslovnou časovou prodlevu. | **`condition`**, `target`, `timeout_ms`, `stability_ms`, `tab_id`, `snapshot_id`, `result_detail` |
| `ogma_browser_handle_dialog` | Přijme nebo odmítne dialog JavaScriptu s volitelným textem vstupního dialogu a kontrolami očekávaného dialogu. | **`action`**, `prompt_text`, `expected_type`, `expected_message`, `tab_id`, `snapshot_id` |
| `ogma_browser_dialog_status` | Uvede případný čekající dialog JavaScriptu, aniž jej zavře. | Žádné. |

### Soubory, vyskakovací okna a stahování v prohlížeči {#browser-files-popups-and-downloads}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_list_hosted_files` | Vypíše hostované soubory aktivního projektu a jejich ID pro nahrávání a prohlížení artefaktů. | `limit`, `offset` |
| `ogma_artifact_read_range` | Přečte omezený rozsah bajtů hostovaného souboru místo vrácení celého souboru. | **`artifact_id`**, `offset`, `length` |
| `ogma_artifact_search` | Prohledá omezený rozsah hostovaného souboru UTF-8 a hledá doslovný text; vrátí bajtové pozice shod. | **`artifact_id`**, **`query`**, `offset`, `max_bytes`, `max_matches` |
| `ogma_browser_file_upload` | Nastaví souborové vstupní pole pomocí existujících ID hostovaných souborů Ogma, nikoli libovolných cest v souborovém systému klienta. | **`element_ref`**, `snapshot_id`, **`artifact_ids`**, `tab_id` |
| `ogma_browser_wait_for_popup` | Připraví detekci vyskakovacího okna před akcí, počká na něj nebo zkontroluje stav detekce. | **`action`**, `timeout_ms`, `switch_to_new_tab` |
| `ogma_browser_download_wait` | Zjistí probíhající či dokončené stahování v prohlížeči. Prozkoumejte jeho ID a stav; detekce neznamená dokončení ani to, že jde o nejnovější stahování. | `timeout_ms` |
| `ogma_browser_download_get` | Prozkoumá jedno stahování a uloží dokončený obsah jako artefakt, pokud je dostupný. | **`download_id`** |
| `ogma_browser_download_status` | Vypíše stahování prohlížeče a jejich aktuální průběh či stav. | Žádné. |

### Identity, úložiště a oprávnění prohlížeče {#browser-identities-storage-and-permissions}

Níže uvedené nástroje oprávnění prohlížeče řídí oprávnění webů, například ke kameře nebo geolokaci. Nemění oprávnění nástrojů serveru MCP.

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_browser_context_create` | Vytvoří izolovanou identitu prohlížeče a počáteční kartu; vrátí `context_id` a `tab_id`. | `label`, `auth_profile_id`, `initial_url`, `retain_on_close` |
| `ogma_browser_context_clone` | Vytvoří čistý kontext nebo zkopíruje cookies zdrojového kontextu pomocí `clone_mode: authenticated`; nejde o úplnou kopii úložiště. | **`context_id`**, `clone_mode`, `label` |
| `ogma_browser_context_close` | Zavře kontext a jeho karty a vymaže úložiště, pokud při vytváření nebylo požadováno jeho zachování. | **`context_id`** |
| `ogma_browser_context_list` | Vypíše kontexty prohlížeče a jejich stav. | Žádné. |
| `ogma_browser_auth_state_capture` | Zachytí cookies a webové úložiště jako pojmenovaný autentizační stav v paměti; vrátí metadata s odstraněnými citlivými údaji. | **`name`**, `tab_id`, `context_id`, `role`, `url` |
| `ogma_browser_auth_state_apply` | Obnoví zachycený autentizační stav; metadata vypršení nejsou důkazem, že server relaci přijímá. | **`auth_state_id`**, `tab_id`, `context_id`, `url` |
| `ogma_browser_auth_state_list` | Vypíše zachycené autentizační stavy bez jejich úplných tajných hodnot. | Žádné. |
| `ogma_browser_auth_state_delete` | Smaže jeden zachycený autentizační stav. | **`auth_state_id`** |
| `ogma_browser_storage_list` | Vypíše cookies a položky webového úložiště se zkrácenými náhledy hodnot. | `origin`, `storage_type` |
| `ogma_browser_storage_get` | Prozkoumá jednu cookie nebo klíč úložiště se zkráceným náhledem hodnoty. | **`storage_type`**, **`key`**, `origin` |
| `ogma_browser_storage_set` | Zapíše hodnotu cookie či úložiště; přijímá odkaz Ogma `env:VARIABLE_NAME`. | **`storage_type`**, **`key`**, **`value`**, `origin`, `domain`, `path`, `http_only`, `secure`, `expires` |
| `ogma_browser_storage_delete` | Smaže jednu cookie nebo klíč webového úložiště. | **`storage_type`**, **`key`**, `origin` |
| `ogma_browser_permissions_set` | Udělí, zamítne nebo resetuje určená oprávnění webu pro daný původ. | **`origin`**, **`permissions`**, `setting`, `context_id` |
| `ogma_browser_permissions_reset` | Vymaže přepsaná nastavení oprávnění prohlížeče. | `context_id` |
| `ogma_browser_permissions_get` | Zjistí stavy oprávnění webu pro daný původ. | **`origin`**, `permissions` |

### Diagnostika, důkazy a obnovení prohlížeče {#browser-diagnostics-evidence-and-recovery}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_browser_network_delta` | Získá omezený počet síťových záznamů za kurzorem, přičemž zachová úplné URL, časování, chyby a ID Historie HTTP, jsou-li dostupné. | `since_entry_id`, `resource_types`, `status_filter`, `failed_only`, `max_entries` |
| `ogma_browser_console_delta` | Získá nové záznamy konzole včetně zdrojové URL, řádku a sloupce, pokud je prohlížeč poskytuje. | `since_entry_id`, `levels`, `max_entries` |
| `ogma_browser_action_correlation` | Získá provoz a události spojené s časovým oknem akce nebo vypíše nedávné akce. Samotné časování neprokazuje příčinnou souvislost. | `browser_action_id`, `limit` |
| `ogma_browser_snapshot_save` | Archivuje aktuální snímek pro pozdější porovnání; archiv uchovává až 20 snímků. | `label` |
| `ogma_browser_page_state_compare` | Porovná dva archivované snímky a uvede rozdíly prvků a stavů, volitelně s ignorováním proměnlivých hodnot a rolí. | **`snapshot_id_a`**, **`snapshot_id_b`**, `ignore_volatile`, `ignore_roles` |
| `ogma_browser_trace_start` | Spustí jednoduché trasování akcí; `detailed` přidává odkazy na konzoli a síť. | `level`, `label`, `context_id` |
| `ogma_browser_trace_stop` | Zastaví trasování a uchová jeho události v paměti. | **`trace_id`** |
| `ogma_browser_trace_export` | Uloží zastavené trasování jako artefakt hostovaného souboru JSON v aktivním projektu. | **`trace_id`** |
| `ogma_browser_trace_list` | Vypíše trasování a jejich stav záznamu či exportu. | Žádné. |
| `ogma_browser_trace_note` | Připojí poznámku ke všem právě zaznamenávaným trasováním. | **`note`** |
| `ogma_browser_human_takeover_start` | Pozastaví akce agenta v prohlížeči kvůli ručnímu kontrolnímu bodu s omezeným časovým limitem. | `reason`, `context_id`, `tab_id`, `timeout_ms` |
| `ogma_browser_human_takeover_complete` | Vrátí řízení po ruční interakci a obnoví snímek stránky. | **`takeover_id`** |
| `ogma_browser_human_takeover_status` | Zkontroluje, zda je aktivní ruční ovládání, a uvede zbývající čas. | Žádné. |
| `ogma_browser_health` | Uvede kondici přemostění debuggeru a nedávné informace o pádech či odpojeních. | Žádné. |
| `ogma_browser_recover` | Pokusí se obnovit přemostění a ve výchozím stavu zachová důkazy; může hlásit `relaunch_required`. | `preserve_evidence` |

### Testování autentizace a autorizace {#authentication-and-authorization-testing}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_auth_capture_profile` | Zachytí cookies, úložiště, zjištěné autentizační tokeny a kandidáty CSRF z vestavěného prohlížeče. | **`name`**, `role`, `url`, `tab_id`, `wait_ms` |
| `ogma_auth_list_profiles` | Vypíše zachycené autentizační profily se souhrnným zobrazením tajných hodnot. | Žádné. |
| `ogma_auth_apply_profile` | Použije zachycený autentizační profil ve vestavěném prohlížeči pro přepínání rolí či účtů. | **`profile_id`**, `url`, `tab_id`, `wait_ms` |
| `ogma_auth_refresh_csrf` | Obnoví kandidáty tokenů CSRF z aktuální stránky, cookies, úložiště, meta tagů a skrytých vstupních polí. | `profile_id`, `url`, `tab_id`, `wait_ms` |
| `ogma_login_replay_auto` | Automaticky zjistí přihlašovací formulář, odešle přihlašovací údaje ve vestavěném prohlížeči a zachytí autentizační profil. | **`login_url`**, **`username`**, **`password`**, **`profile_name`**, `role`, `tab_id`, `wait_ms` |
| `ogma_authz_matrix_test` | Zopakuje jeden zachycený požadavek pod více autentizačními profily pro porovnání výsledků řízení přístupu. | **`request_id`**, **`profile_ids`**, `mutations`, `entry_id` |

### Opakovaně použitelné přihlašovací postupy {#reusable-login-journeys}

Na rozdíl od autentizačních profilů v paměti se přihlašovací postupy trvale ukládají pro každý projekt. Přihlašovací údaje odkazují na ID proměnných prostředí Ogma. Všechny nakonfigurované ověřovací kontroly musí projít; samotné odeslání přihlašovacího formuláře neznamená úspěšnou autentizaci.

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_auth_journey_record` | Uloží přihlašovací kroky, odkazy na přihlašovací údaje, ověřovací kontroly a volitelné ruční kontrolní body MFA. Tím definuje postup; nezaznamenává automaticky libovolná kliknutí. | **`name`**, `role`, **`login_url`**, **`username_env_var_id`**, **`password_env_var_id`**, `username_selectors`, `password_selectors`, `submit_selectors`, `steps`, **`verification`**, `mfa`, `mfa_reason`, `mfa_timeout_ms` |
| `ogma_auth_journey_list` | Vypíše uložené přihlašovací postupy v aktivním projektu s odstraněnými tajnými údaji relace. | Žádné. |
| `ogma_auth_journey_replay` | Provede uložený přihlašovací postup, ověří autentizaci a uloží obnovenou relaci; při nastaveném ručním MFA se pozastaví. | **`journey_id`**, `tab_id` |
| `ogma_auth_journey_verify` | Zkontroluje URL, DOM, cookies a volitelný ověřovací požadavek vůči aktuální relaci. | **`journey_id`**, `tab_id` |
| `ogma_auth_journey_ensure` | Ověří aktuální relaci, pokusí se obnovit uložený stav a opakuje přihlášení pouze tehdy, pokud je stále potřeba. | **`journey_id`**, `tab_id` |
| `ogma_auth_journey_resume` | Pokračuje v postupu po ručním kontrolním bodu a ověří výslednou relaci. | **`journey_id`**, **`takeover_id`**, `tab_id` |

### Pomocné nástroje a analýza {#utilities-and-analysis}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_fetch_sourcemap` | Načte a prozkoumá mapu zdrojového kódu JavaScriptu. | **`url`**, `base_url` |
| `ogma_proto_decode` | Dekóduje payloady protobuf pomocí nakonfigurovaných schémat. | **`data_b64`**, `content_type` |
| `ogma_decode_jwt` | Dekóduje hlavičky a deklarované údaje JWT. | **`token`** |
| `ogma_decode_response` | Dekóduje, dekomprimuje nebo transformuje těla odpovědí pomocí uspořádaných operací, například zpracování base64, gzip, deflate, brotli, URL, entit HTML a hexadecimálního zápisu. | **`input`**, `input_is_b64`, **`operations`**, `max_output_bytes` |
| `ogma_search_js_secrets` | Prohledává odpovědi JavaScriptu a hledá odhalené tajné údaje a koncové body. | `host`, `patterns` |
| `ogma_compare_responses` | Porovná dvě odpovědi. | **`entry_id_a`**, **`entry_id_b`**, `mode` |
| `ogma_bytes_transform` | Provádí transformace bajtů, například kódování, dekódování, XOR, hashování a extrakci. | **`operation`**, **`data`**, `key`, `output_encoding`, `offset`, `length`, `min_len` |
| `ogma_wasm_inspect` | Prozkoumá modul WebAssembly. | **`wasm_b64`**, `data_encoding` |
| `ogma_fingerprint_target` | Identifikuje technologie cíle ze zachyceného provozu a odpovědí. | `host`, `entry_limit` |
| `ogma_sign_request` | Vypočítá podpisové hlavičky požadavku HMAC-SHA256 pro aplikace používající podpisová schémata na straně klienta. | **`key`**, **`method`**, **`path`**, `params` |
| `ogma_find_in_response` | Načte až 10 URL a prohledá těla odpovědí regulárním výrazem s kompaktním kontextem. | **`urls`**, **`pattern`**, `headers`, `context_chars`, `max_matches_per_url`, `case_insensitive`, `timeout_secs` |
| `ogma_think` | Zaznamená strukturované úvahy nebo text plánu uvnitř relace MCP. | **`thought`** |
| `ogma_explain_capabilities` | Vrátí souhrn funkcí serveru MCP. | Žádné. |

### Pomocné nástroje aktivního sondování {#active-probe-helpers}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_run_active_probe_workflow` | Spustí omezenou sondu pro konkrétní zranitelnost proti zachycenému požadavku. Moduly zahrnují IDOR/BOLA, CORS, SSRF OAST, odražené/uložené XSS, časové/chybové SQLi, průchod cestami, SSTI, obcházení kontrol nahrávání, introspekci/autorizaci GraphQL, manipulaci JWT a kontroly omezení četnosti. | **`probe`**, **`request_id`**, `entry_id`, `target_param`, `profile_ids`, `values`, `origins`, `max_cases` |
| `ogma_test_race` | Odešle jeden požadavek souběžně a uvede nejčastější stavový kód, odpovědi, které se od něj odchýlily, a verdikt. Používejte jej pro jednorázové operace: několik úspěšných odpovědí na operaci, která má uspět pouze jednou, ukazuje, že není atomická. Pro zachycený záznam předejte `request_id`, nebo výslovně zadejte `host` a `port` spolu se zbytkem požadavku. Nastavte `http2`, aby se každý požadavek odeslal jako souběžný proud na jednom připojení (single-packet); tato varianta umožňuje zasáhnout úzká časová okna, pokud cíl podporuje HTTP/2. Ve výchozím stavu se otevírá jedno připojení na požadavek. Odchylka je důkazem pouze o zpracování souběhu a stejné výsledky celé dávky nejsou důkazem atomicity, proto výsledek potvrďte ze stavu, který operace změnila. | `request_id`, `entry_id`, `method`, `host`, `port`, `tls`, `path`, `query`, `params`, `headers`, `body_b64`, `concurrency`, `stagger_ms`, `http2` |
| `ogma_test_smuggling` | Odešle sondy desynchronizace CL.TE a TE.CL přes surové TCP a uvede výsledky sond, kandidáty a verdikt. Hlavičky předané v `headers` se posílají pouze s požadavkem sondy; následný požadavek měřící desynchronizaci se vždy odesílá bez nich. Sonda je heuristická a často dává falešně pozitivní i falešně negativní výsledky: frontend, který po prvním požadavku uzavře připojení, nebo který odmítne rozporné vymezení zprávy odpovědí 400, dává při sondování stejný výsledek jako zranitelný frontend; negativní výsledek také není důkazem bezpečnosti. Před nahlášením potvrďte výsledek: zopakujte bajty sondy pomocí `ogma_http_request` v surovém režimu, předejte je jako `raw_request_base64` s `max_responses` nastaveným na 2 pro přečtení odpovědi, kterou bajty nevyžadovaly, poté na stejném připojení odešlete běžný požadavek pomocí `followup_raw_request_base64` a porovnejte oba stavové kódy. Pouze HTTP/1.x. | **`host`**, **`port`**, `tls`, `path`, `timeout_ms`, `headers` |
| `ogma_test_hpp` | Odešle varianty znečištění parametrů HTTP pro pojmenované parametry a uvede, která varianta změnila stav nebo tělo odpovědi, spolu s verdiktem. Použijte jej, když se parametr validuje v jedné komponentě a používá v jiné, takže se duplicitní název může v každé vyhodnotit jinak. Změněná odpověď ukazuje rozdílné zpracování duplicitních parametrů; sama o sobě neprokazuje obejití kontroly. `headers` se odesílá v každém požadavku včetně výchozího porovnávacího, takže Cookie nebo Authorization v těchto hlavičkách umožní sondovat koncový bod vyžadující přihlašovací údaje. Bez hlaviček požadavky nenesou cookies ani autentizaci, a varianta, která na koncovém bodu chráněném přihlášením nic nezmění, tedy nic neprokazuje. | **`host`**, **`port`**, **`params`**, `tls`, `path`, `base_value`, `test_value`, `timeout_ms`, `headers` |
| `ogma_list_nuclei_templates` | Vypíše šablony skeneru přibalené k Ogma se závažností a významem shody. Přečtěte si je před `ogma_run_nuclei`, abyste jednu vybrali podle názvu. | Žádné. |
| `ogma_run_nuclei` | Spustí jednu šablonu proti cílové URL a uvede každou shodu. Nevytváří nálezy. Pro přibalenou šablonu předejte `template`, pro vlastní dokument `template_yaml`, nikoli obojí. Parser podporuje podmnožinu nuclei: podmínky shody stavu, slov a regulárních výrazů, `matchers-condition` a extraktory regulárních výrazů. Typy podmínek shody mimo tuto podmnožinu, včetně výrazů DSL, se přeskakují místo vyhodnocení a nástroj nespouští všechny šablony, které by úplná instalace nuclei přijala. Šablony kontrolují vystavené prostředky a chybné konfigurace, které pasivní skener nevidí, například vystavené `.env`, `.git/config`, koncový bod actuator nebo stránku server-status. | **`target`**, `template`, `template_yaml` |
| `ogma_record_test_attempt` | Zaznamená, že byl otestován jeden koncový bod, parametr nebo vektor, a jaký byl výsledek, aby pozdější relace odlišila slepou uličku od neotestovaného bodu. Pouze `no_signal` vyřadí bod z dalšího testování; `transport_error` znamená, že sonda k cíli vůbec nedorazila, takže o vektoru nic neprokazuje. | **`host`**, **`port`**, **`path`**, **`vector`**, **`outcome`**, **`reason`**, `parameter`, `payload_label`, `evidence_entry_id` |
| `ogma_list_test_attempts` | Vypíše zaznamenané pokusy testování od nejnovějších a seskupí je podle hostitele, portu, cesty, parametru a vektoru. U každého bodu uvede rozhodující pokus, počet pokusů a zda je vyčerpán. Bod je vyčerpán pouze tehdy, když je jeho rozhodující výsledek `no_signal`; pozdější `transport_error` tento stav neruší. | `host`, `port`, `path`, `vector`, `limit` |

### Přímé testování WebSocket {#direct-websocket-testing}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_websocket_connect` | Připojí se k URL `ws://` nebo `wss://`, odešle zprávy a vrátí přepis. | **`url`**, **`messages`**, `headers`, `timeout_secs` |
| `ogma_ws_capture_history` | Uloží přepis WebSocket z `ogma_websocket_connect` jako strukturovanou historii Ogma pro kontrolu a propojení důkazů. | **`url`**, **`transcript`**, `label` |

### Vyhledat a nahradit {#match-and-replace}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_list_match_replace_rules` | Vypíše pravidla funkce Vyhledat a nahradit. | Žádné. |
| `ogma_create_match_replace_rule` | Vytvoří pravidlo funkce Vyhledat a nahradit; operace pracovních postupů vyžadují workflow\_id. | **`name`**, `enabled`, **`direction`**, **`operation`**, **`match_value`**, `match_mode`, `replace_value`, `filter_method`, `filter_host`, `filter_path`, `filter_httpql`, `position`, `workflow_id` |
| `ogma_toggle_match_replace_rule` | Povolí nebo zakáže pravidlo funkce Vyhledat a nahradit. | **`rule_id`**, **`enabled`** |
| `ogma_delete_match_replace_rule` | Smaže pravidlo funkce Vyhledat a nahradit. | **`rule_id`** |

### Proměnné prostředí {#environment-variables}

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_list_env_vars` | Vypíše názvy a metadata proměnných prostředí. | Žádné. |
| `ogma_set_env_var` | Vytvoří nebo aktualizuje proměnnou prostředí. | **`name`**, **`value`**, `scope`, `is_secret` |
| `ogma_get_env_var_value` | Přečte hodnotu proměnné prostředí, pokud je to povoleno. | **`name`** |

### Projekty, poznámky, úkoly a relace {#projects-notes-todos-and-session}

Přepnutí projektu ovlivňuje aktivní projekt v Ogma, nejen žádajícího agenta. Koordinujte se s ostatními klienty. Níže uvedené nástroje poznámek a úkolů jsou **pracovní zápisník relace MCP v paměti**, nikoli trvale ukládaná stránka Poznámky v aplikaci. Před odpojením nebo restartem MCP uchovejte zprávu relace.

| Nástroj | Co dělá | Vstupy |
| --- | --- | --- |
| `ogma_list_projects` | Vypíše projekty. | Žádné. |
| `ogma_switch_project` | Přepne aktivní projekt. | `project_id`, `project_name` |
| `ogma_start_pentest_session` | Vytvoří strukturovaný plán posouzení cíle a ve výchozím stavu také poznámku či kontrolní seznam uchovávané pouze v dané relaci. Automaticky nespouští úplné skenování. | **`target_url`**, `objective`, `mode`, `create_scratchpad` |
| `ogma_get_coverage_status` | Shrne průběh kontrolního seznamu aktuální relace a zbývající pokrytí; nejde o důkaz úplného otestování. | Žádné. |
| `ogma_recommend_skills` | Navrhne vestavěné pokyny dovedností podle pozorovaných technologií, cest, hlaviček a dalšího dodaného kontextu. | `observations`, `paths`, `content_types`, `headers`, `technologies`, `response_snippets`, `notes` |
| `ogma_note_create` | Vytvoří poznámku. | **`title`**, **`content`**, `category` |
| `ogma_note_list` | Vypíše poznámky. | `category` |
| `ogma_note_get` | Získá jednu poznámku. | **`id`** |
| `ogma_note_update` | Aktualizuje poznámku. | **`id`**, `title`, `content`, `category` |
| `ogma_note_delete` | Smaže poznámku. | **`id`** |
| `ogma_todo_create` | Vytvoří úkol. | **`task`**, `priority` |
| `ogma_todo_list` | Vypíše úkoly. | `status`, `priority` |
| `ogma_todo_update` | Aktualizuje úkol. | **`id`**, `task`, `priority`, `status` |
| `ogma_todo_mark_done` | Označí úkol jako dokončený. | **`id`** |
| `ogma_todo_delete` | Smaže úkol. | **`id`** |
| `ogma_finish_session` | Dokončí relaci MCP se souhrnem, metodikou a doporučeními. | **`summary`**, **`methodology`**, **`recommendations`** |
| `ogma_get_session_report` | Získá zprávu aktuální relace MCP. | Žádné. |

## Vztah k AI v pracovním prostoru {#relationship-to-workspace-ai}

Server MCP je protokolový server používaný externími nástroji. AI v pracovním prostoru v aplikaci je funkce Vue/prohlížeče, která přímo volá nakonfigurované poskytovatele AI a nabízí vlastní seznam frontendových nástrojů. Viz [AI v pracovním prostoru](../guide/workspace-ai.md).