Clay zu MCP: Personen- und Firmensuche, Enrichment-Funktionen, Tabellenabfragen und Credits in jedem KI-Agent

💡 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

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.

Einrichtung

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.

Voraussetzungen: CLAY_API_KEY

Connector lokal 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

Öffne http://localhost:3000/connectors/store, wähle Clay und trage die unter Voraussetzungen aufgelisteten Variablen ein.

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?“

Nächste Schritte

• Mit Claude verbinden
• Mit ChatGPT verbinden