Conectar un asistente de IA

TCultura le responde a un asistente de inteligencia artificial sobre actividades culturales. Le puedes preguntar qué hay este fin de semana en tu comuna, si queda cupo en un taller o cuánto cuesta una entrada, y la respuesta trae el enlace para inscribirte.

Si además conectas tu cuenta, responde sobre lo tuyo: a qué actividades estás inscrito, qué tienes en la agenda, cómo va tu Pasaporte Cultural. Y si formas parte de un proyecto cultural, responde sobre su gestión: asistencia, encuestas, indicadores y rendiciones.

Qué necesitas antes de empezar

• Para buscar en la cartelera, nada: esa parte responde sin conectar ninguna cuenta.
• Para lo tuyo, una cuenta de TCultura. La tienes desde que te inscribes a una actividad.
• Para la gestión de un proyecto, ser parte de su equipo y que el plan del proyecto incluya el conector de IA. La conexión no crea proyectos: consulta el que ya tienes.
• Un asistente que acepte conectores. En la versión web de Claude y de ChatGPT esa función viene en los planes de pago, y en ChatGPT hay que activarla en los ajustes avanzados de la cuenta.

La dirección del servidor

Es la misma para cualquier proyecto y es lo único que hay que copiar:

https://mcp.tcultura.com/mcp

Camino 1: con tu asistente en el navegador

Es el camino corto y no necesita ningún archivo ni ninguna clave. Sirve para Claude y para ChatGPT en su versión web.

1. Abre los conectores de tu asistente. En los ajustes de tu cuenta busca la sección de conectores, y dentro de ella la opción de agregar uno personalizado.
2. Pega la dirección del servidor. Es https://mcp.tcultura.com/mcp, la misma para cualquier proyecto. No hay nada más que completar en esa pantalla.
3. Autoriza con tu cuenta de TCultura. El asistente te trae a una pantalla de TCultura donde inicias sesión y eliges qué autorizas: uno de tus proyectos, o solo tu cuenta. Ahí termina la conexión.
4. Retírala cuando quieras. Las ves y las retiras en TCultura, en tu portal, en Asistentes conectados; si administras el proyecto, también en el panel, pestaña Llaves. Al retirar una, ese asistente deja de responder de inmediato.

Camino 2: con Claude Code

Claude Code autoriza por el navegador igual que el camino 1: no hace falta emitir ninguna clave ni guardarla en un archivo.

1. Declara el servidor. En una terminal: claude mcp add --transport http tcultura https://mcp.tcultura.com/mcp. Si prefieres compartirlo con tu equipo, el mismo servidor va en .mcp.json en la raíz de tu proyecto, con "type": "http" y la dirección, sin encabezados.
2. Autoriza desde la sesión. Dentro de Claude Code escribe /mcp, elige tcultura y autentícate: se abre el navegador en una pantalla de TCultura donde inicias sesión y eliges qué autorizas, uno de tus proyectos o solo tu cuenta. Ahí termina la conexión, y se retira como cualquier otra, en Asistentes conectados.

Camino 3: con una clave, para un programa instalado que no autoriza por el navegador

Si tu asistente instalado no autoriza por el navegador, la conexión se declara en un archivo de configuración con una clave, que se emite desde el panel y se ve una sola vez. Donde abajo dice tck_TU_LLAVE va esa clave. Claude Code también acepta esta vía.

{
  "mcpServers": {
    "tcultura": {
      "type": "http",
      "url": "https://mcp.tcultura.com/mcp",
      "headers": {
        "Authorization": "Bearer tck_TU_LLAVE"
      }
    }
  }
}

[mcp_servers.tcultura]
url = "https://mcp.tcultura.com/mcp"
bearer_token_env_var = "TCULTURA_MCP_TOKEN"

{
  "mcpServers": {
    "tcultura": {
      "url": "https://mcp.tcultura.com/mcp",
      "headers": {
        "Authorization": "Bearer tck_TU_LLAVE"
      }
    }
  }
}

{
  "mcpServers": {
    "tcultura": {
      "serverUrl": "https://mcp.tcultura.com/mcp",
      "headers": {
        "Authorization": "Bearer tck_TU_LLAVE"
      }
    }
  }
}

{
  "mcpServers": {
    "tcultura": {
      "serverUrl": "https://mcp.tcultura.com/mcp",
      "headers": {
        "Authorization": "Bearer tck_TU_LLAVE"
      }
    }
  }
}

{
  "mcpServers": {
    "tcultura": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.tcultura.com/mcp",
        "--header",
        "Authorization:${TCULTURA_AUTH}"
      ],
      "env": {
        "TCULTURA_AUTH": "Bearer tck_TU_LLAVE"
      }
    }
  }
}

Qué le puedes pedir

La cartelera, sin conectar nada

Responden sin credencial y muestran lo mismo que la agenda pública del sitio. Cada respuesta trae el enlace para inscribirte o comprar en TCultura.

• buscar_actividades: Busca actividades culturales publicadas: conciertos, talleres, obras, exposiciones.
• hay_cupo: Si una actividad publicada todavía tiene cupo disponible, ahora mismo.
• ver_actividad: Detalle de una actividad publicada: fecha, lugar, descripción y tipos de entrada.

Tu cuenta, si conectas

Responden sobre ti y sobre nadie más.

• mi_agenda: Lo que tengo por delante: actividades a las que voy y turnos de voluntariado, en orden.
• mi_pasaporte: Mi Pasaporte Cultural: cuántos sellos llevo, qué nivel tengo y dónde he estado.
• mi_voluntariado: En qué programas de voluntariado participo, cuántas horas llevo y qué turnos tengo.
• mis_certificados: Qué certificados tengo y de qué actividad.
• mis_encuestas_pendientes: Las encuestas que me toca responder y todavía no respondí.
• mis_inscripciones: Las actividades a las que estoy inscrito, con su fecha y su lugar.
• mis_premios: Qué gané en sorteos y si ya lo retiré.

Consultar un proyecto

Estas solo leen y responden.

• consultar_proyecto: Los datos generales del proyecto: nombre, descripción y el enlace al proyecto en TCultura.
• panorama: Estado general del proyecto en una sola llamada, para arrancar con contexto.
• listar_eventos: Los eventos del proyecto con sus conteos de inscripción y asistencia, por período.
• contar_participantes: Cuántas personas hay inscritas y cuántas asistieron, con el enlace a la nómina.
• ver_kpis: Los indicadores de gestión del proyecto con su valor actual, agrupados por categoría.
• ver_indicadores: Indicadores compuestos del proyecto con la evidencia que los hace interpretables.
• ver_dashboard: El dashboard del proyecto como lo arma su diseñador: sus hojas (de indicadores, de texto o de fotos) y sus tarjetas, con valor, meta, máximo y logro (el valor sobre la meta, en porcentaje), y los enlaces para verlo y editarlo en TCultura.
• ver_resultados_pregunta: Distribución de respuestas de una pregunta, entera o abierta por una dimensión de corte.
• ver_respuestas_encuesta: Cuántas respuestas tiene una encuesta y qué pregunta, con el enlace a los resultados.
• ver_asistencia: Asistencia real por evento, con el desglose que hace defendible el número ante un fondo.
• ver_pasaporte: Visitas registradas como sellos del Pasaporte Cultural en los eventos del proyecto.
• listar_concursos: Los concursos de fotografía del proyecto, con su estado y su volumen de participación.
• ver_concurso: Cómo va un concurso: fotos recibidas, en qué estado de moderación están y cuántos votos.
• listar_unidades: Organizaciones y unidades del proyecto, con los identificadores que aceptan los cortes, y los temas de sesiones con su id.
• ver_voluntariado: Programas de voluntariado con su dotación, turnos y horas acumuladas.
• ver_sponsors: Auspiciadores del proyecto, leads capturados por QR y reportes generados.
• listar_sorteos: Sorteos del proyecto, sus premios, cuántos ganaron y el historial de ejecuciones.
• ver_networking: Ruedas de negocios del proyecto: participantes, citas y resultados declarados.
• ver_encuestas_resumen: Los instrumentos del proyecto con cuántas respuestas tiene cada uno, por período.
• ver_estado_rendicion: El estado de las rendiciones de fondos del proyecto y qué falta para cerrarlas.
• ver_rendicion_detalle: Marco lógico, presupuesto y avance de la rendición del proyecto.
• ver_finanzas: Las finanzas del proyecto en un rango de fechas: lo mismo que su resumen financiero.
• listar_gastos: Los gastos del proyecto uno a uno en un rango de fechas, y sus fuentes de financiamiento con su id.
• ver_datos_autocompletados: Los datos que TCultura autocompletó en las rendiciones del proyecto, con su valor, su fuente, su estado de aprobación y el enlace a la rendición en TCultura, donde se aprueban o rechazan: por aquí solo se leen.
• ver_medios_de_verificacion: Los medios de verificación del marco lógico del proyecto: el archivo de verificación de cada resultado, y las fotos y la asistencia del evento vinculado a cada actividad, con los enlaces a TCultura.
• listar_tableros: Los tableros de análisis del proyecto: por cada uno, su título, cuántos indicadores activos tiene, la fecha de corte de su último cálculo y los enlaces para verlo y editarlo en TCultura.
• ver_tablero: Un tablero de análisis del proyecto con el valor de cada indicador en su último cálculo guardado, sin recalcular: `fecha_corte` dice de cuándo es, y se recalcula en TCultura (`ver_en`).
• ver_actos_culturales: Los actos culturales que presentó el proyecto (artistas, bandas, compañías): por cada uno, su nombre, su origen (local, regional, nacional o internacional) y cuántos integrantes tiene, con el resumen por origen.
• ver_empleo_directo: El empleo directo que generó el proyecto: cuántos puestos hay y cuántos de cada rol.
• ver_alcance_difusion: El alcance de la difusión del proyecto por plataforma (Instagram, Facebook, Twitter/X, TikTok, prensa u otra): impresiones y usuarios únicos de cada publicación o campaña medida, con los totales por plataforma, en un período de fechas de medición.
• ver_tasa_respuesta: Qué proporción del público de cada actividad respondió una encuesta del proyecto: por cada actividad (función) con respuestas, sus asistencias registradas, sus respuestas y la tasa (respuestas sobre asistencias; puede pasar de 1 si hubo asistencia sin registrar).
• ver_cobertura_evento: El embudo de cobertura de un evento del proyecto (personas contadas en la puerta, registradas con su nombre, con perfil mínimo de edad, género y comuna, y con una respuesta atribuible al evento, con el porcentaje de cada escalón, más las buscadas a propósito si el evento declaró cuántas), lo que pasó con la encuesta (enviadas, sin responder y las que no quisieron responder en persona, con `motivo_desenlace` si algo se calla) y lo que va al margen (menores a cargo, respuestas sin persona, respuestas del proyecto sin actividad y `al_margen.negativas_del_proyecto_sin_actividad`).
• ver_cobertura_nomina: En qué estado está la aplicación de una encuesta por nómina, en el proyecto y en cada organización: el universo de personas inscritas y cuántas respondieron, esperan confirmación, tienen la respuesta retenida, quedaron fuera, tienen una respuesta inutilizable, están bloqueadas por falta de permiso, se retiraron, tienen la inscripción inactiva o faltan por encuestar.
• ver_valoraciones_evento: La valoración de un evento del proyecto por quienes asistieron: cuántas valoraciones aprobadas se ven en el sitio, cuántas de cada puntuación (de una a cinco estrellas), su promedio y cuántas esperan revisión del equipo.
• listar_biblioteca_formularios: Preguntas de biblioteca y grupos de opciones reutilizables, con búsqueda.
• listar_plantillas: Plantillas de encuesta que este proyecto puede copiar, con búsqueda.
• guia_de_medicion: Orientación de TCultura para medir una actividad: qué preguntar, cuánto y con qué cuidado.
• ver_enlaces_cortos: Los enlaces cortos del proyecto: la dirección corta, el destino, si sigue activo, los clics totales y por mes y la fecha del último clic.
• guiar_en_el_panel: Lleva a la pantalla de TCultura donde una persona hace lo que este conector no hace: publicar o abrir, enviar a personas, tocar dinero o datos de personas, aprobar, moderar, borrar, el equipo y los roles, los consentimientos y las acreditaciones.

Preparar cambios

Estas escriben. Lo que crean nace sin publicar y cerrado, y solo existe después de confirmar la vista previa. Las ediciones se aplican al momento cuando no afectan a nadie; si el evento tiene inscritos, la encuesta ya tiene respuestas o el cambio altera lo que mide una pregunta, queda como propuesta que una persona del equipo aprueba en TCultura. Una encuesta de papel transcrita entra en revisión y no cuenta en ninguna cifra hasta que una persona la confirma en TCultura.

• registrar_gasto: Prepara el registro de un gasto del proyecto, que no se escribe hasta que una persona lo aprueba en TCultura.
• registrar_ingreso: Prepara el registro de un ingreso del proyecto, que no se escribe hasta que una persona lo aprueba en TCultura.
• registrar_presupuesto: Prepara cambios al presupuesto del proyecto aprobado por el fondo (la cabecera y líneas nuevas), que no se escriben hasta que una persona los aprueba en TCultura.
• editar_marco_logico: Prepara cambios al marco lógico de la rendición del proyecto (objetivo general, objetivos, actividades y resultados), que no se escriben hasta su aprobación.
• registrar_avance_resultado: Prepara el avance de un resultado del marco lógico de la rendición (valor real, resultado real y estado de cumplimiento), que no se escribe hasta su aprobación.
• redactar_seccion_rendicion: Prepara el texto de una sección de una rendición del proyecto (por ejemplo, el resumen ejecutivo o las actividades realizadas), que no se escribe hasta su aprobación.
• crear_tablero: Prepara un tablero de análisis del proyecto con sus fuentes (encuestas o eventos del proyecto) y sus indicadores, que nace privado, en modo híbrido e inactivo hasta que alguien del equipo que edita el proyecto lo activa en la revisión del asistente de TCultura.
• agregar_indicador: Prepara un indicador nuevo en un tablero de análisis del proyecto, sobre una de sus fuentes, que no se agrega hasta su aprobación.
• editar_indicador: Prepara cambios a un indicador de un tablero de análisis del proyecto, que no se aplican hasta su aprobación.
• archivar_indicador: Prepara el archivo de un indicador de un tablero de análisis: deja de calcularse y de mostrarse, sin borrarse, cuando una persona del equipo que edita el proyecto lo aprueba en TCultura.
• editar_tablero: Prepara cambios al título, la descripción, el modo de cálculo o la plantilla de un tablero de análisis del proyecto, que no se aplican hasta su aprobación.
• registrar_indicador_manual: Prepara una tarjeta manual nueva en la biblioteca del diseñador de dashboard del proyecto (un número que el equipo escribe, como voluntarios o talleres, con su meta), que no se agrega hasta su aprobación.
• fijar_meta: Prepara la meta y el máximo de una tarjeta de la biblioteca del diseñador de dashboard del proyecto, que no cambian hasta su aprobación.
• registrar_acto_cultural: Prepara el registro de un acto cultural que presentó el proyecto (un artista, una banda o una compañía), que no se registra hasta su aprobación.
• registrar_empleo_directo: Prepara el registro de un puesto de trabajo que generó el proyecto, que no se registra hasta su aprobación.
• registrar_alcance_difusion: Prepara el registro del alcance de una publicación o campaña del proyecto en una plataforma, que no se registra hasta su aprobación.
• crear_evento: Prepara un evento cultural del proyecto.
• duplicar_evento: Prepara la copia de un evento de este proyecto en otra fecha.
• crear_formulario: Prepara una encuesta con secciones y opciones reales.
• crear_formulario_desde_plantilla: Prepara la copia de una plantilla de encuesta completa para este proyecto.
• generar_rendicion: Prepara el borrador de una rendición de fondos con los datos que ya están en el sistema.
• editar_pregunta: Prepara el cambio de campos de una pregunta existente.
• agregar_pregunta: Prepara una pregunta nueva al final de una encuesta.
• archivar_pregunta: Prepara el retiro de una pregunta, que deja de mostrarse conservando las respuestas ya recibidas.
• reordenar_preguntas: Prepara otro orden para las preguntas de una encuesta: reemplaza el orden anterior.
• editar_evento: Prepara cambios a un evento: nombre, descripción, fecha, lugar, organizador, encuesta posterior, certificado y datos que pide la inscripción.
• archivar_evento: Prepara el retiro de un evento: deja de ser público y cierra las inscripciones.
• agregar_actividad: Prepara una actividad nueva (una función, un taller, una charla) en un evento que ya existe, que no se agrega hasta su aprobación.
• editar_actividad: Prepara cambios a una actividad de un evento, que no se aplican hasta su aprobación.
• crear_seccion: Prepara una sección nueva, vacía y al final, en una encuesta del proyecto, que no se crea hasta su aprobación.
• editar_seccion: Prepara otro título u otra descripción para una sección de una encuesta del proyecto, que no cambian hasta su aprobación.
• reordenar_secciones: Prepara otro orden para las secciones de una encuesta del proyecto, que no cambia hasta su aprobación.
• crear_organizacion: Prepara una organización nueva del proyecto (un colegio, una sede, un centro cultural, una junta de vecinos), que no se crea hasta su aprobación.
• crear_unidad: Prepara una unidad nueva (un curso, un taller, un grupo) en una organización del proyecto, que no se crea hasta su aprobación.
• duplicar_encuesta: Prepara una copia de una encuesta del proyecto, que no se crea hasta su aprobación.
• crear_fuente_de_participantes: Prepara quién participa en los sorteos del proyecto: una fuente de participantes (los inscritos o asistentes de un evento o de una actividad, quienes respondieron una encuesta, los autores de un concurso, un registro de visita o la encuesta de asistentes), que no se crea hasta su aprobación.
• crear_sorteo: Prepara un sorteo del proyecto, que no se crea hasta su aprobación, y que nace sin ejecutar.
• editar_sorteo: Prepara cambios a un sorteo del proyecto que todavía no se ejecuta, que no se aplican hasta su aprobación.
• crear_premio: Prepara un premio del proyecto para sus sorteos, que no se crea hasta su aprobación.
• editar_premio: Prepara cambios a un premio del proyecto (nombre, descripción, stock y activación), que no se aplican hasta su aprobación.
• crear_concurso: Prepara un concurso de fotografía del proyecto (sus bases, su cierre y quién participa), que no se crea hasta su aprobación.
• editar_concurso: Prepara cambios a un concurso de fotografía del proyecto (bases, cierre, quién participa), que no se aplican hasta su aprobación.
• crear_programa_de_voluntariado: Prepara un programa de voluntariado del proyecto, que no se crea hasta su aprobación.
• crear_turno_de_voluntariado: Prepara un turno nuevo en un programa de voluntariado del proyecto, sin personas asignadas, que no se crea hasta su aprobación.
• crear_rueda_de_negocios: Prepara la rueda de negocios de un evento del proyecto (su horario, la duración de cada cita, las mesas y sus encuestas), que no se crea hasta su aprobación.
• editar_rueda_de_negocios: Prepara cambios a la rueda de negocios de un evento del proyecto (horario, citas, mesas, encuestas), que no se aplican hasta su aprobación.
• crear_serie_de_eventos: Prepara una serie de eventos que se repiten a partir de un evento del proyecto, que no se crea hasta su aprobación.
• crear_diseno_de_certificado: Prepara un diseño de certificado del proyecto (nombre, color, fuentes y posiciones de los textos), que no se crea hasta su aprobación.
• crear_etiqueta: Prepara una etiqueta para la biblioteca de la cuenta dueña del proyecto, que no se crea hasta su aprobación.
• crear_grupo_de_opciones: Prepara un grupo de opciones para la biblioteca de la cuenta dueña del proyecto, que no se crea hasta su aprobación.
• crear_pregunta_de_biblioteca: Prepara una pregunta para la biblioteca de la cuenta dueña del proyecto, que no se crea hasta su aprobación.
• importar_seccion_a_encuesta: Prepara la copia de una sección con sus preguntas al final de una encuesta del proyecto, que no se hace hasta su aprobación.
• marcar_item_de_indicador: Prepara sumar una pregunta como ítem de un índice propio del proyecto, que no se aplica hasta su aprobación.
• agregar_fuente_al_tablero: Prepara una fuente nueva para un tablero de análisis del proyecto que ya existe (una encuesta o un evento del proyecto), que no se agrega hasta su aprobación.
• recalcular_tablero: Prepara el recálculo de un tablero de análisis del proyecto, el mismo del botón "Actualizar ahora" del panel, que no se hace hasta su aprobación.
• anexar_impacto_a_rendicion: Prepara anexar el informe de impacto del proyecto a una de sus rendiciones, el mismo PDF que anexa el panel, que no se anexa hasta su aprobación.
• editar_acto_cultural: Prepara cambios a un acto cultural del proyecto, que no se aplican hasta su aprobación.
• editar_empleo_directo: Prepara cambios a un puesto de empleo directo del proyecto, que no se aplican hasta su aprobación.
• editar_alcance_difusion: Prepara cambios a una medición del alcance de la difusión del proyecto, que no se aplican hasta su aprobación.
• borrar_acto_cultural: Prepara borrar un acto cultural del proyecto, que no se borra hasta que una persona lo aprueba; borrado, no se recupera.
• borrar_empleo_directo: Prepara borrar un puesto de empleo directo del proyecto, que no se borra hasta que una persona lo aprueba; borrado, no se recupera.
• borrar_alcance_difusion: Prepara borrar una medición del alcance de la difusión del proyecto, que no se borra hasta que una persona la aprueba; borrada, no se recupera.
• editar_organizacion: Prepara cambios a los nombres de una organización del proyecto (un colegio, un centro, una sede), que no se aplican hasta su aprobación.
• editar_unidad: Prepara cambios a una unidad de una organización del proyecto (un curso, un taller, un grupo), que no se aplican hasta su aprobación.
• crear_tema: Prepara un tema nuevo del proyecto (una bitácora, un taller, una charla: lo que después se programa en fechas), que no se crea hasta su aprobación.
• crear_sesion_programada: Prepara una sesión programada (una fecha concreta de un tema del proyecto, con las unidades que participan), que no se crea hasta su aprobación.
• crear_enlace_corto: Prepara un enlace corto del proyecto hacia una página de TCultura, que no se crea hasta su aprobación.
• confirmar_accion: Ejecuta la acción preparada en una vista previa, identificada por su token.
• cargar_encuesta_de_papel: Carga una encuesta que se respondió en papel, a partir de su transcripción.
• adjuntar_foto_de_papel: Adjunta la foto del papel a una respuesta ya cargada, como fuente de la transcripción.

Qué no sale por esta vía

Los datos de las personas de un proyecto. Se entregan conteos, totales, indicadores agregados y direcciones de pantallas de la plataforma. No se entregan nombres, correos, teléfonos, RUT ni respuestas individuales de nadie: cuando la pregunta apunta a una persona, la respuesta es un número y el enlace a la pantalla de TCultura donde ese dato vive, detrás del inicio de sesión.

Y hay algo que no sale nunca, ni siquiera cuando preguntas por lo tuyo: el número y el código de una entrada, el código de tu Pasaporte Cultural, el archivo de un certificado y el código de canje de un premio. Con cualquiera de esos se entra a una actividad o se retira un premio, así que se ven en TCultura con tu sesión y no viajan a una conversación.

Cada consulta queda registrada con su fecha, la herramienta usada y la conexión que la hizo, y ese registro se puede revisar desde el panel.

El detalle de cómo tratamos la información está en nuestra política de privacidad.

Si algo no funciona

Escríbenos a soporte@tcultura.com con el nombre de tu proyecto y qué asistente estás usando.