Integriere externe MCP-Server (Model Context Protocol) wie GitHub MCP oder Atlassian MCP in deinen ClickUp-Workspace und ermögliche so deinen ClickUp-Super Agents und ClickUp Brain, Tools aus externen Apps zu nutzen.

Du kannst zum Beispiel den MCP-Server deines CRM mit deinem Workspace verbinden. Deine Super Agents und Brain können dann verfügbare MCP-Tools nutzen, um Aktionen auszuführen – etwa CRM-Datensätze erstellen, Konten bereitstellen oder Kundendaten synchronisieren – alles direkt aus ClickUp heraus.

Informationen zu MCP-Aufrufbeschränkungen nach Plan findest du unter Verfügbarkeit und Limits der ClickUp-KI-Funktionen.

Dieser Artikel beschreibt, wie du ClickUp über das App Center mit externen MCP-Servern verbindest (ausgehende Verbindungen). Die Verbindung zum ClickUp-MCP-Server – bei der ein externer KI-Client auf deine ClickUp-Daten zugreift – ist eine separate Funktion, die über Berechtigungen für persönliche API-Token gesteuert wird.

Du kannst einen externen MCP-Server mit jedem Plan verbinden.

Nur Workspace-Eigentümer und Admins können Workspace-Verbindungen einrichten.

Mitglieder können persönliche Verbindungen über das App Center einrichten, sofern Admins die Berechtigung „Persönlichen MCP-Server verbinden" aktiviert haben.

Gäste und eingeschränkte Mitglieder können keine Integrationen einrichten.

MCP-Server lassen sich derzeit nur über die ClickUp-Browser-App verbinden.

Verbindungstypen

Wenn du einen externen MCP-Server verbindest, wählst du einen Verbindungstyp aus:

• Nur für mich: Eine persönliche Verbindung. Verknüpfe dein externes MCP-Server-Konto mit deinem ClickUp-Benutzerkonto – für jeden Workspace, den du erstellt hast oder dem du beigetreten bist. Nur du kannst Tools aus dieser Verbindung in Super Agents und Brain nutzen.
• Für alle Mitglieder: Eine Workspace-Verbindung, die nur von einem Workspace-Eigentümer oder Admin aktiviert werden kann. Alle Mitglieder im Workspace können Tools aus dieser Verbindung in Super Agents und Brain nutzen.

Admin-Steuerung für Verbindungen

Workspaces, die benutzerdefinierte Rollenberechtigungen verwenden, können das Hinzufügen von Workspace- oder persönlichen MCP-Server-Verbindungen deaktivieren.

Externen MCP-Server verbinden

Kläre vor dem Verbinden mit deinem MCP-Anbieter, welche Authentifizierungsmethode und welche Header erwartet werden. Übernimm diese Einstellungen, wenn du den Server in ClickUp verbindest.

MCP-Server benötigen eine öffentliche URL, um verbunden werden zu können.

ClickUp verwendet keine festen ausgehenden IP-Adressen für Brain- und Super-Agent-Verbindungen zu externen MCP-Servern. Der ausgehende Datenverkehr nutzt dynamisch zugewiesene Cloud-IP-Adressen – IP-Allowlisting wird daher nicht unterstützt. Sichere deinen MCP-Server-Endpunkt mit OAuth- oder API-Key-Authentifizierung.

So verbindest du einen externen MCP-Server mit deinem Workspace:

1. Öffne das App Center:

   

   • Klicke oben links auf deinen Workspace-Avatar und wähle Apps aus.
   • Klicke in deiner globalen Navigation auf Mehr und wähle Apps aus.
   • Verwende den Befehl App Center öffnen in der KI-Befehlsleiste.
2. Wähle in der App-Center-Seitenleiste Custom MCP aus.
3. Klicke unten auf Neu hinzufügen oder wähle eine der Vorlagen aus.
4. Wähle den Verbindungstyp:
   • Tab Für alle Mitglieder oder Workspace: Richtet eine Workspace-Verbindung ein.
   • Tab Nur für mich oder Persönlich: Richtet eine persönliche Verbindung ein.
5. Klicke auf Weiter.
6. Gib deine Serverinformationen in die erforderlichen Felder ein oder autorisiere dein Konto, wenn du eine unserer Vorlagen verwendest. Bei benutzerdefinierten Servern sind Name, URL und Authentifizierungsmethode Pflichtangaben. Optional kannst du ein Server-Symbol und eine Beschreibung ergänzen.

