Suche

Frag mich alles

Verbinde den Box-MCP-Server mit deinem Workspace

Verbinde ClickUp mit dem gehosteten MCP-Server von Box, damit deine KI-Tools Box-Inhalte suchen, lesen, hochladen und organisieren können. Die Einrichtung dauert etwa 10 Minuten.

Box-Scopes und die Berechtigungen des Box-Kontos, das die Verbindung autorisiert hat, gelten für jede Anfrage.

Was du benötigst

  • Einen ClickUp Workspace und die ClickUp-Browser-App.
  • Einen Box Business-Plan oder höher. Business Starter wird nicht unterstützt. Einzelne MCP-Funktionen oder Scopes erfordern möglicherweise einen höheren Plan.
  • Einen Box-Administrator oder Co-Administrator, der Integrationen und MCP-Anmeldedaten einrichten kann.
  • Workspace-Eigentümer oder -Administrator für eine Workspace-Verbindung. Mitglieder benötigen die Berechtigung „Persönlichen MCP-Server verbinden" für eine persönliche Verbindung. Gäste und eingeschränkte Mitglieder können keine MCP-Server verbinden.

Schritt 1: Integrationen in der Admin-Konsole öffnen

Ein Box-Administrator oder Co-Administrator führt die Schritte 1 bis 4 aus:

  1. Melde dich bei der Box Admin-Konsole an.
  2. Wähle Integrationen aus.
  3. Suche nach Custom Box MCP Server.
  4. Fahre mit der Maus darüber und wähle Konfigurieren aus.

Screenshot der Seite „Integrationen

Schritt 2: Anmeldedaten für die Integration hinzufügen

So erstellst du den Anmeldedaten-Eintrag:

  1. Wähle unter Zusätzliche Konfiguration die Option + Anmeldedaten für Integration hinzufügen aus.

Screenshot der Registerkarte „Konfiguration

  1. Gib einen Namen für den Eintrag ein und wähle Speichern aus.
  2. Klappe den neuen Eintrag auf.
  3. Kopiere Client-ID und Client-Secret an einen sicheren Speicherort.

Wenn ClickUp einen invalid_client-Fehler anzeigt, stimmen Client-ID und Client-Secret nicht mit einem Anmeldedaten-Eintrag überein. Kopiere beide Werte erneut aus demselben Eintrag.

Bewahre das Client-Secret nicht in Kommentaren, Screenshots oder freigegebenen Dokumenten auf.

Schritt 3: Weiterleitungs-URI hinzufügen

So fügst du den Weiterleitungs-URI hinzu:

  1. Füge unter Weiterleitungs-URIs den URI https://search.clickup-prod.com/connect/boxmcp hinzu.
  2. Lasse den Anmeldedaten-Eintrag geöffnet.

Gib den URI genau wie angegeben ein – ohne abschließenden Schrägstrich. Ein generischer MCP-Weiterleitungs-URI schlägt mit dem Fehler redirect_uri_mismatch fehl.

Screenshot der unkenntlich gemachten Anmeldedaten

Schritt 4: Zugriffs-Scopes auswählen

Welche Scopes verfügbar sind, hängt von deinem Box-Plan und den Administrator-Einstellungen ab. So wählst du Scopes aus:

  1. Wähle nur die Zugriffs-Scopes aus, die für die Aufgaben benötigt werden, die ClickUp in Box ausführen soll.

Screenshot der Konfiguration und des URI

  1. Wähle Speichern aus.
  2. Prüfe, ob der gespeicherte Eintrag den Weiterleitungs-URI und die Scopes anzeigt.

Box-Scopes legen fest, welche Aktionen die Integration maximal anfordern kann. Sie gewähren keinen Zugriff auf Inhalte, auf die die autorisierende Box-Identität noch keinen Zugriff hat.

Wenn ClickUp einen insufficient_scope-Fehler anzeigt, bitte deinen Box-Administrator, die Scopes für die benötigten Tools auszuwählen und zu speichern. Box-Administratoren können Tools auch deaktivieren.

Wenn die Verbindung erfolgreich hergestellt wird, aber keine Tools anzeigt, braucht ClickUp mindestens ein Tool vom Server. Prüfe, ob mindestens ein Scope gespeichert ist, und bitte deinen Box-Administrator zu bestätigen, dass die benötigten Tools aktiviert sind.

In ClickUp verbinden

