Ve kterých tarifech je MCP?

Ve všech. Čtení je zdarma. Práce s AI, kterou agent v Orboxu spustí, čerpá kredity jako jakákoli jiná práce v prostoru.

Ano. Claude, Codex a ChatGPT se přihlásí v prohlížeči, bez kopírování tokenu. Připojení platí 90 dní a kdykoli ho zrušíte v Nastavení → Aplikace a tokeny. Skripty a další klienti používají API tokeny.

Dostane agent přístup k celému mému účtu?

Dostane to, co povolíte: Pouze čtení, nebo Čtení a zápis, v prostoru, do kterého jste přihlášeni. Jedná za vás, takže vidí jen to, co vidíte vy.

Může Partner používat MCP v prostoru klienta?

Ano. Klient Partnera pozve jako člena a Partner připojí svého agenta přihlášený do toho prostoru. Odebráním člena se zruší i přístup.

Napište nám e-mail, jakého klienta používáte a jaká chyba se objevila. Odpovíme e-mailem.

MCP server

Váš AI agent pracuje přímo s vašimi procesy.

Orbox provozuje hostovaný MCP server. Připojte Claude, Codex nebo ChatGPT přihlášením v prohlížeči a agent si vaše procesy přečte krok po kroku, nebo je za vás zmapuje a upraví.

Nastavit Pro vývojáře

URL serveru

https://orbox.dev/api/mcp

claude

Přečti proces „Zpracování faktur“ a zautomatizuj další krok v n8n.

Jak to funguje

Přihlášení bez tokenu: Claude, Codex a ChatGPT se připojí přes OAuth. Přihlásíte se svým účtem do Orboxu v prohlížeči a připojení povolíte.
Přístup volíte vy: Pouze čtení, nebo Čtení a zápis, pokud má agent procesy mapovat a upravovat. Nic není předvybrané. Agent jedná za vás a vidí jen to, co vidíte vy.
Máte to pod kontrolou: Připojení platí 90 dní. Uvidíte a zrušíte ho v Orboxu v Nastavení → Aplikace a tokeny, vlastník organizace vidí a ruší připojení všech členů. Každá změna se zapíše do historie verzí.
I pro skripty a CI: Pro automatizace a klienty bez OAuth vytvoříte osobní API token. Pouze čtení, nebo Čtení a zápis, platnost 1 až 365 dní.

Nastavení

Tři kroky: připojit, nainstalovat skill, vyzkoušet.

1. Připojte svého agenta

Claude Code

terminál

claude mcp add --transport http --scope user orbox https://orbox.dev/api/mcp

Pak v Claude Code spusťte /mcp, vyberte orbox → Authenticate a přihlaste se v prohlížeči. Ověříte příkazem claude mcp list.

Claude (web a Desktop)

Customize → Connectors → + → Add custom connector
Název: Orbox. URL: https://orbox.dev/api/mcp
Pokročilá pole OAuth nechte prázdná, pak Add → Connect

Jedno nastavení funguje na claude.ai i v Claude Desktop. V plánech Team a Enterprise konektor nejdřív přidá vlastník, pak se připojí každý člen.

Podrobný návod pro Claude

Codex

terminál

codex mcp add orbox --url https://orbox.dev/api/mcp
codex mcp login orbox

Druhý příkaz otevře přihlášení do Orboxu. Pokud se Codex po čase přestane ověřovat, spusťte codex mcp login orbox znovu.

ChatGPT

Settings → Security and login → zapněte Developer mode
Settings → Plugins (chatgpt.com/plugins) → + → vytvořte aplikaci. Název: Orbox. URL: https://orbox.dev/api/mcp. Authentication: OAuth
Přihlaste se do Orboxu. V chatu zvolte + → Developer mode → Orbox

Jen na webu. V tarifech Business, Enterprise a Edu zapíná režim pro vývojáře správce prostoru. Podle OpenAI je zápis zatím dostupný v Business, Enterprise a Edu, v ostatních tarifech může jít jen o čtení. Každý zápis ChatGPT nechá potvrdit.

