Explorar la documentación

Conecta tus canales

Asistentes de IA (MCP)

Semurai tiene su propio servidor MCP, así que el asistente de IA que ya usas puede trabajar en tu espacio de trabajo de Semurai. Pide a Claude, ChatGPT, Claude Code, Cursor o VS Code una investigación de palabras clave, una auditoría del sitio o un artículo nuevo, y el resultado llega a Semurai, listo para que lo revises.

MCP (Model Context Protocol) es el estándar abierto que usan los asistentes de IA para conectarse a otras aplicaciones. Añades una dirección en tu asistente, apruebas la conexión una vez y, a partir de ahí, pides trabajo de SEO y contenidos en el mismo chat que ya usas. Tienes un resumen de lo que te aporta en la página Servidor MCP de Semurai.

Qué puedes hacer

Escribe con tus propias palabras. El asistente elige las acciones adecuadas de Semurai, trabaja en tu espacio de trabajo y te cuenta lo que ha hecho. Algunos ejemplos por área:

Investigación SEO

Investigación de palabras clave y palabras clave relacionadas, análisis de la competencia y brechas de palabras clave, quién posiciona para una búsqueda, resumen de un dominio, comprobación de posiciones en directo y clústeres temáticos. Más en Investigación de palabras clave.

  • Encuentra palabras clave long tail sobre café cold brew con baja dificultad.
  • ¿Para qué palabras clave posiciona mi competencia y nosotros no?
  • Crea un clúster temático sobre el espresso en casa.

Posiciones y Search Console

Palabras clave monitorizadas y su historial de posiciones, nuevas palabras clave para monitorizar, informes de Google Search Console (resumen, consultas principales, páginas principales, tendencias de consultas y oportunidades), auditorías de páginas, auditorías completas del sitio e informes de rendimiento.

  • ¿Cómo se han movido nuestras palabras clave monitorizadas este mes?
  • Muéstrame las consultas de Search Console con muchas impresiones y un CTR bajo.
  • Haz una auditoría SEO completa de nuestro sitio web y enumera las correcciones más importantes.

Contenidos

Busca y lee tus artículos y documentos, crea esquemas, escribe artículos SEO con marcadores de imagen, actualiza contenidos, crea documentos y borradores de correo, planifica contenidos y campañas, encuentra fechas clave de marketing y recibe sugerencias de enlaces internos.

  • Escribe un artículo SEO sobre cómo elegir un molinillo de café, basado en nuestra investigación de palabras clave.
  • Planifica un mes de contenidos para el blog de nuestra tienda.
  • Sugiere enlaces internos para el artículo sobre cafeteras espresso.

Redes sociales y calendario

Borradores de publicaciones para redes sociales (texto), la lista de tus publicaciones, el calendario de contenidos y la programación de contenidos y publicaciones.

  • Escribe tres publicaciones de LinkedIn que promocionen nuestro último artículo.
  • ¿Qué hay planificado en el calendario de contenidos la semana que viene?
  • Programa la publicación de LinkedIn sobre la mezcla de otoño para el viernes a las 9:00.

Publicación

Publica artículos en WordPress, PrestaShop o el blog de Shoper. En WordPress, el asistente también puede revisar entradas y preparar, aplicar o descartar cambios de SEO.

  • Publica el artículo sobre molinillos de café en nuestro blog de Shoper.
  • Revisa el SEO de nuestras cinco entradas más recientes de WordPress y prepara correcciones.

E-commerce

Trabaja con tus tiendas conectadas de Shoper, WooCommerce y PrestaShop: busca productos y categorías, prepara propuestas de SEO para productos, categorías y textos alternativos de imágenes, aplica las propuestas que apruebes e importa productos de Shoper. Más en Tienda.

  • Encuentra productos sin meta descripción y prepara propuestas de SEO.
  • Escribe textos alternativos para las imágenes de la categoría Molinillos.
  • Aplica en la tienda las propuestas aprobadas.

Medios y tareas

Busca en la biblioteca de medios, añade medios desde una URL, actualiza sus datos y organiza carpetas. Consulta, crea y actualiza tareas, y asigna una tarea a uno de los agentes de Semurai.

  • Mueve las fotos de producto de la semana pasada a una carpeta Campaña de primavera.
  • Crea una tarea para actualizar el artículo de precios y asígnasela a Tenko.

Conecta tu asistente

Todos los asistentes usan la misma dirección de servidor. Cópiala y sigue los pasos de tu asistente. La misma dirección y unas instrucciones breves están en la app de Semurai, en Ajustes → Asistentes de IA (MCP).

https://api.semur.ai/mcp

Claude (web y app de escritorio)

  1. En Claude, abre Customize → Connectors.
  2. Haz clic en + Add y elige Add custom connector.
  3. Escribe un nombre, por ejemplo Semurai, pega la dirección del servidor y haz clic en Continue y luego en Add.
  4. Haz clic en Connect y aprueba la conexión en la página de Semurai.

En los planes Team y Enterprise de Claude, un Owner de la organización añade el conector una sola vez en Organization settings → Connectors → Add → Custom → Web. Después, cada miembro hace clic en Connect e inicia sesión con su propia cuenta de Semurai. En el plan Free puedes añadir un conector personalizado. Lo que Claude puede hacer con Semurai, con prompts de ejemplo: Claude para SEO.

ChatGPT

  1. En ChatGPT en el navegador, abre Plugins y haz clic en +.
  2. Elige Add custom MCP server, escribe un nombre y pega la dirección del servidor.
  3. En la autenticación, elige OAuth, marca I understand and want to continue y haz clic en Create.
  4. Aprueba la conexión en la página de Semurai.

Acciones completas (escritura) en ChatGPT: planes Business, Enterprise y Edu. Con Pro, los servidores MCP personalizados se conectan en modo de solo lectura. Los servidores MCP personalizados se añaden en ChatGPT en el navegador. Casos de uso y prompts para probar en ChatGPT para SEO.

Claude Code

Ejecuta este comando en tu terminal:

claude mcp add --transport http --scope user semurai https://api.semur.ai/mcp

La opción --scope user añade Semurai a todos tus proyectos. Después inicia sesión en Semurai con claude mcp login semurai o escribe /mcp en Claude Code. Trabajo de SEO desde la terminal, con ejemplos: Claude Code para SEO.

Codex

Ejecuta este comando en tu terminal:

codex mcp add semurai --url https://api.semur.ai/mcp

Después inicia sesión en Semurai con codex mcp login semurai. También puedes añadir el servidor en ~/.codex/config.toml:

config.toml
[mcp_servers.semurai]
url = "https://api.semur.ai/mcp"

La extensión de Codex para IDE y la app de escritorio de Codex usan la misma configuración. También puedes añadir el servidor allí en Settings → MCP servers → Add server, con el tipo Streamable HTTP. Más sobre cómo trabajar con Semurai en Codex: Codex MCP.

Cursor

Añade el servidor a ~/.cursor/mcp.json para usarlo en todos tus proyectos, o a .cursor/mcp.json en un solo proyecto:

mcp.json
{
  "mcpServers": {
    "semurai": {
      "url": "https://api.semur.ai/mcp"
    }
  }
}

Inicia sesión en Semurai cuando Cursor te lo pida. Lo que puedes pedir en Cursor: Cursor MCP.

VS Code (GitHub Copilot)

En modo agente, GitHub Copilot usa los servidores de .vscode/mcp.json de tu proyecto:

.vscode/mcp.json
{
  "servers": {
    "semurai": {
      "type": "http",
      "url": "https://api.semur.ai/mcp"
    }
  }
}

Haz clic en Start encima del servidor en el archivo e inicia sesión en Semurai. Ejemplos para Copilot en modo agente: VS Code MCP.

Otros asistentes

Cualquier asistente compatible con servidores MCP remotos e inicio de sesión OAuth se conecta igual: añade https://api.semur.ai/mcp como dirección del servidor.

Gemini CLI: añade el servidor con este comando y luego inicia sesión con /mcp auth semurai en Gemini CLI.

gemini mcp add --transport http semurai https://api.semur.ai/mcp

En el archivo settings.json de Gemini CLI, la dirección va en la clave httpUrl:

settings.json
{
  "mcpServers": {
    "semurai": {
      "httpUrl": "https://api.semur.ai/mcp"
    }
  }
}

Servidor completo con gráficos de IA

La dirección de arriba es el servidor oficial, el de los directorios de aplicaciones de Claude y ChatGPT y el trabajo diario. Semurai también tiene un servidor completo: el mismo inicio de sesión y las mismas herramientas, y además gráficos de IA. Lo añades tú mismo como conector personalizado, con esta dirección:

https://api.semur.ai/mcp/full

Con el servidor completo, tu asistente también puede:

  • crear imágenes para publicaciones en redes y artículos,
  • crear diseños en Canvas,
  • crear diseños en Creative Studio,
  • trabajar con tus diseños de Creative Studio: elegir el modo, responder a las preguntas del diseñador, revisar un diseño y volver a una versión anterior o a una variante,
  • guardar gráficos para redes, carruseles y anuncios de Creative Studio en tu biblioteca de medios y añadirlos a tus publicaciones en redes,
  • proponer ideas de diseño para tu marca,
  • escribir descripciones con IA y textos alternativos para las imágenes de tu biblioteca de medios.