So verbindest du den MCP-Server in ClickUp:

  1. Öffne in der ClickUp-Browser-App das App Center.
  2. Suche nach Box MCP und wähle es aus.
  3. Wähle Persönlich oder Workspace aus:
    • Persönlich (Nur für mich): Nur du kannst die Tools dieser Verbindung nutzen. Verwende diese Option, wenn jede Person Box-Zugriff über ihr eigenes Konto benötigt.
    • Workspace (Für alle Mitglieder): Ein Workspace-Eigentümer oder -Administrator richtet die Verbindung ein, und alle Mitglieder können deren Tools nutzen. Alle Mitglieder agieren als das Box-Konto, das die Verbindung autorisiert hat – stelle daher sicher, dass der Zugriff dieses Kontos sicher geteilt werden kann.
  4. Wähle Verbinden aus.
  5. Gib die Client-ID und das Client-Secret ein, die du in Schritt 2 kopiert hast.

Screenshot der App-Center-Verbindung

  1. Melde dich mit dem Konto bei Box an, das die Verbindung verwenden soll, und erteile dann den Zugriff.
  2. Warte, bis ClickUp die Verbindung validiert hat.

Die Validierung dauert bis zu 15 Sekunden und schlägt fehl, wenn Box keine Tools zurückgibt.

Die Box-MCP-Verbindung verwendet https://mcp.box.com. Du benötigst keine separate OAuth-App.

Der Standard-OAuth-Flow von Box MCP agiert als der Box-Nutzer, der ihn autorisiert. Box setzt dabei weiterhin den Zugriff, die Zusammenarbeitsberechtigungen und die vom Administrator ausgewählten Scopes dieser Identität durch.

Verfügbare Tools

Welche Tools verfügbar sind, hängt von deinen Box-Scopes, deinem Plan, den Administrator-Einstellungen und den Berechtigungen des Box-Kontos ab, das die Verbindung autorisiert hat. Hier sind einige Beispiele:

Tool Funktion
search_files_keyword Box-Dateien per Stichwort suchen, mit optionalen Filtern und Ordner-Eingrenzung.
get_file_content Den Inhalt einer Box-Datei abrufen.
upload_file Eine Datei in Box hochladen.
create_folder Einen Ordner in Box erstellen.

Einschränkungen

Box-Plan und Administrator-Einstellungen beeinflussen, was du einrichten und verwenden kannst:

  • Planabhängige Funktionen: Nicht jeder Box-Plan enthält jeden Scope und jedes Tool. Der Scope docgen.readwrite erfordert beispielsweise den Box Enterprise Advanced-Plan. Frage deinen Box-Administrator, welche Scopes für deine Organisation verfügbar sind.
  • Zugriff auf die Admin-Konsole: Wenn du Integrationen nicht findest oder das Box MCP nicht einrichten kannst, wende dich an einen Box-Administrator. Co-Administrator-Berechtigungen und Box-Plan-Funktionen können beeinflussen, welche Einstellungen sichtbar sind.

Fehlerbehebung

Wenn deine Verbindung fehlschlägt, sieh nach, welchen Fehler ClickUp anzeigt:

Fehler Aktion
redirect_uri_mismatch Prüfe, ob im Box-Anmeldedaten-Eintrag der genaue Weiterleitungs-URI aus Schritt 3 gespeichert wurde. Vergleiche ihn Zeichen für Zeichen, einschließlich https:// und ohne abschließenden Schrägstrich. Wenn Box deine Werte nicht speichert, wende dich vor dem Verbinden an deinen Box-Administrator oder den Box-Support.
invalid_client Lies die Tipps in Schritt 2 und Schritt 4.
insufficient_scope Lies die Tipps in Schritt 2 und Schritt 4.

Verbindung trennen oder Zugriff widerrufen

Nur Workspace-Eigentümer und -Administratoren können eine Workspace-Verbindung trennen.

So trennst du Box von ClickUp:

  1. Öffne das App Center.
  2. Wähle MCP Servers aus.
  3. Öffne die Box-MCP-Verbindung.
  4. Wähle die Registerkarte Persönlich oder Workspace aus.
  5. Wähle das Ellipsis-...-Symbol neben Verbunden aus.
  6. Wähle Verbindung trennen aus.

Das Trennen der Verbindung in ClickUp entfernt nur die ClickUp-Verbindung. Um den Zugriff in Box zu widerrufen, bitte deinen Box-Administrator, das Token für diese Verbindung zu widerrufen, oder wende dich an den Box-Support.

Wenn ein Token widerrufen wird, das auch ein anderer Client verwendet, wird dessen Verbindung unterbrochen.

Sicherheitshinweise

Fordere nur die Box-Zugriffs-Scopes an, die für deinen Anwendungsfall nötig sind, und prüfe vor der Freigabe für den gesamten Workspace, welche Box-Identität die Verbindung autorisiert.

Box MCP umgeht nicht die bestehenden Box-Berechtigungen der autorisierenden Identität.