Guía · MCP para desarrolladores
Rastrea tu visibilidad en IA desde Claude Code y Codex
Un solo comando de terminal conecta tu agente de código con Howseen. Luego pregúntale, en lenguaje sencillo, qué preguntas de compra responde ChatGPT, Gemini, Perplexity y Google AI con un competidor en lugar de contigo, y qué debes corregir primero.
Claude Code
Codex
Por Raphaël Aubry, fundador de Howseen AI · Actualizado el Respuesta breve
¿Cómo rastreo la visibilidad en IA desde Claude Code o Codex?
Crea una clave API de Howseen, añade el servidor MCP de Howseen con un solo comando y pregúntale a tu agente qué preguntas de compra mencionan a un competidor en lugar de a ti.
El servidor MCP de Howseen está disponible en https://app.howseen.ai/api/mcp y utiliza Streamable HTTP, así que ambos agentes se conectan a él como a cualquier servidor remoto. Ofrece a tu agente 26 herramientas sobre tus datos de Howseen: el mismo porcentaje de visibilidad, competidores y fuentes citadas que ves en tu panel, solo para tus propias marcas. Las herramientas de lectura funcionan con cualquier clave; las herramientas de acción solo se ejecutan después de una vista previa y tu confirmación.
"MCP (Model Context Protocol) es un estándar de código abierto para conectar aplicaciones de IA con sistemas externos."
Por qué la terminal
Por qué los desarrolladores y las agencias quieren estos datos junto a su código
La persona que puede corregir una brecha de visibilidad (una página, una tabla comparativa, una sección de documentación) suele trabajar en el repositorio. Poner la brecha en la misma terminal elimina el ir y venir al panel.
- De la brecha al pull request. Pregunta qué pregunta estás perdiendo y luego pídele al mismo agente que escriba o actualice la página que la responde, directamente en tu propio código.
- Agencias, una sola clave para cada cliente. La herramienta
list_brandsdevuelve todas las marcas de tu cuenta de Howseen, para que puedas revisar a todos los clientes en una sola sesión. Consulta GEO para agencias. - Datos reales, no suposiciones. Tu agente lee las respuestas que Howseen realmente recopiló de ChatGPT, Gemini, Perplexity, Google AI Overviews y Google AI Mode, en lugar de adivinar lo que la IA dice sobre ti.
Si el concepto de visibilidad en IA es nuevo para ti, lee primero qué es el GEO (generative engine optimization) y cómo elige la IA qué marcas recomendar.
Ejemplo real
Cómo se ve con nuestra propia marca
El 6 de octubre de 2026, le preguntamos a Claude, conectado a través del servidor MCP de Howseen, sobre el propio Howseen, usando nuestro escaneo del 5 de octubre. La respuesta no fue halagadora, y ese es precisamente el objetivo.
Preguntas de compra en las que se mencionó a un competidor y no a nosotros
90%
45 de 50 preguntas rastreadas
Visibilidad de Howseen
4%
Escaneo del 5 de octubre de 2026
Respuestas perdidas que citan la página n.º 1
19
Un artículo de "mejores herramientas de visibilidad en IA" en Zapier
Lo útil es el último dato. La página que la IA citó con más frecuencia en las respuestas que perdimos fue un artículo de lista de terceros, así que la primera solución es aparecer ahí, no reescribir nuestra página de inicio. Los distintos motores confían en fuentes distintas: nuestro estudio de 5.331 respuestas de IA encontró que YouTube se citaba en el 45 % de los Google AI Overviews y en 0 de 1.164 respuestas de ChatGPT. Para ver cómo se comparan las herramientas en este tipo de datos, consulta herramientas de visibilidad en IA.
Configuración 1
Conecta Claude Code
Un solo comando claude mcp add registra el servidor de Howseen para tu cuenta de usuario, de modo que esté disponible en todos tus proyectos. Luego escribe /mcp dentro de Claude Code para comprobar que está conectado.
- Crea una clave. En Howseen, abre Configuración > "API & AI assistants" (app.howseen.ai/settings?tab=api). La clave empieza por
hs_live_y se muestra una sola vez, así que cópiala de inmediato. - Ejecuta esto en tu terminal, con tu clave en lugar de
hs_live_YOUR_KEY:
claude mcp add --scope user --transport http howseen https://app.howseen.ai/api/mcp \
--header "Authorization: Bearer hs_live_YOUR_KEY"- Compruébalo. Inicia Claude Code y escribe
/mcp. El servidorhowseendebería aparecer como conectado. Ejecutamos este mismo comando el 6 de octubre de 2026 y obtuvimos "Connected".
Por qué --scope user: según la documentación de Anthropic, este ámbito guarda el servidor en ~/.claude.json y lo hace disponible en todos tus proyectos, manteniéndolo privado para tu cuenta de usuario. El ámbito de proyecto, en cambio, está pensado para compartirse mediante control de versiones, lo cual no es el lugar adecuado para una clave. Fuente: Connect Claude Code to tools via MCP.
Configuración 2
Conecta Codex
Codex lee el token de autenticación desde una variable de entorno, así que tu clave no queda en el archivo de configuración de Codex. Exporta la clave y luego ejecuta codex mcp add una sola vez.
export HOWSEEN_API_KEY=hs_live_YOUR_KEY
codex mcp add howseen --url https://app.howseen.ai/api/mcp --bearer-token-env-var HOWSEEN_API_KEYAñade la línea export a tu perfil de shell (por ejemplo ~/.zshrc o ~/.bashrc) para que la clave siga disponible en tu próxima sesión de terminal. Para comprobar la configuración, ejecuta codex mcp list, o escribe /mcp dentro de Codex.
¿Prefieres editar el archivo directamente? El mismo servidor en ~/.codex/config.toml:
[mcp_servers.howseen]
url = "https://app.howseen.ai/api/mcp"
bearer_token_env_var = "HOWSEEN_API_KEY"Las opciones --url y --bearer-token-env-var, así como las claves url y bearer_token_env_var, provienen de la documentación de Codex de OpenAI: Model Context Protocol (MCP) for Codex.
Qué preguntar
7 prompts que funcionan
No necesitas conocer los nombres de las herramientas. Pregunta en lenguaje natural y tu agente elegirá la herramienta de Howseen adecuada por su cuenta. Aquí tienes siete que funcionan bien.
| Tú preguntas | Herramienta detrás |
|---|---|
| "¿Qué preguntas de compra mencionan a un competidor y no a nosotros?" | get_prompt_gaps |
| "¿En qué sitios deberíamos aparecer primero?" | get_easiest_wins |
| "¿Qué cambió desde nuestro último escaneo, motor por motor?" | get_changes |
| "¿Quiénes son ahora mismo nuestros principales competidores en las respuestas de IA?" | get_competitors |
| "Muéstrame lo que dice realmente ChatGPT cuando menciona a un rival." | search_responses |
| "Redacta el artículo que nos permita recuperar nuestra mayor brecha." | draft_article (clave con acciones, con vista previa primero) |
| "Dame el resumen de esta semana." | prompt weekly_review |
Las agencias también pueden usar el prompt client_report (visibilidad, competidores y un enlace para compartir) para cada marca de cliente. La lista completa de las 26 herramientas está en la página de MCP de Howseen.
Permisos
Solo lectura por defecto, las acciones solo ocurren tras tu confirmación
Una clave estándar solo lee. Para permitir que tu agente cambie algo, crea una clave con acciones habilitadas; aun así, cada cambio se muestra primero como vista previa y solo se aplica después de tu confirmación.
| Clave | Qué puede hacer tu agente |
|---|---|
| Solo lectura (por defecto) | Visibilidad, brechas, competidores, fuentes citadas, extractos de respuestas reales, artículos, uso, marcas |
| Con acciones | Seguir o archivar preguntas, añadir o quitar competidores, actualizar el plan de acción, redactar un artículo, ejecutar un escaneo, crear un enlace de informe para clientes, publicar un artículo y solicitar su indexación, cada una con vista previa antes de confirmarse |
Los límites de tu plan se aplican igual que en la app, y cada cambio aplicado queda registrado en Configuración, en “Acciones realizadas por tu IA”.
Seguridad
Mantén tu clave fuera de tu repositorio
Trata una clave de Howseen como una contraseña. Guárdala en una variable de entorno o en tu configuración de usuario, nunca en un archivo con control de versiones, y revócala en Configuración en cuanto se filtre.
- Nunca la subas al repositorio. No pegues la clave en un
.mcp.jsondel proyecto, en un README ni en un script que vaya a Git. Con Claude Code, usa--scope user; con Codex, usa--bearer-token-env-var. - Cuidado con tus dotfiles. Si sincronizas
~/.zshrco~/.claude.jsoncon un repositorio público, mueve la clave a un archivo que no se sincronice. - Evita la variante por URL aquí. La opción
?key=existe para clientes que no pueden enviar headers. Claude Code y Codex sí pueden, así que usa el header o la variable de entorno. - Revócala con un clic. Cada clave se puede revocar en cualquier momento en Configuración > "API y asistentes de IA". Howseen solo guarda un hash de tu clave, nunca la clave en sí.
- Límites de uso. 120 solicitudes por minuto y 5.000 por día, por clave.
Automatización
Úsala en CI o scripts
Para una tarea nocturna, una verificación de CI o un panel para clientes, omite el agente y llama directamente a la API REST de solo lectura, con la misma clave y los mismos datos.
La API REST devuelve JSON con filtros de rango de fechas, motor y paginación. Guarda la clave como secreto de CI, nunca en el archivo del workflow. Los endpoints y un ejemplo con curl están en la sección de API REST de la página de MCP.
Precios
Cuánto cuesta
El servidor MCP está incluido en Pro (79€ por sitio al mes) y Business, y durante la prueba gratuita de 3 días, consulta los precios para marcas.
¿Aún no estás listo para la prueba? Obtén primero un informe de IA gratuito: sin tarjeta, en unos 2 minutos.
Preguntas respondidas
¿Puedo usar el servidor MCP de Howseen con Claude Code y con Codex?+
Sí. El servidor es un servidor MCP remoto estándar sobre Streamable HTTP en https://app.howseen.ai/api/mcp. Claude Code se conecta con un solo comando claude mcp add y Codex con un solo comando codex mcp add, y puedes usar la misma clave en ambos.
¿Cómo compruebo que Claude Code está conectado a Howseen?+
Escribe /mcp dentro de Claude Code. Muestra tus servidores MCP configurados y su estado de conexión, y el servidor howseen debería aparecer como conectado. Con Codex, ejecuta codex mcp list o escribe /mcp en Codex.
¿Dónde guarda Codex mi clave de Howseen?+
En ningún sitio, si sigues esta guía. La configuración solo nombra la variable de entorno (bearer_token_env_var = "HOWSEEN_API_KEY"), y Codex lee la clave desde esa variable. Mantén la línea export en tu perfil de shell para que la variable exista en cada sesión.
¿Puede mi agente de código cambiar mi cuenta de Howseen?+
Solo con una clave que tenga las acciones habilitadas. Por defecto, las claves son de solo lectura. Con las acciones habilitadas, cada cambio (seguir preguntas, redactar o publicar un artículo, ejecutar un escaneo) llega primero como vista previa y solo se aplica tras tu confirmación.
¿Qué pasa si mi clave se filtra?+
Revócala en Howseen, en Configuración > "API y asistentes de IA" y crea una nueva. Howseen solo guarda un hash de tu clave, la muestra una única vez, y cada clave solo ve las marcas de la cuenta que la creó.
¿Hay límites de uso?+
Sí: 120 solicitudes por minuto y 5.000 por día, por clave. El uso normal desde un agente queda muy por debajo de esos límites.
¿Pueden las agencias seguir varias marcas de clientes desde una sola terminal?+
Sí. La herramienta list_brands devuelve todas las marcas que sigues en tu cuenta de Howseen, así que una sola clave cubre a todos tus clientes, y el prompt client_report genera un informe con un enlace para compartir por cada marca. También puedes crear una clave limitada a una sola marca.
¿Qué planes lo incluyen?+
El servidor MCP y la API REST están incluidos en el plan Pro (79 euros por sitio al mes) y Business (desde 219 euros), y durante la prueba gratuita de 3 días. Si solo quieres un primer vistazo, el informe gratuito de IA no necesita tarjeta y tarda unos 2 minutos.
Pregúntale a tu agente a quién recomienda la IA en lugar de a ti
Inicia la prueba gratuita de 3 días, crea tu clave, ejecuta un comando y haz tu primera pregunta en Claude Code o Codex. Toda la configuración toma un par de minutos.
