Server MCP

Setup

Altri client

Qualsiasi client che usa Streamable HTTP si collega allo stesso modo, con l'URL e un header Authorization. Prova il server con MCP Inspector.

npx @modelcontextprotocol/inspector --cli https://gemlead.ai/mcp \
  --transport http \
  --header "Authorization: Bearer $GEMLEAD_API_KEY" \
  --method tools/list

Più account X

Una connessione vale per un solo account X. Per lavorare su più account insieme, aggiungi Gemlead una volta per account, ognuno con il suo URL del server, https://gemlead.ai/mcp/ seguito da un nome a tua scelta, come https://gemlead.ai/mcp/acme e https://gemlead.ai/mcp/julien. Il nome è solo un'etichetta, fatta di lettere, cifre, - e _.

Collega ognuno e scegli il suo account X nella pagina di consenso di Gemlead. Se il nome coincide con lo username X dell'account, viene scelto in automatico. Se gli account sono su login Gemlead diversi, accedi con quello giusto prima di collegarli.

Ogni connessione legge e agisce solo sul proprio account, e dice all'assistente di quale @handle si tratta, così un DM parte sempre dall'account che hai chiesto. Dai a ogni connettore il nome del suo account, come Gemlead Acme, per distinguerli nella chat.

Tool

Il server ha 67 tool, uno per ogni cosa che fa l'API. I tool di lettura leggono e basta. I tool di scrittura modificano i dati o agiscono su X dal tuo account, quindi richiedono lo scope write, e l'assistente ti chiede conferma prima di inviare, avviare o eliminare qualcosa.

Clicca il tag MCP di un endpoint nel riferimento API per arrivare al suo tool.

Per scelta, nessun tool imposta o rimuove il codice X Chat, così il codice non passa mai da una chat IA. Impostalo nell'app o con Imposta il codice X Chat.

Argomenti e risultati

• Un tool accetta i parametri del suo endpoint, con gli ID chiamati come il loro oggetto, come lead_id, persona_id, campaign_id, conversation_id o export_id. Gli elenchi si paginano con limit e cursor, come in Paginazione.
• Un tool che fa più cose accetta un action, un kind o uno status, come lead_action con action impostato su rescore, refresh, follow o unfollow.
• list_campaigns accetta status come array di draft, active, paused e archived. get_campaign_stats conta da from fino a to, entrambi in ISO 8601, con to che di default è adesso e from 30 giorni prima.
• create_export accetta i filtri di search_leads in filters, senza limit e cursor. Con type impostato su conversations, esporta tutte le conversazioni in DM con il loro thread completo, e filters accetta persona_id e unread. Funziona con una chiave read, come Crea un export.
• ask_julien_ai invia text a Julien AI, con chat_id per continuare una chat. Una risposta che richiede più di 25 secondi torna come running con il suo id. Richiama il tool impostando solo reply_id su quell'ID, e attenderà fino ad altri 25 secondi.
• get_conversation e list_messages elencano i media di ogni messaggio con il loro url. view_media prende l'url di un'immagine o di una GIF e mostra l'immagine stessa all'assistente, che può così leggere uno screenshot inviato da un lead. send_message ne invia una con media, un url https pubblico o data in base64 con il suo mime_type.
• Un argomento sbagliato torna come errore del tool che lo indica. Un errore dell'API torna come errore del tool con il suo codice e l'argomento a cui si riferisce.

Ogni tool risponde con il JSON del suo endpoint, come contenuto strutturato e come testo. I tool non pubblicano alcuno schema di output. Il riferimento API descrive ogni oggetto.

Sui piani Free e Starter il server si installa ed elenca i suoi tool, e ogni chiamata risponde con un errore plan_required che l'assistente può spiegare. Le chiamate ai tool contano nelle 120 richieste al minuto della chiave, condivise con l'API REST.

Prompt di esempio

• Mostrami i lead caldi di oggi per la mia buyer persona Tipsters, con il motivo per cui ognuno ha preso un punteggio alto.
• Quale campagna ha avuto il miglior tasso di risposta negli ultimi 30 giorni, e quanti DM ha inviato?
• Elenca le mie conversazioni non lette e riassumi cosa chiede ogni lead.
• Esporta in CSV tutti i lead caldi trovati questa settimana e dammi il link.
• Esporta tutte le mie conversazioni in DM, poi dimmi quali messaggi di apertura ottengono più risposte e come reagiscono i lead al prezzo.
• Segna il lead @jane_builds come chiuso e salva il suo ID HubSpot hs_48213 nei metadati.
• Metti Sam AI su Semi-auto per la mia buyer persona Tipsters e aggiungi il nostro PDF dei prezzi a quello che legge.

Sicurezza

• L'assistente vede solo l'account X che hai collegato.
• Revoca una connessione o una chiave nell'app, alla voce API, quando vuoi.
• Dai una chiave read a un assistente che deve solo leggere.
• Gli assistenti possono essere ingannati dai testi che leggono. Controlla cosa sta per fare un tool di scrittura prima di autorizzarlo.