Twelfth

Lee tu espacio de trabajo minorista de Twelfth mediante herramientas MCP de solo lectura con permisos limitados.

Ver en twelfth.ai

Servidor MCP alojado

npx add-mcp 'https://api.twelfth.ai/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

MCP genérico

Cualquier asistente que hable el Protocolo de Contexto de Modelos (MCP) puede conectarse a un espacio de trabajo de Twelfth, incluso si no está en la lista nombrada. Twelfth expone un endpoint MCP en https://api.twelfth.ai/mcp, de solo lectura a menos que permitas cambios. Acepta un token de usuario OAuth o una clave de portador del espacio de trabajo. Encuentra la guía de configuración en Configuración → IA y agentes → MCP genérico.

Úsalo cuando tu cliente no sea Claude,
ChatGPT,
Gemini,
Grok,
Glean,
Cursor,
Claude Desktop o
VS Code / Copilot. El patrón es el mismo para cada cliente MCP.

Conectar con OAuth

Si tu cliente admite OAuth para un servidor MCP remoto, añade https://api.twelfth.ai/mcp como URL del servidor. Los metadatos de descubrimiento de Twelfth inician el flujo de inicio de sesión. Elige un espacio de trabajo y las herramientas de lectura permitidas en la pantalla de consentimiento. Esta conexión lee como tú, dentro del rol y alcance de tu espacio de trabajo; no es necesario copiar ninguna clave. Termínala desde Configuración → IA y agentes.

Si has cerrado sesión, Twelfth te pide que inicies sesión antes de mostrar el consentimiento. La conexión requiere una cuenta existente y un espacio de trabajo al que pertenezcas. Si no tienes una cuenta, elige Reservar una demo en la página de inicio de sesión para solicitar acceso. Si tienes una cuenta pero no un espacio de trabajo, acepta una invitación, crea un espacio de trabajo o reserva una demo para obtener ayuda para comenzar.

Conectar con una clave de espacio de trabajo

  1. En Twelfth, abre Configuración → IA y agentes, ve a la pestaña Configuración y, en Claves de API, elige Conectar un agente → MCP genérico. Twelfth crea una clave para esta conexión, la copia en tu portapapeles y comienza a esperar la primera solicitud de MCP genérico. Copia la clave ahora si la necesitas de nuevo. Twelfth la muestra solo una vez.
  2. En la configuración MCP de tu cliente, añade un servidor con:
    • URL / endpoint: el endpoint de Twelfth que se muestra en la fila de la conexión.
      • Autorización: un token de portador configurado con la clave que generaste.
  3. Recarga los servidores MCP del cliente y luego pídele que liste las herramientas de Twelfth para confirmar la conexión.

Permitir cambios

La pantalla de consentimiento también ofrece Permitir cambios, desactivada a menos que la actives. Con ella activada, a una conexión OAuth se le ofrecen las herramientas de escritura que apruebes en el consentimiento, actuando como tú:

  • twelfth_complete_action: marca una de tus acciones abiertas como completada. Una revisión de precio o un cambio de precio se cierra como revisado, sin acción: los precios solo se cambian en Twelfth.
  • twelfth_snooze_action: oculta una hasta mañana o la próxima semana.
  • twelfth_create_action: crea una tarea para ti, con un título y detalles.
  • twelfth_run_routine: ejecuta una de tus propias rutinas.
  • twelfth_update_agent_policy: los propietarios/administradores pueden actualizar los valores predeterminados del chat del espacio de trabajo, incluidos modelos y presupuestos de turnos suaves. Requiere MFA del espacio de trabajo cuando está aplicada.

Siguen las mismas reglas que la página de Tareas de la aplicación, y cada llamada se registra contra la conexión. Cifras, precios, pedidos y otras configuraciones del espacio de trabajo no se pueden cambiar a través de MCP. Las conexiones existentes mantienen sus permisos anteriores; vuelve a conectar y aprueba la concesión actualizada para habilitar cambios en la política de chat. Una conexión hecha sin Permitir cambios, o antes de que existiera, nunca ve estas herramientas. Las claves de espacio de trabajo nunca realizan cambios. Para activarla o desactivarla, conéctate de nuevo; Extensiones tiene los detalles.

Herramientas disponibles

