Come collegare Clay a Claude via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Clay, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Clay + Claude

Dati GTM di Clay da qualsiasi agente AI: cerca nel database di persone e aziende di Clay, esegui funzioni di arricchimento gestite da Clay o personalizzate su fino a 100 elementi, interroga le tabelle Clay nei piani Enterprise, cerca le esecuzioni dei Workflow e controlla il saldo crediti. Funziona con una chiave API personale di Clay; la cancellazione per privacy è disattivata all'installazione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

CLAY_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account Clay.

1. In Clay apri API and CLI, scheda API keys (https://app.clay.com/workspaces/~/api-and-cli?tab=api-keys), e crea una chiave. La chiave agisce come il tuo utente, con i tuoi accessi al workspace.
2. Incollala in CLAY_API_KEY. Viene inviata nell'header clay-api-key.
3. Per le funzioni personalizzate apri la funzione in Clay, poi Details, e attiva l'accesso API; copia il suo id t_....
4. Installa il connettore ed esegui clay_get_me: restituisce utente e workspace e conferma la chiave. clay_get_credit_balance mostra i crediti rimasti; leggere il saldo non costa crediti.

Cercare nel database di persone e aziende:

1. clay_get_search_query_reference, una volta per sessione, dà i campi interrogabili di persone e aziende, gli operatori e la grammatica.
2. clay_create_search avvia una ricerca con una query che inizia con select from people o select from companies, per esempio select from companies where people.exists(is_current = true and job_title is_similar_to ("VP Sales")), e restituisce un search_id. Le query di conteggio e le ricerche di offerte di lavoro non sono supportate.
3. clay_get_search_results con quell'id è un iteratore con stato: ogni chiamata restituisce la pagina successiva e l'AI richiama finché has_more è true. Le persone arrivano con nome, località ed esperienze corrispondenti; le aziende con dominio, settore, dimensione, fatturato e URL LinkedIn.

I risultati delle ricerche contano sui limiti del tuo piano: nel piano gratuito 50 per ricerca e 100 ogni 30 giorni, nei piani a pagamento 500 per richiesta. Oltre un limite Clay risponde 402 indicando il limite.

Arricchire con una funzione:

1. clay_run_routine esegue una funzione gestita da Clay, o una personalizzata con accesso API, su 1-100 elementi: l'id della routine (function:t_...) ed elementi come {"id": "row-1", "inputs": {"domain": "clay.com"}}. L'id (al massimo 64 caratteri) è tuo e torna con il risultato. Un webhook_id può avvisare un webhook Clay registrato quando l'esecuzione termina. Le esecuzioni consumano crediti Clay, quindi l'AI ti dice prima quale funzione e quanti elementi avvia.
2. clay_get_run_results con il routine_run_id: HTTP 202 e status: in_progress mentre gira, poi 200 con status: complete e data. I risultati si abbinano agli input tramite id, non per ordine; un'esecuzione completa può contenere elementi falliti, e finished include i fallimenti. L'AI controlla ogni pochi secondi, non in un ciclo stretto.
3. clay_get_batch_run_results segue un'esecuzione batch avviata dalla CLI di Clay o via API; un batch finito restituisce result_url per il file dei risultati.

Tabelle (piani Enterprise): clay_query_tables legge le righe di tabelle note con campi selezionati, filtri, ordinamento, raggruppamento e join; l'id della tabella è nel suo URL (.../tables/t_...). Ogni cella torna con uno status: success (con value), empty, error (con error) o uno stato in attesa (running, queued, retry, rate_limited, awaiting_callback). Una scansione può restituire due volte una riga che cambia durante la lettura, quindi l'AI elimina i duplicati per id.

Workflow (beta): clay_get_runs_query_reference dà la grammatica delle query sulle esecuzioni, poi clay_query_workflow_runs trova le esecuzioni (una query select le restituisce dalla più recente, una query count ne dà il numero). Le query hanno al massimo 2000 caratteri; i dati possono arrivare con qualche secondo di ritardo.

Disattivati all'installazione: clay_privacy_delete_people elimina persone da Clay Audiences per una richiesta privacy come una cancellazione GDPR, trovate per email, slug LinkedIn (la parte dopo /in/, non l'URL) o telefono, da 1 a 100 identificativi per chiamata. Non si può annullare, quindi un admin del workspace lo attiva quando serve; poi va eseguito prima con dry_run: true per contare le corrispondenze, e il job si segue con clay_get_privacy_deletion_status, disponibile fino a cinque giorni dopo la fine del job.

Paginazione: le raccolte restituiscono data e un cursor finché ci sono altre pagine; l'AI ripassa il cursore. Le query sulle tabelle restituiscono 50 righe per pagina di default (al massimo 100), i risultati delle esecuzioni 20 (al massimo 100), le pagine di ricerca 20 (al massimo 500 nei piani a pagamento, 50 in free e trial).

Errori comuni: gli errori hanno un message. 401 o 403 indicano una chiave errata o nessun accesso, 402 un limite di risultati di ricerca raggiunto, 404 un id sconosciuto o una funzione senza accesso API, 409 o 422 uno stato o un input non validi. 429 è il limite di frequenza del workspace: aspetta i secondi indicati in Retry-After.

Cosa non fa: la Clay Public API non ha endpoint per elencare tabelle o funzioni, creare tabelle o scrivere righe. Le righe arrivano comunque in una tabella tramite il suo webhook in ingresso, e gli id di funzioni e tabelle si copiano dall'app di Clay.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Claude

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.

1. In Claude apri Customize → Connectors.
2. Clicca + e poi Add custom connector.
3. Inserisci un nome, ad esempio Clay, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add.
4. Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.

Tool disponibili

Esempi di prompt

• "Quanti crediti Clay ci restano?"
• "Trova i VP Sales di aziende software in Germania con 50-200 dipendenti e mostrami i primi 20."
• "Esegui la nostra funzione di arricchimento aziende function:t_abc123 su questi cinque domini e mostrami i risultati quando l'esecuzione è completa."
• "Dalla tabella t_0te9i4tZEHwc9hihBXu mostra le aziende con il dominio compilato, ordinate per dominio."
• "Quali esecuzioni dei nostri Workflow Clay sono fallite nelle ultime 24 ore?"

FAQ

Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

• Landing del connettore
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot