Cinode

Proporciona a los agentes una vista de personas, proyectos, habilidades y asignaciones.

Ver en cinode.com

Documentación

El servidor MCP de Cinode (Model Context Protocol) conecta de forma segura clientes de IA y agentes compatibles con MCP a tu entorno de Cinode para que puedan acceder a los datos en vivo de tu organización. Esto les da a los agentes la misma vista contextual de personas, proyectos, habilidades y asignaciones que tiene tu equipo, al instante, para que puedan asistir, analizar, actualizar y automatizar con confianza.

Piénsalo como darle a tu asistente de IA un conocimiento práctico de tu configuración de Cinode, sin exponer datos que no quieras compartir.

¿Por qué usar el servidor MCP de Cinode?

  • Soporte de IA más inteligente – Los agentes actúan con contexto real de tus datos de Cinode
  • Flujos de trabajo más rápidos – Reduce el tiempo dedicado a actualizaciones y consultas manuales
  • Siempre sincronizado – Los agentes trabajan con información en vivo y actualizada
  • Seguro por diseño – Control de acceso granular sobre lo que los agentes pueden ver y cambiar

Primeros pasos

Puedes acceder a nuestro servidor MCP con HTTP Streamable en https://mcp.cinode.com/_mcp

Necesitas estar en un plan de pago usando Cinode para tener acceso a nuestra API y a nuestro servidor MCP.

Métodos de autenticación

Nuestro servidor MCP admite tres métodos de autenticación. OAuth es el enfoque recomendado: no requiere manejo manual de tokens y es la opción más segura. También se admiten Bearer Token y Credenciales Básicas para clientes que aún no admiten OAuth:

  1. OAuth (recomendado): Inicio de sesión basado en navegador. Sin manejo manual de tokens. El cliente se identifica con un Documento de Metadatos de ID de Cliente (CIMD), o con Registro Dinámico de Clientes (DCR) si aún no admite CIMD.
  2. Bearer Token: Autenticación con token de API estático
  3. Credenciales Básicas: Autenticación con ID de Cliente y Secreto de Cliente

Los tokens Bearer y las credenciales básicas son información sensible.

Nunca los compartas ni los almacenes de forma insegura (por ejemplo: en capturas de pantalla, documentos públicos/compartidos, archivos adjuntos de tickets, herramientas de chat como Teams/Slack, correos electrónicos, notas adhesivas o sitios web). Usa siempre almacenamiento seguro y transmite las credenciales solo a través de conexiones cifradas (HTTPS/TLS).

Cómo funciona OAuth

Con OAuth no creas ni pegas ningún token. Los clientes MCP compatibles se conectan a la URL del servidor y manejan la autenticación por ti:

  1. Apunta el cliente a https://mcp.cinode.com/_mcp y elige OAuth (o simplemente conéctate, si el cliente lo detecta automáticamente).
  2. El cliente se identifica ante Cinode e inicia un flujo de autorización OAuth 2.1. Un cliente que admite Documentos de Metadatos de ID de Cliente (CIMD) usa una URL HTTPS como su ID de cliente, y Cinode obtiene y verifica el documento de metadatos en esa URL. Un cliente que no admite CIMD se registra automáticamente con Registro Dinámico de Clientes (DCR, RFC 7591) en su lugar.
  3. Se abre una ventana del navegador pidiéndote que inicies sesión en Cinode y apruebes el acceso.
  4. Una vez aprobado, el cliente recibe un token de acceso y se conecta. El acceso está limitado a tus propios roles y permisos de Cinode, exactamente igual que con los otros métodos.

Usa CIMD donde tu cliente lo admita. La especificación MCP establece que los clientes MCP y los servidores de autorización deben admitir CIMD. La especificación marca DCR como obsoleto y lo mantiene solo por compatibilidad con versiones anteriores, por lo que DCR no se recomienda. Cinode admite ambos métodos, por lo que las conexiones existentes siguen funcionando. Los clientes que admiten CIMD lo seleccionan automáticamente cuando se conectan a Cinode, por lo que no necesitas configurar nada.

Cómo funcionan las Credenciales Básicas

La autenticación básica usa tu ID de Cliente y Secreto de Cliente:

  1. Únelos con dos puntos: CLIENT_ID:CLIENT_SECRET
  2. Codifica la cadena completa en Base64.

Cuando generas una Cuenta de API Personal en Cinode, te mostramos una cadena codificada y lista para usar que puedes usar inmediatamente dentro del encabezado Authorization. Lee más aquí.

Ejemplos de configuración

Los ejemplos a continuación son plantillas genéricas. Consulta siempre la documentación oficial de tu proveedor para obtener las instrucciones de configuración más actualizadas, ya que los detalles de configuración pueden variar entre versiones y proveedores.

Para autenticación con Bearer token:

{
   "mcpServers": {
      "cinode": {       
         "command": "npx",       
         "args": [         
            "mcp-remote",
            "https://mcp.cinode.com/_mcp",         
            "--header",         
            "Authorization: ${AUTH_HEADER}"       
         ],
         "env": {         
            "AUTH_HEADER": "Bearer YOUR_CINODE_API_TOKEN"       
         }
      }
   }
}

