MCP

Servidor MCP

Pergunte ao Claude, ao ChatGPT ou ao Cursor sobre seus leads em linguagem natural. O servidor MCP do Gemlead dá aos assistentes de IA os dados e as ações da API, com a sua permissão.

O que é

O Model Context Protocol é o padrão aberto que os assistentes de IA usam para chamar ferramentas externas. Conecte o Gemlead uma vez e seu assistente passa a buscar seus leads quentes, ler e responder suas conversas, ver como vai uma campanha ou iniciar uma exportação, direto no chat. Ele só vê a conta do X que você conectar, e valem as mesmas regras da API, planos Business e Enterprise e os mesmos scopes.

O servidor usa Streamable HTTP. Claude e ChatGPT fazem login com OAuth, Cursor e Claude Code podem enviar uma chave de API como bearer token.

URL do servidor

https://gemlead.ai/mcp

Setup

No Claude, abra Customize e depois Connectors.
Clique em Add e depois em Add custom connector.
Dê a ele o nome Gemlead e cole https://gemlead.ai/mcp como URL do servidor.
Mantenha Use Claude's published identity como cliente OAuth e clique em Add.
Clique em Connect, faça login no Gemlead e escolha a conta do X.

Num chat, ative o Gemlead no menu +, em Connectors. O Claude Desktop e os apps mobile usam os mesmos conectores da sua conta do Claude, não há mais nada para configurar.

Nos planos Team e Enterprise, um owner adiciona o Gemlead em Organization settings, Connectors, e depois cada membro clica em Connect. O plano Free do Claude permite um único conector personalizado.

Outros clientes

Qualquer cliente que fale Streamable HTTP se conecta do mesmo jeito, com a URL e um cabeçalho Authorization. Teste o servidor com o MCP Inspector.

Terminal

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

Várias contas do X

Uma conexão serve uma única conta do X. Para trabalhar com várias ao mesmo tempo, adicione o Gemlead uma vez por conta, cada uma com sua própria URL de servidor, https://gemlead.ai/mcp/ seguido de um nome à sua escolha, como https://gemlead.ai/mcp/acme e https://gemlead.ai/mcp/julien. O nome é só um rótulo, com letras, números, - e _.

Conecte cada uma e escolha a conta do X na página de consentimento do Gemlead. Um nome igual ao nome de usuário da conta no X já a seleciona para você. Se as contas estiverem em logins diferentes do Gemlead, entre com o login certo antes de conectar.

Cada conexão só lê e age na própria conta e informa ao assistente qual é o @handle, então uma DM sempre sai da conta que você pediu. Dê a cada conector o nome da conta dele, como Gemlead Acme, para distingui-los no chat.

Ferramentas

O servidor tem 67 ferramentas, uma para cada coisa que a API faz. As ferramentas de leitura só leem. As de escrita alteram dados ou agem no X pela sua conta, então precisam do scope write, e o assistente pede confirmação antes de enviar, iniciar ou excluir qualquer coisa.

Clique na tag MCP de um endpoint na referência da API para ir direto à ferramenta dele.

Por design, nenhuma ferramenta define ou remove o código do X Chat, para que ele nunca passe por um chat de IA. Defina o código no app ou com Definir o código do X Chat.

Leads

search_leadsScope read
Leads com os filtros de Listar leads, como os leads quentes de uma persona encontrados esta semana.
Opcionalpersona_idstatusscore_minscore_maxhotscored_afterscored_beforefound_afterfound_beforeorderlimitcursor
get_leadScope read
Um lead com o perfil, o score e o motivo.
Obrigatóriolead_id
update_leadScope write
Define metadados num lead, ou encerra o lead quando você terminar com ele.
Obrigatóriolead_id
Opcionalmetadatastatus
get_lead_originScope read
Como o Gemlead encontrou um lead, o post que o revelou e as campanhas dele.
Obrigatóriolead_id
lead_actionScope write
Repontua um lead com até 2 créditos por lead: 1 pela primeira triagem, mais 1 pelo score aprofundado quando o lead passa, relê o perfil dele no X, ou segue ou deixa de seguir o lead pela sua conta do X.
Obrigatóriolead_idaction
convert_lead_to_sourceScope write
Transforma um lead em fonte da persona dele, para ler quem ele segue, os seguidores dele ou quem comenta nos posts dele.
Obrigatóriolead_id
Opcionalmethod
delete_leadScope write
Exclui um lead e o tira de todas as campanhas. O assistente pede confirmação antes.
Obrigatóriolead_id

Personas

