O Claude e o ChatGPT escrevem um bom tweet, mas não conseguem publicá-lo. Você copia o texto, abre o X, cola e publica você mesmo. Com um servidor MCP que tem ferramentas de conta, o assistente publica por você, depois que você aprova no chat.

Este guia configura isso com o servidor MCP do Twitter hospedado da TwittrAPI, que nós operamos. Sem conta de desenvolvedor do X e sem nada para instalar. Se você só quer que o assistente leia o X, o guia de leitura basta.

O que o assistente consegue fazer

ÁreaFerramentas
Publicarcreate_tweet, reply_to_tweet, delete_tweet, create_draft, list_drafts
Interagirlike_tweet, retweet, bookmark_tweet, follow_user e as ferramentas para desfazer cada uma
Mensagens diretaslist_dm_conversations, send_dm, list_dm_requests, accept_dm_request, decline_dm_request
Listas e itens salvoscreate_list, add_list_member, remove_list_member, pastas de itens salvos e busca nos itens salvos
ArtigosEscrever, atualizar e publicar X Articles

Ele continua com todas as ferramentas de leitura: perfis, tweets, respostas, busca, seguidores, listas, comunidades e trends.

O que você precisa

  1. Uma conta da TwittrAPI com saldo. Crie uma pelo /start. As ferramentas de conta funcionam depois da primeira recarga; o crédito de teste grátis só cobre leituras.
  2. Sua sessão do X. O cookie de um navegador logado no x.com, com auth_token e ct0. Como copiar (em inglês) no Chrome, Edge, Firefox ou Safari.
  3. Um proxy no formato http://user:pass@host:port. As requisições ao X saem por ele. Use um da região de onde a conta costuma fazer login. Mais sobre o proxy (em inglês).

Use uma conta dedicada em vez da sua principal. O X pode limitar contas que publicam, seguem ou curtem de forma automática.

Claude.ai e ChatGPT: salve a sessão no painel

O Claude.ai, o Claude Desktop e o ChatGPT não conseguem enviar headers personalizados, então você salva a sessão uma vez no painel da TwittrAPI.

  1. Abra Connected apps no painel e clique em Add X account. Cole o cookie, informe o proxy e, se o assistente for mandar DMs, o seu passcode do X Chat. Clique em Save and check.
  2. Adicione o conector com a URL https://mcp.twittrapi.com/mcp:
    • Claude.ai e Claude Desktop: Settings > Connectors > Add custom connector.
    • ChatGPT: ative o Developer mode em Settings > Apps & Connectors > Advanced settings e depois clique em Create com autenticação OAuth.
  3. Entre na TwittrAPI. Na página de consentimento, marque Also act on my X account e clique em Allow access.

Já tinha conectado antes? Essa conexão só consegue ler. Remova o conector e adicione de novo, desta vez com a caixa marcada. Connected apps mostra quais apps podem agir na sua conta.

Tem várias contas do X? Salve todas: o Bulk import no mesmo diálogo aceita uma conta por linha (cookie | proxy | passcode), um arquivo CSV ou exportações JSON do Cookie-Editor. O assistente publica pela conta padrão, a não ser que você cite outra: "Responda pela @acme_support". O guia de contas do X (em inglês) traz os formatos e o que significa cada status.

Claude Code e Cursor: envie a sessão nos headers

Esses apps deixam você definir headers, então a sessão não precisa ficar salva em nenhum lugar além da sua própria máquina. Coloque os valores em variáveis de ambiente primeiro:

export TWITTRAPI_API_KEY="your-key"
export TWITTRAPI_X_COOKIE="auth_token=...; ct0=...; twid=u%3D..."
export TWITTRAPI_X_PROXY="http://user:pass@host:port"

Claude Code:

claude mcp add --transport http twittrapi https://mcp.twittrapi.com/mcp \
  --header "Authorization: Bearer $TWITTRAPI_API_KEY" \
  --header "X-Twitter-Cookie: $TWITTRAPI_X_COOKIE" \
  --header "X-Twitter-Proxy: $TWITTRAPI_X_PROXY"

Cursor (~/.cursor/mcp.json):

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

Para DMs, adicione X-Twitter-Chat-Passcode com o seu passcode do X Chat. O VS Code funciona do mesmo jeito; a documentação de configuração (em inglês) tem uma config que pede os valores em vez de guardá-los.

Teste

Peça com palavras simples. O assistente escolhe as ferramentas:

  • "Escreva um post curto anunciando a nossa nova página de preços e me mostre antes de publicar."
  • "Leia as respostas do meu último tweet e escreva uma resposta para cada pergunta. Publique as que eu aprovar."
  • "Curta os cinco posts mais recentes da @XDevelopers."
  • "Mostre as minhas solicitações de DM sem resposta e aceite as de pessoas que eu sigo."
  • "Salve esta thread como rascunho; vou publicar amanhã."

Antes de uma ferramenta mudar qualquer coisa, o Claude, o ChatGPT e o Cursor mostram a chamada e o texto e esperam a sua aprovação. Deixe essas confirmações ativadas e leia o texto antes de permitir.

Quanto custa

Cada chamada de ferramenta é uma chamada de API, com o mesmo preço para um post e para uma leitura: US$ 0,10 por 1.000 chamadas no Standard, e menos com volume. Um post com link custa o mesmo que um sem. Não há mensalidade pelo servidor.

Segurança

  • Quem tiver o cookie consegue usar a sua conta do X. Só coloque ele em apps e arquivos de config que você controla, e nunca faça commit dele.
  • O assistente nunca vê o cookie nem o proxy. Eles vão nas configurações da conexão, não no chat.
  • Delete em Connected apps remove uma conta salva na hora. Disconnect remove um app.
  • Se o assistente disser que a sessão pode ter sido desconectada, entre de novo no x.com e salve o cookie novo.

Perguntas frequentes

Preciso de uma conta de desenvolvedor do X?

Não. O servidor age com a sua sessão do X, não com um app de desenvolvedor do X.

Posso usar mais de uma conta do X?

Sim. Salve várias em Connected apps e cite a conta no prompt ("publique pela @nome"); sem nome, o assistente usa a sua conta padrão. Com headers, cada app envia a própria sessão.

Por que o assistente diz que não consegue publicar?

O app foi conectado sem Also act on my X account, ou não há sessão salva. Salve a sessão em Connected apps, depois remova o conector e adicione de novo com a caixa marcada. Com headers, envie tanto X-Twitter-Cookie quanto X-Twitter-Proxy.

Ele consegue publicar imagens ou enquetes?

Enquetes e tweets com citação, sim. Para imagens, vídeos e posts agendados, use as ações de conta (em inglês) da API diretamente.