Guía de ayuda

Conecta un asistente de IA a tu sitio

Deja que tu propio asistente de IA lea tu sitio y cree borradores de cambios en páginas y artículos del blog. Solo puede crear borradores: nada se publica hasta que alguien de tu equipo hace clic en Publicar. La configuración toma unos 10 minutos.

  • Premium y Ultra
  • Dueños de la cuenta
  • Unos 10 minutos

Antes de empezar

Necesitarás

  • Un sitio de WorkspaceCMS con el plan Premium o Ultra.
  • Ser el dueño de la cuenta. Solo los dueños ven la tarjeta Developer API.
  • Una herramienta de IA que pueda agregar un servidor MCP personalizado: la app de Claude, ChatGPT (planes de pago, con modo de desarrollador), Claude Code, Cursor, VS Code con GitHub Copilot u otro cliente MCP.

¿Usas la app de Claude o ChatGPT?

Esas apps inician sesión en lugar de usar una clave, así que no necesitas crear una. Si nadie ha aceptado todavía los términos de la API para desarrolladores, hazlo una vez primero: en Configuración, haz clic en + Generar clave de API y acéptalos. Luego copia la dirección de tu servidor desde la tarjeta Conecta un asistente de IA y sigue los pasos de la app en el paso 2.

Crea una clave que pueda crear borradores

La clave es la forma en que tu asistente demuestra que tiene permiso para entrar. Trátala como una contraseña.

  1. Inicia sesión en WorkspaceCMS y abre Configuración. Desplázate hasta la tarjeta Developer API.
  2. Haz clic en + Generar clave de API.
  3. La primera vez, un cuadro te pide Aceptar los términos de la API para desarrolladores. Lee los términos, marca la casilla, escribe tu nombre legal completo y haz clic en Aceptar y continuar. Solo lo haces una vez.
  4. Ponle a la clave el nombre de la herramienta que conectas, como Claude o Cursor. Agrega una fecha de vencimiento si quieres.
  5. Marca Deja que los asistentes de IA redacten cambios. Sin eso la clave solo puede leer, y el asistente no puede crear ningún borrador.
  6. Haz clic en Generar clave. Copia la clave ahora y guárdala en un lugar seguro. Se muestra una sola vez. Luego haz clic en Listo, la guardé.
  7. Debajo de la lista de claves, busca la tarjeta Conecta un asistente de IA y haz clic en el botón de copiar junto a la dirección del servidor. Se ve así: https://app.workspacecms.ai/api/mcp/your-site, con tu propio sitio en lugar de your-site.

Agrégala a tu asistente

Elige tu herramienta abajo. En cada ejemplo, reemplaza https://app.workspacecms.ai/api/mcp/your-site con la dirección del servidor que copiaste. En las herramientas que usan una clave, reemplaza YOUR_API_KEY con tu clave, y siempre deja la palabra Bearer y el espacio que le sigue delante de la clave.

App de Claude (claude.ai, escritorio y móvil)

  1. Abre Configuración, luego Conectores, y haz clic en Agregar conector personalizado.
  2. Llámalo WorkspaceCMS, pega la dirección de tu servidor y haz clic en Agregar.
  3. Haz clic en Conectar. Inicia sesión en WorkspaceCMS si te lo pide, revisa la solicitud y haz clic en Permitir.

No se necesita clave. Al aprobar se crea una para la app, que aparece en tu lista de claves como (con sesión iniciada). Solo un dueño de la cuenta puede hacer clic en Permitir.

ChatGPT

Los conectores personalizados requieren el modo de desarrollador, disponible en los planes de pago de ChatGPT.

  1. Abre Configuración, luego Apps y conectores. En Avanzado, activa el modo de desarrollador.
  2. Crea un conector llamado WorkspaceCMS, pega la dirección de tu servidor y elige OAuth para iniciar sesión.
  3. Conéctalo. Inicia sesión en WorkspaceCMS si te lo pide, revisa la solicitud y haz clic en Permitir.

Igual que la app de Claude, ChatGPT recibe su propia clave, que aparece como (con sesión iniciada).

App de escritorio de Claude, usando su archivo de configuración

El conector de arriba es la forma fácil. Si prefieres usar una clave, esto funciona en todos los planes de Claude y requiere tener Node.js instalado. En la app de escritorio abre Configuración, luego Developer y luego Edit Config. Agrega esto al archivo, guárdalo y reinicia Claude.

claude_desktop_config.json
{
  "mcpServers": {
    "workspacecms": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.workspacecms.ai/api/mcp/your-site",
        "--header",
        "Authorization:${WCMS_AUTH}"
      ],
      "env": {
        "WCMS_AUTH": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Deja ${WCMS_AUTH} exactamente como está escrito. La clave va solo en la sección env.

Claude Code

Ejecuta esto una vez en tu terminal:

claude mcp add --transport http workspacecms https://app.workspacecms.ai/api/mcp/your-site \
  --header "Authorization: Bearer YOUR_API_KEY"

Ejecuta /mcp dentro de Claude Code para verificar que aparezca como conectado.

Cursor

Abre Cursor Settings, ve a la sección MCP y agrega un servidor MCP nuevo. Eso abre mcp.json (el archivo global es ~/.cursor/mcp.json). Agrega:

mcp.json
{
  "mcpServers": {
    "workspacecms": {
      "url": "https://app.workspacecms.ai/api/mcp/your-site",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Guarda el archivo. WorkspaceCMS muestra un punto verde en la lista de MCP cuando se conecta.

VS Code (modo agente de GitHub Copilot)

Crea .vscode/mcp.json en tu proyecto. Esta versión pide la clave al iniciar, así que la clave nunca se guarda en el archivo:

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "wcms-key",
      "description": "WorkspaceCMS API key",
      "password": true
    }
  ],
  "servers": {
    "workspacecms": {
      "type": "http",
      "url": "https://app.workspacecms.ai/api/mcp/your-site",
      "headers": {
        "Authorization": "Bearer ${input:wcms-key}"
      }
    }
  }
}

Haz clic en Start encima de la entrada del servidor y pega tu clave cuando te la pida.

Cualquier otro cliente MCP

El servidor habla MCP sobre Streamable HTTP con respuestas JSON, sin sesión y sin flujo de eventos. Envía cada mensaje JSON-RPC como un POST a la dirección del servidor con el encabezado Authorization: Bearer YOUR_API_KEY. Admite initialize, ping, tools/list y tools/call. La referencia completa está en la Especificación OpenAPI.

Pide un cambio

Habla con tu asistente con normalidad. Por ejemplo:

  1. “Agrega una frase a mi página Nosotros diciendo que ahora pintamos oficinas.”
  2. “Escribe un borrador de artículo del blog con consejos de limpieza de primavera.”
  3. “Haz una lista de mis artículos del blog y sugiere mejores títulos para los tres más antiguos.”

La primera vez que use WorkspaceCMS, tu asistente puede pedir permiso para ejecutar una herramienta. Permítelo.

Revisa y publica

  1. Recibes una notificación en la campana del panel cuando el asistente empieza un borrador.
  2. Las páginas editadas muestran Cambios sin publicar. Abre la página, revísala y luego haz clic en Publicar cambios, o en Descartar cambios si no quieres los cambios. El editor marca estos borradores como Borrador creado por tu asistente de IA conectado.
  3. Los artículos del blog nuevos esperan en tu blog como borradores. Abre cada uno, revísalo y publícalo.

¿Quieres que alguien lo revise primero? Consulta borradores y enlaces de vista previa.

Lo que puede y no puede hacer

Puede

  • Leer tus páginas publicadas, artículos del blog y archivos multimedia
  • Crear borradores de cambios en el texto, los enlaces y las imágenes de una página
  • Crear artículos del blog nuevos como borradores
  • Actualizar artículos del blog que todavía son borradores

No puede

  • Publicar cualquier cosa
  • Eliminar páginas o artículos
  • Cambiar la dirección web o la plantilla de una página
  • Editar un artículo del blog que ya está publicado
  • Cambiar robots, la URL canónica u otros ajustes de SEO

Solución de problemas

El asistente dice que no está autorizado o muestra un error 401

Verifica que el valor empiece con Bearer y un espacio, seguido de la clave completa. Verifica que la clave no haya sido revocada ni esté vencida en la tarjeta Developer API. Una clave solo funciona para su propio sitio, así que verifica que la dirección del servidor termine en tu sitio. Si tienes dudas, crea una clave nueva y vuelve a conectar.

La app de Claude o ChatGPT no termina de conectarse

Lee el mensaje en la pantalla de WorkspaceCMS que se abre. Solo un dueño de la cuenta puede hacer clic en Permitir, el sitio debe estar en Premium o Ultra, y los términos de la API para desarrolladores deben aceptarse una vez en Configuración (haz clic en + Generar clave de API y acepta). Si ya tienes 5 claves activas, revoca una primero. La pantalla de inicio de sesión dura 15 minutos, así que si venció, empieza de nuevo desde la app.

Dice que la clave de API es de solo lectura

La clave se creó sin Deja que los asistentes de IA redacten cambios. Crea una clave nueva con esa casilla marcada y úsala en su lugar. Revoca la anterior.

El asistente no ve ninguna herramienta de WorkspaceCMS

En Cursor, verifica que el servidor esté activado en la lista de MCP. En Claude Code, ejecuta /mcp. Reinicia la app después de editar un archivo de configuración.

No veo la tarjeta Developer API

Solo la ven los dueños de la cuenta. En Essentials y Growth muestra un mensaje para mejorar el plan en lugar del botón Generar, porque las claves vienen con Premium y Ultra. Pregunta al dueño de tu cuenta o compara los planes en la página de precios.

Mi cambio no aparece en el sitio publicado

Es lo esperado. Todo lo que escribe el asistente es un borrador. Abre la página o el artículo en WorkspaceCMS y publícalo. El sitio publicado se actualiza en aproximadamente un minuto.

Dice que se superó el límite de solicitudes

Cada clave permite 600 solicitudes por minuto y cada sitio 50,000 al día. Espera el tiempo que indica y vuelve a intentarlo.

Preguntas frecuentes

Preguntas,
respondidas.

¿Sigues con problemas? Contacta a nuestro equipo y te ayudaremos a conectarlo.

¿Qué asistentes de IA puedo conectar?

Cualquier asistente que pueda agregar un servidor MCP personalizado y enviar tu clave de API como token Bearer. Las apps de Claude y ChatGPT se conectan iniciando sesión, así que no necesitan clave. Claude Code, Cursor y VS Code con GitHub Copilot se conectan con una clave de API, igual que cualquier otro cliente MCP que envíe un token Bearer. En ChatGPT, los conectores personalizados requieren el modo de desarrollador, disponible en los planes de pago de ChatGPT.

¿Puede el asistente dañar mi sitio publicado?

No. Solo puede crear borradores. No puede publicar, eliminar páginas, cambiar la dirección o la plantilla de una página, ni editar un artículo del blog publicado. Las páginas editadas muestran Cambios sin publicar y los artículos nuevos esperan como borradores hasta que una persona de tu equipo los publica.

¿Cuánto cuesta?

Nada adicional en WorkspaceCMS. El asistente funciona con tu propia cuenta de IA, bajo el plan de esa cuenta. Cada solicitud cuenta para tus límites normales de la API para desarrolladores de 600 solicitudes por minuto por clave.

¿Qué planes lo incluyen?

Premium y Ultra. Solo un dueño de la cuenta puede crear claves de API.

¿Cómo lo desconecto?

Abre Configuración, busca tu clave en la tarjeta Developer API y haz clic en Revoke. Una app que se conectó iniciando sesión tiene su propia clave, marcada como (signed in). El asistente pierde el acceso de inmediato. Quita también el conector en el asistente para que deje de intentarlo.

¿Puede conectar un asistente más de una persona?

Sí. Puedes tener hasta 5 claves activas. Dale a cada persona o herramienta su propia clave con un nombre claro, para que puedas revocar una sin afectar a las demás.

¿Tengo que usar esto?

No. Nuestro equipo sigue haciendo los cambios por ti cuando lo pidas. Esto es para quienes ya usan un asistente de IA y quieren que les ayude con su sitio.