Claves de API

Las claves de API se usan cuando tu sitio, aplicación u otro sistema externo necesita solicitar contenido a Contismo.

Dan acceso autenticado fuera del Studio y deben manejarse de forma segura.

Tipos de clave

Contismo admite claves de GraphQL para sitios y aplicaciones, y claves de MCP para clientes de IA.

Tipo	Prefijo	Acceso
GraphQL - Solo lectura	`gql_`	Consultar contenido mediante GraphQL
GraphQL - Lectura y escritura	`gqlw_`	Consultar contenido y ejecutar mutaciones de GraphQL para modelos de contenido, entradas y recursos (crear, actualizar, eliminar y cambios de estado)
MCP - Solo lectura	`mcp_`	Leer contenido a través del servidor MCP
MCP - Lectura y escritura	`mcpw_`	Crear, actualizar y eliminar entradas a través del servidor MCP cuando las escrituras están habilitadas

Las claves de lectura y escritura no pueden administrar miembros del equipo, facturación, webhooks ni otras claves de API. Las claves de GraphQL no funcionan en el servidor MCP, y las claves de MCP no funcionan en GraphQL.

Crear una clave de API

Para crear una clave de API nueva:

Ve a Configuración → Claves de API.
Haz clic en Crear clave de API.
Ingresa un nombre que te ayude a identificar dónde se usará la clave.
Elige un tipo de clave de GraphQL o de MCP.
Copia la clave y guárdala en un lugar seguro.

Usar la clave

Incluye la clave de API en el encabezado Authorization al hacer solicitudes GraphQL. También envía el entorno en el encabezado X-Environment:

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

Las claves de GraphQL de solo lectura pueden ejecutar consultas. Las claves de GraphQL de lectura y escritura también pueden ejecutar mutaciones. Consulta la referencia de la API GraphQL.

Las claves de MCP usan los mismos encabezados contra el extremo de MCP. Configura modelos, borradores y escrituras en la configuración de MCP y luego consulta la referencia del servidor MCP para las herramientas y un ejemplo de cliente.