MCP server

Připojte Rowvia tabulky k AI agentovi

Rowvia MCP dovolí autorizovanému chatbotovi nebo agentovi pracovat s existujícími tabulkami: vypsat a najít tabulky, načíst schema, prompty a souhrny, přidat řádky z URL, textu nebo inline souborů, volitelně spustit processing, sledovat stav, vyhledávat řádky a přečíst vybrané výsledky. Standardně přidává jeden hlavní zdroj jako jeden řádek; při čtení mohou rozšířené řádky obsahovat i související přílohy.

Otevřít aplikaci Markdown pro agenty
První automatizace

Začněte tabulkou v aplikaci, potom připojte MCP

Přímý deep-link do Profile -> Integrations zatím není veřejná route. Po přihlášení otevřete profil, přejděte na Integrations a vytvořte token až pro konkrétní tabulku nebo účet.

  1. V aplikaci vytvořte tabulku a vyberte šablonu.
  2. V Profile -> Integrations vytvořte API token s potřebnými scopes.
  3. Přidejte URL nebo text přes MCP nástroj do existující tabulky.
  4. Spusťte processing výslovně a sledujte stav řádků.
  5. Přečtěte výsledky a zkontrolujte buňky proti zdrojům.
Setup

Nejdřív vyberte způsob připojení

ChatGPT webové rozhraní

Použijte veřejný HTTPS MCP endpoint https://api.rowvia.ai/mcp a Rowvia OAuth. Nevytvářejte ani nekopírujte API token; ChatGPT po přihlášení dostane vlastní OAuth token pro aktuálního Rowvia uživatele.

Lokální MCP klient

Použijte stdio konfiguraci v Claude Desktop, Cursoru, Codex CLI nebo lokálním agentovi. Sem patří Rowvia API token rvia_... do env konfigurace klienta.

Auth

OAuth, MCP token a REST Bearer token

Tyto tři režimy nemíchejte. ChatGPT web connector používá Rowvia OAuth bez kopírování tokenu. Lokální MCP a REST API používají rvia_... token, ale na jiném místě konfigurace.

OAuth, MCP token a REST Bearer token
Režim Kdy použít Auth Kam patří token
ChatGPT web connector ChatGPT UI Rowvia OAuth Uživatel token nekopíruje
Lokální MCP Claude Desktop, Cursor, Codex CLI rvia_... API token Env konfigurace lokálního klienta
REST API Vlastní backend nebo automatizace Authorization: Bearer rvia_... Server-side konfigurace nebo secret manager

Bezpečnost tokenů

  • Nikdy nevkládejte rvia_ token do sdíleného chatu, promptu ani dokumentu.
  • Token nepatří do browser frontendu, veřejného JavaScriptu ani klientského balíčku.
  • Token neposílejte v URL, query parametrech ani importovaných odkazech.
  • Pro opakované workflow preferujte token omezený na konkrétní tabulku.
  • Větší processing spouštějte až po potvrzení cílové tabulky a odhadu pending práce.
  • Do logů ukládejte request_id nebo processing_run_id, nikdy celý token.
Klienti

Jak se liší autorizace

ChatGPT používá OAuth

ChatGPT web se připojuje na veřejný /mcp endpoint a získá Rowvia OAuth token rvoa_... přes přihlášení a consent. Uživatel token nevidí, nekopíruje ho a nesmí zadávat rvia_... token do ChatGPT connectoru.

Lokální klient používá API token

Claude Desktop, Cursor, Codex CLI a lokální agenti spouští Rowvia stdio MCP server lokálním commandem. Token rvia_... patří do env konfigurace lokálního klienta.

ChatGPT

ChatGPT web krok za krokem

1

Přihlaste se do Rowvia

Nejdřív otevřete Rowvia.ai a ověřte, že jste přihlášení pod správným účtem. První verze používá uživatelův existující workbook a tabulky.

2

Zapněte Developer Mode v ChatGPT

V ChatGPT otevřete Settings -> Apps & Connectors -> Advanced settings a zapněte Developer Mode, pokud ho váš plán nebo workspace povoluje. Ve firemním nebo školním workspace ho může blokovat admin.

3

Vytvořte connector

V ChatGPT přejděte do Settings -> Connectors -> Create. Jako connector URL zadejte https://api.rowvia.ai/mcp. ChatGPT si z Rowvia metadat zjistí OAuth a automaticky zaregistruje svůj callback. Lokální stdio JSON ani ROWVIA_API_TOKEN se v tomto flow nepoužívají.

4

Dokončete Rowvia OAuth

ChatGPT otevře Rowvia přihlášení a consent. Zkontrolujte přihlášený Rowvia email a povolené akce, potom připojení potvrďte. Rowvia vydá OAuth token rvoa_... jen pro tento ChatGPT connector.

5

Použijte connector v novém chatu

V novém ChatGPT chatu vyberte Rowvia connector z nabídky nástrojů. Začněte bezpečně: nechte si vypsat tabulky, potvrďte cílovou tabulku a teprve potom přidávejte dokumenty nebo spouštějte processing.

ChatGPT

Hodnoty do ChatGPT formuláře

Název

Uživatelský název, který se bude zobrazovat v ChatGPT nabídce nástrojů.

Popis

Text pro model. Může být zkopírovaný přesně takto.

URL serveru MCP

Jediná produkční URL, kterou ChatGPT web pro Rowvia connector potřebuje.

Ověření

V tomto ChatGPT connector flow nepoužívejte API key, bearer token ani ROWVIA_API_TOKEN. REST API Bearer token je samostatný režim.

