Servidor MCP

Usa el servidor MCP cuando un cliente de IA deba leer o editar contenido de Contismo. Los sitios web y las aplicaciones deben seguir usando la API GraphQL.

Activa el servidor y elige qué modelos, borradores y escrituras están permitidos en Configuración → MCP. Consulta MCP.

Extremo

El servidor habla Streamable HTTP. Los clientes se conectan a:

https://mcp.contismo.com

Autenticación

Autentícate con una clave de API de MCP. Las claves de GraphQL se rechazan.

Authorization: Bearer <your-mcp-api-key>
X-Environment: <environment-api-id>

X-Environment es opcional cuando hay un entorno predeterminado guardado en el Studio. Si no se define ninguno de los dos, la solicitud falla.

Clave	Prefijo	Acceso
MCP - Solo lectura	`mcp_`	Solo herramientas de lectura
MCP - Lectura y escritura	`mcpw_`	Herramientas de lectura, más herramientas de escritura cuando Permitir escrituras está activado

Un servidor desactivado devuelve 403. Las solicitudes cuentan para la cuota mensual de llamadas a la API del proyecto, el mismo límite que GraphQL.

Herramientas de lectura

Llama primero a get_content_model y usa el apiId de cada campo en las herramientas posteriores. Solo son visibles los modelos seleccionados en el Studio. Una lista de modelos vacía significa todos los modelos de contenido.

Herramienta	Qué devuelve
`list_content_models`	Modelos que el servidor puede exponer
`get_content_model`	Campos y asignaciones de taxonomía de un modelo
`list_entries`	Entradas de un modelo, con `limit`, `offset`, `locale`, `status` y filtros
`get_entry`	Una entrada por el ID de API del modelo y el ID de la entrada. Las instancias únicas no necesitan un ID
`list_locales`	Configuraciones regionales del entorno actual
`list_taxonomies`	Taxonomías del entorno actual
`list_taxonomy_terms`	Términos de una taxonomía
`get_ui_translations`	Cadenas de traducción de la interfaz de una configuración regional

Las herramientas de lectura usan de forma predeterminada las entradas publicadas. Un status de DRAFT, IN_REVIEW o SCHEDULED solo se acepta cuando Permitir borradores está activado, o cuando la clave puede escribir.

Los campos de recurso de una entrada incluyen metadatos y la URL de entrega. El servidor no sube archivos.

Herramientas de escritura

Las herramientas de escritura solo se registran para una clave de lectura y escritura cuando Permitir escrituras está activado. No modifican modelos, componentes ni campos.

Herramienta	Qué hace
`create_entry`	Crea una entrada. Las claves de `input` son los ID de API de los campos
`update_entry`	Actualiza una entrada, incluido el estado y la programación
`delete_entry`	Elimina una entrada por el ID de API del modelo y el ID de la entrada

Los valores de estado coinciden con GraphQL: DRAFT, IN_REVIEW, PUBLISHED y SCHEDULED. create_entry y update_entry también aceptan scheduledPublishAt y scheduledUnpublishAt como cadenas de fecha y hora ISO, además de locale y las asignaciones de taxonomía.

Recursos

Los recursos reflejan las herramientas de lectura para los clientes que prefieren URI:

contismo://models
contismo://model/{apiId}
contismo://entry/{modelApiId}/{id}

Conectar Cursor

Copia el fragmento desde Configuración → MCP, o usa esta forma. Reemplaza la clave y el entorno.

{
  "mcpServers": {
    "contismo": {
      "url": "https://mcp.contismo.com",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY",
        "X-Environment": "master"
      }
    }
  }
}