Saltar al contenido
Documentación

MCP & ChatGPT app

Conecta Claude, ChatGPT, Cursor o cualquier cliente MCP a las 72 herramientas de AutoPSEO para Search Console, GA4, investigación y el motor de contenido, con inicio de sesión o con una clave de API.

MCP y API5 min de lectura

AutoPSEO ejecuta un único servidor MCP (Model Context Protocol) en https://app.autopseo.com/mcp. Cualquier asistente que hable MCP sobre HTTP puede conectarse, ya sea iniciando sesión en tu cuenta de AutoPSEO o con una clave de API apk_live_, y trabaja después con las mismas propiedades, permisos y plan que tú. El servidor registra 72 herramientas en tres grupos: informes de Search Console y GA4, datos de investigación y el motor de contenido, con el que tu propia IA puede redactar artículos para tu sitio.

Conectar con inicio de sesión

Las herramientas compatibles con el inicio de sesión MCP no necesitan clave. Añade la dirección, inicia sesión en AutoPSEO cuando la herramienta te lo pida y aprueba el acceso; la herramienta conserva y renueva después su propio acceso.

  • Claude Code: ejecuta claude mcp add --transport http autopseo https://app.autopseo.com/mcp, escribe /mcp, elige autopseo y selecciona Authenticate.
  • Claude en la web o en el escritorio: Settings → Connectors → Add custom connector, pega https://app.autopseo.com/mcp, pulsa Connect e inicia sesión.
  • Cursor: añade el servidor a ~/.cursor/mcp.json (todos los proyectos) o a .cursor/mcp.json (un solo proyecto) y usa el botón Connect que Cursor muestra a su lado.
{ "mcpServers": { "autopseo": { "url": "https://app.autopseo.com/mcp" } } }

Cada herramienta conectada de este modo aparece en Signed-in tools, dentro de la página MCP & API, donde Sign out le corta el acceso al instante. Una buena primera petición es «Enumera las propiedades de Search Console de mi cuenta»: la respuesta demuestra que la conexión funciona y le da al asistente los nombres exactos de propiedad que esperan las demás herramientas.

ChatGPT

ChatGPT se conecta mediante su modo de desarrollador, y la página MCP & API lo explica paso a paso en ChatGPT app. En resumen: en ChatGPT, abre Settings → Apps & Connectors → Advanced settings y activa Developer mode (la aplicación menciona los planes ChatGPT Plus, Pro, Business, Enterprise y Edu), elige Create, ponle un nombre al conector, define la URL del servidor MCP como https://app.autopseo.com/mcp y la autenticación como OAuth, e inicia sesión en AutoPSEO cuando ChatGPT te lo pida. Los conectores de ChatGPT solo admiten OAuth o ninguna autenticación, así que las claves de API no sirven allí. Encontrarás más información en la página de ChatGPT.

Conectar con una clave de API

Las claves están pensadas para scripts, tareas programadas y máquinas sin navegador. En MCP & API → API keys, ponle nombre a la clave y elige su alcance:

  • Read only: consulta datos y ejecuta informes; no puede añadir, modificar ni eliminar nada.
  • Read & write: todo lo que hace una clave de lectura, más las herramientas que modifican datos o consumen créditos de investigación.

La clave completa, apk_live_ seguido de 32 caracteres hexadecimales, se muestra una sola vez; AutoPSEO guarda únicamente su hash SHA-256. La lista de claves indica cuándo se creó cada una, cuándo se usó por última vez y cuántas peticiones hizo, y Revoke detiene una clave de inmediato. Puedes tener hasta 25 claves activas. Envía la clave como Authorization: Bearer apk_live_... (también funciona la cabecera x-api-key):

claude mcp add --transport http autopseo https://app.autopseo.com/mcp --header "Authorization: Bearer apk_live_..."

La página también incluye fragmentos para la API Responses de OpenAI, para JSON-RPC sin procesar con curl (el servidor usa el transporte Streamable HTTP) y para la REST API en https://app.autopseo.com/v1, que ofrece las 19 herramientas de Search Console y GA4 con las mismas claves y un documento OpenAPI 3.1 en /v1/openapi.json.

Las herramientas

