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.
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
- Abre Configuración → Desarrollo → API Keys.
- Haz clic en Nueva clave.
- Ponle un nombre que la identifique, por ejemplo Servidor MCP - Claude.
- Elige el espacio de trabajo. Es obligatorio y no se puede dejar en blanco: la clave solo verá los datos de ese espacio.
- Marca los scopes que correspondan (ver la tabla de abajo). Si no marcas ninguno, la clave queda con acceso total.
- Opcionalmente pon una fecha de expiración.
- 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_tagymerge_contactsno se pueden deshacer. Si no quieres que tu asistente pueda borrar contactos, no le deswrite: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.404en un registro que sí existe: los ids son por espacio de trabajo; la clave está fijada a otro espacio.
Artículos relacionados
Artículos relacionados
-
Cómo conectar integraciones y apps externas
Conecta Omnifox con tus herramientas favoritas desde el catálogo de integraciones en pocos pasos.
-
Guía completa de integraciones y API
Integraciones y API a fondo, en 30 capítulos: claves API, llamadas reales, webhooks firmados, n8n, MCP y SDK, todo funcionando de verdad.
-
Integrar Omnifox con Azur, Siigo, Alegra, QuickBooks u otro sistema contable o ERP
Omnifox no tiene hoy un conector nativo con sistemas contables o ERP. Te explicamos cómo conectarlos igual con workflows, el nodo HTTP, n8n, Make, Zapier o la API, con ejemplos.
-
Generar y usar API keys y webhooks
Crea claves de API para acceder a Omnifox por código y configura webhooks para recibir eventos en tiempo real.
-
Introducción a las integraciones (webhook / OAuth / API key)
Conecta Omnifox con tus otras herramientas: qué está disponible hoy, qué llega pronto y cuándo usar un webhook, una conexión OAuth o una clave de API.