REST API + MCP Server

Mit Video Intelligence entwickeln

Zwei Integrationswege: eine vollständige REST API für eigene Anwendungen und ein MCP-Server, damit KI-Assistenten nativ mit Ihren Videos arbeiten können.

REST API

Volle programmatische Kontrolle

Eine umfassende RESTful API für den gesamten Video-Lebenszyklus — von Upload und Kodierung über KI-Analyse, Transkription, Suche bis hin zur Teamverwaltung.

Upload & Import

Videos von YouTube importieren oder direkt über vorsignierte S3-URLs hochladen. Die Kodierung erfolgt automatisch im Hintergrund.

KI-Analyse

Videos für KI-gestützte Analyse einreichen — Kapitel generieren, Szenen erkennen, Entitäten extrahieren und detaillierte Zusammenfassungen erstellen.

Transkription

Audio mit Whisper transkribieren und in über 100 Sprachen übersetzen. Vollständige mehrsprachige Untertitelunterstützung ab Werk.

Suche & Chat

Hybride semantische + Keyword-Suche über Ihre Bibliothek. RAG-basierten KI-Chat für einzelne Videos oder die gesamte Sammlung aktivieren.

Embeddings

Vektor-Embeddings aus Analyse- und Transkriptionsdaten generieren, um semantische Suche und RAG-basierten KI-Chat zu ermöglichen.

Organisationen

Teams mit rollenbasiertem Zugriff, Datenisolierung zwischen Gruppen und Einladungsworkflows verwalten — alles per API.

bash
curl -X POST "https://www.coniviso.com/api/v1/videos/{id}/analyze" \
  -H "Authorization: Bearer vi_live_..." \
  -H "Content-Type: application/json" \
  -d '{"analysisType": "comprehensive"}'
MCP-Server

Ihre Videos in jedem KI-Assistenten

Coniviso stellt einen Model Context Protocol (MCP) Server bereit, damit KI-Assistenten wie Claude, Cursor und eigene Agenten auf Ihre Videobibliothek zugreifen, Inhalte durchsuchen, Transkriptionen lesen und Analysen auslösen können — alles über die standardisierte MCP-Schnittstelle.

Was ist MCP?

Das Model Context Protocol ist ein offener Standard, der es KI-Modellen ermöglicht, sicher mit externen Werkzeugen und Datenquellen zu interagieren. Statt eigener Integrationen kann jeder MCP-kompatible KI-Client sich mit Coniviso verbinden und Ihre Videos sofort als Kontext nutzen.

21 verfügbare Tools

Jedes Tool ist auf die Berechtigungen Ihres API-Schlüssels beschränkt. Ihr KI-Assistent kann Videos auflisten, suchen, aktualisieren und löschen, Organisationen, Gruppen, Berechtigungen und Sichtbarkeit verwalten, Analysen und Transkriptionen abrufen, mit einzelnen Videos oder Ihrer gesamten Bibliothek chatten, Embeddings generieren und neue Analyseaufträge einreichen — alles ohne das Gespräch zu verlassen.

  • list_videosIhre Videobibliothek mit Paginierung und Statusfiltern durchsuchen
  • get_videoVollständige Metadaten, Verarbeitungsstatus und Konfiguration eines Videos abrufen
  • search_videosHybride semantische + Keyword-Suche über alle zugänglichen Videos
  • chat_with_libraryFragen Sie Ihre gesamte Videosammlung mit RAG
  • chat_with_videoQ&A zu einem bestimmten Video mit Multi-Turn-Konversationsunterstützung
  • get_analysisKI-Analyseergebnisse abrufen: Zusammenfassungen, Kapitel, Szenen, Entitäten
  • get_transcriptionTranskriptionsdaten abrufen, optional nach Sprache gefiltert
  • analyze_videoVideo für KI-Analyse einreichen (umfassend, Szenen, Objekte oder Text)
  • generate_embeddingsVektor-Embeddings aus Analyse- und Transkriptionsdaten für semantische Suche erstellen
  • update_videoTitel, Beschreibung, Sichtbarkeit oder Organisation eines Videos aktualisieren
  • delete_videoEin Video und alle zugehörigen Daten dauerhaft löschen
  • get_permissionsAlle erteilten Zugriffsberechtigungen eines Videos anzeigen
  • grant_permissionEinem Benutzer, einer Gruppe oder Organisation Zugriff auf ein Video gewähren
  • revoke_permissionEine zuvor erteilte Zugriffsberechtigung von einem Video entfernen
  • list_organizationsGibt eine Liste der Organisationen zurück, denen Sie angehören
  • get_organizationGibt Details zu einer bestimmten Organisation zurück
  • list_org_membersGibt alle Mitglieder einer Organisation zurück
  • invite_org_memberLädt ein Mitglied in eine Organisation ein
  • remove_org_memberEntfernt ein Mitglied aus einer Organisation
  • list_org_groupsListet alle Gruppen innerhalb einer Organisation auf
  • list_group_membersListet alle Mitglieder einer bestimmten Gruppe innerhalb einer Organisation auf

