Connect Profound CMS to your AI client

Profound CMS proporciona un servidor MCP remoto que permite a los clientes de IA compatibles descubrir, crear, actualizar, publicar y gestionar contenido del CMS.

Punto de conexión MCP:

http://107.21.107.99:8081/mcp

Para producción, utiliza la versión HTTPS de tu URL de MCP configurada siempre que esté disponible.

Autenticación

Profound CMS MCP utiliza OAuth de WorkOS.

Para conectarte:

1. Crea una cuenta de Profound CMS.
2. Confirma que tu cuenta pertenece a la organización correcta.
3. Añade el servidor MCP a tu cliente de IA.
4. Completa el inicio de sesión mediante el navegador cuando se te solicite.

No necesitas copiar una clave de API en tu cliente de IA. Después de iniciar sesión, el cliente recibe un token de acceso de corta duración y lo actualiza automáticamente.

Tu rol en el CMS controla el acceso:

• Los miembros pueden leer el contenido del CMS.
• Los editores y administradores pueden crear, actualizar y publicar contenido.

Claude Code

Ejecuta:

claude mcp add --transport http Profound http://107.21.107.99:8081/mcp

Después, inicia Claude Code y completa el flujo de autenticación en el navegador.

Verifica la conexión:

claude mcp list

Codex CLI

Ejecuta:

codex mcp add Profound --url http://107.21.107.99:8081/mcp

Codex solicitará autenticación cuando se utilice el servidor por primera vez.

Puedes verificar la conexión con:

codex mcp list

OpenCode

Añade lo siguiente a:

~/.config/opencode/opencode.json

{
  "mcp": {
    "profound": {
      "type": "remote",
      "url": "http://107.21.107.99:8081/mcp",
      "enabled": true,
      "oauth": {}
    }
  }
}

Después, autentícate:

opencode mcp auth profound

Verifica la conexión:

opencode mcp list

El servidor debería aparecer como conectado mediante OAuth.

Cursor, Windsurf y otros clientes MCP

La mayoría de los clientes compatibles con MCP admiten la configuración HTTP remota estándar:

{
  "mcpServers": {
    "profound": {
      "url": "http://107.21.107.99:8081/mcp"
    }
  }
}

En Cursor, Windsurf, Claude Desktop u otro cliente MCP:

1. Abre la configuración de MCP o de integraciones.
2. Añade un servidor MCP HTTP remoto.
3. Utiliza la URL de MCP de Profound.
4. Activa la autenticación OAuth si el cliente ofrece una opción OAuth.
5. Completa el inicio de sesión de Profound CMS en tu navegador.

El cliente debe ser compatible con Streamable HTTP MCP y OAuth. Los clientes que solo admiten servidores locales o claves de API estáticas no pueden autenticarse directamente con este servidor.

Inicia cada sesión con el descubrimiento

Después de conectarte, pide a tu cliente de IA que descubra las organizaciones y los sitios web disponibles para ti:

Utiliza únicamente el servidor MCP de Profound.

Primero llama a list_my_organizations.
Después llama a list_organizations.
Utiliza el ID de organización devuelto por list_organizations para llamar a list_websites.

Muestra los nombres de las organizaciones, los nombres de los sitios web y los ID de los sitios web en una tabla.

Todas las operaciones del CMS requieren un website_id.

Herramientas disponibles

Actualmente, el servidor MCP proporciona 35 herramientas de CMS.

Organizaciones y sitios web

• list_my_organizations
• list_organizations
• list_websites

Páginas

• create_page
• update_page
• delete_page
• get_page
• list_pages

Vinculaciones de rutas

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

Las vinculaciones de rutas conectan páginas de plantilla con contenido específico o valores de parámetros.

Componentes

• create_component
• update_component
• delete_component
• list_components

Los componentes definen tipos de contenido reutilizables y sus campos.

Bloques

• create_block
• update_block
• delete_block
• get_block
• list_blocks
• publish_block

Los bloques son instancias de contenido colocadas en las páginas.

Campos dinámicos y expresiones de Template Builder

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

Estas herramientas gestionan expresiones dinámicas fx que calculan los valores de los campos en el momento de renderización.

Documentos y variantes

• create_document
• update_document
• delete_document
• get_document
• list_documents

Los documentos son entradas de contenido reutilizables, también llamadas variantes. list_documents devuelve metadatos; utiliza get_document para recuperar el contenido completo.

Traducciones

• list_document_translations
• upsert_document_translation
• delete_document_translation

Las traducciones deben almacenarse como filas de configuración regional en un único documento, en lugar de crear un documento separado para cada idioma.

Flujo de trabajo típico del CMS

Un flujo de contenido completo normalmente tiene este aspecto:

1. Descubre las organizaciones y los sitios web.
2. Inspecciona los componentes, las páginas, los bloques y los documentos existentes.
3. Crea o actualiza el contenido necesario.
4. Utiliza expected_version al actualizar bloques, componentes o documentos.
5. Publica los bloques o documentos.
6. Establece el estado de la página en Live.
7. Verifica el contenido publicado.

Una página solo es visible públicamente cuando está activa y su contenido se ha publicado.

Ejemplos de indicaciones

Crear una página:

Usando Profound CMS, crea una página en /pricing para el sitio web <website_id>.
Crea los bloques necesarios, publícalos y establece la página en Live.

Actualizar contenido existente:

Encuentra la página de inicio del sitio web <website_id>.
Lee sus bloques actuales, actualiza el titular principal y publica el cambio.

Crear contenido localizado:

Para el documento <document_id>, añade traducciones al francés y al alemán.
Utiliza el documento existente y crea filas de traducción en lugar de crear documentos duplicados.

Utilizar contenido dinámico:

Para el bloque principal de la página de plantilla, haz que el titular obtenga su contenido del documento vinculado a la ruta.
Utiliza una expresión de campo del bloque en lugar de colocar la fórmula en draft_content.

Flujo de contenido de extremo a extremo

Profound CMS MCP se puede combinar con otros servidores MCP para admitir un flujo de trabajo completo:

Por ejemplo:

Figma MCP + Profound CMS MCP

puede conectar el descubrimiento del diseño, la creación de contenido, la edición en el CMS, la localización y la publicación en un único flujo de trabajo asistido por IA.