MCP-Server

Rowvia-Tabellen mit einem KI-Agenten verbinden

Rowvia MCP erlaubt einem autorisierten Chatbot oder Agenten, mit vorhandenen Rowvia-Tabellen zu arbeiten: Tabellen auflisten und finden, Schemata, Prompts und Zusammenfassungen lesen, Zeilen aus URLs, Text oder Inline-Dateien hinzufügen, optional Processing starten, Status prüfen, Zeilen durchsuchen und ausgewählte Zeilen oder Ergebnisse lesen. Standardmäßig fügt es eine Hauptquelle als eine Zeile hinzu; beim Lesen können erweiterte Zeilen auch zugehörige Anhänge enthalten.

App öffnen Agent-Markdown
Erste Automatisierung

Mit einer Tabelle in der App starten, dann MCP verbinden

Profile -> Integrations ist noch keine öffentliche Deep-Link-Route. Öffnen Sie nach der Anmeldung das Profil, gehen Sie zu Integrations und erstellen Sie ein Token für eine konkrete Tabelle oder das Konto.

  1. Erstellen Sie in der App eine Tabelle und wählen Sie eine Vorlage.
  2. Erstellen Sie in Profile -> Integrations ein API-Token mit den benötigten Scopes.
  3. Fügen Sie URL oder Text per MCP-Tool zur bestehenden Tabelle hinzu.
  4. Starten Sie Processing explizit und verfolgen Sie den Zeilenstatus.
  5. Lesen Sie Ergebnisse aus und prüfen Sie Zellen gegen die Quellen.
Setup

Zuerst den Verbindungstyp wählen

ChatGPT Weboberfläche

Verwenden Sie den öffentlichen HTTPS-MCP-Endpunkt https://api.rowvia.ai/mcp und Rowvia OAuth. Kein API-Token erstellen oder kopieren; nach dem Login erhält ChatGPT ein eigenes OAuth-Token für den aktuellen Rowvia-Benutzer.

Lokaler MCP-Client

Verwenden Sie stdio-Konfiguration in Claude Desktop, Cursor, Codex CLI oder einem lokalen Agenten. In diesem Weg gehört das Rowvia API-Token rvia_... in die Env-Konfiguration des Clients.

Auth

OAuth, MCP-Token und REST Bearer-Token

Diese drei Modi nicht vermischen. Der ChatGPT Web Connector nutzt Rowvia OAuth ohne Kopieren eines Tokens. Lokales MCP und REST API nutzen ein rvia_... Token, aber an unterschiedlichen Konfigurationsstellen.

OAuth, MCP-Token und REST Bearer-Token
Modus Wann verwenden Auth Wohin das Token gehört
ChatGPT Web Connector ChatGPT UI Rowvia OAuth Der Benutzer kopiert kein Token
Lokales MCP Claude Desktop, Cursor, Codex CLI rvia_... API-Token Env-Konfiguration des lokalen Clients
REST API Eigenes Backend oder Automatisierung Authorization: Bearer rvia_... Serverseitige Konfiguration oder Secret Manager

Token-Sicherheit

  • Ein rvia_ Token niemals in geteilte Chats, Prompts oder Dokumente einfügen.
  • Das Token gehört nicht in Browser-Frontends, öffentliches JavaScript oder Client-Bundles.
  • Tokens nicht in URLs, Query-Parametern oder importierten Links senden.
  • Für wiederkehrende Workflows ein auf eine Tabelle beschränktes Token bevorzugen.
  • Größere Processing-Läufe erst nach Bestätigung der Zieltabelle und Pending-Work-Schätzung starten.
  • request_id oder processing_run_id loggen, niemals das vollständige Token.
Clients

Wie sich die Autorisierung unterscheidet

ChatGPT verwendet OAuth

ChatGPT Web verbindet sich mit dem öffentlichen /mcp Endpunkt und erhält ein Rowvia OAuth-Token rvoa_... über Login und Consent. Der Benutzer sieht oder kopiert dieses Token nicht und darf kein rvia_... Token in den ChatGPT Connector eintragen.

Lokale Clients verwenden API-Token

Claude Desktop, Cursor, Codex CLI und lokale Agenten starten den Rowvia stdio MCP-Server über einen lokalen Command. Das rvia_... Token gehört in die Env-Konfiguration des lokalen Clients.

ChatGPT

ChatGPT Web Schritt für Schritt

1

Bei Rowvia anmelden

Öffnen Sie zuerst Rowvia.ai und prüfen Sie, dass Sie mit dem richtigen Konto angemeldet sind. Die erste Version verwendet das vorhandene Workbook und die Tabellen des Benutzers.

2

Developer Mode in ChatGPT aktivieren

Öffnen Sie in ChatGPT Settings -> Apps & Connectors -> Advanced settings und aktivieren Sie Developer Mode, falls Ihr Plan oder Workspace dies erlaubt. Ein Firmen- oder Schul-Workspace kann ihn durch Admin-Einstellungen sperren.

3

Connector erstellen

Gehen Sie in ChatGPT zu Settings -> Connectors -> Create. Verwenden Sie https://api.rowvia.ai/mcp als Connector URL. ChatGPT erkennt Rowvia OAuth über Metadaten und registriert seinen Callback automatisch. Lokales stdio JSON und ROWVIA_API_TOKEN werden in diesem Flow nicht verwendet.

4

Rowvia OAuth abschließen

ChatGPT öffnet Rowvia Login und Consent. Prüfen Sie die angemeldete Rowvia E-Mail und die erlaubten Aktionen, dann bestätigen Sie die Verbindung. Rowvia stellt ein OAuth-Token rvoa_... nur für diesen ChatGPT Connector aus.

5

Connector in einem neuen Chat verwenden

Wählen Sie in einem neuen ChatGPT Chat den Rowvia Connector aus dem Tools-Menü. Sicher starten: Tabellen auflisten, Zieltabelle bestätigen und erst dann Dokumente hinzufügen oder Processing starten.

ChatGPT

Werte für das ChatGPT-Formular

Name

Der sichtbare Name im Tools-Menü von ChatGPT.

Beschreibung

Text für das Modell. Er kann genau so kopiert werden.

MCP-Server-URL

Die einzige Produktions-URL, die ChatGPT Web für den Rowvia Connector braucht.

Authentifizierung

In diesem ChatGPT Connector Flow keinen API key, bearer token oder ROWVIA_API_TOKEN verwenden. Das REST API Bearer-Token ist ein separater Modus.

Lokal

Lokaler MCP-Client Schritt für Schritt

1

API-Token erstellen

Öffnen Sie in Rowvia Profil -> Integrationen und erstellen Sie ein rvia_... Token. Für einen normalen Agenten verwenden Sie die Scopes tables:read, rows:read, row:add und row:process. rows:update nur für ausdrückliche Zellkorrekturen hinzufügen.

2

Tabelle nach Möglichkeit begrenzen

Für wiederkehrende Workflows ist ein Token mit Beschränkung auf eine Tabelle zu bevorzugen. Der Agent arbeitet dann nur mit der vom Benutzer zugewiesenen Tabelle.

3

Stdio-Client konfigurieren

Command und die Env-Variablen ROWVIA_API_BASE_URL sowie ROWVIA_API_TOKEN in den lokalen MCP-Client eintragen. Das Token gehört in die Env-Konfiguration, nie in einen Prompt oder geteilten Chat.

Konfiguration nur für lokale MCP-Clients

Dieses stdio JSON nicht für ChatGPT Web verwenden. Es gilt für lokale MCP-Clients und lokale Agenten. Der folgende Command gilt für Entwicklung im Rowvia-Monorepo; für externe Installation verwenden Sie den Command aus den Integrationseinstellungen. Optionale Zellupdates bleiben deaktiviert, bis ROWVIA_MCP_ENABLE_ROW_UPDATE=true gesetzt ist.

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

