Um assistente de IA não consegue olhar o X sozinho. Pergunte ao Claude ou ao ChatGPT o que uma conta publicou hoje de manhã e ele chuta ou diz que não tem acesso. Um servidor MCP resolve isso: ele dá ao assistente um conjunto de ferramentas, como "pegar os tweets de um usuário" ou "buscar tweets", e o assistente chama essas ferramentas quando a sua pergunta precisa de dados ao vivo.

Este guia conecta um assistente a dados públicos do X pelo servidor MCP do Twitter hospedado da TwittrAPI, que nós operamos. Não precisa instalar nada nem ter conta de desenvolvedor do X. Os passos seguem a mesma ideia em qualquer cliente MCP; só muda o lugar onde você cola a URL.

O que você ganha

O servidor oferece 30 ferramentas para dados públicos:

ÁreaFerramentas
Perfisget_user_by_username, get_user_by_id, users_by_ids, username_to_id, get_user_about_batch
Tweetsget_tweet, tweets_by_ids, get_tweet_replies, get_tweet_thread, get_user_tweets, get_user_tweets_and_replies, get_user_media, search_tweets
Reaçõesget_tweet_quotes, get_tweet_retweets
Conexõesget_followers, get_following, get_verified_followers, get_user_affiliates, get_friendships_batch
Listas e comunidadesget_list_details, get_list_members, get_list_tweets, get_community, get_community_about, get_community_tweets, search_communities
Trends e Spacesget_trends, get_trend_locations, get_space

Com a sua sessão do X, ele também consegue publicar, curtir, seguir e mandar DMs na sua própria conta. Essa parte tem um guia próprio: Publique no X pelo Claude e ChatGPT.

Por padrão, os resultados voltam no formato simples (em inglês), que é compacto e deixa o texto curto para caber no contexto do assistente.

Passo 1: Consiga uma API key ou uma conta

Crie uma conta pelo /start. Contas novas ganham US$ 0,50 de crédito de teste por 7 dias. A maioria dos apps faz o login com OAuth e nunca vê a sua chave. No Cursor e em scripts, você envia a chave em um header, então guarde ela em uma variável de ambiente:

export TWITTRAPI_API_KEY="your-key"

Passo 2: Adicione o servidor ao seu app

O endereço é sempre o mesmo e precisa terminar em /mcp:

https://mcp.twittrapi.com/mcp

Claude.ai e Claude Desktop. Abra Settings > Connectors, escolha Add custom connector, dê o nome TwittrAPI, cole a URL e clique em Connect. Entre na sua conta e clique em Allow access.

ChatGPT. Ative o Developer mode em Settings > Apps & Connectors > Advanced settings, escolha Create, informe a URL e selecione OAuth como autenticação.

Claude Code.

claude mcp add --transport http twittrapi https://mcp.twittrapi.com/mcp \
  --header "Authorization: Bearer $TWITTRAPI_API_KEY"

Cursor. Adicione isto ao ~/.cursor/mcp.json:

{
  "mcpServers": {
    "twittrapi": {
      "url": "https://mcp.twittrapi.com/mcp",
      "headers": { "X-API-KEY": "${env:TWITTRAPI_API_KEY}" }
    }
  }
}

VS Code (modo agente do Copilot). Crie um .vscode/mcp.json com "type": "http" e a mesma URL; o VS Code faz o login quando o servidor inicia. A página do MCP hospedado (em inglês) tem esse arquivo e os passos para outros clientes.

Passo 3: Faça uma pergunta que precise de dados ao vivo

Abra um chat novo e pergunte algo que só o X sabe responder. O assistente escolhe a ferramenta sozinho e, na maioria dos apps, mostra a chamada antes de executar:

  • "O que a @nasa publicou nas últimas 24 horas? Resuma em três tópicos."
  • "Busque tweets que mencionam o nome do meu produto nos últimos dois dias com pelo menos 20 curtidas. Agrupe por assunto."
  • "Compare o número de seguidores e as bios de @openai, @AnthropicAI e @GoogleDeepMind."
  • "Quais assuntos estão em alta na Alemanha agora?"

