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, Inline-Dateien oder ChatGPT-Anhängen hinzufügen, optional Processing starten, Status prüfen, Zeilen durchsuchen und ausgewählte Zeilen oder Ergebnisse lesen.

App öffnen Agent-Markdown
Setup

Schnelle Einrichtung

1. Token erstellen

Öffnen Sie in Rowvia.ai Profil -> Integrationen. 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. Client konfigurieren

Ein lokaler MCP-Client benötigt den stdio-Server sowie die Umgebungsvariablen ROWVIA_API_BASE_URL und ROWVIA_API_TOKEN. ChatGPT benötigt einen HTTPS-MCP-Endpunkt, kein lokales stdio-JSON.

MCP-Client-Konfiguration

Der folgende Command gilt für lokale 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.

{
  "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-Dokumentzeilen zu einer vorhandenen Tabelle hinzu. Für öffentliche oder temporär geteilte Dokumente source=url bevorzugen; Rowvia lädt PDF, DOCX, TXT, MD oder HTML serverseitig herunter. HTML-URLs werden als Markdown-Snapshots gespeichert. Für ein in ChatGPT angehängtes Dokument rowvia_row_add_chatgpt_document mit einem Top-level-Objekt file verwenden, das HTTPS download_url, file_id, mime_type und file_name enthält.

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_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

Optionale Korrektur

  • rowvia_row_update
Context

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.
  • Vollständige ChatGPT download_url Werte nicht loggen und Rowvia-Token niemals an importierte URLs senden.
  • Für Automatisierungen tabellenbeschränkte Token bevorzugen.
  • 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.
  • 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.