Referencia técnica del MCP de Seobility

Esta guía está pensada para ti si formas parte del equipo técnico, llevas una agencia y si prefieres un enfoque más práctico y entender cómo funciona el MCP de Seobility por dentro: el endpoint que expone, cómo se llaman las herramientas, cómo te autenticas, cómo se cobran los créditos MCP y a qué puede acceder el servidor dentro de tu cuenta.

Si solo quieres conectar el MCP de Seobility a tu asistente de IA y empezar a hacer preguntas, consulta esta guía "Seobility MCP: conecta tu asistente de IA con tus datos de Seobility". Este artículo es la capa que hay debajo, para cuando quieras saber exactamente qué está haciendo tu cliente de IA en tu nombre.

¿Cómo funciona el MCP de Seobility?

El MCP de Seobility es un servidor único con el que tu cliente de IA se comunica a través de una sola dirección web. Cada capacidad, ya sea leer tu posicionamiento, iniciar un rastreo o ejecutar una comprobación SEO en vivo, se expone como una herramienta con nombre. Tu cliente elige una herramienta por su nombre, le pasa un conjunto de argumentos y recibe una respuesta estructurada.

En la práctica, tu cliente compatible con el MCP (Claude, Cursor, Cowork y similares) se encarga de todo esto por ti una vez conectado. Describes lo que quieres en lenguaje natural, y el cliente elige la herramienta adecuada y completa los argumentos.

Tres cosas que debes saber:

• Hay un solo endpoint. Cada herramienta se llama en la misma URL. El nombre de la herramienta y sus argumentos deciden lo que sucede, no la dirección.
• El protocolo es JSON-RPC 2.0, utilizando el método MCP tools/call. Este es un transporte MCP estándar, por lo que cualquier cliente compatible puede comunicarse con él.
• El servidor es autodescriptivo. Tu cliente puede solicitar al servidor su catálogo completo de herramientas en cualquier momento, para que siempre sepa qué herramientas están disponibles para tu clave.

El endpoint

Cada llamada a una herramienta es una solicitud JSON-RPC envuelta en la misma estructura. Tú defines el nombre de la herramienta y sus argumentos, y el resto se mantiene igual:

{

"jsonrpc": "2.0",

"id": 1,

"method": "tools/call",

"params": {

"name": "<tool-name>",

"arguments": { ... }

}

}

Este es un ejemplo de un par petición/respuesta:

La autenticación

El MCP de Seobility se autentica con tu clave personal API de Seobility. Durante la beta no hay un paso aparte de inicio de sesión ni de OAuth. La clave por sí sola identifica tu cuenta y tu plan, así que trátala como una contraseña y guárdala del lado del servidor.

Envía tu clave en un encabezado de la petición:

X-Seobility-Authorization: <your-api-key>

Si tu cliente solo admite autenticación por token bearer, puedes enviar la misma clave como un encabezado Authorization estándar:

Authorization: Bearer <your-api-key>

Usa el que admita tu cliente. Para la mayoría de configuraciones (Claude Code, Cursor y clientes similares basados en archivos de configuración), el encabezado X-Seobility-Authorization es la opción más directa, y es la que aparece en la guía de configuración.

💡 Bueno saberlo: Tu clave da acceso completo a los datos de tu cuenta y, a través de las herramientas de escritura, la posibilidad de modificarlos (por ejemplo, para añadir keywords). Puede leer y añadir, pero nunca eliminar nada de tu cuenta. Si tu clave llega a quedar expuesta, escribe a soporte en [email protected] y la restableceremos.

¿Cómo funcionan los créditos MCP?

Las solicitudes que haces a través del MCP de Seobility consumen créditos MCP. Los créditos mantienen un uso justo, de modo que ninguna cuenta pueda sobrecargar nuestras herramientas en tiempo real usándolas sin parar.

Puedes consultar tu saldo restante en cualquier momento, y las respuestas de las herramientas en directo también te lo indican, para que tu asistente lleve la cuenta mientras trabaja. Los créditos MCP vienen incluidos en tu suscripción y puedes contratar más si te hacen falta.

Durante la beta, además obtienes límites de créditos más altos para que tengas margen para explorar. Consulta la guía de configuración para ver los límites incluidos en cada plan.