Nota: Reemplaza "npx" arriba con "C:\\Progra~1\\nodejs\\npx.cmd" si estás usando Windows.

Guías de configuración para proveedores de LLM

Configurar ChatGPT

Sigue estos pasos para conectar ChatGPT a Cinode a través del servidor MCP de Cinode. Para los detalles más recientes, consulta la documentación del modo Desarrollador de OpenAI.

Antes de comenzar

Tu organización necesita un plan de pago de Cinode.

Necesitas una cuenta de ChatGPT Plus, Pro, Business, Enterprise o Edu. Los conectores MCP personalizados requieren el modo Desarrollador, que no está disponible en el plan gratuito.

Configura la conexión en ChatGPT en la web (chatgpt.com).

En cuentas Business, Enterprise y Edu, un administrador del espacio de trabajo debe permitir el modo Desarrollador primero.

  1. Abre ChatGPT en la web y ve a Configuración > Aplicaciones > Configuración avanzada.
  2. Activa el modo Desarrollador.
  3. Vuelve a Configuración > Aplicaciones y haz clic en Crear aplicación.
  4. Ingresa un nombre, por ejemplo Cinode, y pega la URL del servidor https://mcp.cinode.com/_mcp.
  5. Selecciona OAuth como método de autenticación.
  6. Inicia sesión en Cinode en la ventana emergente y aprueba el acceso.
  7. Abre la aplicación de Cinode y activa las herramientas que quieras usar.
  8. Inicia un nuevo chat, haz clic en + y selecciona modo Desarrollador, luego selecciona la aplicación de Cinode.
  9. Haz una pregunta sobre tus datos de Cinode, por ejemplo "¿Qué consultores están disponibles el próximo mes?", para verificar que la conexión funcione.

Seguridad y Gobernanza

Usar MCP junto con IA hace posible realizar cambios a gran escala y automatizados en tus datos de Cinode. Aunque es potente, esto también aumenta el riesgo de resultados no deseados o irreversibles si los prompts son incorrectos o están mal probados.

Cuando el acceso de escritura está habilitado, las acciones impulsadas por IA pueden modificar o eliminar grandes cantidades de datos en poco tiempo.

Eres responsable de cómo se usan MCP y las herramientas de IA en tu organización.
Los cambios realizados a través de MCP pueden ser permanentes y no siempre se pueden deshacer.
Usa las capacidades de escritura de MCP bajo tu propio riesgo.

Para reducir el riesgo, Cinode recomienda encarecidamente que:

  • Solo habilites herramientas de escritura cuando sea necesario y cuando tengas confianza tanto en la tecnología como en tus capacidades de prompts.
  • Valida los prompts con acceso de solo lectura antes de permitir operaciones de crear, actualizar o eliminar.
  • Limita el acceso de escritura a usuarios experimentados que entiendan el modelo de datos de Cinode y su impacto en el negocio.
  • Revisa y monitorea los flujos de trabajo automatizados regularmente.
  • Asegúrate de que la configuración de privacidad de tu proveedor esté establecida según la política interna.

El servidor MCP de Cinode no envía tus datos a ningún lugar por sí solo. Solo responde a las solicitudes específicas que hace el cliente de IA que conectas, y solo dentro de los permisos de la cuenta que se autenticó.

Qué se comparte y con quién

  • Cuando conectas un cliente de IA (por ejemplo Claude/Anthropic, ChatGPT/OpenAI o Microsoft Copilot), ese cliente, no Cinode, es la parte que procesa tus prompts y los datos que recupera.
  • Solo los datos que un agente consulta realmente se le devuelven y se pasan a tu proveedor de IA elegido. No hay exportación masiva ni sincronización en segundo plano de tu base de datos de Cinode.
  • Cada solicitud está limitada a los roles y permisos existentes del usuario conectado en Cinode. Un agente nunca puede ver o cambiar más de lo que ese usuario ya puede.

Tus responsabilidades

  • Cómo se almacenan, retienen o usan los datos recuperados para el entrenamiento de modelos se rige por los términos y la configuración de privacidad de tu proveedor de IA elegido, no por Cinode. Revísalos y configúralos según tu política interna.
  • Cualquier acuerdo de procesamiento de datos (DPA) para el procesamiento de IA es entre tu organización y el proveedor de IA, no con Cinode.
  • Solo habilita herramientas de escritura una vez que tengas confianza en tus prompts y permisos (consulta Seguridad y Gobernanza arriba).

Acceso y permisos de usuario

De forma predeterminada, los empleados pueden crear cuentas de API personales y usar esas credenciales (por ejemplo, tokens Básicos) para conectar clientes MCP y herramientas de IA a Cinode. Esto significa que el acceso a MCP no tiene que ser aprovisionado centralmente por un administrador.

Esto no es un riesgo de seguridad en sí mismo:

  • Una cuenta de API personal no se puede usar para hacer más de lo que el usuario ya puede hacer en la aplicación de Cinode.
  • Todas las acciones realizadas a través de MCP están limitadas por los roles y permisos existentes del usuario.
  • El acceso a MCP sigue los mismos límites de permisos que el uso interactivo normal de Cinode.

Para organizaciones que quieren un control más estricto, los administradores pueden: