Knowi MCP-Server

Verbinden Sie Claude Code, Claude Desktop, Cursor oder einen beliebigen MCP-kompatiblen KI-Client mit Knowi. Fragen Sie Ihre Daten ab, erstellen Sie Dashboards, verwalten Sie Berichte und mehr – in natürlicher Sprache, direkt von Ihrem KI-Assistenten aus.

Der MCP-Server ist in die Knowi-Anwendung integriert. Es ist keine separate Installation erforderlich.

Schnellstart

1. MCP-Token generieren

1. Melden Sie sich bei Knowi an

2. Gehen Sie zu Einstellungen → KI-Einstellungen

3. Wählen Sie unter MCP-Token eine Ablaufzeit und klicken Sie auf Token generieren

4. Kopieren Sie das Token – es wird nur einmal angezeigt

2. Mit Claude Code verbinden

claude mcp add knowi https://your-instance.knowi.com/api/2.0/mcp \
  --transport http \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"

Für knowi.com-Konten:

claude mcp add knowi https://www.knowi.com/api/2.0/mcp \
  --transport http \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"

3. Mit Claude Desktop verbinden

Bearbeiten Sie Ihre Konfigurationsdatei:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "knowi": {
      "type": "streamable-http",
      "url": "https://your-instance.knowi.com/api/2.0/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern neu.

4. Überprüfung

"What Knowi tools are available?"

Sie sollten Tools wie knowi_do, knowi_ask, knowi_search, knowi_list_dashboards und andere sehen.

Related MCP server: AgenticBI

Verfügbare Tools

KI-gestützte Tools

Tools in natürlicher Sprache, die den KI-Orchestrator von Knowi nutzen, um Anweisungen zu interpretieren und Vorgänge zu verketten.

Deterministische Tools

Direkte, schnelle Vorgänge mit vorhersehbarem Verhalten.

Anwendungsbeispiele

"Show me my Knowi dashboards"

"Ask Knowi: what were our top customers by revenue last month?"

"Create a sales dashboard with revenue trends and top products"

"Search Knowi for dashboards related to customer analytics"

"Get the data from the Monthly Revenue widget"

"Export the Executive Summary dashboard to PDF"

"Push these sales records to a Knowi dataset called 'Daily Sales'"

"Set up a daily email report for the executive dashboard"

Token-Verwaltung

Token rotieren:

1. Gehen Sie zu Einstellungen → KI-Einstellungen → MCP-Token

2. Klicken Sie auf Token widerrufen

3. Generieren Sie ein neues und aktualisieren Sie Ihre Konfiguration:

claude mcp remove knowi
claude mcp add knowi https://your-instance.knowi.com/api/2.0/mcp \
  --transport http \
  --header "Authorization: Bearer YOUR_NEW_TOKEN"

Ein Token pro Benutzer. Das Generieren eines neuen Tokens widerruft automatisch das vorherige.

API-Referenz

Der MCP-Server stellt sowohl Streamable HTTP (für MCP-Clients) als auch REST-Endpunkte (für die direkte programmatische Nutzung) bereit.

Gesundheitsprüfung

curl https://your-instance.knowi.com/api/2.0/mcp/health

{
  "status": "healthy",
  "toolCount": 28,
  "tools": ["knowi_do", "knowi_ask", "knowi_search", "..."],
  "activeSessions": 0
}

Tools auflisten

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://your-instance.knowi.com/api/2.0/mcp/tools

Ein Tool aufrufen (REST)

curl -X POST https://your-instance.knowi.com/api/2.0/mcp/tools/call \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "knowi_list_dashboards",
    "arguments": {}
  }'

Streamable HTTP (JSON-RPC)

Alle MCP-Client-Vorgänge verwenden POST /api/2.0/mcp mit Standard-JSON-RPC:

# Initialize
curl -X POST https://your-instance.knowi.com/api/2.0/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

Die Antwort enthält einen Mcp-Session-Id-Header, der bei nachfolgenden Anfragen verwendet werden soll.

Sicherheit

• Bereichsbezogene Anmeldeinformationen: MCP-Token greifen nur auf MCP-Endpunkte zu – sie können nicht gegen die umfassendere Management-API verwendet werden.

• Autorisierung bei jeder Anfrage: Jedes Tool überprüft, ob der authentifizierte Benutzer Zugriff auf die angeforderte Ressource hat, bevor es ausgeführt wird.

• Schutz vor Prompt-Injection: KI-gestützte Tools scannen Anweisungen auf bekannte Injection-Muster und lehnen diese ab, bevor sie das KI-Modell erreichen.

• Schutz vor destruktiven Vorgängen: knowi_do blockiert Lösch-/Drop-/Bereinigungsanweisungen. Löschungen erfordern das explizite knowi_delete-Tool mit einem erforderlichen confirm: true-Parameter.

• Datenkürzung: knowi_get_data und knowi_ask geben standardmäßig maximal 100 Zeilen zurück.

• Sitzungssicherheit: Streamable HTTP-Sitzungen sind an den authentifizierten Benutzer gebunden. Sitzungs-IDs allein gewähren keinen Zugriff.

Datenfluss

Wenn Claude ein Knowi MCP-Tool aufruft, wird die Tool-Antwort (Datenzeilen, Metadaten, Erkenntnisse) an Claude zurückgegeben und auf der Infrastruktur von Anthropic verarbeitet. Dies ist MCP inhärent – der Client muss Ergebnisse erhalten, um darauf reagieren zu können.

Für maximale Datenisolierung verwenden Sie die produktinternen KI-Agenten von Knowi anstelle von MCP.

Fehlerbehebung

Tools erscheinen nicht in Claude:

• Starten Sie Claude Code / Claude Desktop vollständig neu

• Überprüfen Sie, ob der Server erreichbar ist: curl https://your-instance.knowi.com/api/2.0/mcp/health

• Überprüfen Sie, ob das Token gültig ist: curl -H "Authorization: Bearer TOKEN" https://your-instance.knowi.com/api/2.0/mcp/tools

"Failed to connect" in claude mcp list:

• Bestätigen Sie, dass Sie --transport http verwendet haben (erforderlich für Streamable HTTP)

• Entfernen Sie den Server und fügen Sie ihn erneut hinzu, falls der Transport falsch eingestellt war

401-Fehler:

• Das Token ist möglicherweise abgelaufen oder widerrufen. Generieren Sie ein neues Token unter Einstellungen → KI-Einstellungen und aktualisieren Sie Ihre Konfiguration.

Tool-Aufrufe geben Zugriff verweigert zurück:

• Der Benutzer, dessen Token Sie konfiguriert haben, hat keine Berechtigung für die angeforderte Ressource.

• Erstellen Sie für den Produktionseinsatz einen dedizierten Knowi-Benutzer mit den minimal erforderlichen Berechtigungen.

Anforderungen

• Knowi-Konto mit aktivierten KI-Agenten (Einstellungen → KI-Einstellungen)

• Claude Code CLI, Claude Desktop oder ein beliebiger MCP-kompatibler Client

Dokumentation

• MCP-Server-Referenz – vollständige API-Referenz, alle Tool-Schemata, Sicherheitsmodell

• Claude Code Einrichtungsanleitung – Schritt-für-Schritt-Einrichtungsanweisungen

• Knowi-Dokumentation – vollständige Produktdokumentation

Support

• Dokumentation: knowi.com/docs

• Support: support.knowi.com

• Probleme mit diesem Repo: Öffnen Sie ein GitHub-Issue