Deine Dateien. Deine Tools. Verbunden mit MCP.
Bitte deinen Assistenten, ein Bild zu konvertieren, ein Video zu schneiden oder eine PDF zu bearbeiten. Das Model Context Protocol (MCP) verbindet ihn mit den Canbari-Tools und reicht Ergebnisse direkt an den nächsten Schritt weiter.
https://canbari.com/mcpTrage diese URL in deinem MCP-Client ein. Sie ist die Serveradresse; hier liest du die Anleitung zur Einrichtung.
Assistenten verbindenVerbinde deinen Assistenten
Wähle den Client, den du bereits nutzt. Canbari läuft auf dem Server; du musst kein Canbari-Paket und keinen lokalen Server installieren.
Codex
Wenn die Codex CLI bereits installiert ist, führe diese Befehle in PowerShell unter Windows oder im Terminal unter macOS oder Linux aus. Sie fügen Canbari hinzu, zeigen die eingerichteten Server und starten Codex.
codex mcp add canbari --url https://canbari.com/mcp
codex mcp list
codexStarte nach dem Hinzufügen eine neue Codex-Sitzung. Mit /mcp prüfst du in Codex die Verbindung. Du brauchst keinen Canbari-Server auf deinem Computer zu installieren.
Konfiguration lieber direkt bearbeiten?
Alternativ zum Hinzufügen per Befehl kannst du diesen Abschnitt in ~/.codex/config.toml eintragen (Windows: %USERPROFILE%\.codex\config.toml).
[mcp_servers.canbari]
url = "https://canbari.com/mcp"
tool_timeout_sec = 120Claude Code
Wenn Claude Code installiert ist, führe diese Befehle aus. Der User-Scope macht Canbari in deinen Projekten verfügbar.
claude mcp add --transport http --scope user canbari https://canbari.com/mcp
claude mcp list
claudeStarte eine neue Claude-Code-Sitzung und prüfe Canbari mit /mcp. Den Gast-Workflow unten kannst du direkt ausprobieren. Für Kontozugriff findest du die Anmeldebefehle im Abschnitt zum Zugang.
Offizielle Claude-Code-MCP-DokumentationAllgemeine Einrichtung
- Öffne die MCP-/Server-Einstellungen deines Clients und füge einen Remote-Server mit dem Namen Canbari hinzu.
- Wähle Streamable HTTP und trage die MCP-Server-URL von oben ein. Für den Gastzugang brauchst du keinen lokalen Startbefehl, kein npm-Paket und keinen API-Key.
- Wähle für den Gastmodus keine Authentifizierung oder für dein Canbari-Konto OAuth, sofern dein Client dies unterstützt. Bestätige die Kontoverbindung bei Aufforderung im Browser.
- Speichere und aktiviere den Server. Lade die Tools neu oder starte eine neue Sitzung. Bitte deinen Assistenten, die Canbari-Tools aufzulisten, und probiere dann den Beispiel-Workflow unten aus.
Für den Gastmodus brauchst du einen Client, der Tools ohne OAuth unterstützt. Für den Kontozugriff muss er OAuth unterstützen. Zum Hochladen lokaler Dateien muss der Assistent außerdem HTTP-PUT-Anfragen senden können; ein Chat-Anhang allein lädt noch keine Datei zu Canbari hoch. Mit einer Kontoverbindung kannst du Dateien auch vorher auf der Website hochladen.
Probiere deinen ersten Workflow aus
Gib deinem Assistenten diesen Auftrag und ersetze den Beispielpfad durch eine Datei, auf die er zugreifen kann. Die einzelnen Tool-Aufrufe kann er für dich übernehmen.
Nutze Canbari MCP als Gast. Starte eine Gast-Sitzung, lade C:\Users\DeinName\Pictures\foto.png hoch, drehe das Bild um 90 Grad, konvertiere das Ergebnis nach WebP und speichere es neben dem Original. Verwende die zurückgegebenen Datei-IDs zwischen den Tools, beachte poll_after_ms bei Statusabfragen und beende die Gast-Sitzung nach dem Download des Ergebnisses.Unter macOS oder Linux passt zum Beispiel /Users/deinname/Pictures/foto.png oder /home/deinname/Pictures/foto.png. Erlaube dem Client bei Bedarf, diese Datei zu lesen und das Ergebnis zu speichern.
Wähle deinen Zugang
Privater Gast-Workspace
Starte ohne Canbari-Anmeldung. Dein Assistent ruft start_guest_session auf und übergibt den zurückgegebenen guest_token bei weiteren Tool-Aufrufen. Der private Workspace gilt sechs Stunden. Lokale Serververarbeitung und die direkte Gemini-Verarbeitung sind innerhalb der bestehenden Limits verfügbar. Dateien aus deinem Website-Konto gehören nicht zu diesem Workspace.
Verbundenes Konto
Verbinde dein Canbari-Konto, um deine eigenen Website-Uploads und Ergebnisse über mehrere Tools hinweg zu nutzen. GLM/Z.ai, OpenRouter, OpenAI API und andere kostenpflichtige Anbieter benötigen diese Verbindung. Die Berechtigungen, Credits und Kontingente deines Kontos gelten weiterhin.
Nutze den Befehl für deinen Client, melde dich im Browser bei Canbari an und bestätige die Verbindung. Starte anschließend eine neue Client-Sitzung. In Claude Code kannst du die Anmeldung auch über /mcp verwalten.
codex mcp login canbariclaude mcp login canbariZurück zum Gastmodus
Nutze den Befehl für deinen Client und starte eine neue Sitzung, um zum Gastmodus zurückzukehren. Eine aktive Kontoverbindung hat Vorrang vor einem Gast-Token.
codex mcp logout canbariclaude mcp logout canbariHalte Gast-Tokens und Übertragungs-URLs privat. Normale Uploads bleiben privat; share_files erstellt ausdrücklich öffentliche Links, die 90 Tage bestehen bleiben. Beauftrage das Teilen nur, wenn du einen öffentlichen Link möchtest.
Ein Upload. Mehrere Tools.
Innerhalb desselben Gast-Workspaces oder verbundenen Kontos nutzen die Tools dieselben Dateien. Übergib die Datei-ID eines Ergebnisses an das nächste Tool und bearbeite es direkt weiter, ohne es erneut herunter- und hochzuladen.
Datei hochladen
create_upload erhält tool_id, filename und size_bytes. Sende die unveränderten Datei-Bytes per HTTP PUT an die upload_url und gib Content-Length an. Verwende anschließend die file_id aus der Upload-Antwort. Die Upload-URL ist fünf Minuten gültig.
Tool ausführen
Lies das Eingabeschema des Tools, übergib die Datei-IDs in file_ids und setze die gewünschten Einstellungen. Verwende pro Vorgang einen neuen idempotency_key mit 16–128 Buchstaben, Ziffern, Unterstrichen oder Bindestrichen. Wiederhole eine unterbrochene Netzwerkanfrage mit demselben Schlüssel und identischen Eingaben.
Ergebnis abwarten und weiterbearbeiten
Das Tool liefert eine job_id. Frage den Status mit get_job ab und warte vor der nächsten Abfrage die zurückgegebenen poll_after_ms ab, normalerweise drei Sekunden. Nach Abschluss kannst du die Ergebnis-IDs an ein weiteres Tool übergeben oder list_files nach job_id filtern.
Ergebnis herunterladen
Hole mit get_file eine Download-URL und speichere die Datei innerhalb von fünf Minuten. Fordere bei Ablauf eine neue URL an. Lade Gastergebnisse vor Ablauf des sechsstündigen Workspaces herunter und widerrufe danach mit end_guest_session den Zugang sowie noch offene Übertragungslinks.
Tools & Hilfsfunktionen
Der MCP stellt die Bild-, GIF-, Video-, Audio- und PDF-Tools der Website bereit, außerdem Workflows für Memes, Hintergründe, Teilen, Reddit und Instagram. Die aktuellen Tool-Namen, Einstellungen und Eingabelimits ruft dein Client über tools/list ab.
Alle Canbari-Tools ansehen| Hilfsfunktion | Aufgabe |
|---|---|
start_guest_session | Privaten Gast-Workspace erstellen und dessen Token erhalten. |
end_guest_session | Gast-Workspace und seine Übertragungslinks widerrufen. |
create_upload | Kurzzeitig gültige URL zum Hochladen der Datei-Bytes erstellen. |
list_files | Uploads und Ergebnisse finden; mit next_offset die Liste fortsetzen. |
get_file | Dateidetails lesen und eine Download-URL anfordern. |
get_job | Verarbeitungsstatus prüfen und Ergebnis-Datei-IDs abrufen. |
inspect_pdf | PDF-Berechtigungen oder Formularfelder prüfen, einschließlich schema_hash zum Ausfüllen eines Formulars. |
Fragen & Fehlerbehebung
Wie viele Jobs kann ich starten?
Über MCP sind 10 neue Verarbeitungsjobs innerhalb einer rollierenden Stunde erlaubt, pro IP-Adresse und zusätzlich pro Gast-Workspace oder verbundenem Konto. Drehen und anschließendes Konvertieren zählen als zwei Jobs. Uploads, Statusabfragen und Downloads verbrauchen dieses Job-Kontingent nicht. Identische Wiederholungen verwenden den ursprünglichen Auftrag. Neue Sitzungen oder erneute Kontoverbindungen setzen das Limit nicht zurück; IPv6-Adressen desselben /64-Netzes teilen sich ein Kontingent. Bei JOB_RATE_LIMITED wartest du die angegebenen retry_after_seconds ab, bevor du einen weiteren Job startest.
Warum verlangt ein Tool eine Anmeldung?
OAUTH_REQUIRED bedeutet, dass der ausgewählte Anbieter eine Kontoverbindung benötigt. Verbinde dich mit codex mcp login canbari oder wähle lokale Verarbeitung beziehungsweise direktes Gemini, sofern das Tool dies anbietet. Die Anmeldung hebt Kontoberechtigungen und Credit-Limits nicht auf.
Warum sieht mein Assistent meinen Website-Upload nicht?
Gast-Workspaces sind von Website-Konten getrennt. Verbinde dasselbe Canbari-Konto, mit dem du die Datei hochgeladen hast, und rufe list_files auf. Für die Gastverarbeitung lädst du die Datei mit create_upload und HTTP PUT in den jeweiligen Gast-Workspace hoch.
Was passiert, wenn eine Sitzung oder ein Download-Link abläuft?
Fordere für einen abgelaufenen Übertragungslink einen neuen an, solange dein Workspace oder deine Kontoverbindung aktiv ist. Ein Gast-Workspace läuft nach sechs Stunden ab und lässt sich nicht wiederherstellen. Kontoverbindungen gelten bis zu 30 Tage; verbinde dein Konto bei Bedarf erneut. Die bestehenden Aufbewahrungsregeln für Dateien gelten weiterhin.
Was mache ich bei einem Fehler oder erreichten Limit?
Lies vor einem erneuten Versuch die Fehlermeldung. Bei 401 oder 403 klärst du zuerst die Sitzung, Anmeldung oder Berechtigung. Bei 429 wartest du das angegebene Wiederholungsintervall ab. Nutze bei laufenden Aufträgen poll_after_ms. Dateiformate, Größenlimits, Credits und Verarbeitungskontingente hängen vom gewählten Tool und Konto ab.