La conexión lee, a menos que hayas permitido cambios. Sus herramientas disponibles dependen de su selección guardada, las capacidades del espacio de trabajo y, para OAuth, los permisos del miembro. Incluyen:

  • Obtener la identidad del espacio de trabajo y los valores predeterminados operativos.
  • Listar los miembros del espacio de trabajo y sus roles.
  • Listar acciones abiertas, incluidas fechas de vencimiento, asignados y contexto de origen disponible.
  • Herramientas de análisis de solo lectura para la instantánea visible de la unidad de trabajo y el catálogo legible del llamador: métricas de ventas, ranking de productos, posición de inventario, maestro de productos, productos similares, restricciones de proveedores, búsqueda de proveedores, perfiles y contexto de entidades, y metodología. Los espacios de trabajo conectados también pueden ofrecer inteligencia de precios de competidores. El SQL arbitrario del almacén está reservado para el espacio de trabajo de diagnóstico solo para el personal de Twelfth.

Las herramientas que solo tienen sentido dentro del chat de la aplicación (hacer una pregunta aclaratoria al comprador, renderizar una tabla o gráfico) no se ofrecen a través de MCP. Los resultados de las herramientas incluyen source_evidence_ids; una llamada posterior puede pasarlos de vuelta para referirse a las mismas filas.

Una clave MCP es una credencial del espacio de trabajo y no pertenece a ninguna persona. Lee todo el negocio, como lo hace el propietario o administrador que la creó, y no se limita al alcance de ningún comprador individual.

Aparte de las herramientas aprobadas de Permitir cambios, estas herramientas no pueden escribir datos ni realizar cambios en Twelfth.

Prompts y recursos

Los clientes que admiten prompts MCP pueden ofrecer los informes listos de Twelfth, a menudo como comandos de barra: Informe comercial semanal, Explicar una recomendación, Verificación de precios de competidores, Revisión de proveedores y Estado del proyecto. Cada uno guía al asistente a través de las herramientas de solo lectura anteriores.

Los clientes que admiten recursos MCP pueden fijar contexto permanente: el espacio de trabajo, acciones abiertas, miembros y, donde el espacio de trabajo los tenga, flujos de trabajo de proyectos, configuraciones de categorías, conjuntos de precios rastreados e integraciones. Un recurso muestra solo lo que su herramienta correspondiente mostraría, por lo que una conexión limitada a ciertas herramientas solo ve esos recursos.

Eventos

Un asistente también puede observar el espacio de trabajo y actuar cuando algo cambia: nuevas recomendaciones, movimientos de precios de competidores, cambios de proyectos o un nuevo día de datos. Consulta Eventos.

Lo que Twelfth registra sobre una conexión

Cada llamada se registra contra su conexión: el nombre de la herramienta, si tuvo éxito, cuándo y cuánto tiempo tomó. Los resultados de las herramientas nunca se almacenan ni se envían a análisis; solo su tamaño. Las claves de espacio de trabajo se almacenan con hash y se muestran una vez, en la creación. La autenticación fallida repetida desde una dirección se rechaza durante un período de enfriamiento.

Plugins y listados

Donde Twelfth está, o estará, listado:

  • Claude (Directorio de Conectores de Claude): listado en revisión. Hasta entonces, añade Twelfth como conector personalizado.
  • ChatGPT y Codex (Directorio de Plugins de OpenAI, un listado para ambos): en revisión. Hasta entonces, añade Twelfth como conector en ChatGPT, o por comando en Codex (abajo).
  • Microsoft Copilot, para Copilot Studio y Microsoft 365 Copilot: próximamente.

En Codex:

codex mcp add twelfth --url https://api.twelfth.ai/mcp && codex mcp login twelfth

El servidor de Twelfth está publicado en el
Registro Oficial de MCP
como ai.twelfth/workspace, desde el dominio twelfth.ai. Los clientes y directorios que leen el registro pueden encontrarlo allí.

El repositorio de código abierto twelfth-ai/twelfth-mcp contiene el lado del cliente: la configuración MCP, un plugin para Cursor y Claude Code, y una habilidad que ayuda a un asistente a usar bien las herramientas. En Claude Code:

/plugin marketplace add twelfth-ai/twelfth-mcp
/plugin install twelfth@twelfth

El repositorio contiene solo configuración. El servidor en sí está alojado por Twelfth, y cada conexión aún inicia sesión y sigue los permisos de tu espacio de trabajo.

Soporte

Envía un correo a hello@twelfth.ai con cualquier pregunta sobre conectar un asistente, una herramienta que devuelva algo inesperado o acceso a tu espacio de trabajo. También puedes usar el formulario en twelfth.ai/contact. Incluye el asistente que estás usando (por ejemplo, Microsoft Copilot, Claude o ChatGPT), el nombre del espacio de trabajo y aproximadamente cuándo ocurrió, para que podamos encontrar la solicitud.

Para usar el conector necesitas una cuenta activa de Twelfth en un espacio de trabajo de Twelfth. Para obtener una, reserva una demo.

Relacionado