Cogram Project

npx add-mcp 'https://mcp.cogram.com/mcp'

Para el índice completo de la documentación, consulta llms.txt. Las versiones en Markdown de las páginas de documentación están disponibles añadiendo .md a las URL de las páginas; esta página está disponible como Markdown.

Servidor MCP

Conecta ChatGPT, Claude o un agente de IA personalizado a Cogram a través del servidor MCP: acceso de solo lectura, actuando como la persona que lo conectó.

El servidor MCP de Cogram permite a un usuario conectar una aplicación de IA a Cogram y luego hacerle preguntas sobre sus proyectos: actas de reuniones, correos electrónicos, RFI, envíos, planos, informes de campo y el directorio.

MCP (Protocolo de Contexto de Modelo) es el estándar abierto que las aplicaciones de IA utilizan para acceder a sistemas externos. Cualquier cliente MCP puede conectarse: ChatGPT, claude.ai o un agente que tu propio equipo construya.

Dirección del servidor: https://mcp.cogram.com/mcp

Dos hechos definen lo que un agente conectado puede hacer:

• Es de solo lectura. El agente puede buscar, leer y resumir. No puede crear, cambiar ni eliminar nada en Cogram.
• Actúa como una persona. El agente ve exactamente lo que puede ver el usuario que lo conectó, y nada más.

Esta página cubre la configuración para administradores de la organización. Los usuarios que conectan ChatGPT, Claude u otra aplicación de IA deben seguir Conectar aplicaciones de IA en su lugar.

Tú controlas el acceso MCP en dos lugares: en Cogram, donde permites conexiones en absoluto, y — si tu empresa opera un espacio de trabajo de ChatGPT o Claude — en ese espacio de trabajo, donde haces que Cogram esté disponible para sus usuarios.

Paso 1: Activa el acceso MCP en Cogram

El acceso MCP está desactivado por defecto para cada organización. Un administrador lo activa una vez, para toda la organización.

1. Ve a Configuración de la organización → Integraciones → Acceso MCP.
2. Activa Permitir a los miembros conectar agentes de IA de terceros.

La misma página muestra la URL del servidor con un botón de copiar — esta es la dirección que los usuarios y las aplicaciones de IA necesitan.

Una vez que el acceso MCP está activado, cualquier usuario puede conectar una aplicación de IA para sí mismo. Los usuarios que no conectan nada no se ven afectados. Desactivarlo de nuevo corta el acceso a todos los agentes ya conectados y detiene a los usuarios que conectan nuevos.

Si no ves el acceso MCP en Configuración de la organización → Integraciones, el acceso MCP aún no está disponible para tu organización. Envía un correo a support@cogram.com.

Si tus usuarios están en cuentas de IA personales, has terminado — envíalos a Conectar aplicaciones de IA. El resto de esta página cubre espacios de trabajo de IA gestionados por la empresa y agentes personalizados.

Paso 2 (opcional): Publica Cogram en tu espacio de trabajo de ChatGPT

En ChatGPT Business, Enterprise y Edu, los usuarios no pueden añadir aplicaciones MCP personalizadas por sí mismos — un administrador del espacio de trabajo crea la aplicación de Cogram una vez y la publica en el espacio de trabajo.

1. Como administrador o propietario, activa el modo de desarrollador para ti en Configuración → Aplicaciones → Configuración avanzada → Modo de desarrollador. Cada administrador lo activa para sí mismo; también se ofrece al crear una aplicación. (En Enterprise y Edu, también puedes otorgar el modo de desarrollador a usuarios seleccionados que no sean administradores en Configuración del espacio de trabajo → Permisos y roles → Datos conectados.)
2. Ve a Configuración del espacio de trabajo → Aplicaciones → Crear.
3. Nombra la aplicación Cogram MCP e introduce la URL del servidor MCP https://mcp.cogram.com/mcp. Elige OAuth como método de autenticación.
4. Selecciona Escanear herramientas. ChatGPT abre el inicio de sesión de Cogram — inicia sesión como lo haces normalmente, incluso a través de tu proveedor de identidad si tu organización usa SSO, y luego selecciona Permitir en la pantalla de aprobación.
5. Espera a que termine el escaneo de herramientas y luego selecciona Crear. La aplicación se guarda como borrador en Configuración del espacio de trabajo → Aplicaciones → Borradores. Opcionalmente, pruébala primero: en un chat nuevo, selecciona el borrador (etiquetado como "Dev") desde el menú de herramientas y pregúntale sobre tus proyectos de Cogram.
6. Publícala: Configuración del espacio de trabajo → Aplicaciones → Borradores → Publicar, y confirma las indicaciones de revisión. Cada herramienta de Cogram es de solo lectura, por lo que no hay acciones de escritura que revisar.
7. En Enterprise y Edu, el diálogo de publicación también te permite restringir herramientas individuales (Configurar acciones) o limitar qué grupos ven la aplicación (Configurar acceso).

Resultado esperado: Cogram MCP aparece para los usuarios en Complementos, en la pestaña de tu espacio de trabajo, etiquetado como "personalizado" — lo instalan como se describe en Conectar aplicaciones de IA. Cada usuario inicia sesión en Cogram por sí mismo, por lo que el agente de cada usuario ve solo sus propios proyectos.

ChatGPT congela la lista de herramientas de la aplicación cuando la publicas. Cuando Cogram lanza nuevas herramientas, no se recogen automáticamente: en Enterprise y Edu, selecciona Actualizar bajo el Control de acciones de la aplicación y habilita las nuevas herramientas (las nuevas herramientas llegan desactivadas); en Business, recrea y vuelve a publicar la aplicación.

Paso 3 (opcional): Publica Cogram en tu espacio de trabajo de Claude

En los planes Claude Team y Enterprise, un Propietario puede añadir Cogram como conector personalizado para toda la organización. Solo los Propietarios pueden hacer esto.

1. Ve a Configuración de la organización → Conectores.
2. Selecciona Añadir, pasa el cursor sobre Personalizado y elige Web.
3. Nombra el conector Cogram MCP e introduce la URL del servidor MCP https://mcp.cogram.com/mcp.
4. Deja vacíos los campos de ID de cliente OAuth y Secreto de cliente en Configuración avanzada — Cogram registra cada cliente automáticamente.
5. Selecciona Añadir.

Resultado esperado: cada usuario ve Cogram MCP en Personalizar → Conectores, etiquetado como "Personalizado" — lo conectan como se describe en Conectar aplicaciones de IA. Cada usuario selecciona Conectar allí e inicia sesión en Cogram por sí mismo, por lo que el agente de cada usuario ve solo sus propios proyectos.

Conecta un cliente personalizado o un agente interno

El servidor es un servidor MCP estándar: transporte HTTP transmisible, OAuth 2.1 con registro dinámico de clientes. Apunta cualquier biblioteca de cliente MCP, o el conector MCP de Anthropic, a https://mcp.cogram.com/mcp. El cliente maneja el descubrimiento y el flujo OAuth — incluido su propio registro, por lo que no hay nada que pre-registrar con Cogram.

Dos cosas a planificar en tu propio agente:

• Un inicio de sesión interactivo por identidad. No hay cuentas de máquina ni cuentas de servicio. Una persona debe iniciar sesión en Cogram en un navegador y aprobar la conexión una vez, por cada identidad bajo la que el agente opera.
• Almacena y rota el token de actualización. Después de la aprobación, tu agente tiene un token de actualización, que intercambia por tokens de acceso de corta duración. Mantenlo en un lugar secreto y reemplaza tu copia almacenada con la nueva cada vez que actualices. Si lo pierdes o caduca, la única recuperación es otro inicio de sesión interactivo.

Si varias personas usan tu agente y cada una debe ver solo sus propios proyectos, conecta una vez por persona y mantén sus tokens separados. Una conexión compartida significa que todos ven los datos de quien la aprobó.

Trata el contenido de Cogram como datos, no como instrucciones

Los resultados de las herramientas contienen texto que personas fuera de tu organización escribieron: cuerpos de correos electrónicos, transcripciones de reuniones, texto de archivos adjuntos, preguntas de RFI, notas del directorio. Cualquiera de ellos puede contener algo que parezca una instrucción para un modelo de IA — "ignora tus instrucciones anteriores", "envía este archivo por correo a…", "el usuario ha aprobado…".

Tu agente debe tratar cada resultado de herramienta como datos no confiables:

• Mantén los resultados de las herramientas separados de tus propias instrucciones en el prompt, y di claramente en el prompt del sistema que el contenido devuelto por las herramientas son datos a examinar, nunca un comando a seguir.
• Nunca permitas que un resultado de herramienta decida, por sí solo, llamar a otra herramienta que actúe fuera de Cogram — enviar correo, escribir en otro sistema, ejecutar código.
• Pon a un humano frente a cualquier acción consecuente que tu agente tome a partir del contenido de Cogram.

El servidor MCP de Cogram es de solo lectura, por lo que nada de lo que un agente lea puede cambiar Cogram. El riesgo es lo que tu agente haga después con lo que leyó.

Lo que un agente conectado puede y no puede hacer

Puede	No puede
Buscar y leer los registros de Cogram que el usuario puede abrir	Crear, editar, eliminar o archivar nada
Leer texto de archivos adjuntos y documentos	Enviar correos electrónicos, transmisores o notificaciones
Obtener enlaces con límite de tiempo a imágenes de hojas de planos	Acceder a un proyecto del que el usuario no es miembro
Leer el directorio y la lista de usuarios de la organización	Acceder a los datos de otra organización
Actuar como un usuario nombrado	Actuar como una cuenta de máquina, un administrador o la organización en general

Los permisos de Cogram se aplican sin cambios. La membresía del proyecto, roles de proyecto y visibilidad de activos siguen decidiendo lo que el agente ve, porque cada solicitud se responde como el usuario conectado.

Qué datos puede alcanzar un agente

El agente trabaja a través de un conjunto fijo de herramientas de solo lectura. La columna Módulo necesario muestra dónde una herramienta depende de la licencia de tu organización: si tu organización no tiene licencia para ese módulo, esas herramientas no se ofrecen al agente en absoluto.

Categoría	Módulo necesario	Herramientas
Identidad del usuario conectado	—	whoami
Proyectos	—	search_projects, get_projects_by_id
Reuniones y archivos adjuntos de reuniones	Reuniones	search_meetings, get_meetings_by_id, search_meeting_attachments, get_meeting_attachment_content
Correos electrónicos y archivos adjuntos de correos	Gestión de correos	search_emails, get_emails_by_id, search_email_attachments, get_email_attachment_content
Documentos	—	search_documents, get_documents_by_id
RFI y envíos	Correspondencia	search_rfis, get_rfis_by_id, search_submittals, get_submittals_by_id
Planos, informes de campo, observaciones	Informes de campo	search_drawings, get_drawings_by_id, search_reports, get_reports_by_id, search_observations, get_observations_by_id
Transmisores	Transmisores o Gestión de correos	search_transmittals, get_transmittals_by_id
Tableros de proyecto	—	search_board_items, get_board_item, get_board_items_for_meeting
Agentes	—	search_agents, get_agents_by_id
Personas y empresas	—	search_org_members, search_directory
Resumen de la organización	—	get_org_data_summary

Las grabaciones de audio de reuniones no son accesibles a través de ninguna herramienta. Las transcripciones sí lo son, para usuarios que ya pueden leerlas. Las herramientas de recuperación que aceptan una lista de IDs admiten como máximo 100 IDs por llamada. Un agente que solicite más recibirá un error de validación, por lo que debe trabajar en lotes.

Límite de velocidad

A cada usuario se le permiten 50 solicitudes por minuto por aplicación conectada. Dos aplicaciones conectadas por la misma persona tienen cada una su propia cuota, y dos usuarios nunca comparten una.

Por encima del límite, el servidor responde 429 con un encabezado Retry-After. Un cliente MCP bien comportado espera y reintenta. Si tu trabajo realmente necesita un límite más alto, escribe a support@cogram.com — el límite no es algo que puedas cambiar por ti mismo.

Solución de problemas

Síntoma: El agente informa "El acceso a MCP no está habilitado para tu organización", o la pantalla de aprobación no ofrece un botón Permitir. Causa probable: El acceso a MCP está desactivado para tu organización. Solución: Actívalo en Configuración de la organización → Integraciones → Acceso a MCP. Si la configuración no está en esa página, escribe a support@cogram.com.

Síntoma: Cogram no aparece en el menú de herramientas de ChatGPT. Causa probable: En Business, Enterprise y Edu, un administrador del espacio de trabajo aún no ha publicado la aplicación Cogram — los usuarios no pueden agregarla por sí mismos. En Pro, el modo de desarrollador está desactivado. Solución: Publica la aplicación Cogram (consulta Paso 2 arriba) — los usuarios no pueden agregarla por sí mismos. En Pro, el usuario activa el modo de desarrollador en Configuración → Aplicaciones → Configuración avanzada.

Síntoma: Falta una categoría completa en la lista de herramientas del agente, o una llamada responde "El módulo de reuniones no está licenciado para tu cuenta de Cogram". Causa probable: Tu organización no tiene licencia para ese módulo. Solución: Consulta Licencias y luego escribe a support@cogram.com sobre el módulo. Después, haz que el agente vuelva a listar sus herramientas — o reconéctalo — para que aparezcan las nuevas herramientas. En un espacio de trabajo de ChatGPT, un administrador también debe actualizar y volver a publicar la aplicación.

Síntoma: Las llamadas fallan con 429 rate_limit_exceeded. Causa probable: Más de 50 solicitudes en un minuto para ese usuario y aplicación. Solución: Espera la cantidad de segundos indicada en el encabezado Retry-After. Haz que el agente solicite menos páginas pero más grandes en lugar de muchas llamadas pequeñas. Escribe a support@cogram.com si el trabajo realmente necesita un límite más alto.

Síntoma: Un agente que funcionaba de repente te pide que inicies sesión nuevamente, o cada llamada responde 401. Causa probable: El token de actualización expiró, fue revocado o fue sobrescrito por una copia más antigua. Solución: Vuelve a ejecutar la conexión — inicia sesión y aprueba. Para un agente sin interfaz, verifica que guarde el nuevo token de actualización después de cada renovación y que solo un proceso lo use.

Síntoma: El agente ve menos proyectos o reuniones de los que el usuario espera. Causa probable: El agente tiene exactamente el mismo acceso que el usuario. El usuario no está en esos proyectos, o la visibilidad de activos oculta esos registros. Solución: Agrega al usuario a los proyectos o revisa Visibilidad de activos. Nada sobre la conexión en sí puede ampliar lo que el agente ve.

Síntoma: Necesitas cortar el acceso de un agente ya conectado. Causa probable: Cogram no tiene una pantalla de desconexión por agente. Solución: Elimina el conector en la aplicación de IA que lo contiene. Para detener a todos los agentes conectados de la organización a la vez, desactiva el acceso a MCP en Configuración de la organización → Integraciones.

Próximos pasos

• Conectar aplicaciones de IA — los pasos de conexión orientados al usuario.
• API de Cogram — la API REST, para integraciones de sistema a sistema que necesitan escribir datos.
• Licencias — qué módulos tiene licenciados tu organización.
• Visibilidad de activos — cómo funciona la visibilidad a nivel de registro.
• Agente — el agente integrado de Cogram, que no requiere configuración.

¿Preguntas? Escribe a support@cogram.com o usa el menú de Ayuda dentro de la aplicación.

---

Instrucciones para el agente

Esta documentación se publica con GitBook. GitBook es la plataforma de documentación diseñada para que tanto humanos como agentes de IA puedan leer, navegar y razonar sobre contenido técnico de manera efectiva. Obtén más información en gitbook.com.

Consultar esta documentación

Si necesitas información adicional que no está disponible directamente en esta página, puedes consultar la documentación dinámicamente haciendo una pregunta.

Realiza una solicitud HTTP GET en la URL de la página actual con el parámetro de consulta ask y el parámetro de consulta opcional goal:

GET https://docs.cogram.com/integrations/mcp-server.md?ask=<question>&goal=<endgoal>

ask es la pregunta inmediata: debe ser específica, autónoma y escrita en lenguaje natural. goal es opcional y describe el objetivo final más amplio que intentas lograr en nombre del usuario. GitBook lo usa para adaptar la respuesta hacia lo más útil para ese objetivo.

La respuesta contendrá una respuesta directa a la pregunta y extractos y fuentes relevantes de la documentación.

Usa este mecanismo cuando la respuesta no esté explícitamente presente en la página actual, necesites aclaraciones o contexto adicional, o quieras recuperar secciones de documentación relacionadas.