Clay über MCP mit Cursor 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 + Cursor

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 Cursor 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.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Clay-Tools aufrufen.

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

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden