Permisos y seguridad de la clave que usa el servidor MCP

Cómo emitir la clave de API para el servidor MCP, qué permisos marcar según lo que quieras que haga tu asistente y cómo revocarla.

Aug 19, 2026

Mira este paso en el video · MCP: que una IA opere Omnifox

El servidor MCP se autentica con una clave de API personal de Omnifox, enviada como Authorization: Bearer en cada llamada. Como el asistente de IA decide solo qué herramienta usar, conviene que esa clave tenga únicamente los permisos que de verdad necesitas.

Crear la clave

  1. Abre Configuración → Desarrollo → API Keys.
  2. Haz clic en Nueva clave.
  3. Ponle un nombre que la identifique, por ejemplo Servidor MCP - Claude.
  4. Elige el espacio de trabajo. Es obligatorio y no se puede dejar en blanco: la clave solo verá los datos de ese espacio.
  5. Marca los scopes que correspondan (ver la tabla de abajo). Si no marcas ninguno, la clave queda con acceso total.
  6. Opcionalmente pon una fecha de expiración.
  7. Guarda y copia la clave en ese momento: es la única vez que se muestra completa.

Qué scope necesita cada grupo de herramientas

Lo que quieres que haga el asistente Scopes a marcar
Leer contactos, buscarlos, ver sus canales read:contacts
Crear, actualizar, etiquetar o fusionar contactos write:contacts
Leer conversaciones, mensajes y notas internas read:messages
Enviar mensajes, notas, asignar, cerrar o posponer write:messages
Ver los canales conectados y las plantillas read:channels
Leer oportunidades, empresas y embudos read:crm
Crear o mover registros del CRM write:crm
Leer proyectos y tableros read:projects
Escribir en proyectos y tableros write:projects
Registrar o listar webhooks manage:webhooks
Todo lo anterior admin

Si dejas la lista vacía, la clave equivale a acceso total. Es cómodo para probar, pero para uso diario marca solo lo que corresponda.

Combinación recomendada para empezar

Para un asistente que atiende la bandeja pero no toca facturación ni configuración: read:contacts, write:contacts, read:messages, write:messages y read:channels.

Revocar el acceso

En API Keys, borra la clave. El servidor MCP dejará de funcionar en la siguiente llamada, con un 401. No hace falta tocar la configuración del cliente de IA para cortar el acceso.

Consejos

  • Una clave por integración. Si compartes la misma clave con n8n, un script propio y el servidor MCP, revocarla los rompe a todos.
  • Pon fecha de expiración a las claves que emitas para pruebas.
  • Las herramientas destructivas existen: delete_contact, delete_tag y merge_contacts no se pueden deshacer. Si no quieres que tu asistente pueda borrar contactos, no le des write:contacts.

Si algo no funciona

  • 401: la clave fue revocada, expiró o se copió mal.
  • 403: a la clave le falta el scope de ese módulo, o el plan no incluye el módulo.
  • 404 en un registro que sí existe: los ids son por espacio de trabajo; la clave está fijada a otro espacio.

Artículos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp