Agentes y MCP
Puedes usar TweetAPI con agentes de IA para programar de dos formas: el MCP alojado, para consultar la documentación actual y acceder a la API en modo de solo lectura, y el código normal con SDK o del lado del servidor cuando el agente integra TweetAPI en tu aplicación.
Para ver la descripción del producto, los requisitos y el proceso de conexión, visita la página del servidor MCP de la API de Twitter de TweetAPI.
MCP alojado
Conecta el cliente de tu agente a:
https://mcp.tweetapi.com/mcp
El MCP alojado usa la autorización del panel. Agregar el servidor MCP solo guarda su configuración en el cliente de tu agente. Ejecuta el comando de inicio de sesión o autorización MCP del cliente para abrir TweetAPI en el navegador, elige la clave de API que va a respaldar la conexión y aprueba tweetapi:read. El cliente guarda los tokens del MCP, así que la conexión se mantiene aunque reinicies la aplicación o el equipo.
Las herramientas en vivo del MCP son de solo lectura y se limitan a los endpoints públicos para clientes. Cada llamada a una herramienta en vivo se envía a la API de TweetAPI y consume tu cuota normal.
Instalación rápida
Para Codex, ejecuta:
codex mcp add tweetapi --url https://mcp.tweetapi.com/mcp
codex mcp login tweetapi
Para Claude Code, ejecuta:
claude mcp add --transport http --scope user tweetapi https://mcp.tweetapi.com/mcp
claude mcp login tweetapi
Para Cursor, agrega esto a ~/.cursor/mcp.json:
{
"mcpServers": {
"tweetapi": {
"url": "https://mcp.tweetapi.com/mcp"
}
}
}
Ejecuta los comandos de Codex y Claude Code por separado. El comando para agregar o instalar no abre el navegador por sí solo. El comando de inicio de sesión o autorización abre TweetAPI para que inicies sesión, elijas la clave de API que va a respaldar la conexión MCP y apruebes el acceso. Cursor inicia OAuth la primera vez que se conecta al servidor remoto guardado.
Qué puedes hacer
- Buscar en la documentación actual de TweetAPI.
- Consultar los parámetros de un endpoint antes de escribir código.
- Hacer consultas de solo lectura en vivo a X/Twitter desde el chat de tu agente.
- Usar tu cuota y tu facturación normales de TweetAPI.
Requisitos
- Una cuenta de TweetAPI.
- Una clave de API de TweetAPI, elegida durante la aprobación en el panel.
- Codex, Claude Code u otro cliente de agente compatible con MCP remoto por HTTP.
Instalar en Codex
Ejecuta:
codex mcp add tweetapi --url https://mcp.tweetapi.com/mcp
codex mcp login tweetapi
Ejecútalos uno por uno. El primer comando agrega el servidor MCP. El segundo abre TweetAPI para aprobar el acceso MCP. Elige una clave de API existente o crea en el panel una clave solo para el MCP. Después de agregarlo e iniciar sesión, reinicia Codex o abre un chat nuevo. En Codex, ejecuta /mcp o pídele al modelo que liste las herramientas MCP de TweetAPI.
Si revocas la conexión en el panel o eliminas la clave de API que la respalda, borra la sesión local antigua del cliente antes de volver a conectar:
codex mcp logout tweetapi
codex mcp login tweetapi
Luego reinicia Codex por completo y abre un chat nuevo.
Instalar en Claude Code
Ejecuta:
claude mcp add --transport http --scope user tweetapi https://mcp.tweetapi.com/mcp
claude mcp login tweetapi
Ejecútalos uno por uno. El primer comando agrega el servidor MCP. El segundo abre la aprobación en el panel de TweetAPI. No subas al control de versiones archivos de configuración del agente que contengan tokens o claves de API.
Si revocas la conexión en el panel, elimina en Claude Code la autorización o sesión guardada del MCP de TweetAPI y vuelve a ejecutar claude mcp login tweetapi.
Instalar en Cursor
Agrega TweetAPI a la configuración MCP global de Cursor en ~/.cursor/mcp.json:
{
"mcpServers": {
"tweetapi": {
"url": "https://mcp.tweetapi.com/mcp"
}
}
}
Reinicia Cursor si no detecta el servidor nuevo de inmediato. Cuando Cursor se conecte, completa la aprobación OAuth de TweetAPI en tu navegador y elige la clave de API que va a respaldar la conexión.
Prueba la conexión
Después de instalar el MCP, abre un chat nuevo y pide:
Lista las herramientas MCP de TweetAPI que puedes usar. Luego busca en la documentación de
TweetAPI el endpoint de búsqueda y explica sus parámetros obligatorios. Todavía no llames a
ninguna herramienta en vivo de TweetAPI.
Para probar el acceso en vivo de solo lectura, pide:
Usa el MCP de TweetAPI para obtener el perfil público del usuario "elonmusk". Haz exactamente
una llamada a una herramienta en vivo y dime qué herramienta usaste.
Las llamadas a herramientas en vivo consumen tu cuota normal de solicitudes de TweetAPI.
Cuándo usar el MCP
Usa el MCP alojado cuando el modelo necesite revisar la documentación actual de TweetAPI, consultar los parámetros de un endpoint o hacer llamadas acotadas de solo lectura a TweetAPI durante una conversación.
Usa código de integración normal, con SDK o REST, cuando el modelo esté modificando tu aplicación. Las llamadas a TweetAPI deben ejecutarse en el servidor y leer la clave de API desde el entorno del servidor.
Prompt seguro para tu agente
Usa TweetAPI para agregar esta función a mi aplicación. Lee la clave de TweetAPI desde
TWEETAPI_API_KEY en el servidor. No pongas en el código claves de API, authToken de Twitter/X,
credenciales de proxy ni contenido de DMs. Usa las herramientas de documentación del MCP alojado
de TweetAPI antes de elegir los parámetros de los endpoints.
Ejemplo con Node.js
npm install tweetapi-node
import TweetAPI from "tweetapi-node";
const client = new TweetAPI({ apiKey: process.env.TWEETAPI_API_KEY! });
const result = await client.explore.search({
query: "tweetapi",
type: "Latest",
});
Ejemplo con Python
pip install tweetapi
import os
from tweetapi import TweetAPI
client = TweetAPI(api_key=os.environ["TWEETAPI_API_KEY"])
result = client.search.search(query="tweetapi", type="Latest")