La página MCP & API siempre muestra los nombres de herramientas vigentes; cuando se redactó esta página eran 72.

Search Console y GA4 (19 herramientas)

list_properties, search_analytics, top_queries, top_pages, top_countries, compare_periods, content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings, url_inspection, sitemaps, annotations, create_annotation, ga4_overview, ga4_breakdown y ga4_key_events. No consumen créditos. Si no se indican fechas, abarcan los últimos 28 días consolidados frente a los 28 anteriores, y cualquiera puede probarlas con la propiedad de demostración sc-domain:demo.autopseo.app. Pese a su nombre, content_decay pertenece a este grupo: encuentra las páginas que están perdiendo clics.

Investigación (33 herramientas)

  • Cuenta y proyectos: whoami, create_project, get_project_context, update_project_context
  • Palabras clave: research_keywords, get_keyword_metrics, get_ranked_keywords, get_domain_keyword_suggestions, save_keywords, list_saved_keywords
  • Dominios, páginas de resultados y enlaces: get_domain_overview, get_serp_results, find_serp_competitors, get_backlinks_overview, get_backlinks_profile
  • Seguimiento de posiciones: create_rank_tracker, get_rank_tracker, add_rank_tracking_keywords, remove_rank_tracking_keywords, estimate_rank_tracker_cost, run_rank_tracker
  • Búsqueda local: search_local_businesses, get_local_serp_results, get_local_rank_grid, get_business_profile, get_business_reviews, get_business_updates, get_google_business_questions, list_business_categories
  • Auditorías del sitio: run_site_audit, get_audit_status, get_audit_issues, get_audit_pages

Muchas de ellas compran datos a DataForSEO y consumen tus créditos de investigación, así que mantén las peticiones acotadas y comprueba el coste antes de lanzar lotes grandes.

Motor de contenido (20 herramientas)

Permiten que tu propia IA trabaje con la misma cola que el redactor de AutoPSEO: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish, content_unpublish, content_get_page, content_report, content_find_pages, content_add_topics, content_decline, content_merge, content_cover, content_set_cover, content_get_translation, content_submit_translation, content_instructions, content_propose_value, content_submit_value y content_remove_path. El servidor ofrece además cinco prompts: write-articles, optimize-page, revise-draft, connect-repo y refresh-decayed.

Una sesión típica enumera las tareas, reclama una (la reclamación la reserva durante dos horas), lee el briefing, redacta, envía y corrige lo que señalen las comprobaciones, y publica solo cuando tú lo indicas. Las imágenes de portada y las traducciones tienen sus propias herramientas. Los artículos escritos así superan las mismas comprobaciones que los de AutoPSEO y no consumen nada de tu cuota de artículos, aunque la primera llamada a un briefing lee los resultados de búsqueda en vivo con créditos de investigación. El flujo completo está en Redactar con tu propia IA.

Herramientas de lectura, escritura y de pago

Cada herramienta tiene una clase de acceso. Las herramientas Read solo consultan (33), las herramientas write modifican tu espacio de trabajo (22) y las herramientas paid solo leen, pero compran datos de investigación (17). Una clave de solo lectura únicamente puede llamar a herramientas de lectura. Un miembro del equipo con acceso Read también se limita a las herramientas de lectura, con cualquier clave o inicio de sesión que use, y cada miembro solo accede a las propiedades que indicaba su invitación (Compartir y acceso del equipo).

Límites y errores

Las llamadas están limitadas a 60 por minuto y por clave y a 1,000 por hora y por cuenta, sumando todas sus claves. Al superar cualquiera de los dos límites, el servidor responde con HTTP 429 y una cabecera Retry-After, y la mayoría de los clientes esperan y reintentan por sí solos; los handshakes initialize y ping no cuentan. Cuando termina una prueba sin suscripción, las herramientas responden «subscription required». El proveedor de un asistente recibe tus datos solo para las peticiones que realizas; cierra la sesión de la herramienta o revoca su clave para detenerlo. Hay más ejemplos en la página de MCP para Search Console.

Pon tu contenido SEO en piloto automático

Conecta Search Console y tu sitio. AutoPSEO lo analiza y planifica los primeros temas al instante. No necesitas tarjeta de crédito.