7. Beim Verbinden eines benutzerdefinierten MCP-Servers stehen dir drei Autorisierungsmethoden zur Verfügung:
   • OAuth: Du wirst zum OAuth-Flow des Anbieters weitergeleitet und danach zu ClickUp zurückgeleitet. Manche Anbieter verlangen, dass eine Weiterleitungs-/Callback-URL registriert wird, bevor du eine Verbindung herstellen kannst. Verwende https://search.clickup-prod.com/connect/mcp.
   • API-Key: Gib deinen API-Key ein. Falls dein Anbieter benutzerdefinierte Header erfordert, trage diese ebenfalls ein. Bei gültigen Angaben stellt ClickUp die Verbindung her und zeigt die verfügbaren Tools an.
   • Keine Authentifizierung: Verbinde ClickUp direkt. Falls dein Anbieter benutzerdefinierte Header erfordert, trage diese ebenfalls ein. Bei gültigen Angaben stellt ClickUp die Verbindung her und zeigt die verfügbaren Tools an.
8. Beim Verbinden eines benutzerdefinierten MCP-Servers kannst du Client-ID, Client-Secret und Scopes im Abschnitt Erweiterte Konfiguration anpassen.

9. Nach dem Verbinden siehst du im Abschnitt KI-Tools der App alle verfügbaren Tools aufgelistet, die du jetzt zu Super Agents hinzufügen und in Brain verwenden kannst.

Eine MCP-Vorlage verwenden

ClickUp bietet Vorlagen an, mit denen du dich schnell mit den beliebtesten MCP-Servern verbinden kannst.

So verbindest du einen externen MCP-Server mithilfe einer dieser Vorlagen:

1. Öffne das App Center:
   • Klicke oben links auf deinen Workspace-Avatar und wähle Apps aus.
   • Klicke in deiner globalen Navigation auf Mehr und wähle Apps aus.
   • Verwende den Befehl App Center öffnen in der KI-Befehlsleiste.
2. Wähle in der App-Center-Seitenleiste MCP Servers aus.
3. Klicke auf die Vorlage, die du verwenden möchtest.
4. Standardmäßig ist der Tab Persönlich aktiv. Um eine Workspace-Verbindung einzurichten, klicke auf den Tab Workspace.
5. Wähle Verbinden aus.
6. Führe die Autorisierungsschritte aus, um den externen MCP-Server zu verbinden.

MCP-Tools zu Super Agents hinzufügen

Sobald dein MCP-Server verbunden ist, stehen seine Tools in deinen Super Agents zur Verfügung.

Verfügbarkeit und Verhalten der Tools hängen vom jeweiligen externen MCP-Server-Anbieter ab.

MCP-Tools zu einem bestehenden Super Agent hinzufügen

So fügst du Tools eines verbundenen MCP-Servers zu einem bestehenden Super Agent hinzu:

1. Öffne das Profil deines Super Agents.
2. Klicke im Abschnitt Tools auf Tools hinzufügen.
3. Suche nach einer MCP-Vorlage und wähle sie aus, oder klicke auf Benutzerdefinierter MCP-Server, um einen benutzerdefinierten Server hinzuzufügen.
4. Füge die MCP-Tools hinzu:
   • Alle Tools des MCP-Servers auf einmal hinzufügen: Klicke oben im Menü auf Alle hinzufügen.
   • Einzelne Tools hinzufügen: Wähle sie einzeln aus.

Denk daran, auch die Anweisungen des Super Agents zu aktualisieren!

MCP-Tools beim Erstellen eines Super Agents hinzufügen

Wenn du beim Erstellen eines Super Agents einen Workflow erwähnst, der einen verbundenen MCP-Server einbezieht, werden die Tools dieses Servers nach der Erstellung automatisch zum Super Agent hinzugefügt.

Workspace-Auditprotokolle und MCP-Server

Workspace-Auditprotokolle enthalten Informationen zu externen MCP-Servern, die im Workspace eingerichtet wurden. Personen mit Zugriff auf deine Workspace-Auditprotokolle können folgende Informationen zu externen MCP-Servern einsehen:

• Wer einen externen MCP-Server verbunden hat sowie Datum und Uhrzeit des Vorgangs
• Wer einen externen MCP-Server getrennt hat sowie Datum und Uhrzeit des Vorgangs
• Wer einen externen MCP-Server aktualisiert hat sowie Datum und Uhrzeit des Vorgangs
• Ob es sich bei der externen MCP-Server-Verbindung um eine Workspace- oder persönliche Verbindung handelt
• Die Details des externen MCP-Servers:
  • Name
  • Server-URL
  • Autorisierungstyp