list_personasScope read
Suas personas com as contagens e os números de hoje.
Opcionallimitcursor
get_personaScope read
Uma persona e as estatísticas dela.
Obrigatóriopersona_id
create_personaScope write
Cria uma persona com descrição, palavras-chave, concorrentes e fontes iniciais. O scoring usa até 2 créditos por lead: 1 pela primeira triagem, mais 1 pelo score aprofundado quando o lead passa.
Obrigatórionamedescription
Opcionalwebsitemarketkeywordscompetitorsavoidmin_followersinclude_closed_inboxesauto_expandauto_expand_directiondaily_scoring_limitsources
get_persona_settingsScope read
Todas as configurações de uma persona, com as buscas por palavra-chave e as contas concorrentes.
Obrigatóriopersona_id
update_personaScope write
Altera as configurações de uma persona, ou ativa ou pausa a persona.
Obrigatóriopersona_id
Opcionalnamewebsitedescriptionmarketkeywordscompetitorsavoidmin_followersinclude_closed_inboxesauto_expandauto_expand_directiondaily_scoring_limitstatus
delete_personaScope write
Exclui uma persona com as fontes dela e os leads que nenhuma campanha trabalhou. O assistente pede confirmação antes.
Obrigatóriopersona_id
reorder_personasScope write
Define a ordem das suas personas.
Obrigatóriopersona_ids
suggest_personaScope write
Pede à IA que escreva uma persona a partir de um nome e do que você vende.
Obrigatóriopersona_name
Opcionalwebsitebriefcurrent_descriptioninstruction
get_persona_suggestionScope read
A última sugestão de persona, pending, ready com o texto, ou error.
Sem argumentos
get_persona_sharingScope read
Quais contas do X do dono compartilham uma persona, e as outras com as quais ela pode ser compartilhada.
Obrigatóriopersona_id
update_persona_sharingScope write
Define quais outras contas do X do dono compartilham uma persona. Só para o dono.
Obrigatóriopersona_idaccount_ids

Fontes

list_sourcesScope read
As fontes de uma persona com as estatísticas, ou uma delas.
Obrigatóriopersona_id
Opcionalsource_idlimitcursorpaused
add_sourceScope write
Adiciona uma conta do X como fonte de uma persona.
Obrigatóriopersona_idusername
Opcionalread_followingread_followersscore_self
update_sourceScope write
Altera o que o Gemlead lê numa fonte, ou pausa, retoma, pula, recarrega ou pontua a fonte.
Obrigatóriopersona_idsource_id
Opcionalread_followingread_followersscore_selfaction
delete_sourceScope write
Remove uma fonte e os leads dela que nenhuma campanha trabalhou. O assistente pede confirmação antes.
Obrigatóriopersona_idsource_id
list_source_leadsScope read
Os leads que uma fonte encontrou, do maior score para o menor.
Obrigatóriopersona_idsource_id
Opcionalorderlimitcursor
list_persona_itemsScope read
As buscas por palavra-chave ou as contas concorrentes de uma persona, cada uma com os leads encontrados, pontuados e quentes.
Obrigatóriopersona_idkind
edit_persona_itemsScope write
Adiciona ou remove buscas por palavra-chave ou contas concorrentes numa persona.
Obrigatóriopersona_idkind
Opcionaladdremove
list_item_leadsScope read
Os leads que uma busca por palavra-chave ou uma conta concorrente encontrou, do maior score para o menor.
Obrigatóriopersona_id
Opcionalsearch_querycompetitor_accountorderlimitcursor
suggest_sourcesScope read
Contas do X que a IA sugere como fontes para uma persona.
Obrigatóriopersona_id
lookup_x_profileScope read
Lê um perfil do X ao vivo e, com uma persona, diz o quanto ele vale como fonte.
Obrigatóriousername
Opcionalpersona

Campanhas

list_campaignsScope read
Suas campanhas com os totais.
Opcionalstatuspersona_idlimitcursor
get_campaign_statsScope read
As DMs, as respostas e a taxa de resposta de uma campanha num período, dia a dia.
Obrigatóriocampaign_id
Opcionalfromto
create_campaignScope write
Cria uma campanha em rascunho a partir de um modelo ou do seu próprio fluxo. Nada é enviado até ela começar.
Obrigatóriopersona_idname
Opcionalmethodmin_scoredaily_limitlead_ordertemplateflow
get_campaign_settingsScope read
As configurações e o fluxo de uma campanha, cada etapa com o seu ID.
Obrigatóriocampaign_id
update_campaignScope write
Altera as configurações de uma campanha ou substitui o fluxo dela.
Obrigatóriocampaign_id
Opcionalnamemethodmin_scoredaily_limitlead_orderflow
set_campaign_statusScope write
Inicia, pausa ou arquiva uma campanha. Iniciar envia curtidas, comentários, follows e DMs pela sua conta do X, então o assistente pede confirmação antes.
Obrigatóriocampaign_idstatus
duplicate_campaignScope write
Copia as configurações e o fluxo de uma campanha para um novo rascunho.
Obrigatóriocampaign_id
delete_campaignScope write
Exclui uma campanha. Os leads e as conversas dela continuam, e o assistente pede confirmação antes.
Obrigatóriocampaign_id
list_campaign_leadsScope read
Os leads de uma campanha por etapa, com o que ela publicou para cada um deles.
Obrigatóriocampaign_id
Opcionalstagestep_idbranchskippedqlimitcursor
get_campaign_trendsScope read
Os leads iniciados, as DMs, as respostas e os follows de uma campanha por dia ou por hora.
Obrigatóriocampaign_id
Opcionalmetricsrangetimezone
list_campaign_templatesScope read
Os modelos de campanha com os fluxos completos.
Opcionalmethodmarket

Conversas

list_conversationsScope read
Suas conversas, ordenadas pela mensagem mais recente, ou só as não lidas se você pedir. Com include_messages, cada uma vem com todas as mensagens.
Opcionalunreadpersona_idinclude_messageslimitcursor
get_conversationScope read
Uma conversa com todas as mensagens.
Obrigatórioconversation_id
list_messagesScope read
Todo o histórico de uma conversa no X, página por página.
Obrigatórioconversation_id
Opcionallimitcursor
view_mediaScope read
Permite que o assistente veja uma imagem ou um GIF de uma mensagem, a partir da url no media dela.
Obrigatóriourl
send_messageScope write
Envia uma DM da sua conta do X para o lead, com texto, imagem, GIF, vídeo ou mensagem de voz. O assistente mostra o texto antes.
Obrigatórioconversation_id
Opcionaltextmediareply_to_message_id
react_to_messageScope write
Adiciona ou remove a sua reação com emoji numa mensagem recente.
Obrigatórioconversation_idmessage_idemoji
Opcionalremove
delete_messageScope write
Apaga uma mensagem recente, para você ou para os dois lados. O assistente pede confirmação antes.
Obrigatórioconversation_idmessage_id
Opcionalfor_everyone
update_conversationScope write
Marca uma conversa como lida ou não lida, move a conversa para uma coluna do quadro, ou fixa ou desafixa a conversa.
Obrigatórioconversation_id
Opcionalreadcolumn_idpinned
delete_conversationScope write
Exclui uma conversa no Gemlead e na sua inbox do X. O assistente pede confirmação antes.
Obrigatórioconversation_id
update_conversation_translationScope write
Ativa ou desativa a tradução de uma conversa, ou lê as configurações dela.
Obrigatórioconversation_id
Opcionalenabledshownlanguage
translate_messagesScope write
Traduz as mensagens recentes de uma conversa para um idioma.
Obrigatórioconversation_id
Opcionalmessage_idslanguage
list_pipeline_columnsScope read
As colunas do seu quadro de Conversas, em ordem.
Sem argumentos
edit_pipeline_columnsScope write
Cria, renomeia, recolhe, exclui ou reordena as colunas do seu quadro de Conversas.
Obrigatórioaction
Opcionalcolumn_idnamecollapsedpositioncolumn_ids

Sam AI

get_sam_settingsScope read
O modo, as instruções e os arquivos do Sam AI na conta do X, numa persona ou numa conversa. Numa conversa, também o modo que está valendo, o que o Sam AI está fazendo e a resposta que ele tem pronta.
Opcionalconversation_idpersona_id
update_sam_settingsScope write
Altera o modo ou as instruções do Sam AI numa persona ou numa conversa, ou liga e desliga o Sam AI e define as informações do seu negócio na conta do X. auto envia respostas pela sua conta do X, então o assistente pede confirmação antes.
Opcionalconversation_idpersona_idmodeinstructionsenabled
edit_sam_filesScope write
Adiciona arquivos a partir de uma URL ou remove arquivos que o Sam AI lê, na conta do X, numa persona ou numa conversa. O assistente pede confirmação antes de remover um arquivo.
Opcionalconversation_idpersona_idaddremove

Conta e outros

get_accountScope read
A conta do X à qual a conexão pertence e o plano dela.
Sem argumentos
get_account_settingsScope read
A sincronização da inbox, a pausa das DMs, o X Chat e o fuso horário e o idioma do dono.
Sem argumentos
update_account_settingsScope write
Altera a sincronização da inbox ou o fuso horário, o idioma ou o nome do dono, ou relê o perfil do X.
Opcionalsync_all_conversationstimezonelanguagefirst_namelast_nameinbox_syncrefresh_x_profile
get_exclusion_listScope read
As contas do X e os domínios que o Gemlead nunca contata, na conta ou em uma persona.
Opcionalpersona
edit_exclusion_listScope write
Adiciona ou remove contas do X e domínios da lista de exclusão da conta ou de uma persona.
Opcionaladdremovepersona
get_analyticsScope read
Um gráfico do seu Painel para a conta ou para uma persona, ou as últimas respostas, DMs e leads quentes.
Obrigatóriometric
Opcionalpersonascalestartendtimezone
create_exportScope read
Inicia um arquivo com os seus leads, em CSV ou JSON Lines, ou com todas as conversas por DM e o histórico completo de cada uma, em JSON Lines ou Markdown.
Opcionaltypeformatfilters
get_exportScope read
O status, o progresso e o link de download de uma exportação.
Obrigatórioexport_id
list_exportsScope read
Suas exportações, das mais novas para as mais antigas, com o status e o link de cada uma.
Sem argumentos

Equipe

get_teamScope read
O dono da conta do X, os membros e os convites dela, com as funções e as áreas de cada um.
Sem argumentos
edit_teamScope write
Convida alguém por email, muda a função ou as áreas de um membro, remove um membro ou cancela um convite, ou sai da equipe.
Obrigatórioaction
Opcionalemailrolezonesmember_id

Julien AI

ask_julien_aiScope write
Pergunta ao Julien AI, o assistente do Gemlead, sobre o Gemlead e os dados da sua conta. chat_id continua um chat. Uma resposta ainda running depois de 25 segundos volta com o seu ID, para você chamar de novo só com reply_id.
Opcionaltextchat_idreply_id

Argumentos e resultados

Uma ferramenta recebe os parâmetros do seu endpoint, com os IDs nomeados pelo objeto, como lead_id, persona_id, campaign_id, conversation_id ou export_id. As listas são paginadas com limit e cursor, como em Paginação.
Uma ferramenta que faz várias coisas recebe um action, um kind ou um status, como lead_action com action definido como rescore, refresh, follow ou unfollow.
list_campaigns recebe status como um array de draft, active, paused e archived. get_campaign_stats conta de from até to, ambos horários ISO 8601, com to igual a agora por padrão e from 30 dias antes.
create_export recebe os filtros de search_leads em filters, sem limit e cursor. Com type definido como conversations, exporta todas as conversas por DM com o histórico completo, e filters recebe persona_id e unread. Funciona com uma chave read, assim como Criar uma exportação.
ask_julien_ai envia text ao Julien AI, com chat_id para continuar um chat. Uma resposta que leva mais de 25 segundos volta como running com o seu id. Chame a ferramenta de novo passando só reply_id com esse valor, e ela espera até mais 25 segundos.
get_conversation e list_messages listam a mídia de cada mensagem com sua url. view_media recebe a url de uma imagem ou de um GIF e mostra a própria imagem ao assistente, que assim consegue ler um print enviado por um lead. send_message envia mídia com media, uma url https pública ou data em base64 com seu mime_type.
Um argumento errado volta como erro da ferramenta que indica qual é. Um erro da API volta como erro da ferramenta, com o código e o argumento em questão.

Cada ferramenta retorna o JSON do seu endpoint, como conteúdo estruturado e como texto. As ferramentas não publicam um schema de saída, a referência da API descreve cada objeto.

Nos planos Free e Starter, o servidor é instalado e lista as ferramentas, mas cada chamada retorna um erro plan_required que o assistente pode explicar. As chamadas de ferramentas contam nas 120 requisições por minuto da chave, compartilhadas com a API REST.

Exemplos de prompts

Mostre os leads quentes de hoje da minha persona Tipsters, com o motivo do score alto de cada um.
Qual campanha teve a melhor taxa de resposta nos últimos 30 dias, e quantas DMs ela enviou?
Liste minhas conversas não lidas e resuma o que cada lead está pedindo.
Exporte em CSV todos os leads quentes encontrados esta semana e me passe o link.
Exporte todas as minhas conversas por DM e depois me diga quais mensagens de abertura recebem mais respostas e como os leads reagem ao preço.
Marque o lead @jane_builds como encerrado e salve o ID do HubSpot dela, hs_48213, nos metadados.
Coloque o Sam AI no Semiautomático para a minha persona Tipsters e adicione o nosso PDF de preços ao que ele lê.

Segurança

O assistente só vê a conta do X que você conectou.
Revogue uma conexão ou uma chave no app, em API, quando quiser.
Dê uma chave read a um assistente que só precisa ler.
Os assistentes podem ser enganados pelos textos que leem. Confira o que uma ferramenta de escrita vai fazer antes de permitir.