Cursor, opencode a další klienti se připojí přes API token. Viz API tokeny

Na obrazovce souhlasu v Orboxu

Zkontrolujte, že adresa přesměrování patří aplikaci, ze které jste začali: localhost u Claude Code a Codexu, claude.ai u Claude, chatgpt.com u ChatGPT. Neznámou adresu nikdy nepovolujte.
Zvolte Čtení a zápis, pokud má agent procesy mapovat a upravovat, nebo Pouze čtení, pokud má jen číst. Pak klikněte na Povolit.

2. Nainstalujte skill orbox-process

MCP dává agentovi nástroje, skill mu dává metodu: jak se vás vyptat, rozdělit proces na kroky, dohledat role a nástroje a před odesláním vše zkontrolovat. Bez skillu agent funguje, ale procesy vycházejí výrazně hůř.

Claude Code

terminál

claude plugin marketplace add ordexai/orbox-skills
claude plugin install orbox@orbox

Aktualizace později: claude plugin marketplace update orbox a pak claude plugin update orbox@orbox.

Claude (web a Desktop)

Stáhněte orbox-process.zip
Customize → Skills → + → Create skill → Upload a skill
Skill zapněte

Vyžaduje zapnuté Code execution and file creation v Settings → Capabilities. V plánech Team a Enterprise může vlastník skill nasdílet celé organizaci.

Stáhnout orbox-process.zip

Codex, Cursor a další

terminál

npx skills add ordexai/orbox-skills -g

Nainstaluje skill globálně pro agenty, které na počítači najde. Aktualizace později: npx skills update orbox-process.

Po instalaci začněte novou relaci, agent načítá skilly na jejím začátku. Skill je veřejný a licencovaný pro použití s Orboxem: github.com/ordexai/orbox-skills

3. Vyzkoušejte

V nové konverzaci nejdřív ověřte připojení, pak se pusťte do práce:

Co je v mém prostoru v Orboxu? Ukaž mi procesy a katalog entit.
Zmapuj náš proces schvalování dodavatelské faktury.
Ukaž mi, co je potřeba opravit v procesu „Zpracování faktur“.

Odeslaný proces nejdřív projde krátkou AI kontrolou (waiting_for_processing). Agent na ni počká přes get_process_status a pak vám dá odkaz na koncept v Orboxu. Tam ho člověk ověří a schválí.

API tokeny pro skripty, CI a další klienty

Pro automatizace a klienty, kteří OAuth neumí. Stejný server přes Streamable HTTP, token jde do hlavičky Authorization: Bearer.

1.
V Orboxu otevřete Nastavení → Aplikace a tokeny a vytvořte token. Pojmenujte ho podle zařízení nebo nástroje.
2.
Zvolte Pouze čtení, nebo Čtení a zápis, a platnost: výchozí 90 dní, 1 až 365.
3.
Zkopírujte tajný klíč. Zobrazí se jen jednou. Uložte ho do proměnné prostředí, nikdy ne do repozitáře, URL ani sdílené konfigurace projektu.

Proměnná prostředí

~/.zshrc

export ORBOX_API_TOKEN='paste-token-here'

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "orbox": {
      "url": "https://orbox.dev/api/mcp",
      "headers": { "Authorization": "Bearer ${env:ORBOX_API_TOKEN}" }
    }
  }
}

Stejně funguje v každém klientovi, který podporuje vzdálené MCP s vlastními hlavičkami.

opencode

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "orbox": {
      "type": "remote",
      "url": "https://orbox.dev/api/mcp",
      "enabled": true,
      "oauth": false,
      "headers": { "Authorization": "Bearer {env:ORBOX_API_TOKEN}" }
    }
  }
}

"oauth": false zabrání opencode, aby zkoušel přihlášení přes OAuth.

Claude Code s tokenem

terminál

claude mcp add --transport http --scope user orbox https://orbox.dev/api/mcp \
  --header "Authorization: Bearer $ORBOX_API_TOKEN"

Pro CI nebo stroj bez prohlížeče. Parametr --header nechte poslední.

Codex s tokenem

terminál

codex mcp add orbox --url https://orbox.dev/api/mcp --bearer-token-env-var ORBOX_API_TOKEN

Codex čte proměnnou při startu, proto ji exportujte v shellu, ze kterého codex spouštíte.

REST API

Pro integrace z vlastních systémů je k dispozici REST API v1 se stejnými tokeny. Interaktivní dokumentace: orbox.dev/api/v1/docs a specifikace OpenAPI: openapi.json

Co agent umí

Nástroje pro čtení fungují s každým připojením. Nástroje pro zápis vyžadují Čtení a zápis.

Oblast	Nástroje	Přístup
Orientace	get_workspace_overview, search_processes, search_entities, list_entity_types, list_entities	Čtení
Čtení	get_process, get_entity, get_process_status, get_process_history, get_process_comments, get_lint_status	Čtení
Procesy	create_draft_process, update_process_meta, apply_process_batch, submit_process, archive_process	Čtení a zápis
Kroky a tok	create_step, update_step, delete_step, reorder_steps, create_flow, delete_flow	Čtení a zápis
Entity	create_entity, update_entity, apply_entity_batch	Čtení a zápis
Komentáře	add_process_comment	Čtení a zápis

Agent nemůže schvalovat návrhy entit, měnit typy entit ani jejich pole, ani nic natrvalo smazat. To zůstává na lidech v Orboxu.

Když něco nefunguje

Agent nevidí nástroje Orboxu: Začněte novou konverzaci nebo aplikaci restartujte. Ověřte, že je připojení zapnuté: /mcp v Claude Code, přepínač konektoru v Claude.
Přihlášení selže nebo stránka souhlasu hlásí chybu: Spusťte připojení z klienta znovu. Každý pokus potřebuje nové přihlášení, starý odkaz nefunguje.
FORBIDDEN při zápisu: Připojení je jen pro čtení. Připojte se znovu a zvolte Čtení a zápis, nebo vytvořte token pro zápis.
STALE_REVISION: Proces mezitím změnil někdo jiný. Agent ho znovu načte přes get_process a změnu zopakuje.
TOO_MANY_REQUESTS: Příliš mnoho volání najednou. Chvíli počkejte a změny pošlete dávkou přes apply_process_batch.
PROCESS_NOT_EDITABLE: Proces čeká na kontrolu nebo je už schválený. Agent založí novou verzi konceptu.

Na co se zeptat

Přečti proces „Zpracování faktur“ a zautomatizuj další krok v n8n.
Vyptej se mě na náš onboarding a zmapuj ho jako nový koncept procesu.
Co se v „Schvalování nákupů“ změnilo od minulého týdne a co musím přestavět?

Časté otázky

Ve kterých tarifech je MCP?
Ve všech. Čtení je zdarma. Práce s AI, kterou agent v Orboxu spustí, čerpá kredity jako jakákoli jiná práce v prostoru.
Podporujete OAuth?
Ano. Claude, Codex a ChatGPT se přihlásí v prohlížeči, bez kopírování tokenu. Připojení platí 90 dní a kdykoli ho zrušíte v Nastavení → Aplikace a tokeny. Skripty a další klienti používají API tokeny.
Dostane agent přístup k celému mému účtu?
Dostane to, co povolíte: Pouze čtení, nebo Čtení a zápis, v prostoru, do kterého jste přihlášeni. Jedná za vás, takže vidí jen to, co vidíte vy.
Může Partner používat MCP v prostoru klienta?
Ano. Klient Partnera pozve jako člena a Partner připojí svého agenta přihlášený do toho prostoru. Odebráním člena se zruší i přístup.
Něco nefunguje?
Napište nám e-mail, jakého klienta používáte a jaká chyba se objevila. Odpovíme e-mailem.