Lokálně

Lokální MCP klient krok za krokem

1

Vytvořte API token

V Rowvia otevřete Profil -> Integrace a vytvořte token rvia_.... Pro běžného agenta použijte scopes tables:read, rows:read, row:add a row:process. rows:update přidejte jen pro výslovné korekce buněk.

2

Omezte tabulku, pokud to jde

Pro opakované workflow preferujte token omezený na jednu tabulku. Agent pak pracuje jen s tabulkou, kterou mu uživatel svěřil.

3

Nastav stdio klienta

Do lokálního MCP klienta vložte command a env proměnné ROWVIA_API_BASE_URL a ROWVIA_API_TOKEN. Token patří do env konfigurace, nikdy do promptu ani do sdíleného chatu.

Konfigurace jen pro lokální MCP klienty

Tento stdio JSON nepoužívejte pro ChatGPT web. Platí pro lokální MCP klienty a lokální agenty. Níže uvedený command odpovídá vývoji v Rowvia monorepu; pro externí instalaci použijte command publikovaný v integračním nastavení. Volitelný update buněk je vypnutý, dokud není nastaveno ROWVIA_MCP_ENABLE_ROW_UPDATE=true.

API base URL

  • Production: https://api.rowvia.ai
{
  "mcpServers": {
    "rowvia": {
      "command": "npx",
      "args": ["--workspace", "@rowvia/mcp", "rowvia-mcp"],
      "env": {
        "ROWVIA_API_BASE_URL": "https://api.rowvia.ai",
        "ROWVIA_API_TOKEN": "rvia_...",
        "ROWVIA_MCP_ENABLE_ROW_UPDATE": "false"
      }
    }
  }
}
Workflow

Jak má agent pracovat

1

Najít existující tabulku

Začněte přes rowvia_table_list nebo rowvia_table_find. Pokud uživatel neurčí přesný název, nechte si cílovou tabulku potvrdit.

2

Přečíst schema a prompty

Použijte rowvia_table_get_schema nebo resource rowvia://tables/{table_id}/schema. Pro automatizaci používejte table_id a row_id; row_index je jen zobrazovací pozice.

3

Přidat řádky

rowvia_row_add přidá URL, textové a malé inline zdrojové řádky do existující tabulky. Každá položka standardně vytvoří nový řádek s hlavním zdrojem; při čtení může include_document vrátit primary document i documents[] se souvisejícími přílohami. Pro více dokumentů v jednom logickém řádku použijte rowvia_row_create_source_group; existující přílohy spravujte přes rowvia_row_get_sources, rowvia_row_add_source a rowvia_row_remove_source. Pro veřejné nebo dočasně sdílené dokumenty preferujte source=url; Rowvia stáhne podporovaný dokument server-side. HTML URL se uloží jako Markdown snapshot.

4

Processing spouštět výslovně

rowvia_row_add má process_after_add defaultně false. Před větším během zavolejte rowvia_table_get_pending_work a processing spusťte přes rowvia_table_start_processing.

5

Sledovat stav a číst výsledky

Uložené processing_run_id kontrolujte přes rowvia_processing_get_status. Výsledky čtěte přes rowvia_row_get_results nebo rowvia_row_get s projekcí sloupců.

MCP

Dostupné nástroje

Tabulky a schema

  • rowvia_table_list
  • rowvia_table_find
  • rowvia_table_get_schema
  • rowvia_table_get_summary
  • rowvia_table_get_pending_work

Řádky a dokumenty

  • rowvia_row_add
  • rowvia_row_create_source_group
  • rowvia_row_get_sources
  • rowvia_row_add_source
  • rowvia_row_remove_source
  • rowvia_row_list
  • rowvia_row_search
  • rowvia_row_get
  • rowvia_row_get_results

Processing

  • rowvia_table_start_processing
  • rowvia_processing_get_status

Volitelná korekce

  • rowvia_row_update
Kontext

Resources

  • rowvia://tables
  • rowvia://tables/{table_id}/schema
  • rowvia://tables/{table_id}/rows?offset=0&limit=20

Bezpečnostní pravidla pro chatbota

  • Neposílejte plný token do chatu ani do logů.
  • Nevkládejte rvia_ token do veřejného frontend kódu.
  • Nelogujte celé ChatGPT download_url a nikdy neposílejte Rowvia tokeny na importované URL.
  • U lokálních automatizací preferujte token omezený na konkrétní tabulku; u ChatGPT webu se řiďte OAuth consentem.
  • Čtěte řádky po omezených oknech, ne celou tabulku najednou.
  • Nespouštějte větší processing bez výslovného potvrzení a pending-work odhadu.
  • Prázdná output buňka je processable; neprázdná output buňka se přeskakuje podle běžných pravidel Rowvia.
  • Nepředpokládejte, že řádek má vždy jen jeden soubor. Když čtete dokumenty přes include_document, použijte documents[] jako celý source set a document jen jako legacy primary zdroj.
  • MCP nástroje nemažou řádky ani tabulky, nevytváří tabulky, nemění schema, neupravují prompty a nemění billing nebo admin nastavení.
  • Volitelný rowvia_row_update je vypnutý defaultně a vyžaduje ROWVIA_MCP_ENABLE_ROW_UPDATE=true i token se scope rows:update.

Potřebujete vlastní integraci?

MCP je cesta pro agenty. Pro backendy a skripty použijte REST API s Bearer tokenem.

Otevřít API konzoliIntegrace