¿A qué puede acceder el MCP de Seobility?

El servidor agrupa sus herramientas en módulos que reflejan las áreas principales de Seobility. A grandes rasgos, tu asistente puede trabajar con:

• Proyectos y rastreos: enumera tus proyectos, abre la configuración de cualquiera de ellos e inicia o detén un rastreo de Auditoría Web.
• Auditoría Web (a nivel de sitio): el resumen de un rastreo, sus problemas priorizados, el reparto de puntuaciones, la distribución de estados HTTP y la profundidad de clics de todo el sitio.
• Auditoría Web (a nivel de página): inspecciona una URL rastreada en detalle -> sus metaetiquetas, encabezados, enlaces internos y externos, contenido y los problemas detectados en ella.
• Rank Tracker: tus posiciones monitoreadas en Google y en las Vistas Creadas con IA de Google, a lo largo del tiempo y por país, más las subidas y bajadas, las páginas mejor posicionadas y las posiciones de tu competencia.
• Buscador de Palabras Clave (en directo): lanza búsquedas de palabras clave al momento -> sugerencias, términos relacionados y similares, preguntas, volumen de búsquedas y datos de tu competencia.
• Backlinks: tu perfil de enlaces entrantes, los enlaces nuevos, perdidos y rotos, los textos ancla, los dominios que más te enlazan y las sugerencias de link building.
• Competencia: sigue y compara el rendimiento de la competencia en rankings y backlinks, y recibe sugerencias de sitios de la competencia a los que seguir.
• Uptime Monitor: la disponibilidad, las caídas y los tiempos de respuesta del servidor de los sitios que monitoreas.
• Herramientas SEO en directo: lanza comprobaciones bajo demanda sobre cualquier URL o keyword, por ejemplo un análisis SEO de una sola página o un análisis de contenido TF*IDF, sin añadir el sitio a un proyecto.
• Informes: recupera tus informes existentes de Seobility para que tu asistente los convierta en resúmenes o los pase a otra herramienta.
• Cuenta y créditos: tus datos de cuenta, los límites de tu suscripción y el saldo de créditos MCP, además de la gestión de subcuentas.

Tu asistente de IA elige entre ellas automáticamente según lo que le pidas. Nunca llamas tú mismo a una herramienta por su nombre, a menos que quieras hacerlo.

Convenciones que vale la pena conocer

Algunos patrones se repiten en todo el servidor. Te vendrá bien conocerlos si estás depurando una llamada o creando tu propia integración:

• Los proyectos se identifican con un ID numérico. La mayoría de las herramientas necesitan un project_id para saber en cuál de tus proyectos trabajar. Tu asistente puede enumerar tus proyectos para dar con el correcto.
• Las listas largas están paginadas. Las respuestas de listado incluyen un total, un offset y un limit, y avanzan por los resultados de 100 en 100 por defecto.
• Los buscadores usan notación de dominio. Usa google.es, google.com, etcétera. Las formas cortas como google o google_de se rechazan.
• Puedes apuntar al rastreo anterior. Donde la herramienta lo admite, una opción permite ejecutarla sobre tu penúltimo rastreo completado en lugar del más reciente, algo muy útil para comparaciones de antes y después.

¿Cómo encontrar la lista completa de herramientas?

No necesitas una lista estática para saber qué tienes disponible.

Como el servidor es autodescriptivo, tu cliente siempre dispone del catálogo completo y actualizado de las herramientas a las que tu clave puede acceder, cada una con sus parámetros, a través del método tools/list de MCP.

Esta es la fuente de verdad: se obtiene en directo del servidor, así que nunca se queda desfasada. En una sesión interactiva de Claude Code, el comando /mcp muestra el servidor seobility-mcp conectado y sus herramientas; otros clientes lo enseñan en su vista de herramientas conectadas.

¿Necesitas más ayuda?

• 📩 Escríbenos cuando quieras a [email protected].
• 💬 Estás usando el MCP de Seobility en fase beta, así que tu opinión influirá en cómo va a evolucionar la herramienta. Cuéntanos qué te funciona y qué no.

Gracias por trabajar con el MCP de Seobility. 💙