Añadir el servidor completo

  • Claude: en Customize → Connectors, haz clic en + Add, elige Add custom connector y pega la dirección del servidor completo.
  • ChatGPT: en Plugins, haz clic en +, elige Add custom MCP server y pega la dirección del servidor completo.
  • Cursor y VS Code: usa el mismo mcp.json de arriba, con la dirección del servidor completo.

En Claude Code, ejecuta:

claude mcp add --transport http --scope user semurai-full https://api.semur.ai/mcp/full

En Codex, ejecuta:

codex mcp add semurai-full --url https://api.semur.ai/mcp/full

Una conexión aprobada para el servidor oficial funciona con el servidor oficial. Para usar el servidor completo, añádelo como un conector aparte y aprueba la conexión en la página de Semurai. En Claude Code y Codex, inicia sesión con claude mcp login semurai-full o codex mcp login semurai-full. Los gráficos creados con el servidor completo cuentan para los límites de uso del espacio de trabajo, igual que los creados en la app.

Primera conexión y espacios de trabajo

La primera vez que conectas, el asistente abre una página de Semurai. Inicia sesión si todavía no lo has hecho y después:

  1. Comprueba el nombre de la aplicación y la dirección a la que vuelve tu navegador. Ambos aparecen en la página.
  2. Elige el Espacio de trabajo predeterminado.
  3. Haz clic en Permitir. El navegador te devuelve al asistente, listo para trabajar.

El asistente trabaja en el espacio de trabajo predeterminado. Si se lo pides, enumera tus otros espacios de trabajo, trabaja en cualquiera de ellos y cambia el predeterminado, por ejemplo: ¿Qué espacios de trabajo tengo? Cambia al espacio de trabajo de la tienda.

Los trabajos largos se ejecutan en segundo plano: escribir un artículo, una auditoría completa del sitio, un plan de contenidos, publicaciones para redes sociales o un clúster temático. El asistente sigue el progreso y te trae el resultado cuando está listo. Los borradores aparecen en la app de Semurai: en la Biblioteca, el calendario de contenidos y tus publicaciones en redes sociales.

Gestionar y desconectar

En la app de Semurai, abre Ajustes → Asistentes de IA (MCP). Ahí encontrarás:

  • las dos direcciones del servidor (oficial y completo) con botones para copiarlas e instrucciones breves para cada asistente,
  • las aplicaciones conectadas, con la fecha de conexión y el último uso de cada una,
  • el espacio de trabajo predeterminado de cada aplicación, que puedes cambiar en cualquier momento,
  • Desconectar, que corta el acceso de la aplicación al instante.

Para volver a usar un asistente desconectado, conéctalo de nuevo desde el asistente.

Seguridad y límites de uso

  • Tú confirmas lo que sale de Semurai. Publicar o programar fuera de Semurai (WordPress, el blog de PrestaShop o Shoper, las redes sociales) y aplicar cambios en una tienda o en un sitio de WordPress son acciones separadas, y el asistente te pide confirmar cada una.
  • Los cambios en la tienda empiezan como propuestas. Los cambios de SEO de productos, categorías e imágenes se crean primero como propuestas, y solo las que apruebas llegan a la tienda.
  • Se aplica tu rol. El asistente trabaja con tu rol en cada espacio de trabajo. Con el rol Lector solo puede leer la información básica del espacio de trabajo.
  • Los mismos límites de uso. Las acciones de un asistente cuentan para los mismos límites de uso que tu trabajo en la app.

Solución de problemas

  • El enlace de conexión ha caducado: la página de aprobación es válida durante 10 minutos. Vuelve a iniciar la conexión desde el asistente.
  • El asistente dice que ha perdido el acceso: conéctalo de nuevo. En Ajustes → Asistentes de IA (MCP) puedes comprobar si la aplicación se desconectó.
  • Se ha agotado el límite de uso: espera a que se renueve y vuelve a pedirlo.
  • Una herramienta dice que una integración no está conectada: conecta Google Search Console, WordPress o tu tienda en Ajustes → Integraciones y vuelve a pedirlo. Consulta Conecta tu sitio web o tienda.

Siguientes pasos

Tus agentes están listos.
Dales un objetivo.

Empieza con tu sitio web. Semurai aprende tu marca y planifica tu primera semana de contenidos.

  • Plan gratuito para siempre
  • Sin tarjeta de crédito
  • Listo en unos 3 minutos