# Servidor MCP do Twitter para Claude e Cursor Servidor MCP do Twitter para Claude e Cursor: seu agente lê posts públicos do X, threads e buscas em Markdown. Pague por post. Page: https://twitterviewer.app/pt/twitter-mcp-server Permita que Claude, Cursor e Codex leiam conteúdo público do X. Um servidor remoto, cinco ferramentas somente leitura e respostas em Markdown. Entre uma vez pelo navegador ou use uma chave de API. O TwitterViewer é um serviço independente. Não é a API oficial do X e não tem vínculo com a X Corp. Lê apenas posts públicos: não pode publicar, curtir, seguir, enviar mensagens nem ler contas privadas. ## Connect Server URL: https://twitterviewer.app/mcp (Streamable HTTP). A primeira conexão abre o navegador para você entrar no TwitterViewer. Não há mais nada para configurar. ### Claude Code ``` claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp ``` With an API key: ``` claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp \ --header "Authorization: Bearer $TWITTERVIEWER_API_KEY" ``` ### Cursor ``` { "mcpServers": { "twitterviewer": { "url": "https://twitterviewer.app/mcp" } } } ``` With an API key: ``` { "mcpServers": { "twitterviewer": { "url": "https://twitterviewer.app/mcp", "headers": { "Authorization": "Bearer ${env:TWITTERVIEWER_API_KEY}" } } } } ``` ### Codex ``` [mcp_servers.twitterviewer] url = "https://twitterviewer.app/mcp" ``` With an API key: ``` [mcp_servers.twitterviewer] url = "https://twitterviewer.app/mcp" bearer_token_env_var = "TWITTERVIEWER_API_KEY" ``` ## Tools | Tool | Arguments | What it does | | --- | --- | --- | | convert_x_url | url, scope, format, stats, max | Turns a post, thread or profile link into Markdown, Obsidian, text or JSON. | | search_x_posts | query, max | Searches public posts (Pro and Business). | | get_x_replies | url, max | Reads the replies under a post. | | get_x_trends | region | Lists trends for a region. | | get_credits | none | Shows the balance. | O Servidor MCP do Twitter oferece a um assistente de IA uma forma segura de ler o X. O TwitterViewer disponibiliza esse serviço como um servidor remoto em `https://twitterviewer.app/mcp`. Adicione-o ao Claude, Claude Code, Cursor ou Codex, e o assistente poderá transformar um link do X em Markdown, ler as respostas de um post, pesquisar posts públicos e consultar os assuntos em alta, sem que você precise copiar e colar nada. O servidor permite apenas leitura. Ele não pode publicar, responder, curtir, seguir, enviar mensagens nem acessar contas privadas, e é um serviço independente, sem vínculo com a X Corp. Este guia explica o que é um servidor MCP do Twitter, como conectá-lo em cada aplicativo, como funciona o login, o que fazem as cinco ferramentas, como os créditos são cobrados e como resolver os problemas mais comuns. ## O que é o Servidor MCP do Twitter? MCP, sigla de Model Context Protocol, é um padrão aberto que permite a um aplicativo de IA chamar ferramentas fornecidas por outro programa. Um servidor MCP do Twitter oferece ferramentas para ler o X (Twitter) por meio desse padrão. Em vez de colar uma thread na conversa, você pede ao assistente que leia um link, e ele chama a ferramenta, recebe o conteúdo em Markdown e trabalha com ele. Este servidor é remoto. Não há nada para instalar nem processo para manter em execução na sua máquina: seu aplicativo se conecta a uma URL por Streamable HTTP. É o mesmo serviço da [Twitter API](https://twitterviewer.app/pt/twitter-api), portanto usa os mesmos créditos: um crédito por post retornado, sem cobrança por chamadas que falham. Você também pode encontrá-lo com os nomes servidor MCP do X ou Twitter MCP. Todos se referem à mesma coisa: um servidor de ferramentas que permite a um agente ler posts públicos. O que muda entre os servidores é o que eles podem fazer. Este foi feito para ler apenas conteúdo público. ## O que um servidor MCP do Twitter pode fazer pelo seu agente? Depois de conectado, um agente pode realizar quatro tipos de trabalho com o conteúdo do X: - **Ler um link.** Envie o endereço de um post, uma thread ou um perfil, e ele retorna Markdown, notas para o Obsidian, texto simples ou JSON. - **Pesquisar.** Peça para encontrar posts públicos usando operadores de busca do X, como todos os posts de uma conta que receberam pelo menos 100 curtidas. A busca faz parte dos planos Pro e Business. - **Ler respostas.** Pergunte o que as pessoas estão respondendo a um post e quais objeções se repetem. - **Consultar assuntos em alta.** Liste os assuntos em alta em uma região. Como as respostas chegam em Markdown, elas consomem pouco espaço no contexto do modelo e preservam a estrutura do original: a ordem dos posts na thread, os links compartilhados pelo autor e as referências às imagens. O agente recebe um documento, sem precisar extrair dados de uma página e tentar interpretar sua estrutura. ## Conecte o servidor MCP do Twitter A URL do servidor é `https://twitterviewer.app/mcp`. Escolha seu aplicativo abaixo. Todos os exemplos usam login pelo navegador, que é a forma mais simples de conectar. ### Claude Code Execute um comando no terminal: ```bash claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp ``` Inicie o Claude Code, execute `/mcp` para ver o servidor e acesse o link de login na primeira conexão. Depois, peça em linguagem natural: "Leia https://x.com/username/status/1234567890123456789 em Markdown." ### Claude No Claude pela web ou pelo aplicativo para computador, abra Configurações, acesse Conectores, escolha Adicionar conector personalizado e cole a URL do servidor. O Claude abre uma janela do navegador para você entrar no TwitterViewer. As ferramentas passam a aparecer nas suas conversas. ### Cursor Adicione o servidor ao seu `mcp.json`: ```json { "mcpServers": { "twitterviewer": { "url": "https://twitterviewer.app/mcp" } } } ``` Abra as configurações de MCP do Cursor, ative o servidor e entre na sua conta quando solicitado. ### Codex Adicione o servidor ao arquivo de configuração do Codex: ```toml [mcp_servers.twitterviewer] url = "https://twitterviewer.app/mcp" ``` Reinicie o Codex, e ele listará as cinco ferramentas. ## Entre pelo navegador ou com uma chave de API Há duas formas de autorizar o servidor MCP do Twitter, e você pode escolher uma para cada aplicativo. **O login pelo navegador** é a opção padrão. Na primeira conexão, o aplicativo abre seu navegador para você entrar no TwitterViewer e aprovar a conexão. Não é preciso configurar mais nada nem copiar credenciais secretas. **Uma chave de API** serve para ambientes sem navegador: servidores, tarefas de CI e alguns editores. Crie uma chave na página da API, exporte-a como `TWITTERVIEWER_API_KEY` e envie-a como token Bearer. No Claude Code, adicione `--header "Authorization: Bearer $TWITTERVIEWER_API_KEY"` ao comando. No Cursor, adicione uma entrada `headers` com o mesmo valor. No Codex, adicione `bearer_token_env_var = "TWITTERVIEWER_API_KEY"` abaixo da URL. Em ambos os casos, as chamadas são cobradas da conta usada para entrar. Não coloque chaves em arquivos compartilhados nem em repositórios e, se uma chave vazar, exclua-a na página da API. Toda conta pode ter pelo menos uma chave: 1 na conta gratuita, 2 no Plus, 5 no Pro e 20 no Business. ## As cinco ferramentas Todas permitem apenas leitura e aparecem para o agente com estes nomes. | Ferramenta | O que faz | Custo | | --- | --- | --- | | `convert_x_url` | Transforma um link de post, thread ou perfil em Markdown, Obsidian, texto ou JSON | 1 crédito por post | | `search_x_posts` | Pesquisa posts públicos com operadores de busca do X (Pro e Business) | 1 crédito por post | | `get_x_replies` | Lê as respostas públicas de um post | 1 crédito por resposta | | `get_x_trends` | Lista os assuntos em alta em uma região | 1 crédito por chamada | | `get_credits` | Mostra seu saldo e a origem dos créditos | Grátis | `convert_x_url` recebe o link, um escopo (`post`, `thread` ou `conversation`), um formato e, para perfis, a quantidade de posts a retornar. É a ferramenta mais usada pelos agentes. `search_x_posts` recebe uma consulta e um número máximo de posts e exige uma conta do X conectada, pois o X só disponibiliza a busca para usuários conectados. A lista completa de argumentos está na [Documentação da API](https://twitterviewer.app/docs/api). ## O que pedir ao seu agente Um servidor de ferramentas só é útil quando você sabe o que pedir. Estas instruções funcionam bem depois que o servidor está conectado: - "Leia esta thread e me dê os cinco pontos principais: https://x.com/username/status/1234567890123456789" - "Pesquise no X posts da última semana sobre nosso lançamento e agrupe-os por tema." - "O que as pessoas estão respondendo a este post? Mostre as objeções que se repetem." - "Converta esta thread para Markdown do Obsidian e salve como uma nota." - "Quais são os assuntos em alta no Japão agora?" - "Quantos créditos do TwitterViewer ainda tenho?" Os agentes podem combinar as ferramentas. Uma tarefa de pesquisa pode buscar posts, converter as três threads mais relevantes, ler as respostas de uma delas e depois escrever um resumo. Cada etapa é uma chamada de ferramenta separada, cobrada pelos posts que retorna, e você pode conferir o custo em `get_credits` depois. Se você só precisa converter uma thread uma única vez, a página [X para Markdown](https://twitterviewer.app/pt/x-to-markdown) faz o mesmo trabalho no navegador, e o [Leitor de threads do Twitter](https://twitterviewer.app/pt/twitter-thread-reader) mostra uma thread em uma só página. O servidor MCP é para agentes que precisam fazer isso por conta própria. ## Fluxos de trabalho com o servidor MCP do Twitter Perguntas isoladas são simples. O servidor mostra seu valor quando um agente encadeia as ferramentas em um pequeno fluxo de trabalho. Três usos são especialmente comuns. **Triagem de uma lista de leitura.** Você cola dez links do X em uma conversa e pergunta quais valem a leitura. O agente chama `convert_x_url` para cada um, com `scope` definido como `thread` e `stats` desativado para manter o texto curto, e depois os classifica pelo que cada um acrescenta. Nove dos dez links podem conter apenas um post, então o custo costuma ficar próximo de dez créditos. **Pesquisa sobre um tema.** Você pede ao agente que descubra o que as pessoas pensam sobre um produto. Ele usa `search_x_posts` com alguns operadores, converte as duas ou três melhores threads, lê as respostas do post mais discutido com `get_x_replies` e escreve um relatório curto com links para as fontes. O custo em créditos corresponde à quantidade de posts que ele realmente leu, exibida depois por `get_credits`. **Registro de notas.** Você pede uma thread como nota do Obsidian. O agente chama `convert_x_url` com o formato `obsidian`, que adiciona um frontmatter com autor, data e link da fonte, e grava o arquivo no seu cofre. É a mesma saída da página [X para Markdown](https://twitterviewer.app/pt/x-to-markdown), produzida sem sair da conversa. Dois hábitos ajudam a manter o custo desses fluxos baixo. Peça uma thread em vez de um perfil, a menos que realmente precise dos posts recentes, pois um perfil com 200 posts custa 200 créditos. E diga ao agente para parar e perguntar antes de converter mais do que algumas threads longas, para você manter o controle do saldo. ## Créditos e limites Os créditos funcionam como na API REST. Um crédito corresponde a um post retornado. Os dados do autor são gratuitos. Não há cobrança por chamadas que falham, resultados vazios ou PDFs que não puderam ser renderizados. Uma conta gratuita recebe 50 créditos uma única vez, os planos pagos adicionam 3.000, 8.000 ou 25.000 créditos por mês, e os pacotes de 1.000, 6.000 e 20.000 créditos custam US$ 5, US$ 20 e US$ 50 e nunca expiram. Consulte os planos em [Preços](https://twitterviewer.app/pt/pricing). As chamadas têm um limite por conta, por minuto: 10 na conta gratuita, 30 no Plus, 60 no Pro e 300 no Business. Se o agente executar chamadas em um ciclo, esse limite também protege seu saldo. Quando os créditos acabam, a ferramenta não falha com um rastreamento de erro: ela responde com uma linha e um link para a página de preços, que o agente pode repassar a você. Os dados têm as mesmas limitações da API. Só há acesso a posts públicos, portanto contas privadas, posts protegidos, mensagens diretas, posts excluídos e contas suspensas não retornam conteúdo útil. O conteúdo fica em cache por pouco tempo, cerca de dois minutos para um post, então uma edição muito recente pode ainda não aparecer. ## Somente leitura desde a concepção Muita gente se preocupa em dar a um agente acesso a uma conta de rede social, e com razão: um agente com permissão de escrita pode publicar por engano. Este servidor MCP do Twitter evita esse problema. Ele não tem ferramentas para publicar, responder, curtir, repostar, seguir, bloquear ou enviar mensagens, e nunca pede sua senha nem seus tokens do X. O máximo que um agente confuso pode fazer é gastar créditos com leitura, e o limite de chamadas e o saldo disponível restringem esse gasto. A busca é o único recurso que usa uma conta do X, pois o X só mostra resultados de busca para usuários conectados. Ela usa a conta do X que você mesmo conecta em um plano Pro ou Business, apenas para solicitações feitas por você ou pelo seu agente, e você pode desconectá-la a qualquer momento. ## Servidor MCP do Twitter, API, CLI ou troca de domínio: qual usar? As quatro formas de acesso compartilham o mesmo saldo, então escolha conforme o ambiente em que você trabalha. - **Servidor MCP:** ideal quando um assistente como Claude, Cursor ou Codex deve decidir quando ler o X. Sem código e sem copiar e colar. - **API REST:** ideal para scripts, fluxos de processamento e aplicativos que você desenvolve. Consulte a página [Twitter API](https://twitterviewer.app/pt/twitter-api). - **Ferramenta de linha de comando:** `npx twitterviewer ` para uma conversão rápida no terminal ou em um script de shell. - **Troca de domínio:** substitua `x.com` por `twitterviewer.app` em um link e envie sua chave; a resposta vem em Markdown. Uma habilidade para agentes em `/.well-known/agent-skills/twitterviewer/SKILL.md` pode ensinar o agente a escolher entre essas opções ao encontrar um link do X. ## Solução de problemas do servidor MCP do Twitter Se o servidor não conectar, confira estes pontos primeiro. - **O aplicativo diz que não consegue acessar o servidor.** Confirme que a URL é exatamente `https://twitterviewer.app/mcp`. Aplicativos que só aceitam servidores locais precisam de uma ponte; Claude Code, Claude, Cursor e Codex se conectam diretamente a servidores remotos. - **O login pelo navegador fica se repetindo.** Conclua o login no mesmo perfil de navegador aberto pelo aplicativo e confirme que você entrou na conta da qual deseja descontar os créditos. - **Uma ferramenta informa que os créditos acabaram.** Consulte `get_credits` e depois compre um pacote na página de preços ou aguarde a renovação dos créditos mensais. - **A busca é recusada.** A busca exige Pro ou Business e uma conta do X conectada. Conecte-a na página Conta do X das suas configurações. - **Um link não retorna nada.** O post pode ter sido excluído ou estar protegido, ou a conta pode estar suspensa. Abra o link em [Ver perfil do Twitter](https://twitterviewer.app/pt/twitter-profile-viewer) para conferir o que está público. - **Aparece uma mensagem de limite de chamadas.** Aguarde a quantidade de segundos indicada ou mude para um plano com um limite maior por minuto. ## Perguntas frequentes sobre o Servidor MCP do Twitter ### O que é um servidor MCP do Twitter? Um servidor MCP do Twitter permite que um assistente de IA leia o X por meio do Model Context Protocol. A versão do TwitterViewer é remota, permite apenas leitura e retorna Markdown, para que um agente possa ler uma thread, pesquisar posts, ler respostas e consultar assuntos em alta dentro do Claude, Cursor ou Codex. ### Este é um servidor MCP oficial do X? Não. É um serviço independente, sem vínculo com a X Corp. Ele lê apenas posts públicos e não pode publicar, curtir, seguir nem enviar mensagens. ### Como adiciono o servidor MCP do Twitter ao Claude Code? Execute `claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp`, depois abra `/mcp` dentro do Claude Code e entre pelo navegador na primeira conexão. Em seguida, peça ao assistente que leia um link do X. ### Funciona com Cursor e Codex? Sim. No Cursor, adicione a URL em `mcpServers` no `mcp.json`. No Codex, adicione um bloco `[mcp_servers.twitterviewer]` com a URL. Ambos permitem entrar pelo navegador ou usar uma chave de API como token Bearer. ### Preciso de uma chave de API? Não. O login pelo navegador funciona sem chave. Uma chave é útil em ambientes sem navegador, como servidores e CI, e você pode criar uma na página da API. ### O que as ferramentas podem fazer? São cinco: `convert_x_url`, `search_x_posts`, `get_x_replies`, `get_x_trends` e `get_credits`. Todas permitem apenas leitura. Elas convertem links, pesquisam posts públicos, leem respostas, listam assuntos em alta e mostram seu saldo. ### Quanto custa usar? O serviço usa os mesmos créditos da API: um crédito por post retornado, sem cobrança pelos dados do autor nem por chamadas que falham. Uma conta gratuita recebe 50 créditos uma única vez, e os planos adicionam 3.000, 8.000 ou 25.000 créditos por mês. Os pacotes de créditos custam US$ 5, US$ 20 e US$ 50 e nunca expiram. ### O agente pode publicar ou curtir por mim? Não. O servidor não tem ferramentas que escrevam no X. Ele não pode publicar, responder, curtir, repostar, seguir nem enviar mensagens, e nunca pede sua senha do X. ### Por que a busca exige Pro ou Business? O X só mostra resultados de busca para usuários conectados, então a busca precisa de uma conta do X. Ela faz parte dos planos Pro e Business e usa a conta que você mesmo conecta. ### Posso usar o servidor MCP do Twitter para contas privadas? Não. Apenas conteúdo público está disponível. Contas privadas, posts protegidos, mensagens diretas e posts excluídos não são retornados.