8 Ressourcen

MCP-Ressourcen geben KI-Assistenten direkten Zugriff auf Ihre Videodaten als strukturierten Kontext:

  • coniviso://videosVollständige Liste aller zugänglichen Videos mit Metadaten
  • coniviso://video/:idVollständige Videodetails inklusive Analyse und Transkription
  • coniviso://video/:id/transcriptionVollständige Transkriptionsdaten für ein bestimmtes Video
  • coniviso://video/:id/analysisKI-Analyseergebnisse: Zusammenfassung, Kapitel, Szenen, Entitäten
  • coniviso://video/:id/permissionsZugriffssteuerungsliste mit erteilten Berechtigungen
  • coniviso://organizationsListe aller Organisationen, denen Sie angehören
  • coniviso://organization/:idOrganisationsdetails und Liste ihrer Mitglieder
  • coniviso://organization/:id/groupsListe aller Gruppen innerhalb einer Organisation

In 30 Sekunden verbinden

Fügen Sie Coniviso mit einem einzigen Konfigurationsblock zu jedem MCP-Client hinzu. Verwenden Sie Ihren vorhandenen API-Schlüssel zur Authentifizierung.

Endpunkthttps://www.coniviso.com/mcp
AuthentifizierungBearer vi_live_...
TransportStreamable HTTP (JSON-RPC über HTTP)

Jede Sitzung erhält eine eigene isolierte Serverinstanz. Sitzungen werden über den mcp-session-id Header identifiziert.

mcp config
{
  "mcpServers": {
    "coniviso": {
      "url": "https://www.coniviso.com/mcp",
      "headers": {
        "Authorization": "Bearer vi_live_..."
      }
    }
  }
}
Erste Schritte

In wenigen Minuten einsatzbereit

1. API-Schlüssel erstellen

Gehen Sie zu Einstellungen → API-Schlüssel in Ihrem Coniviso-Dashboard. API-Schlüssel folgen dem vi_live_* Format und können mit granularen Berechtigungen versehen werden.

2. Anfragen authentifizieren

Fügen Sie Ihren API-Schlüssel als Bearer-Token im Authorization-Header ein. Funktioniert sowohl für REST-API-Aufrufe als auch für MCP-Verbindungen.

3. Loslegen

Nutzen Sie die REST API aus jeder Sprache oder verbinden Sie den MCP-Server mit Ihrem KI-Assistenten. Beide verwenden denselben API-Schlüssel und dieselben Berechtigungen.

Verfügbare Berechtigungen

  • videos:readVideometadaten auflisten und lesen
  • videos:writeVideos hochladen, aktualisieren und löschen
  • analysisKI-Analyseergebnisse einreichen und lesen
  • searchVideoinhalte durchsuchen
  • chatKI-Chat-Funktionen nutzen (pro Video und bibliotheksweit)
  • embeddingsVektor-Embeddings generieren und verwalten

Bereit zur Integration?

Starten Sie mit der Coniviso API und dem MCP-Server. Der kostenlose Tarif umfasst 60 Minuten KI-Verarbeitung.