So sollte der Agent arbeiten

1

Vorhandene Tabelle finden

Beginnen Sie mit rowvia_table_list oder rowvia_table_find. Wenn der Benutzer keinen genauen Tabellennamen nennt, lassen Sie die Zieltabelle bestätigen.

2

Schema und Prompts lesen

Verwenden Sie rowvia_table_get_schema oder die Resource rowvia://tables/{table_id}/schema. Für Automatisierung table_id und row_id verwenden; row_index ist nur eine Anzeige-Position.

3

Zeilen hinzufügen

rowvia_row_add fügt URL-, Text- und kleine Inline-Quellenzeilen zu einer vorhandenen Tabelle hinzu. Jedes Element erstellt standardmäßig eine neue Zeile mit Hauptquelle; beim Lesen kann include_document das primäre document und documents[] mit zugehörigen Anhängen zurückgeben. Für mehrere Dokumente in einer logischen Zeile verwenden Sie rowvia_row_create_source_group; vorhandene Anhänge verwalten Sie mit rowvia_row_get_sources, rowvia_row_add_source und rowvia_row_remove_source. Für öffentliche oder temporär geteilte Dokumente source=url bevorzugen; Rowvia lädt unterstützte Dokumente serverseitig herunter. HTML-URLs werden als Markdown-Snapshots gespeichert.

4

Processing ausdrücklich starten

rowvia_row_add hat process_after_add standardmäßig auf false. Vor größeren Läufen rowvia_table_get_pending_work aufrufen und Processing über rowvia_table_start_processing starten.

5

Status verfolgen und Ergebnisse lesen

Die zurückgegebene processing_run_id mit rowvia_processing_get_status verfolgen. Ergebnisse über rowvia_row_get_results oder rowvia_row_get mit Spaltenprojektion lesen.

MCP

Verfügbare Tools

Tabellen und Schema

  • rowvia_table_list
  • rowvia_table_find
  • rowvia_table_get_schema
  • rowvia_table_get_summary
  • rowvia_table_get_pending_work

Zeilen und Dokumente

  • 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

Optionale Korrektur

  • rowvia_row_update
Kontext

Resources

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

Sicherheitsregeln für Chatbots

  • Das vollständige Token niemals in Chats oder Logs einfügen.
  • rvia_ Tokens nicht in öffentlichem Frontend-Code offenlegen.
  • Vollständige ChatGPT download_url Werte nicht loggen und Rowvia-Token niemals an importierte URLs senden.
  • Für lokale Automatisierungen tabellenbeschränkte Tokens bevorzugen; für ChatGPT Web gilt der OAuth Consent.
  • Zeilen nur über begrenzte Fenster lesen, nicht die ganze Tabelle ausgeben.
  • Größere Processing-Läufe nicht ohne ausdrückliche Bestätigung und Pending-Work-Schätzung starten.
  • Eine leere Output-Zelle ist verarbeitbar; eine nicht leere Output-Zelle wird gemäß den normalen Rowvia-Regeln übersprungen.
  • Nicht annehmen, dass eine Zeile immer nur eine Datei hat. Beim Lesen über include_document ist documents[] das gesamte Source-Set; document ist nur die legacy Primary-Quelle.
  • Die MCP-Tools löschen keine Zeilen oder Tabellen, erstellen keine Tabellen, ändern keine Schemata, bearbeiten keine Prompts und ändern keine Billing-/Admin-Einstellungen.
  • Optionales rowvia_row_update ist standardmäßig deaktiviert und erfordert ROWVIA_MCP_ENABLE_ROW_UPDATE=true sowie ein Token mit rows:update.

Brauchen Sie eine eigene Integration?

MCP ist der Weg für Agenten. Für Backends und Skripte nutzen Sie die REST API mit Bearer-Token.

API-Konsole öffnenIntegrationen