Skip to content

Todos los artículos

Acceso de agentes MCP

Emperor tiene un servidor MCP (Model Context Protocol). Un agente de IA como Cursor u otro cliente MCP puede leer y cambiar datos del workspace a través de él. No hace falta ser administrador: cada usuario lo configura en su Profile.

Crear un token

  1. Menú → Profile → MCP Agent Access.
  2. En Create token, escriba un Name (por ejemplo Cursor laptop).
  3. Elija Scopes (ver abajo). Por defecto, solo lectura.
  4. Pulse Create token.
  5. Copie el token. Tiene la forma emp_<id>.<secret> y se muestra una vez. Guárdelo como una contraseña.

Un token:

  • actúa como usted, sin más derechos que su cuenta en el workspace;
  • solo funciona en el workspace activo al crearlo;
  • caduca a los 90 días (columna Expires);
  • deja de funcionar tras Revoke o si pierde acceso al workspace.

Edit scopes cambia los scopes de un token existente. El secreto no cambia y el cliente sigue funcionando.

Scopes

Los scopes de lectura están activos por defecto. Active un scope de escritura solo si el agente debe crear o modificar registros.

  • signals:read — señales de marketing
  • calendar:read / calendar:write — calendario de contenido
  • content-marketing:read / content-marketing:write — campañas, planes, tareas, embudos de ventas
  • content-optimization:read / content-optimization:write — palabras clave SEO, Search Console, escaneos de sitios, informes de optimización
  • development:read / development:write — proyectos, repositorios, modelos de negocio
  • youtrack:read / youtrack:write — Gantt de YouTrack
  • crm:read / crm:write — leads, oportunidades, contactos, organizaciones
  • crm:delete — borrado permanente de CRM (separado de crm:write)
  • finance:read / finance:write — presupuestos y transacciones
  • facilities:read / facilities:write — facilities e informes de seguridad
  • settings:read — lectura de ajustes (no hay scope de escritura)

Secretos, credenciales OAuth, gestión de tokens y borrado de proyectos nunca están disponibles por MCP.

Conectar un cliente

El endpoint MCP es el servidor MCP de Emperor en /mcp (puerto 4477 en el host de Emperor, salvo que su administrador publique otra dirección). MCP Agent Access muestra la dirección de su instalación.

Envíe el token como cabecera Bearer. Ejemplo para Cursor (.cursor/mcp.json o la configuración MCP global) y otros clientes con formato mcpServers:

{
  "mcpServers": {
    "emperor": {
      "url": "https://<emperor-host>:4477/mcp",
      "headers": {
        "Authorization": "Bearer emp_<id>.<secret>"
      }
    }
  }
}

Sustituya <emperor-host> y el token. 401: token incorrecto, revocado o caducado. 403 en una herramienta: falta el scope o su rol no permite la acción.

Eliminar registros de CRM

Estas herramientas reciben el UUID del registro en id:

  • delete_crm_lead elimina el lead, sus contactos, interacciones, oportunidades y partidas. Los proyectos vinculados se conservan.
  • delete_crm_contact elimina solo el contacto, no su propietario.
  • delete_crm_opportunity elimina la oportunidad y sus partidas; conserva el lead y el proyecto vinculado.
  • delete_crm_person elimina la persona y sus contactos; las identidades de aplicaciones vinculadas se conservan sin el vínculo a la persona.
  • delete_crm_organization y delete_crm_counterparty también eliminan sus contactos (y los roles de la contraparte). No se puede eliminar una organización con proyectos, contrapartes o facturación de workspace vinculados, ni una contraparte vinculada a leads o socios de modelos de negocio.

El borrado es irreversible. Se requiere crm:delete y permiso de su cuenta para eliminar en ese workspace. crm:write solo permite crear y modificar. Los tokens nuevos son de solo lectura por defecto; active crm:delete en Edit scopes cuando sea necesario. Al incorporar esta función, solo los tokens existentes con crm:write reciben crm:delete automáticamente. Los tokens de solo lectura y los que solo tienen escritura en otros dominios no cambian. Su secreto, caducidad y estado de revocación se conservan. Si después quita el scope, no se vuelve a añadir automáticamente.

La respuesta incluye success: true, data.id y los contadores en data.deleted: contacts, interactions, opportunities, lineItems y roles. Los registros inexistentes (también los de otro workspace) devuelven 404 / not found; las dependencias bloqueantes, 409. Un fallo no guarda eliminaciones parciales y los borrados correctos quedan registrados en la auditoría.

Artículos