Para tarefas mais longas, dê um limite ao assistente logo de cara, por exemplo "olhe os 40 tweets mais recentes, não mais que isso". Assim ele para de paginar quando já tem o suficiente.

Passo 4: Fique de olho no custo

Cada chamada de ferramenta é uma chamada de API cobrada do seu saldo, pelo seu preço normal: US$ 0,10 por 1.000 chamadas no Standard, e menos com volume. Uma página de busca retorna cerca de 20 tweets, então uma pergunta que gera cinco chamadas custa uma fração de centavo. O risco não é uma pergunta, e sim um assistente que pagina uma conta grande sem motivo.

Dois hábitos mantêm o custo baixo:

  • Peça um número: "os 50 tweets mais recentes" ou "as duas primeiras páginas de seguidores".
  • Para agentes que rodam sem supervisão, crie uma chave de agente (em inglês) separada com orçamento próprio, para que ele não gaste mais do que você permite.

O servidor também limita cada chave a 8 requisições simultâneas, e um erro 402 significa que o saldo acabou. O assistente mostra os dois casos como uma mensagem legível.

Passo 5: Desconecte quando terminar

Os apps conectados aparecem no painel em Connected apps, com o horário do último uso. Disconnect encerra o acesso de um app em até um minuto. Gerar uma nova API key desconecta todos os apps.

Quando um script é a melhor escolha

Um servidor MCP serve para perguntas e pesquisas pontuais. Para uma tarefa que roda toda hora, chame a API pelo código, para que o resultado seja sempre o mesmo e nenhum modelo entre no meio: veja Get an account's tweets with Python e Search Twitter/X without a developer account (em inglês). Para ser avisado sobre posts novos, use o monitoramento de contas (em inglês) em vez de pedir para um assistente verificar.

Se o seu cliente só aceita stdio, rode as mesmas ferramentas localmente com o pacote npm:

npx -y twittrapi-mcp

Problemas comuns

  • "404 Not found" ou "Couldn't determine how this server signs in": falta o /mcp na URL. Remova o conector e adicione de novo com o endereço completo.
  • O app diz que não está autorizado: ele foi desconectado ou a chave foi gerada de novo. Remova o conector e conecte outra vez.
  • O assistente responde de memória em vez de chamar uma ferramenta: diga "use as ferramentas da TwittrAPI" ou cite a conta e o período. Alguns apps exigem que você ative o conector no chat.

Perguntas frequentes

O que é um servidor MCP?

O MCP, Model Context Protocol, é um padrão aberto que permite que apps de IA chamem ferramentas externas. Um servidor MCP oferece essas ferramentas. Aqui, as ferramentas leem dados públicos do X.

Preciso de uma conta de desenvolvedor do X para o servidor MCP do Twitter?

Não. O servidor é um serviço de terceiros, com conta e chave próprias. Ele não tem afiliação com o X.

O assistente consegue publicar tweets por ele?

Sim, na sua própria conta, depois que você passa a sua sessão do X para o servidor (o cookie de um navegador logado e um proxy). O seu app pede confirmação antes de cada post. Configuração: Publique no X pelo Claude e ChatGPT.

Quanto custa uma chamada MCP?

Uma chamada de ferramenta é uma chamada de API, US$ 0,10 por 1.000 no Standard, e menos com volume. Confira o saldo no painel; o assistente não consegue gastar mais do que isso.

Quais apps funcionam com ele?

Claude.ai, Claude Desktop, ChatGPT, Claude Code, Cursor e VS Code, e qualquer cliente que suporte Streamable HTTP.

Fontes

A TwittrAPI não tem afiliação com a X Corp. Ela lê apenas dados públicos.