MCP server

Připoj 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, inline souborů nebo ChatGPT příloh, volitelně spustit processing, sledovat stav, vyhledávat řádky a přečíst vybrané výsledky.

Otevřít aplikaci Markdown pro agenty
Setup

Rychlé nastavení

1. Vytvoř token

V Rowvia.ai otevři Profil -> Integrace. Pro běžného agenta použij scopes tables:read, rows:read, row:add a row:process. rows:update přidej jen pro výslovné korekce buněk.

2. Omez tabulku, pokud to jde

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

3. Nastav klienta

Lokální MCP klient potřebuje stdio server a env proměnné ROWVIA_API_BASE_URL a ROWVIA_API_TOKEN. ChatGPT potřebuje HTTPS MCP endpoint, ne lokální stdio JSON.

Konfigurace MCP klienta

Níže uvedený command odpovídá lokálnímu vývoji v Rowvia monorepu. Pro externí instalaci použij command publikovaný v integračním nastavení. Volitelný update buněk je vypnutý, dokud není nastaveno ROWVIA_MCP_ENABLE_ROW_UPDATE=true.

{
  "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čni přes rowvia_table_list nebo rowvia_table_find. Pokud uživatel neurčí přesný název, nech si cílovou tabulku potvrdit.

2

Přečíst schema a prompty

Použij rowvia_table_get_schema nebo resource rowvia://tables/{table_id}/schema. Pro automatizaci používej 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 dokumentové řádky do existující tabulky. Pro veřejné nebo dočasně sdílené dokumenty preferuj source=url; Rowvia stáhne PDF, DOCX, TXT, MD nebo HTML server-side. HTML URL se uloží jako Markdown snapshot. Pro dokument přiložený v ChatGPT použij rowvia_row_add_chatgpt_document s top-level objektem file obsahujícím HTTPS download_url, file_id, mime_type a file_name.

4

Processing spouštět výslovně

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

5

Sledovat stav a číst výsledky

Uložené processing_run_id kontroluj přes rowvia_processing_get_status. Výsledky čti 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_chatgpt_document
  • rowvia_row_add
  • 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
Context

Resources

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

Bezpečnostní pravidla pro chatbota

  • Neposílej plný token do chatu ani do logů.
  • Neloguj celé ChatGPT download_url a nikdy neposílej Rowvia tokeny na importované URL.
  • Preferuj token omezený na konkrétní tabulku.
  • Čti řádky po omezených oknech, ne celou tabulku najednou.
  • Nespouštěj 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.
  • 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.