MCP

El servidor MCP permite que los clientes de IA lean y, de forma opcional, escriban contenido estructurado en un proyecto. Tú controlas la conexión desde el Studio.

MCP usa sus propias claves de API. Las claves de GraphQL no funcionan con el servidor MCP, y las claves de MCP no funcionan con GraphQL.

Activar MCP

Ve a Configuración → MCP.
Activa Activado.
Elige un Entorno predeterminado, o déjalo sin definir y envía X-Environment desde el cliente.
De forma opcional, limita los Modelos. Deja la lista vacía para exponer todos los modelos de contenido.
Activa Permitir escrituras solo si los clientes deben crear, actualizar o eliminar entradas.
Activa Permitir borradores si las herramientas de lectura deben poder solicitar borradores y otros estados no publicados.
Haz clic en Guardar configuración.

Cuando MCP está desactivado, todas las solicitudes devuelven 403.

Crear una clave de API de MCP

Las claves se crean en la página de claves de API, no en la página de MCP.

Ve a Configuración → Claves de API.
Haz clic en Crear clave de API.
Elige MCP - Solo lectura (mcp_) o MCP - Lectura y escritura (mcpw_).
Copia la clave y guárdala en un lugar seguro.

Las claves de solo lectura pueden listar y leer contenido. Las claves de lectura y escritura también pueden crear, actualizar y eliminar entradas, pero solo cuando Permitir escrituras está activado. Las claves de MCP no pueden cambiar modelos, componentes, miembros del equipo ni la facturación.

Conectar un cliente

Los clientes se conectan a https://mcp.contismo.com. La página de MCP muestra la URL de conexión, los encabezados obligatorios y un fragmento mcp.json de Cursor.

Envía la clave como token Bearer. Envía X-Environment con el ID de API del entorno, u omítelo para usar el entorno predeterminado configurado arriba.

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

Para nombres de herramientas, recursos y un ejemplo completo de cliente, consulta la referencia del servidor MCP.