Clay über MCP mit Meta Muse verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Clay klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Clay + Meta Muse

GTM-Daten aus Clay in jedem KI-Agent: Clays Personen- und Firmendatenbank durchsuchen, von Clay verwaltete und eigene Enrichment-Funktionen auf bis zu 100 Einträge anwenden, Clay-Tabellen in Enterprise-Tarifen abfragen, Workflow-Runs suchen und das Credit-Guthaben prüfen. Mit einem persönlichen Clay-API-Schlüssel; die Datenschutz-Löschung ist bei der Installation ausgeschaltet.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

CLAY_API_KEY

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Clay-Konto.

1. Öffne in Clay API and CLI, Tab API keys (https://app.clay.com/workspaces/~/api-and-cli?tab=api-keys), und lege einen Schlüssel an. Der Schlüssel handelt als dein Benutzer, mit deinen Workspace-Rechten.
2. Füge ihn in CLAY_API_KEY ein. Er wird im Header clay-api-key gesendet.
3. Für eigene Funktionen öffnest du die Funktion in Clay, dann Details, und aktivierst den API-Zugriff; kopiere ihre t_...-ID.
4. Installiere den Connector und führe clay_get_me aus: Es liefert Benutzer und Workspace und bestätigt den Schlüssel. clay_get_credit_balance zeigt die restlichen Credits; das Lesen des Guthabens kostet keine Credits.

Die Personen- und Firmendatenbank durchsuchen:

1. clay_get_search_query_reference einmal pro Sitzung liefert die abfragbaren Personen- und Firmenfelder, Operatoren und die Grammatik.
2. clay_create_search startet eine Suche mit einer Abfrage, die mit select from people oder select from companies beginnt, zum Beispiel select from companies where people.exists(is_current = true and job_title is_similar_to ("VP Sales")), und gibt eine search_id zurück. Zählabfragen und Stellensuchen werden nicht unterstützt.
3. clay_get_search_results mit dieser ID ist ein zustandsbehafteter Iterator: Jeder Aufruf liefert die nächste Seite, und die KI ruft erneut auf, solange has_more true ist. Personen kommen mit Name, Ort und passenden Stationen; Firmen mit Domain, Branche, Größe, Umsatz und LinkedIn-URL.

Suchergebnisse zählen gegen die Ergebnislimits deines Tarifs: im Free-Tarif 50 pro Suche und 100 pro 30 Tage, in bezahlten Tarifen 500 pro Anfrage. Über einem Limit antwortet Clay mit 402 und nennt das Limit.

Mit einer Funktion anreichern:

1. clay_run_routine führt eine von Clay verwaltete Funktion oder eine eigene mit API-Zugriff auf 1 bis 100 Einträgen aus: die Routine-ID (function:t_...) und Einträge wie {"id": "row-1", "inputs": {"domain": "clay.com"}}. Die id (höchstens 64 Zeichen) gehört dir und kommt mit dem Ergebnis zurück. Eine webhook_id kann einen registrierten Clay-Webhook benachrichtigen, wenn der Run endet. Runs verbrauchen Clay-Credits, deshalb sagt dir die KI vorher, welche Funktion und wie viele Einträge sie startet.
2. clay_get_run_results mit der routine_run_id: HTTP 202 und status: in_progress, solange er läuft, dann 200 mit status: complete und data. Ergebnisse werden über die id den Eingaben zugeordnet, nicht über die Reihenfolge; ein fertiger Run kann fehlgeschlagene Einträge enthalten, und finished zählt Fehlschläge mit. Die KI fragt alle paar Sekunden ab, nicht in einer engen Schleife.
3. clay_get_batch_run_results verfolgt einen Batch-Run, der über die Clay-CLI oder die API gestartet wurde; ein fertiger Batch liefert result_url für die Ergebnisdatei.

Tabellen (Enterprise-Tarife): clay_query_tables liest Zeilen bekannter Tabellen mit ausgewählten Feldern, Filtern, Sortierung, Gruppierung und Joins; die Tabellen-ID steht in der URL der Tabelle (.../tables/t_...). Jede Zelle kommt mit einem status: success (mit value), empty, error (mit error) oder einem wartenden Zustand (running, queued, retry, rate_limited, awaiting_callback). Ein Scan kann eine Zeile doppelt liefern, wenn sie sich währenddessen ändert, deshalb entfernt die KI Duplikate über die ID.

Workflows (Beta): clay_get_runs_query_reference liefert die Grammatik für Run-Abfragen, danach findet clay_query_workflow_runs Runs (eine Select-Abfrage liefert sie, neueste zuerst, eine Count-Abfrage die Anzahl). Abfragen haben höchstens 2000 Zeichen; die Daten können ein paar Sekunden nachhängen.

Bei der Installation ausgeschaltet: clay_privacy_delete_people löscht Personen aus Clay Audiences für eine Datenschutzanfrage wie eine DSGVO-Löschung, gefunden über E-Mail, LinkedIn-Slug (der Teil nach /in/, nicht die URL) oder Telefon, 1 bis 100 Kennungen pro Aufruf. Das lässt sich nicht rückgängig machen, deshalb schaltet ein Workspace-Admin es bei Bedarf ein; dann zuerst mit dry_run: true die Treffer zählen und den Job mit clay_get_privacy_deletion_status verfolgen, das bis zu fünf Tage nach Jobende verfügbar bleibt.

Seitenweise Abfrage: Sammlungen liefern data und einen cursor, solange weitere Seiten existieren; die KI gibt den Cursor zurück. Tabellenabfragen liefern standardmäßig 50 Zeilen pro Seite (höchstens 100), Run-Ergebnisse 20 (höchstens 100), Suchseiten 20 (höchstens 500 in bezahlten Tarifen, 50 in Free und Trial).

Häufige Fehler: Fehler tragen eine message. 401 oder 403 heißt falscher Schlüssel oder kein Zugriff, 402 ein erreichtes Suchergebnis-Limit, 404 eine unbekannte ID oder eine Funktion ohne API-Zugriff, 409 oder 422 ein ungültiger Zustand oder eine ungültige Eingabe. 429 ist das Rate-Limit des Workspace: Warte die Sekunden aus Retry-After ab.

Was er nicht kann: Die Clay Public API hat keine Endpunkte, um Tabellen oder Funktionen aufzulisten, Tabellen anzulegen oder Zeilen zu schreiben. Zeilen kommen weiterhin über den Inbound-Webhook einer Tabelle hinein, und Funktions- und Tabellen-IDs kopierst du aus der Clay-App.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Muse hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Muse bindet Remote-MCP-Server als Custom Connectors ein und meldet sich per OAuth bei ihnen an.

1. Öffne in Muse Settings → Connectors und wähle Add custom connector.
2. Füge die MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein.
3. Muse öffnet die Anmeldeseite von AnythingMCP: Melde dich an und bestätige den Zugriff.
4. Bitte Muse im Chat um etwas, wofür es die Clay-Tools braucht.

Du kannst den Connector auch per Chat einrichten, im Web, in den Apps für iOS und Android oder in WhatsApp. Schick Muse diese Nachricht:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Muse verbindet sich aus der Cloud von Meta, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Wie viele Clay-Credits haben wir noch?“
• „Finde VPs Sales bei Softwarefirmen in Deutschland mit 50 bis 200 Mitarbeitenden und zeig mir die ersten 20.“
• „Führe unsere Firmen-Enrichment-Funktion function:t_abc123 auf diesen fünf Domains aus und zeig mir die Ergebnisse, wenn der Run fertig ist.“
• „Zeig aus der Tabelle t_0te9i4tZEHwc9hihBXu die Firmen mit ausgefüllter Domain, sortiert nach Domain.“
• „Welche unserer Clay-Workflow-Runs sind in den letzten 24 Stunden fehlgeschlagen?“

FAQ

Wo ist Muse verfügbar? Meta bietet Muse derzeit in den USA und in Kanada an, im Web, in den Apps für iOS und Android und in WhatsApp.

Prüft Meta diesen Connector? Nein. Meta prüft Custom Connectors nicht. Muse sieht nur die Tools, die du in AnythingMCP für diesen MCP-Server eingeschaltet hast, und du kannst den Connector jederzeit unter Settings → Connectors trennen.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Microsoft Copilot verbinden